プラグインcustomizable-post-listings の使用法 | Myblog

Size: px

Start display at page:

Download "プラグインcustomizable-post-listings の使用法 | Myblog"

のぶあきおいもり
5 years ago
Views:

1 プラグイン customizable-post-listings の操作マニュアルこのマニュアルは Wordpress のプラグイン customizable-post-listings ver をベースに作成した CPL 日本語版 (ver.2.0.1) を対象に作成されたものです目次 1. インストール法基本的スクリプトの説明...3 A. テンプレート関数の説明...3 B. パーセント変換タグの説明具体的使用例...7 A. 記事の要約を表示する...7 B. 最近更新された記事...8 C. 最近掲載されたコメント...8 D. カテゴリー毎に全ての記事を表示...9 E. サイドバーに記事の抜粋を表示...10 F. 関数を使用してフォントの体裁を変更する例...11 G. 記事のリストを表形式に表示する...12 H. 題名のポップアップウィンドウに記事の抜粋を表示させる...12 I. カテゴリー / サブカテゴリーの表題を独自に取り出す

2 1. CPL 日本語版のインストール 1. CPL 日本語版をインストールします以下のファイルをマウスでクリックすると保存ウィンドウが開きますので適当なディレクトリに保存してください CPL 日本語版 ver このファイルを解凍するとマニュアル CPL_manual_ver2.0.1.pdf とディレクトリ customizable-post-listings が作成されますこのディレクトリにある readme_jp_2.0.1.txt ファイルにおいて使用条件を確認した上で customizable-post-listings をディレクトリごと Wordpress の wp-content/plugins/ にコピーしてください 3. admin でログインしてプラグインで使用するを選択して CPL を有効にします設定 - CPL でオプションを設定しますがさしあたりデフォルトのままで結構ですマニュアルを通読してから各設定を行ってください ( 注 ):CPL を記事やページで使用する場合にはプラグイン phprun が必要になりますインストールについては次の記事を参照してくださいプラグイン runphp のインストール 2

3 2. 基本的スクリプトの説明 A. テンプレート関数の説明 <ul> <?php c2c_get_recent_posts( $num_posts = 5, $format = "<li>%post_date%: %post_url%</li>", $categories = '', $orderby = 'date', $date_format = 'm 月 d 日 ', $include_passworded_posts = false, $extra_sql_where_clause = '' );?> </ul> 説明 1. 箇条書きの指定です ol を指定すれば番号表示となります 2. $num_posts : 表示する記事の数を指定しますこの場合は 5 件です全部表示したい場合には $num_posts = のように書き換えます 3. $format : 表示するフォーマットを指定します % 変換タグの間に文字列や HTML タグを埋め込むことができますこの例では記事の投稿日と題名 (URL 付き ) を表示する設定です 4. $categories : カテゴリーの ID を指定します空の場合には全てのカテゴリを表示しますカテゴリーを複数表示したい場合には ID をコンマ ( またはスペース ) で区切って指定します例えば $categories = 3,10,11 など逆に特定のカテゴリーを外したい場合にはその ID の前にマイナスをつけ記述します例えば $categories = -2,3,5 とすれば ID が 2,3,5 のカテゴリが表示から除かれますデフォルトは全カテゴリーです ( 注 ) 5. $orderby : 並べ替えの基準となる項目を指定しますこの場合には投稿日が指定されています使用可能なオプションは ID, date ( 投稿日時 ), modified ( 更新日時 ), name, title (ABC 順日本文字は正確に反映されない ) ですデフォルトは date です 6. $order : 並べ替えの順位を指定します DESC は降順 ASC は昇順となりますデフォルトは DESC です 7. $offset : 記事の表示を最初のものから指定した数だけ除外します記事の表示数を指定しないと無効になりますデフォルトは 0 です 3

