最新記事をPHPブロックや静的ページなどへ表示
  phpblock_blogblock.php                             Version: 2.0.7
                                                 Create: 2013/06/01
                Authors: Hiroshi Sakuramoto - hiro AT winkey DOT jp


この phpblock_blogblock はGeeklogをブログとして使う場合に便利なブロックを表示するPHPブロック関数を作成し簡単に利用できるように１つにまとめてあるものです。

PHPブロックや静的ページ内から利用でき、自動タグでも利用できます。

※自動タグに対応しているものは一部です。



===== まとめてある関数一覧 =====

  * 最新記事の表示用PHPブロック関数 - phpblock_newentries (自動タグ対応)
  * 記事カテゴリの表示用PHPブロック関数 - phpblock_category
  * 最新コメントの表示用PHPブロック関数 - phpblock_newcomments
  * 過去月間記事の表示用PHPブロック関数 - phpblock_archives
  * 人気記事の表示用PHPブロック関数 - phpblock_storystats (自動タグ対応)

それぞれの表示例は [[#PHPブロック関数の表示サンプル]] にて確認できます。


===== インストール =====

//<private>は非公開ディレクトリを意味します。//

  - phpblock_blogblock.php を <private>/system/custom/ にコピーしてください。　<private>/system/customがない場合は作成してください。
  - add_to_lib-custom.php.txt のすべてを private/system/lib-custom.php の最後の「?>」の前に貼り付けてください。

これでインストール完了です。次はブロックを作成して表示させます。



===== 利用方法(ブロックの作成方法) =====

  - 管理者ログインしてブロック管理画面を表示します。
  - ブロックを新規作成します。
  - "ブロック編集のタイトル"を「最新情報」、ブロックIDを「newentries」、タイプを「PHPブロック」、"PHPブロックのオプション"の関数を「phpblock_newentries」に指定し「保存」します。

※そのほかの関数も同じような作成方法で利用できます。


===== 利用方法(自動タグの作成方法) =====

  - 管理者ログインしてAutotags管理画面を表示します。
  - Autotagsを新規作成します。

//自動タグの新規作成フォーム画面までは同じです。//

==== 最新記事を表示する自動タグの作成 - [newentries:] ====

  - タグ名を「newentries」
  - タグの説明を「最新記事表示用自動タグ」
  - 有効にチェックを付け
  - 関数にチェックを付け
  -「保存」します。
  - 利用する場合の書式は [newentries:件数 <オプション指定>] となります。

=== [newentries:]自動タグのオプション ===

[newentries:件数 <オプション指定>]

オプション指定には次のものが使えます。

     len:24            ・・・表示するタイトルの文字数
     introlen:72       ・・・表示するイントロ記事の文字数
     trimstr:..        ・・・丸めたタイトルの末尾の文字列
     titlepostmsg:new  ・・・タイトルの後に付加する文字列
     exclude:gl,ga     ・・・表示制限する話題(カンマ区切り)
     exclude_flg:false ・・・excludeで指定した話題を表示する(true)/表示しない(false)を切り替える
     list_flg:false    ・・・最新記事を<dl><dt>のリストで表示する(true)/表示しない(false)を切り替える
     newentries_flg:false ・・・ 最新情報を<ul><li>のリストで表示する/表示しないを切り替える
     dateformat:""     ・・・日付のフォーマット(dateのformat)
     morestr:"more"    ・・・記事へのリンクを表す文字列
     arrowimg:""       ・・・記事へのリンク文字の左へ出す矢印画像のurl

日付のフォーマットの記述はこちらを参照
http://www.php.net/manual/ja/function.date.php


==== 人気記事の上位を表示する自動タグの作成 - [storystats:] ====

  - タグ名を「storystats」
  - タグの説明を「人気記事の上位の表示用自動タグ」
  - 有効にチェックを付け
  - 関数にチェックを付けて「保存」します。
  - 利用する場合の書式は [newentries:件数 <オプション指定>] となります。

=== [storystats:]自動タグのオプション ===

[storystas:件数 <オプション指定>]

オプション指定には次のものが使えます。

     title:記事（上位10件）  ・・・表示するタイトル
     fld01:記事のタイトル    ・・・表示する一覧のヘッダ項目１のタイトル 
     fld02:件                ・・・表示する一覧のヘッダ項目２のタイトル 
     notmsg:記事がありません ・・・記事が0件の場合の表示メッセージ

===== カスタマイズ方法 =====

==== デフォルトの動作を変更 ====

phpblock_blogblock.php の関数の引数部分の値を直接変更します。

//コメントが記入してありますのでそれを参考に変更してください。//


==== 見た目をCSSで整える ====

全体を<div class="blogblock">でかこってあります。

個々の記事を<div class="blogblock-contentX">でかこってあります。

//※Xは数値で1から順番に記事のかずだけ増えていきます//

これらを利用しCSSでご自由に整えてください。


===== PHPブロック関数の表示サンプル =====

==== 最新記事の表示用PHPブロック関数 - phpblock_newentries ====

     最新情報
       アンケートにご協力くだ..
       Geeklogへようこそ

==== 記事カテゴリの表示用PHPブロック関数 - phpblock_category ====

     カテゴリ
       General News (3)
       Geeklog (1)

==== 最新コメントの表示用PHPブロック関数 - phpblock_newcomments ====

//2件以上だと[]で件数ができます。//

     コメント
       アンケートにご協力くだ... [+2]
       Geeklogへようこそ

==== 過去月間記事の表示用PHPブロック関数 - phpblock_archives ====

//24ヶ月分までリンク作成(limitで変更可能)//

     Archives
       2008/07 (3)
       2008/06 (1)
       2008/05 (2)

==== 人気記事の表示用PHPブロック関数 - phpblock_storystats ====

     記事（上位10件）

     記事のタイトル              |件
     ----------------------------+------
     Geeklogへようこそ           |10
     アンケートにご協力ください  |4


===== 更新履歴 =====
2013/06/01 2.0.7  phpblock_archivesをGeeklog.2.0に対応
2013/05/29 2.0.6  newentriesをGeeklog.2.0に対応
                  newentriesの日付をhtml5の<time>タグに対応させる
2011/10/26 2.0.5  newentriesでnewentries_flg=true時にdateformatを指定しても日付が表示されない不具合を修正
2010/03/13 2.0.4  newentriesのexclude_flg=true時に複数のexcludeを指定すると表示されない不具合を修正(報告:neroさん)
2010/02/28 2.0.3  phpblock_categoryへulタグを付加(報告:dengen_xpさん)
                  brタグにXHTML未対応があり修正(報告:dengen_xpさん)
2010/02/26 2.0.2  最新記事の記事への続きリンク用の文字列と矢印の指定に対応(morestr&arrowimg)
2010/02/25 2.0.1  <div class="blogblock">が2重に出る不具合を修正
                  人気記事の上位10件を表示する関数と自動タグを追加(要望:Augeさん)
2010/02/25 2.0.0  Blog用の関数をまとめた
                  自動タグがそのまま出力されるバグを修正(報告:Augeさん)
2008/07/24 1.0.2  <dl><dt>でのリスト表示モードに対応
2008/04/16 1.0.1  自動タグ [blogblock:] に対応
2008/02/12 1.0.0  phpblock_newinfoを改良し公開

