BlognPlus 用「アーカイブ一覧化モジュール」

ブログの記事がたくさんたまってくると「あの記事いつ書いたっけ？」と思うことありませんか？
記事を探す為に１ページずつさかのぼっていくのは結構大変です。

そこでこのモジュールを導入すると、BlognPlus でカテゴリー別/月別/ユーザー別記事表示時に、記事タイトルを一覧化して表示出来ます。
１ページに数十個の記事を一覧表示出来、お目当ての記事を探しやすくなる事でしょう。

モジュールの主な機能

１ページに最大50件の記事の一覧を表示する事が出来ます。一覧に表示できる項目は

記事タイトル
日付
投稿者名
コメント数
トラックバック数
カテゴリー
記事の概要

動作例

モジュールを導入する前に、どんな風に動作しているかご覧になりたい場合は、以下のサイトを参考にして下さい。

※ トラックバックをいただいたサイト様に無断でリンクさせていただいています。

動作環境

BlognPlus v2.6.2
BlognPlus v2.6.0
BlognPlus v2.5.6

ダウンロード

利用規約

このモジュールの所有権は「nJOY」管理人 CJ にあります。
モジュールを使用して損害が生じても、「nJOY」管理人 CJ は一切の責任を負いかねます。
モジュールの再配布・販売等は一切禁じます。
利用者個人の責任において改造は自由に行えます。
スクリプト内にあるプログラム名・バージョン名・著作権表示を削除・変更する事は認めません。
当規約に同意された方のみ、このモジュールを無料で使う事が出来ます。
もしよければ、あなたのブログに「nJOY BLOG」へのリンクをはってやってください。管理人が大変喜び、モジュール作成の励みになります。

「アーカイブ一覧化モジュール」（alist.zip, 14kb）

インストール方法（主な手順）

ダウンロードした圧縮ファイル（alist.zip）を解凍する。
「alist」フォルダを BlognPlus ディレクトリ下の /module/ にアップロードする。
「config.cgi」のパーミッションを変更する（「666」等）。
BlognPlus v2.6.x: モジュール管理画面で「インストール」ボタンを押す。
モジュールの設定を変更する。
スキンファイルの任意の場所に alist 用タグを記述する。
BlognPlus v2.6.x: 必要に応じて「PC」「携帯」動作スイッチを「ON」にする必要があります。
BlognPlus v2.6.x: 一部のモジュールと優先順位を入れ替える必要があります。

モジュール構成ファイル

blognplus
module
alist
blank.php
config.cgi
control.php
function.php
i_function.php
index.html
info.php
install.php
menu.php
style.php
uninstall.php
update.php
viewer.php

赤文字のファイルのパーミッションは「666」「606」等にする必要があります。

インストール方法（BlognPlus v2.6.x 以降）

インストール

「alist」フォルダを /module/ ディレクトリ下にアップロード後、未登録一覧に入っている「アーカイブ一覧化モジュール」の [インストール] ボタンを押してください。

動作設定

PC: PC 用スキンに独自タグを記述した場合、「PC」欄を「ON」にしてください。
携帯: 携帯用スキンに独自タグを記述した場合、「携帯」欄を「ON」にしてください。

優先順位

「カレンダーモジュール」より下にする必要があります。

使用できるタグ

タグ	説明
{ALM}	開始タグ
{ALM_HEADING}	カテゴリー別表示時に「カテゴリー名」を出力月別表示時に「年月」を出力ユーザー別表示時に「ユーザー名」を出力
{ALM_LOOP}	ループ処理開始タグ
{ALM_YMD}～{/ALM_YMD}	記事の日付を出力
{ALM_HMS}～{/ALM_HMS}	記事の日付を出力
{ALM_TITLE}	記事タイトルを出力（記事にリンク）
{ALM_AUTHOR}	記事投稿者名を出力（プロフィールにリンク）
{ALM_COMMENT}	コメント数を出力（コメント欄にリンク）
{ALM_TRACKBACK}	トラックバック数を出力（トラックバック欄にリンク）
{ALM_CATEGORY}	記事の属するカテゴリー名を出力（カテゴリー別表示にリンク）
{ALM_MES}	記事の概要を表示
{/ALM_LOOP}	ループ処理終了タグ
{/ALM}	終了タグ

※ 太字で記されているタグは必須です。

スキンファイルへの記述方法

試しに以下のような記述をスキンファイルに追加して、必要に応じて各自修正してください。

{ALM}
■ {ALM_HEADING}
<ul>
{ALM_LOOP}
<li>{ALM_YMD}Y/m/d{/ALM_YMD} {ALM_TITLE} ({ALM_AUTHOR})| {ALM_COMMENT} | {ALM_TRACKBACK} | {ALM_CATEGORY}<br>{ALM_MES}</li>
{/ALM_LOOP}
</ul>
{/ALM}

※ {LOG}～{/LOG} の直前あたりに追加するといいと思います。

管理画面

管理画面からモジュールの動作に関する設定を変更できます。

一覧化・表示件数