4 8. $date_format : 日付時刻のフォーマットを指定しますここでは月と日だけの表示になっていますが m 月 d 日 H 時 i 分のように指定すれば時刻も表示してくれます 9. $authors :author の ID をスペースで区切って指定しますデフォルトは ( 全指定 ) です 10. $post_type : 記事検索の際に対象とされる記事のタイプをスペースで区切って指定しますオプションは post, page, attachment ですデフォルトは post です page を含めてリスト表示したい場合に便利です 11. $post_status : 検索の際に対象とされる記事のステータスをスペースで区切って指定しますオプションは publish( 公開済み ), draft, private, pending, future( 未公開 ) ですデフォルトは publish です 12. $include_passworded_posts: パスワードを指定した記事を表示するかどうかを指定します表示は true 非表示は false を指定しますデフォルトは false です ( 注 ):$category をデフォルト ( 全カテゴリー指定 ) で使用し新しい順に記事を表示しようとすると古い順に表示されてしまう不具合が生じますこの場合には $categories = - というように指定してやれば全カテゴリーについて新しい順に表示されます詳しくは次の記事を参照してください CPLで日付の古い順に表示されてしまう不具合について B. パーセント変換タグの説明以下はテンプレート関数の変数 $format の引数として使用できる % 変換タグの説明です日本語版に特有な内容については [] 内に記述してあります %allcomments_count% : 特定の記事に寄せられたコメント + ピンバック + トラックバックの数の合計を表示 %allcomments_fancy% : 全てのコメントの付帯情報を表示 %comments_count% : 特定の記事に関するコメントの数を表示 %comments_count_url% : 特定の記事に関するコメントの数を表示コメント欄のトップにリンク %comments_fancy% : 特定の記事のコメントの付帯情報を表示 %comments_fancy_url% : 特定の記事のコメントの付帯情報を表示コメント欄のトップにリンク %comments_url% : コメント欄のトップにリンクされた URL を表示 %comments_url% : 記事のタイトルを表示記事のパーマリンクのコメント欄のトップにリンク %last_comment_date% : 最新のコメントの日時を表示 %last_comment_excerpt% : 特定の記事に関する最新のコメントの抜粋を表示 [ 日本語版を使用する場合には表示語数を Comment excerpt words で指定することができます ] 4

5 %last_comment_excerpt_url% : 特定の記事に関する最新のコメントの抜粋を表示そのコメントへリンク %last_comment_id% : 特定の記事に関する最新のコメントの ID を表示 %last_comment_time% : 特定の記事に関する最新のコメントの投稿時刻を表示 %last_comment_url% : 特定の記事に関する最新のコメントへの URL を表示 %last_commenter% : 特定の記事に関する最新のコメントの投稿者を表示 %last_commenter_url% : 特定の記事に関する最新のコメントの投稿者へのリンク ( 投稿者がリンクを提供している場合 ) を表示 %pingbacks_count% : 特定の記事に関するピンバックの数を表示 %pingbacks_fancy% : トラックバックの付帯情報を表示 %post_author% : 記事の投稿者のネーム ( 投稿者の指定したネーム ) を表示 %post_author_count% : 特定の記事の投稿者の投稿した記事の数を表示 %post_author_description% : 投稿者の付帯情報を表示 %post_author_ % : 記事投稿者の e-メールアドレスを表示 %post_author_firstname% : 記事投稿者のファーストネームを表示 %post_author_id% : 記事投稿者の ID を表示 %post_author_lastname% : 記事投稿者のラストネームを表示 %post_author_login% : 記事投稿者のログインネームを表示 %post_author_nickname% : 記事投稿者のニックネームを表示 %post_author_posts% : 記事投稿者の全ての記事がリストされているページにリンク %post_author_url% : 記事投稿者のリンク名を表示 ( 投稿者が提供している場合 ) %post_subcategories% : [ サブカテゴリの題名を取得 - 日本語版のみ ] %post_subcategories_url% : [ サブカテゴリの題名を取得 ( リンク付き )- 日本語版のみ ] %post_pacategories% : [ 親カテゴリの題名を取得 - 日本語版のみ ] %post_pacategories_url% : [ 親カテゴリの題名を取得 ( リンク付き )- 日本語版のみ ] %post_categories% : 記事のカテゴリー名を表示 %post_categories_url% : 記事の所属しているカテゴリー名を表示そのカテゴリーのアーカイブにリンク %post_content% : 記事の全内容を表示 (<p> 及び <br> タグを除去 ) %post_content_full% : 記事の全内容を表示 (<p> 及び <br> タグを維持 ) %post_content_upto_more% :  のセパレータまでの記事を表示 more セパレータが挿入されていない場合には何も表示されません %post_date% : 記事の投稿された日時を表示 %post_excerpt% : 記事の抜粋を表示 (<p> 及び <br> タグ除去 ) [ 日本語版では語数を Excerpt words で指定できますこの場合半角文字も全角文字も 1 字として数えられます ] 5

