テンプレートの改造について

  本プラグインのテンプレートは、WordPress のテーマとほぼ同じ
構造です。このため、WordPress のテーマを制作・改造したことが
あれば、同じ要領で改造することができます。
  なお、プラグインのソースコードおよびテンプレートは原則とし
て UTF-8 で記述されています。このため、WordPress の管理画面
で編集が可能です。ただし、services.php だけ Shift_JIS で書か
れています。WordPress の管理画面で編集すると壊れますので、ご
注意ください。

●附属テンプレートファイル一覧●
・header.php
    ページヘッダの表示用
・footer.php
    ページフッタの表示用
・index.php
    フロントページやその他のページ表示用。1番目の記事だけ本
    文を表示し、2番目以後はタイトル表示というスタイルです。
・xx_home.php
    フロントページ (トップページ) 表示用。投稿のタイトルおよ
    び日時の一覧だけが表示されるシンプルなスタイルです。ただ
    し、そのままでは、このテンプレートは使用されません。使い
    たい場合は、ファイル名を変更して「home.php」としてくださ
    い。自動的に index.php の代わりに使われます。
・archive.php
    アーカイブページ (年日付別／カテゴリー別／投稿者別など) 
    表示用。記事タイトルだけ表示します。
・page.php
    固定ページ表示用
・single.php
    投稿の単独表示用
・comments.php
    コメント一覧／コメント投稿フォーム表示用。

  以上は WordPress のテーマ仕様に従って呼び出されます。もし、
category-10.php というテンプレートを追加すれば、カテゴリー 
ID = 10 のアーカイブにはこのテンプレートが利用されます。

  以後は本プラグイン独自のテンプレートです。

・arc_months.php
  年月アーカイブの一覧表示用
・arc_cats.php
  カテゴリー一覧表示用

●フィルタ対象タグ一覧●
  WordPress が提供するテンプレートタグのうち、以下のものは
本プラグインが出力をフィルタして表示を簡略化しています。

・wp_list_categories()
    title 属性を除去し、href 属性のリンク先からホスト名を削
    除します。
・comments_template()
    PC 向けサイトのコメントテンプレートの代わりに、本プラグ
    インのコメントテンプレートファイルを読み込みます。
・comment_text()
    コメント内容を携帯電話向けに変換して出力します。外部への
    リンクを削除など。

●独自タグ一覧●
  出力される XHTML が簡略化されたテンプレートタグを用意して
います。

・ks_header()
    ヘッダーを出力します (get_header() は使えません)。
・ks_footer()
    ヘッダーを出力します (get_footer() は使えません)。
・ks_is_front()
    サイトの最初のページかどうかを判断します。is_home() かつ
    1ページ目であれば TRUE となります。
・ks_is_comments_list()
    コメント一覧ページであれば TRUE になります。
・ks_is_comment_post()
    コメント投稿ページであれば TRUE になります。
・ks_is_comments()
    コメント一覧ページまたはコメント投稿ページであれば TRUE 
    になります。
・ks_blogurl()
    ウェブログの URL を出力します。ホスト名を省略した絶対パ
    スに変換しています。
・ks_siteurl()
    WordPress がインストールされている URL を出力します。ホ
    スト名を省略した絶対パスに変換しています。
・ks_plugin_dir()
    プラグインのあるディレクトリにアクセスできる URL を出力
    します。
・ks_title()
    ページのタイトルを出力します。ブラウザーウィンドウのタイ
    トルに使われます。wp_title() よりも短い表示になります。
・ks_content()
    ウェブログの内容を携帯電話向けに変換して出力します。外部
    へのリンクを削除／インライン画像をリンクに変換／拙作の 
    Ktai Location が挿入した位置情報 URL を削除など。
・ks_check_password($message)
    パスワード保護された投稿かどうか確認します。保護されてい
    ないか、正しいパスワードが入力されれば、NULL を返します。
    保護されていて、かつ、パスワードが正しくなければパスワー
    ド入力フォームを返します。
    $message: 入力フォームの上に出すメッセージ
・ks_orderd_link($count, $max , $link) 
    携帯電話の絵文字を使った数字付きリストの出力を行います。
    使い方は index.php を参照してください。
    $count: 出力したい数字。accesskey 用の番号にもなります。
    $max: 絵文字を使う最大値。これより $count が大きければ、
          絵文字の代わりに □ (四角) になります。
    $link: リンク文字列。
・ks_pagenum($before, $after)
    指定したコンテンツが複数ページに分かれている場合、現在の
    ページ番号を出力します。1ページのみの場合は何も出力され
    ません。例えば、2007年9月の記事が2ページに渡る場合、1/2, 
    2/2 などと表示されます。accesskey 対応です。
・ks_previous_post_link($format, $link, $in_same_cat, $excluded_categories)
    前の投稿へのナビゲーションリンクを出力します。引数は
    previous_post_link() と同じ仕様です。accesskey 対応です。
・ks_next_post_link($format, $link, $in_same_cat, $excluded_categories)
    次の投稿へのナビゲーションリンクを出力します。引数は
    next_post_link() と同じ仕様です。accesskey 対応です。
・ks_posts_nav_link($sep)
    前後のページへのナビゲーションリンクを出力します。access-
    key 対応です。
    $sep: 間に挟まれる分離文字列。
・ks_comments_link($icon, $zero, $one, $more)
    コメント数を表示し、コメント一覧へのリンクとして出力しま
    す。
    $icon: リンクの前に置く絵文字
    $zero: コメントなしを示す文字列
    $one: コメント1件を示す文字列
    $more: コメント2件以上を示す文字列。「%」はコメント数に
           置き換えられます。
・ks_comment_post_link($before, $link, $after)
    コメント投稿フォームへのリンクを出力します。
    $before: リンクの前に置く文字列 (絵文字等)
    $link: リンク文字列
    $before: リンクの後に置く文字列
・ks_category($separator)
    表示している投稿が属するカテゴリーの一覧を出力します。
・ks_get_archives($args)
    アーカイブ一覧を出力します。wp_get_archives() の結果から、
    余計な空白や title 属性を除去して出力します。
・ks_pages_menu($sep, $before, $after)
    固定ページへのナビゲーションを出力します。
    $sep: 項目ごとの区切り
    $before: 前に付ける HTML タグ
    $after: 後ろに付ける HTML タグ

●絵文字の使い方●

  テンプレートや投稿本文で以下の XHTML タグを使えば絵文字を
挿入できます。EZweb の絵文字と同じ仕様です。
    <img localsrc="nnn" alt="xxxx" />
  nnn は絵文字番号、xxx は絵文字の代替文字です (PDA など絵文
字非搭載の端末向け) 。絵文字番号は KDDI のウェブサイトを参照
してください。
    http://www.au.kddi.com/ezfactory/tec/spec/3.html

  ドコモ端末、ソフトバンク端末に対しては、似たような絵文字に
自動的に変換されます。変換テーブルは独自のもので、十分には揃
っていません。変換テーブルにない絵文字は 〓 (ゲタ) になりま
す。具体的な変換内容についてはソースコード (services.php) を
参照してください。

以上