plugins:headlines

差分

この文書の現在のバージョンと選択したバージョンの差分を表示します。

この比較画面にリンクする

plugins:headlines [2011/03/23 21:28] (現在)
ライン 1: ライン 1:
 +====== NP_Headlines ======
 +
 +http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=3490
 +
 +サイドバーに最新記事の一覧を表示したい場合、コア標準の<​%blog%>​変数だと細かい指定ができず、[[plugins:​showblogs|NP_ShowBlogs]]だと個別アイテムスキンで出力できず、[[plugins:​multitags|NP_MultiTags]]だとこれだけのために使うにはやや重く、汎用的な手法ではちょうどいい方法が意外にありません。
 +
 +こういう場合は[[plugins:​recentitems|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行目あたりにある以下の部分を変えて下さい。
 +<code php>
 +all blogs mode
 +$catformat = '<​%blogname%>​ : <​%category%>';​
 +</​code>​
 +
 +===== Nucleusのテンプレートを使わない場合の出力HTML =====
 +
 +Nucleusのテンプレートを使わない場合のHTMLソースは以下のようになります。
 +<code 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>
 +</​code>​
  
 
plugins/headlines.txt · 最終更新: 2011/03/23 21:28 (外部編集)