6 %post_excerpt_full% : 記事の抜粋を表示します (<p> 及び <br> タグを維持 ) [ 日本語版の場合には語数は Excerpt length で指定できるようにしてあります HTML タグは除去されます ] %post_excerpt_short% : 抜粋の語数を指定して表示します ( サイドバーなどの限られたスペースに使用する場合など ) [ この % タグは日本語ではうまく働きません %post_excerpt% タグを使用してください ] %post_guid% : 記事の GUID を表示 %post_id% : 記事の ID を表示 %post_lat% : 記事の latitude を表示 %post_lon% : 記事の longitude を表示 %post_modified% : 記事の最新更新日時を表示 %post_name% : 記事のネームを表示 (aka slug) %post_status% : 特定の記事のポストステータスを表示 %post_tags% : 記事のタグ名を表示 %post_tags_url% : 記事のタグ名を表示そのタグのアーカイブにリンク %post_time% : 記事の投稿時を表示 %post_title% : 記事のタイトルを表示 %post_type% : 記事のタイプを表示 %post_url_popup% :[ 記事の抜粋をポップアップウィンドウに表示する- 日本語版のみ ] %post_url% : 記事の URL を表示 %post_url% : 記事のタイトルを表示記事のパーマリンクページにリンク %post_url_short% : 短縮形にカスタマイズしたタイトルを表示記事のパーマリンクページにリンク %trackbacks_count% : 特定の記事のトラックバック数を表示 %trackbacks_fancy% : トラックバックの付帯情報を表示 6

7 3. 具体的使用例以下は私が試みた表示方法の幾つかの例です参考にしてくださいカテゴリ ID などは本サイトに特有なものですので適宜変更してください A. 記事の要約を表示する <ol> <?php c2c_get_recent_posts( $num_posts = '5', $format = "<li>%post_url%<br> 掲載日時 :%post_date%<br> 分類 :%post_categories_url%<br>%post_content_upto_more%</li>", $categories = '3,11,30', $orderby= 'date', $date_format = 'Y 年 m 月 d 日 H 時 i 分 ', $include_passworded_posts = false );?> </ol> %post_content_upto_more% を指定すると記事の先頭から more までの内容を抽出して表示してくれます記事の題名や投稿日と共に記事の要約を表示したい場合には便利な機能ですカテゴリーは Wordpress 自宅サーバーアメリカ経済( 本サイトの場合 ) の 3 カテゴリーに絞ってあります読んでほしいジャンルをアッピールするのに便利ですこのテンプレート関数は次のように省略して書くことができます <ol> <?php c2c_get_recent_posts(5, "<li>%post_url%<br> 掲載日時 :%post_date(y 年 m 月 d 日 H 時 i 分 )%<BR> 分類 :%post_categories_url%<br>%post_content_upto_more%</li>", "3,11,30");?> </ol> デフォルトの変数と値は省略することができます値のある変数も順番が間違っていなければその変数の記述も省略することができます日付 % 変換タグは %post_date(y 年 m 月 d 日 H 時 i 分 )% のように準関数として使用することが可能です但しこのような使い方ができるのは日付 % 変換タグの中でも %post_date% だけですので注意してください表示結果 7

