BlognPlus 用 RSS2.0/Atom1.0 生成モジュール
BlognPlus に RSS2.0, Atom1.0 フィードを生成させるようにするモジュールです。
このモジュールで配信されるフィードは「FEED Validator」で正しい文法に基づいて書かれている事を確認しています。
Feed Generator の機能
RSS2.0/Atom1.0
もともと BlognPlus には RSS1.0 形式のフィードを配信する機能が備わっていますが、このモジュール「Feed Generator」を導入すると RSS2.0 と Atom1.0 フィードも配信できるようになります。
フィードのリンク
- RSS1.0 - http://〜〜/index.php?mode=rss
- RSS2.0 - http://〜〜/index.php?mode=rss2
- Atom1.0 - http://〜〜/index.php?mode=atom1
ユーザー別・カテゴリー別フィード
ユーザーまたはカテゴリーで絞ったフィードを出力する事が出来ます。
コメント・トラックバック用フィード
記事についたコメントおよびトラックバックのフィードも配信する事が出来ます。
Podcasting(ポッドキャスティング)対応
MP3ファイルへのリンクを自動的に検出し、フィードに反映する事が出来ます(RSS2.0のみ)。
Podcasting 対応のソフト(iTunes 等)にフィードを登録すれば自動的にMP3ファイルを取得、iPod との連携させる事が出来ます。
スタイルシートを適用できる
フィードへのリンクをクリックすると素の XML が表示されてしまいますが、Feed Generator では スタイルシートを適用する事が出来ます。フィードが整形されて出力されるので、ちょっとかっこいいかも。
適用前 |
| 適用後 |
|
→ |
|
動作例
モジュールを導入する前に、どんな風に動作しているかご覧になりたい場合は、以下のサイトを参考にして下さい。
※ トラックバックをいただいたサイト様に無断でリンクさせていただいています。
動作環境
- BlognPlus v2.6.2
- BlognPlus v2.6.0
- BlognPlus v2.5.6
- BlognPlus v2.5.0
- BlognPlus v2.4.x
- BlognPlus v2.3.x
ダウンロード
利用規約
- このモジュールの所有権は 「nJOY」管理人 CJ にあります。
- モジュールを使用して損害が生じても、「nJOY」管理人 CJ は一切の責任を負いかねます。
- モジュールの再配布・販売等は一切禁じます。
- 利用者個人の責任において改造は自由に行えます。
- スクリプト内にあるプログラム名・バージョン名・著作権表示を削除・変更する事は認めません。
- 当規約に同意された方のみ、このモジュールを無料で使う事が出来ます。
- もしよければ、あなたのブログに「nJOY BLOG」へのリンクをはってやってください。管理人が大変喜び、モジュール作成の励みになります。
「Feed Generator」(feedgen.zip, 15kb)
Feed Generator 用 XSL 詰め合わせ
BlognPlus + Feed Generator で出力される RSS2.0/Atom1.0 フィードに適用できる XSL と CSS を用意しました。
「rss2.xsl」「atom1.xsl」「feed.css」を「skin」ディレクトリ下へアップロードして下さい。
「XSL 詰め合わせ」(xsl_pack.zip, 4kb)
※ 同梱の「readme.txt」にも一度目を通しておいてください。
インストール方法(主な手順)
- ダウンロードした圧縮ファイル(feedgen.zip)を解凍する。
- 「feedgen」フォルダを BlognPlus ディレクトリ下の /module/ にアップロードする。
- 「config.cgi」のパーミッションを「666」等に変更する。
- スキンファイルに RSS2.0 と Atom1.0 へのリンクをはる。
- スキンファイルに Feed auto-discovery を埋め込む。
モジュール構成ファイル
- blognplus
- module
- feedgen
- blank.php
- config.cgi
- control.php
- feedgen.php
- index.html
- info.php
- install.php
- menu.php
- style.php
- uninstall.php
- update.php
- viewer.php
赤文字のファイルのパーミッションは「666」「606」等にする必要があります。
インストール作業(BlognPlus v2.6.x 以降)
BlognPlus v2.6.x 以降では上記の手順に加え、次のインストール作業が必要になります。
インストール
「feedgen」フォルダを /module/ ディレクトリ下にアップロード後、未登録一覧に入っている「RSS/Atom 生成モジュール」の [インストール] ボタンを押してください。
動作設定
- PC
- PC 用にフィードを配信したい場合、「PC」欄を「ON」にしてください。
- 携帯
- 携帯用にフィードを配信したい場合、「携帯」欄を「ON」にしてください。
優先順位
特に制限はありません。
スキンファイルへの記述方法
フィードへのリンク
スキンの適当な場所、例えば RSS1.0 のリンクの下などに以下のタグを追加。
- <a href="{HOMELINK}index.php?mode=rss2">RSS 2.0</a>
- <a href="{HOMELINK}index.php?mode=atom1">Atom 1.0</a>
Feed auto-discovery
スキンファイルの<head>〜</head>内に以下のタグを追加。
- <link rel="alternate" type="application/atom+xml" href="{HOMELINK}index.php?mode=rss2" />
- <link rel="alternate" type="application/atom+xml" href="{HOMELINK}index.php?mode=atom1" />
パラメーターオプション
ユーザー別フィード
複数ユーザーで管理しているブログでも、ユーザーごとのフィードを配信する事が可能です。
ユーザー別に配信する場合は、アドレスの末尾に「&u=ユーザーID」を追加してください。
例(RSS2.0)
- http://〜〜/index.php?mode=rss2&u=1
- http://〜〜/index.php?mode=rss2&u=2
- http://〜〜/index.php?mode=rss2&u=3
例(Atom1.0)
- http://〜〜/index.php?mode=atom1&u=1
- http://〜〜/index.php?mode=atom1&u=2
- http://〜〜/index.php?mode=atom1&u=3
カテゴリー別フィード
カテゴリー別に配信する場合は、アドレスの末尾に「&c=カテゴリーID」を追加してください。
例(RSS2.0)
- http://〜〜/index.php?mode=rss2&c=1-
- http://〜〜/index.php?mode=rss2&c=1-1
- http://〜〜/index.php?mode=rss2&c=2-
例(Atom1.0)
- http://〜〜/index.php?mode=atom1&c=1-
- http://〜〜/index.php?mode=atom1&c=1-1
- http://〜〜/index.php?mode=atom1&c=2-
コメント用フィード
各フィードのアドレスの末尾に「&f=cmt」をつけると、コメント用フィードを配信します。
- http://〜〜/index.php?mode=rss2&f=cmt
- http://〜〜/index.php?mode=atom1&f=cmt
トラックバック用フィード
各フィードのアドレスの末尾に「&f=trk」をつけると、トラックバック用フィードを配信します。
- http://〜〜/index.php?mode=rss2&f=trk
- http://〜〜/index.php?mode=atom1&f=trk
Podcasting(ポッドキャスティング)について
記事内にMP3ファイルへのリンクがあると、RSS2.0フィードに自動的に反映されます。
Podcasting の方法
- 「初期設定」から「許可するファイルの種類」として mp3 を登録する
- 「初期設定」から「アップロード可能ファイルサイズ」を変更する
- 「ファイル管理」もしくは記事投稿時の「画像挿入」で MP3 ファイルをサーバーにアップロードする
- 「画像挿入」で記事内に MP3 ファイルへのリンクを挿入する
- ブログでポッドキャスティング用フィードとして、RSS2.0 の登録を呼びかける
仕様
- Podcasting に対応しているのは、RSS2.0 形式のフィードです。
- 複数のMP3ファイルへのリンクがあっても、最初のファイルしかフィードへは反映されません。
- ブログ外部にあるMP3ファイルへのリンクは Podcasting 対象外です。
- MP3ファイルへのリンクがあっても、そのファイルが存在しない場合は、フィードには反映されません。
- このモジュールは記事をMP3ファイルへ変換する機能は備えていません。別途MP3ファイルを用意してください。
設定画面
各形式のフィードに対して、スタイルシートを適用するか否か、そして出力する記事/コメント/トラックバックの件数(1〜25件)を個別に設定する事が出来ます。
スタイルシートを使う場合は、各フィード用の XSL ファイルと、共通の CSS ファイル(feed.css)を「skin」ディレクトリ下へアップロードして下さい。
※ BlognPlus v2.5.6 ではスタイルシートの適用はできません。
アップグレードの仕方
Ver2.00 → Ver2.01
「config.cgi」以外を上書きアップロードしてください。
Ver1.xx → Ver2.01
モジュールを一度アンインストールする必要があります。
モジュール用の記述を「index.php」へ追加している場合は、その記述を先に削除してください。
アンインストール方法
BlognPlus v2.6.x 以降
- モジュール管理画面から「モジュールアンインストール」ボタンを押す。
BlognPlus 全バージョン共通
- スキンの HTML ファイルに追加したフィードのリンク等を削除する。
- /feedgen/ ディレクトリを削除する。
バージョンアップ情報
- 2012/05/01
- ver2.01 「アメンボ for BlognPlus」に対応
- 2009/05/24
- ver2.00 「index.php」の改造が不要になりました
- 2009/05/24
- ver1.xx 管理画面に固定メニュー導入
- 2009/05/24
- ver1.xx RSS2.0 に <atom:link> 追加
- 2009/05/24
- ver1.xx Atom0.3 配信機能を廃止
- 2009/05/24
- ver1.xx BlognPlus v2.6.x で XSL が適用できない不具合修正
- 2009/05/24
- ver1.xx BlognPlus v2.6.2 に対応
- 2009/04/04
- ver1.52 BlognPlus v2.6.0 に仮対応
- 2009/02/22
- ver1.51 改行制御文字 {:rn:} が混入する不具合を修正
- 2007/09/30
- ver1.50 BlognPlus v2.5.1 に対応
- 2007/04/14
- ver1.45 RSS2.0 に <guid> 属性を追加
- 2006/12/27
- ver1.44 管理画面等を修正
- 2006/12/27
- ver1.43 BlognPlus v2.4.0 に対応
- 2005/11/11
- ver1.42 Atom0.3 にコメント・トラックバック用フィード配信機能追加
- 2005/11/10
- ver1.41 Atom1.0 にコメント・トラックバック用フィード配信機能追加
- 2005/11/08
- ver1.40 RSS2.0 にコメント・トラックバック用フィード配信機能追加
- 2005/10/31
- ver1.32 ポッドキャスティングで MP3 ファイルへのリンクが間違っていたのを修正
- 2005/10/30
- ver1.31 フィードの表示件数を設定可能に
- 2005/10/29
- ver1.30 XSL に対応
- 2005/10/25
- ver1.28 RSS2.0 で Podcasting(ポッドキャスティング)に対応
- 2005/10/18
- ver1.27 改行処理を修正
- 2005/10/15
- ver1.26 Atom1.0 でリンクの属性に間違いがあったのを修正
- 2005/10/15
- ver1.25 BlognPlus v2.3.2 でカテゴリー別フィード出力時にエラーが出る不具合修正
- 2005/09/24
- ver1.24 相対パスが絶対パスに変換されない不具合修正
- 2005/08/17
- ver1.23 Atom1.0 で不正確なフィードを出力していたのを修正
- 2005/08/17
- ver1.22 Atom1.0 で記事本文がXHTML準拠になるように修正
- 2005/08/13
- ver1.21 MySQL版でエラーになる不具合を修正
- 2005/08/12
- ver1.20 Atom1.0 生成機能追加、文法の間違いを修正
- 2005/08/10
- ver1.12 XMLパースエラーになる不具合を修正
- 2005/08/08
- ver1.11 カテゴリー別にフィードを配信出来る機能追加
- 2005/08/08
- ver1.10 ユーザー別にフィードを配信出来る機能追加
- 2005/08/07
- ver1.00 RSS2.0/Atom0.3 生成機能追加
[サイト作成のヒント集に戻る]