カテゴリー別/月別/ユーザー別表示時に、それぞれ一覧化するかしないか、した場合の表示件数（1～50件）を設定できます。

{ALM_MES}

スキンに {ALM_MES} と記述する事で、記事の概要も表示できます。ここでは最初の何文字を抜粋して表示させるかを指定できます（mbstring 関数が使えない場合は、bytes 数で指定）。
概要からはすべての HTML タグが除去されます。また「続き」部分は概要の対象外になります。

{ALM_TITLE}

スキンに {ALM_TITLE} と記述する事で、記事のタイトルを表示できます。ここでは最初の何文字を抜粋して表示させるかを指定できます（mbstring 関数が使えない場合は、bytes 数で指定）。「無制限」を選ぶとタイトルは省略されません。

モジュールの仕様・他

仕様

このモジュールを使うと、カテゴリー別表示時に「index.php?cl=*-*」、月別表示時に「index.php?ml=******」、ユーザー別表示時に「index.php?ul=*」にリダイレクトされるようになります。

スキンが適用されるのは、初期表示用のスキンです。
カテゴリー別/月別/ユーザー別スキンに適用したい場合は、「index.php」の改造が必要です（後述）。

他のモジュールとの互換性

以下のモジュールを使っている場合は、各モジュールの最新版にアップデートしてください。

月別一覧を ON にすると「カレンダーモジュール」に不具合が出る事を確認しています。不具合の解消方法については下記を参照してください。

「カレンダーモジュール」との互換性

カレンダーモジュール v1.4

BlognPlus v2.6.x 以降に同梱されている「カレンダーモジュール v1.4」では改造の必要はありません。

カレンダーモジュール（バージョン表記無し）

月別一覧が「ON」の場合、カレンダーによる月移動が出来ない不具合があります。
「カレンダーモジュール」が「アーカイブ一覧化モジュール」で拡張した機能に対応しきれていないのが原因です。

「カレンダーモジュール」の「calender.php」17行目からを以下のように改造する事で、不具合が解消されます。

赤文字部分の2行を追加してください。

if ($_GET["m"] != "") {
$blogn_mod_calendar_date = $_GET["m"];
} elseif ($_GET["ml"] != "") {
$blogn_mod_calendar_date = $_GET["ml"];
}else{
$blogn_mod_calendar_date = gmdate("Ym", time() + BLOGN_TIMEZONE);
}
$blogn_skin = blogn_mod_calendar_viewer($blogn_user, $blogn_skin, $blogn_mod_calendar_date);

アップグレードの仕方

Ver1.30～1.33 → Ver1.33

「config.cgi」以外を上書きアップロードしてください。
設定項目が増えているので、設定画面に入り設定をしなおしてください。

Ver1.10～1.24 → Ver1.33

一度、「アーカイブ一覧化モジュール」をアンインストールしてください（ /alist/ ディレクトリを削除する、独自タグは残したままで良い）。
その後、一から「アーカイブ一覧化モジュール」を再インストールしてください。

アンインストール方法

BlognPlus v2.6.x 以降

モジュール管理画面から「モジュールアンインストール」ボタンを押す。

BlognPlus 全バージョン共通

スキンの HTML ファイルに追加したモジュール独自タグを削除する。
/alist/ ディレクトリを削除する。

バージョンアップ情報

2009/06/23: ver1.33 記事タイトルの文字数指定機能追加
2009/05/30: ver1.32 BlognPlus v2.6.2 に対応
2009/05/12: ver1.31 「カレンダーモジュール」併用時に不具合があったのを修正
2009/04/25: ver1.30 管理画面に固定メニューを導入
2009/04/24: ver1.28 {NEXTPAGE}{BACKPAGE}タグの機能拡張に対応（v2.6.1）
2009/04/24: ver1.27 携帯用設定追加
2009/04/23: ver1.26 設定ファイル名（「config.ini」→「config.cgi」）＆仕様変更
2009/04/12: ver1.25 カレンダーモジュール v1.4 に対応
2008/12/30: ver1.24 記事の概要から絵文字用制御文字列 [:ほげ:] を削除
2008/12/30: ver1.23 記事の概要から改行用制御文字列 {:rn:} を削除
2008/11/01: ver1.22 存在しないページ参照時の不具合修正
2008/03/20: ver1.21 概要の文字数指定機能追加
2008/03/20: ver1.20 {ALM_MES} 追加
2008/03/20: ver1.15 リダイレクト処理を変更
2006/03/06: ver1.14 「RSS/Atom 生成モジュール」併用時の不具合を修正
2006/03/06: ver1.13 記事がない時にタグがそのまま表示されてしまう不具合を修正
2006/03/01: ver1.12 記事タイトルがない時に“（無題）”と表示
2006/02/28: ver1.11 処理を見直して若干高速化
2006/02/08: ver1.10 設定画面追加
2006/02/04: ver1.03 リダイレクトされるように変更
2006/02/04: ver1.02 ユーザー別一覧化機能追加
2006/02/02: ver1.01 月別一覧化機能追加
2006/02/01: ver1.00 カテゴリー別一覧化機能追加

［サイト作成のヒント集に戻る］