8 B. 最近更新された記事 <ol> <?php c2c_get_recently_modified( $num_posts = '10', $format = "<li>%post_url%<br /> 更新日時 :%post_modified%<br> 分類 :%post_categories_url%</li>", $categories = '3,11,30', $date_format = 'Y 年 m 月 d 日 H 時 i 分 ', $include_passworded_posts = false, $extra_sql_where_clause = '' );?> </ol> 関数は c2c_get_recently_modified を使用します %post_modified% が更新日時の表示設定ですテンプレート関数 c2c_get_recent_posts を使用しても $orderby= 'modified', を指定すれば同じ結果が得られます表示結果 C. 最近掲載されたコメント <ol> <?php c2c_get_recently_commented( $num_posts = '5', $format = "<li>%comments_url%<br /> 掲載日時 :%last_comment_date%<br /> %comments_fancy%<br>%last_comment_excerpt%</li>", $categories = '', $date_format = 'Y 年 m 月 d 日 H 時 i 分 ', $include_passworded_posts = false );?> </ol> 8

9 テンプレート関数は c2c_get_recently_commented を使用します %comments_url% はコメントが掲載された記事の題名( コメントへの URL 付き ) を表示します %last_comment_date% はコメントが掲載された日時を表示します %comments_fancy% は投稿されたコメントの数を表示しますデフォルトでは 1 comment のように表示されますので表示例のようにコメント 1 件と表示したい場合には設定 - CPL の comments_fancy の部分を適当に変えてください %last_comment_excerpt% はコメントの内容の抜粋を表示します表示結果 D. カテゴリー毎に全ての記事を表示 <ul> <?php c2c_get_recent_posts( $num_posts = '', $format = "<li>%post_date%: %post_url%</li>", $categories = '37', $orderby = 'date', $date_format = 'm 月 d 日 ', $include_passworded_posts = false, $extra_sql_where_clause = '' );?> </ul> $categories = 37 のように表示したいカテゴリー / サブカテゴリの ID を指定しますこの例ではサブカテゴリ記事整理システム (CPL) を指定しています表示結果 9

E. サイドバーに記事の抜粋を表示次の例はサイドバーに記事の抜粋を表示する場合の設定です自分のテーマの構造に踏まえて設定を行ってください admin でログインして設定 - CPL のオプションで表示する語数( Excerpt words の項 ) を指定しますこの例では 60 語に指定してありますオプションの値を変更したら必ず Save Changes ( 日本語版変更を保存 )

10 E. サイドバーに記事の抜粋を表示次の例はサイドバーに記事の抜粋を表示する場合の設定です自分のテーマの構造に踏まえて設定を行ってください admin でログインして設定 - CPL のオプションで表示する語数( Excerpt words の項 ) を指定しますこの例では 60 語に指定してありますオプションの値を変更したら必ず Save Changes ( 日本語版変更を保存 ) ボタンをクリックし変更を反映させてください sidebar.php の適当な部分に次のスクリプトを追加します $num_posts = '3' $categories = '30' はサイトの特殊性に踏まえて適当に変更してください <ul> <?php c2c_get_recent_posts( $num_posts = '3', $format = "<li>%post_url%:%post_excerpt%</li>", $categories = '30', $orderby = 'date', $date_format = 'm 月 d 日 ', $include_passworded_posts = false, $extra_sql_where_clause = '' );?> </ul> 10

