plugins:headlines

NP_Headlines

http://japan.nucleuscms.org/bb/viewtopic.php?t=3490

サイドバーに最新記事の一覧を表示したい場合、コア標準の<%blog%>変数だと細かい指定ができず、NP_ShowBlogsだと個別アイテムスキンで出力できず、NP_MultiTagsだとこれだけのために使うにはやや重く、汎用的な手法ではちょうどいい方法が意外にありません。

こういう場合はNP_RecentItemsがおすすめですが、カテゴリー別の出力指定はできません。カテゴリー別の出力ができるものとして、NP_Headlinesが候補に残ります。

スキン記述方法

パラメーターを付けずに

<%Headlines%>

とスキンに書いた場合は、カレントブログの最新10件を日付付きで表示します。カテゴリーが選択されている場合は、このプラグインの表示も同カテゴリーに絞り込まれます

パラメーター指定方法

<%Headlines([テンプレート],表示数,カテゴリーモード,ブログモード,iteminfoタイプ,カテゴリーIDの省略)%>

例(テンプレートは完全省略可能)

<%Headlines(5)%>
<%Headlines(mytemplate,5,,all)%>
<%Headlines(5,itemcat,,both,1)%>

テンプレート

Nucleusのテンプレートを指定することができます(省略可能)。ただし軽さ重視のためタイトルと投稿日時とカテゴリーしか表示できません。指定しない場合はこの分を除いて左詰め、すなわち表示数からパラメーターを書き始めるようにしてください。

カテゴリーモード

指定がない場合は通常のNucleusと同様の動作をします。

  • all・・・常に全カテゴリーのアイテムを表示。(複数ブログがある場合、ブログモードの指定がなければ現在のブログからのみ。指定がある場合はそれに依存します。)
  • itemcat・・・アイテムスキンで使用した場合、そのアイテムのカテゴリーと同じカテゴリーに属するアイテムだけ表示。
  • カテゴリーID・・・指定したカテゴリーのアイテムを表示。複数ある場合はスラッシュで区切って記述(1/3/4のように)。
  • <>カテゴリーID・・・指定したカテゴリー以外のアイテムを表示。複数ある場合はスラッシュで区切って記述(<>2/5のように)。

ブログモード

指定がない場合は通常のNucleusと同様の動作をします。

  • all・・・常に全ブログのアイテムを表示。ただしカテゴリーを選択したときの状態についてはカテゴリーモードの指定に左右されます。
  • ブログID・・・指定したブログのアイテムを表示。複数ある場合はスラッシュで区切って記述(1/3/4のように)。
  • <>ブログID・・・指定したブログ以外のアイテムを表示。複数ある場合はスラッシュで区切って記述(<>2/5のように)。

iteminfoタイプ

Nucleusのテンプレートを利用しない場合に有効になるパラメーターです。指定がない場合は 'date'。Nucleusのテンプレートを使わない場合の出力HTMLも参考にしてください。

  • date・・・デフォルト末尾にアイテム投稿日を2005-05-03の様に挿入します。
  • -category・・・末尾にアイテムのカテゴリー名を[Nucleusメモ]の様に挿入します。
  • both・・・アイテム投稿日とカテゴリー名の両方を2005-05-03[Nucleusメモ]のように先頭に挿入し、さらにこの直後(アイテムタイトルの手前)に改行(<br />)が1つ入ります。

カテゴリーIDの省略

Nucleusによりカテゴリーが絞り込まれている状態のとき、またはカテゴリーモードでitemcatを指定している場合に各アイテムへのリンクにカテゴリーIDを含めないようにできる設定。

  • 0 : デフォルト省略しない
  • 1 : 省略する

複数blog表示時のカテゴリー表記設定

デフォルトではブログモードをall等にした場合、カテゴリー名はWeblog : Nucleusメモの様に、「blog名 : カテゴリー名」の形式で表示されます。これを変更するにはNP_Headlines.phpをエディタで開いて30行目あたりにある以下の部分を変えて下さい。

all blogs mode
$catformat = '<%blogname%> : <%category%>';

Nucleusのテンプレートを使わない場合の出力HTML

Nucleusのテンプレートを使わない場合のHTMLソースは以下のようになります。

date
<ul>
<li>アイテムのタイトル <span class="iteminfo">[2005-05-03]</span></li>
</ul>
//category
<ul>
<li>アイテムのタイトル <span class="iteminfo">[Nucleusメモ]</span></li>
</ul>
//both
<ul>
<li><span class="iteminfo">2005-05-03 [Nucleusメモ]<br /> 
</span>アイテムのタイトル</li>
</ul>
 
plugins/headlines.txt · 最終更新: 2011/03/23 21:28 (外部編集)