pieX (04)

[ スニペット ]

参照ページ：pieX

テスト環境

• サーバ：さくらインターネット 　
  • PHP 4.4.4
  • MYSQL 4.0.27
• MODX：0.9.5
• pieX (04)

基本的な書式

[!pieX? &url=`feedURL`!]

取り込みたいURL内に「?」「=」「&」がある場合

以下のように書き換えます

• 「?」＝>|xq|
• 「=」＝>|xe|
• 「&」＝>|xa|

スニペットコールサンプル：

[!pieX? &url=`http://ドメインとか/index.php?act=rss&id=1`!]

↓

[!pieX? &url=`http://ドメインとか/index.php|xq|act|xe|rss|xa|id|xe|1`!]

パラメータ

cnt

表示するレコード数。デフォルト「10」

スニペットコールサンプル：

[!pieX? &url=`feedURL` &cnt=`5`!]

desc2text

プレイスホルダ（後述）で利用出来る、feed_description（サイト概要）および、description（記事概要）からHTMLタグを除去するか否か。デフォルト「する（1）」

※desc2textを「0（タグ除去無効）」とする場合の注意点※

「0（無効）」の場合、feed側にタグを含んでいる時、場合によっては、読み込み先のソースを崩す可能性があるので、利用には注意が必要

len

プレースフォルダ（後述）で、description（記事概要）の表示文字数。デフォルト「128バイト（サフィックス「...」含む）」。「0」で全文表示

スニペットコールサンプル：

[!pieX? &url=`feedURL` &len=`20` &cnt=`5`!]

date

日時フォーマットを設定。デフォルト「Y/m/d」。PHPのdate関数を利用出来ます。

cachetime

キャッシュの有効時間を設定。単位は分。デフォルト60分。

tmo

タイムアウトを設定。単位は、秒。デフォルト30秒

テンプレート呼び出し用パラメータ

headTpl

ヘッダ用テンプレート。デフォルト以下。

<h2><a href="[+feed_link+]" title="[+feed_title+]">[+image_url+]</a></h2><ul>

footTpl

フッタ用テンプレート。デフォルト以下

</ul>

itemTpl

中身用テンプレート。デフォルト以下

<li><a href="[+permalink+]" title="[+description+]">[+title+]</a>([+date+])[+category+]</li>

noitemTpl

エラーがあった時、記事アイテムがない時用のテンプレート。デフォルト以下

<p>no item</p>

テンプレートで使用出来るプレースフォルダ

headTpl/footTpl

• [+feed_title+]…サイトのタイトル
• [+feed_description+]…サイトの概要
• [+feed_link+]…サイトのURL
• [+image_url+]…ヘッダロゴのURL（imgがない場合は、feed_titleを表示）

itemTpl

• [+title+]…記事のタイトル
• [+permalink+]…記事のURL
• [+description+]…記事の概要
• [+date+]…日付
• [+category+]…カテゴリ
• [+author+]…投稿者

サンプル

サイドバー表示用にリンクタイトルのみ表示し、ツールチップで時間を表示

このサイトのフロントページ左ブロックで、「るるろぐてくにかる。」を読み込んでいる部分がそうです。

スニペットコール

[!pieX? &url=`http://www.yoursite.com/rssfeed.xml` &cnt=`5` &cachetime=`360` &itemTpl=`px_lulu_item` &date=`Y.m.d - H:i` &headTpl=`px_lulu_head`!]

itemTpl = rss_fs_itemTpl

<li><a href="[+permalink+]" title="[+date+]">[+title+]</a></li>

headTpl

<ul>