11 F. 関数を使用してフォントの体裁を変更する例 PHP 関数を指定して % タグを引数に取ることもできます次の例は自作の PHP 関数を使用して % タグが表示する内容のフォントの体裁を変更する例ですもちろん既存の PHP 関数も利用できますのでユーザーの実践的目的に合わせてプログラムを作成してみてください <?php function fontsize_test($data,$size,$color,$char){ $xx = "<font size=\"$size\" color=\"$color\" >".$char.$data."</font>"; return $xx; }?> <div style="font-size:12pt;font-weight:bold;color:#000;padding:10px 0 0px 10px;"> 最近掲載された記事 </div> <ol> <?php c2c_get_recent_posts( $num_posts = '5', $format = "<li>%post_url%<br /> %function(fontsize_test,%post_date%,2,#000, 掲載日時 :)%<br /> %function(fontsize_test,%post_categories_url%,2,, 分類 :)%<br /> %function(fontsize_test,%post_content_upto_more%,2,#883333,)%</li>", $categories = '3,10,30', $orderby= 'date', $date_format = 'Y 年 m 月 d 日 H 時 i 分 ', $include_passworded_posts = false );?> </ol> 2 行目 : 関数名と引数の定義です 3 行目 : フォント加工部分の挿入句です文字列指定特殊文字 ( " " ) の内部で同じ特殊文字を使用する場合にはエスケープ文字 \ を前に挿入してください $sizeにはフォントサイズ (1 2 3 など ) $colorにはフォントカラー (#FF0000 あるいはredなど ) $dataには % タグ $charには任意の文字列を代入します 4 行目 : 変数 $xxの値を返します 12 行目 : 上記に定義した関数を %post_date%( 掲載日時 ) に適用しています % タグ関数 function の第 1 番目の引数として上記のPHP 関数名を指定しそれに続いてその関数の引数である $data,$size,$color,$charを指定しますこの場合にはそれぞれ %post_date%, 2, #000, 掲載日時: を代入しています 13 行目 : 同じく %post_categories_url%( カテゴリー URL) タグの表示体裁の変更です 11

12 14 行目 : 同じく %post_content_upto_more%( 要約 ) の表示体裁の変更です表示結果 ( 注意 ): 同じ機能の関数をページやテーマファイル (index.php など ) で複数使用する場合には関数名を変えてください ( 例えば上記の関数の場合には fontsize_hm などと ) 同じ関数名だとそれが使用されているページやサイドバーが同時に表示されたとき競合してうまく表示されないからです G. 記事のリストを表形式に表示するこれまでは記事はリスト形式で並び替えていましたが表形式でも表示することができます以下は登山日記の一部を表形式に並べて表示するスクリプトの例です <table border="5" bordercolor="008000" cellpadding="3"> <?php c2c_get_recent_posts( $num_posts = '5', $format = "<tr><td width=\"150\" bgcolor=\"dcffff\">%post_url%</td> <td width=\"450\" bgcolor=\"ffffdc\">%post_content_upto_more%</td></tr>", $categories = '6', $orderby = 'date', $date_format = 'm 月 d 日 ', $include_passworded_posts = false, $extra_sql_where_clause = '' );?> </table> 3 行目と 4 行目が表形式を指定するスクリプトですダブルクオーテンションマークをエスケープさせることを除けば HTML で表を作るのと同じ要領ですこのように特殊文字をエスケープさせることを忘れなければ大抵の HTML タグは $format 変数の内部で使用できます自分の目的に合わせて挑戦してみてください表示結果 H. 題名のポップアップウィンドウに記事の抜粋を表示させる一般にリンクが張られた題名にマウスのポインターを当てるとポップアップウィンドウが開いてその表題に関する情報が表示されますこの表示の内容は以下のようなリンク設定の title 部分で指定します <a href="http//: アドレス " title=" ここに指定 " > 表題 </a> 12

13 記事本文にリンクの張られたタイトルにマウスのポインターを当てたときその記事の抜粋を表示することができればサイドバーなどの限られた場所に記事の表題をリストし同時にその内容を表示したい場合に便利な機能となります例えば表題にポップアップウィンドウを表示させるには次のようなスクリプトを使用します 8 行目の %post_url_popup%( 日本語版のみ ) がこれを表示させる % タグです <div style="margin:20px 0 10px 0"> <div style="font-size:12pt;font-weight:bold;color:#000;padding:0 0 10px 10px"> 登山日記 </div> <table border="1" cellpadding="2" cellspacing="0"> <tr align="center" bgcolor="#ccff66"><td width="300"><strong> タイトル </strong></td><td width="110"><strong> 掲載日 </strong></td><td width="180"><strong> 分類 </strong></td></tr> <?php c2c_get_recent_posts( $num_posts = '5', $format = "<tr><td>%post_url_popup%</td><td>%post_date%</td><td>%post_categories_url%</td>< /tr>", $categories = '6', $orderby= 'date', $date_format = 'Y 年 m 月 d 日 ', $include_passworded_posts = false );?> </table> </div> 表示結果をクリックし題名にマウスのポインターを当ててみてくださいその記事の抜粋が表示されるはずです ( 注 ) 日本語版 ver1.0.1 ではポップアップ抜粋表示の % 変換タグは既存の %post_url% を改良して使用していましたしかしオリジナルの %post_url% の利用価値を発見したので新たに %post_url_popup% の項を設けました詳しくはプラグイン customizable-post-listings の改良 (3) を参照してください表示結果 13

14 I. カテゴリー / サブカテゴリーの表題を独自に取り出す %post_categories% あるいは %post_categories_url% 変換タグを使用すればその記事が属しているカテゴリサブカテゴリを全て表示してくれますしかしカテゴリーあるいはサブカテゴリーの題名を独自に取り出して使いたい場合があります例えば本サイトのプルダウン式記事検索システムの submenu の欄に使用されているサブカテゴリー名です確かに直接カテゴリー名を記入すれば済むことなのですが何かの都合でカテゴリー名を変えた場合にはその変更が反映されませんこのためにカテゴリー名を取得する機能を付け加えましたこの改良点についてはプラグイン customizable-post-listings の改良 (3) を参照してくださいここではその使用法について説明いたします <サブカテゴリ名を取得 > <?php c2c_get_recent_posts('1',"%post_subcategories%", '37');?> <サブカテゴリ名をリンク付きで取得 > <?php c2c_get_recent_posts('1',"%post_subcategories_url%", '37');?> < 親カテゴリーを取得 > <?php c2c_get_recent_posts('1',"%post_pacategories%", '30');?> < 親カテゴリーをリンク付きで取得 > <?php c2c_get_recent_posts('1',"%post_pacategories_url%", '30');?> 2 行目 : サブカテゴリーの題名だけを取得するプログラムです 5 行目 : サブカテゴリ名をリンク付きで取得 8 行目 : 親カテゴリーの題名だけを取得 11 行目 : 親カテゴリーをリンク付きで取得表示例使用方法の実用例についてはプルダウン式記事検索システムのサブメニュー登山日記のページ ( 当サイトの上部 Page タイトルをクリック) を参照してください 14

1 フリーページを表示する 1-1 フリーページのカテゴリを作成しますフリーページのカテゴリの情報を入力します 1 複数のフリーページを記事のジャンルや種類で分けその見出しを入力しますお店ページの左サイドバーに表示します 2 消費者が検索エンジンで検索するであろう記事の特長や内容をあらわす

1 フリーページを表示する 1-1 フリーページのカテゴリを作成しますフリーページのカテゴリの情報を入力します 1 複数のフリーページを記事のジャンルや種類で分けその見出しを入力しますお店ページの左サイドバーに表示します 2 消費者が検索エンジンで検索するであろう記事の特長や内容をあらわすフリーページを作成表示する方法 < 目次 > 1 フリーページを表示する 2 1-1 フリーページのカテゴリを作成します 1-2 フリーページの記事を作成します 2 フリーページの記事を編集する 6 3 コメントトラックバックを管理する 7 3-1 コメントの掲載状態を変更します 3-2 トラックバックの掲載状態を変更します 4 フリーページのカテゴリの表示設定とレイアウトを調整する 9 このページは