サイト設定およびテンプレートの改造について

  携帯サイトの見た目を変更する方法を説明します。管理画面での設定による方法と、携
帯表示用テンプレートの改造による方法があります。

●管理画面の「携帯表示」設定●

○携帯電話用テーマ

  使用するテーマを選択します。初期状態では以下の4つのテーマがあります。
  ・default (Ktai Style のデフォルトテーマ)
  ・compact (フロントページ・検索結果で、タイトル一覧のみ表示)
  ・classic (まおう氏の Mobile Eye+ *1 に似たテーマ)
  ・redportal (Livedoor Blog に類似させたテーマ)

  (*1) http://hrlk.com/script/mobile-eye-plus/

  携帯電話キャリアごとにテーマを変更できますが、通常は「共通テーマと同じ」のまま
で構いません。

○動作

携帯サイトの見栄えを変更できます。Ktai Style の標準テーマ (default, compact) 以
外では設定が反映されない場合があります。

・コメントとトラックバック
    デフォルトでは、各記事および最新コメント一覧において、コメントとトラックバッ
    ク・ピンバックを混在して表示しますが、二者を分離できます (トラックバックとピ
    ンバックは分離しません)。
    なお、各記事についている「コメントn件」の件数については、コメントとトラック
    バックを合わせた数です (分離はできません)。
・直接リンクを張るサイト
    このフィールドに記入された URL へのリンクは、フルブラウザや中継ページ経由の
    リンクにせず普通にリンク (直接リンク) します。携帯電話対応サイトの URL を記
    入すると便利です。
・コメント投稿者の端末識別情報
    「送信が必須」を選ぶと、ドコモ、au、ソフトバンク端末からのコメント投稿時に、
    端末識別情報 (端末製造番号、UIM ID、サブスクライバ ID 等) を送信しないと受け
    付けられなくなります。送信された端末 ID は、ユーザーエージェントの後に付与し
    てデータベースに保存されます。WordPress の管理画面では通常見られませんが、
    phpMyAdmin 等で wp_comments テーブルの comment_agent カラムを見れば確認でき
    ます。
        Term ID: 端末情報 (電話機製造番号 など)
        Sub ID : 契約者情報 (UIM ID、EZ番号 など)
    
    なお、ウィルコム端末、その他端末 (スマートフォン、PSP 等) では、「送信が必須」
    にしても端末 ID なしでコメント可能です。
    *** 注意 *** 「送信を必須」にしても、フルブラウザ・PC サイトブラウザ等に切り
    換えれば回避できます。通常は「必須ではない」を選択することをおすすめします。

※バージョン 0.97 以降、外部サイトへのリンクは原則として残すことにしました。もし、
一律に削除したい場合は、ktai_style.php の冒頭にある
    // define ('KS_DELETE_EXTERNAL_LINKS', TRUE);
のコメント記号 (//) を外してください。

○文字色

  要所要所の文字色を変更できます。設定値は #rrggbb の16進表記で記述します。HTML 
では一般的な書式です。値を入力すると、リアルタイムに色見本が変更され、色の確認が
しやすくなっています。
  なお、Ktai Style の標準テーマ以外では設定が反映されない場合があります。

・記事タイトル一覧の横に表示する日付
・記事本文に表示する投稿者・日付
・コメント種別 (コメント／トラックバック／ピンバック)
・外部サイトへのリンク文字列

※背景色・通常の文字色・リンク色・訪問済みリンク色は、設定画面ではなく、テンプレ
ートの改造 (themes/*/header.php の <body> 要素の bgcolor, text, link, vlink 属性
を修正) で対応してください。

○投稿・コメントの日付書式

  投稿やコメントの日付書式を変更できます。WordPress 一般設定の日付書式は、原則と
して使っていません (記事タイトルの上に表示する日付は一般設定を適用)。
  これは、「今年の日付は年を省略して表示する」「今日の日付は時刻のみ表示する」と
いう短縮処理を行うためです。したがって、それぞれの状況に応じて書式を設定する必要
があります。
  フォーマットに使う文字列は WordPress の設定画面と同じ (PHP の date() 関数と同
じ) です。Ktai Style のデフォルトテーマ以外では設定が反映されない場合があります。

・年月日を表示する場合 (去年以前の日付)
    デフォルトでは Y-m-d という ISO フォーマットです。スラッシュ区切りや日本語表
    記に変更して構いません。なお、年・月・日を示す文字それぞれが含まれる必要があ
    ります。
    - OK な例: Y/m/d , Y年n月j日, M jS, Y
    - ダメな例: n/j, Y年n月
・月日のみ表示の場合 (今年の日付)
    デフォルトではスラッシュ区切リの n/j という書式です。年省略では ISO フォーマ
    ットは不自然なためです。月・日を示す文字列それぞれが含まれる必要があります。
・時刻
    時刻フォーマットはいずれの場合で使われます。デフォルトは秒を省略した H:i です。

●テンプレートの改造●

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

  プラグインによっては、携帯電話表示のとき動作しないものがあります。この場合、
header.php で wp_head() を有効にしたり、footer.php で wp_footer() を有効にすると
動作するようになる場合があります (デフォルトではこれらのテンプレートタグはコメン
トアウト)。

  独自のテーマを作るときは、既存テーマのフォルダーを複製して好きな名前を付け、そ
の複製に対して作業することをおすすめします。default テーマを直接改造することは避
けてください。

○WordPress 準拠テンプレート○
・header.php
    ページヘッダの表示用。add_action('wp_head'); を利用しているプラグインの場合、
    このテンプレートの wp_head() 前後のコメントマークを削除すると動作するように
    なります。
・footer.php
    ページフッタの表示用。add_action('wp_footer'); を利用しているプラグインの場
    合、このテンプレートの wp_footer() 前後のコメントマークを削除すると動作する
    ようになります。
・index.php
    フロントページ・検索ページなど表示用で、必須のテンプレートです。default テー
    マでは、1番目の記事だけ本文を表示し、2番目以後はタイトル表示というスタイル、
    compact, classic, redportal テーマではすべてタイトル表示です。
・archive.php
    アーカイブページ (年日付別／カテゴリー別／投稿者別など) 表示用。記事タイトル
    だけ表示します。このテンプレートがないときは index.php で代用します。
・page.php
    固定ページ表示用。このテンプレートがないときは index.php で代用します。
・single.php
    投稿の単独表示用。このテンプレートがないときは index.php で代用しますが、デ
    フォルトの index.php ではコメント一覧やコメント投稿フォームが出ないため、実
    質的に必須のテンプレートです。
・comments.php
    コメント一覧／コメント投稿フォーム表示用。必須のテンプレートです。single.php 
    から comments_template() タグで呼び出されます。
・functions.php 
    テーマ用の独自関数定義ファイル。附属テーマでは classic テーマのみ存在してい
    おり、全角カタカナ→半角カナ変換を行うフィルターを定義しています。

※WordPress 本体と違って、style.css は不要です。

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

○本プラグイン独自テンプレート○

  以下は本プラグイン独自のテンプレートです。ウェブログ直下のURL に「?menu=XXXX」
というクエリー文字列を付けると呼び出されます。
    例: http://blog.example.jp/?menu=months
※バージョン 0.90 からファイル名およびクエリー文字列を変更しています。

  テーマフォルダーに以下のファイルが存在しない場合、自動的に default テーマのテ
ンプレートが使われます。このため、default テーマ以外では menu_***.php を作成する
必要はありません。

・menu_months.php
    年月アーカイブの一覧表示用。?menu=months で呼び出し。
・menu_cats.php
    カテゴリー一覧表示用。?menu=cats で呼び出し。
・menu_tags.php
    タグ一覧表示用。?menu=tags で呼び出し。
・menu_pages.php
    ページ一覧表示用。?menu=pages で呼び出し。defalt, compact テーマでは使用して
    いません。
・menu_links.php
    ブログロール (ブックマーク) 一覧表示用。?menu=links で呼び出し。デフォルトで
    はこのテンプレートは使用していません。footer.php などに、
      <a href="<?php ks_blogurl(); ?>?menu=links">リンク</a> 
    のように記載すれば使用できます。
・menu_comments.php
    最近のコメント表示用。?menu=comments で呼び出し。デフォルトでは、コメントと
    トラックバック・ピンバックを混在して表示しますが、設定で分離表示が可能です。

○絵文字の使い方○

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

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

  投稿本文に使った場合、PC では何も表示されません。携帯電話専用ウェブログにする
以外では、投稿本文で使わないのが無難です。

○テンプレートで画像を使う○

  原則として、すべての画像はリンクに変換するか alt 文字列を表示しますが、携帯電
話でも画像をそのまま表示させたい場合は、その img 要素に 
    class="ktai"
  という属性を追加してください。すでに class 属性があるなら、既存の class の後ろ
  に空白を入れて ktai と書けばよいです。
    例: <img src="/qr.png" class="noframe ktai" />

  なお、画像のサイズが大きくてページの全体サイズが携帯端末の表示容量を越える場合
は、画像を alt テキストの内容に置換して容量制限に収まるようにしています。複数の
画像がある場合は、後ろの画像から順にテキスト化されます (前の画像を極力残しま
す)。
  ただし、画像サイズのチェックはウェブログ内の画像 (uploads フォルダー配下、プラ
グイン用画像、テーマ用画像など) に限られ、外部サイトの画像は対象外です。外部サイ
トの画像に class="ktai" を付けて表示させた場合、携帯端末の容量制限を越えてしまう
可能性があります。

○PNG, GIF 自動切り替え機能○

  JPEG 画像は、ほぼすべての端末で表示できますが、PNG 画像は i-mode (ドコモ) で表
示できず、GIF 画像は Softbank の PDC 端末で表示できません。Ktai Style では、端末
に応じてどちらか適切なフォーマットの画像を表示させることができます。
  PNG や GIF 画像を使いたい場合は、同じファイル名で PNG フォーマット、GIF フォー
マットの画像をそれぞれ用意してください。そして、img 要素の src 属性では、PNG 画
像か GIF 画像どちらかを呼び出してください。PNG 画像の呼び出しは i-mode において 
GIF 画像に、GIF 画像の呼び出しは SoftBank PDC において PNG 画像に変更されます。

    例: <img src="<?php ks_theme_url(); ?>title.png" class="ktai" />
        → i-mode では title.gif を読み込む
    例: <img src="<?php ks_theme_url(); ?>map.gif" class="ktai" />
        → SoftBank では map.png を読み込む

※画像自体を変換するわけではありませんので、あらかじめ title.png, title.gif や 
  map.gif, map.png それぞれを作っておく必要があります。
※img 要素に class="ktai" をつけない場合、画像をリンクにする機能が優先され、PNG, 
  GIF 切り替え機能は働きません。

●フィルター対象タグ一覧●

  WordPress が提供するテンプレートタグのうち、以下のものは本プラグインが出力をフ
ィルタして携帯電話向けにします。

・the_title()
    パスワード保護された投稿の場合、「保護された投稿: 」または「保護中:」の文字
    列を「マル秘」絵文字に差し替えます。
・the_content()
    ウェブログの内容を携帯電話向けに変換して出力します。ただし、携帯電話用テンプ
    レートでは、後述の ks_content() を使ってください (the_content() はパスワード
    保護された投稿に非対応のため)。
・comments_template()
    PC 向けサイトのコメントテンプレートの代わりに、本プラグインのコメントテンプ
    レートファイルを読み込みます。
・comment_text()
    コメント内容を携帯電話向けに簡略化して出力します。
・get_permalink()
・get_page_link()
・get_attachment_link()
・get_year_link()
・get_month_link()
・get_day_link()
・get_category_link()
・get_tag_link()
・wp_list_categories()
・wp_list_pages()
    すべて title 属性, rel 属性を除去し、href 属性のリンク先からホスト名を削除し
    ます。

●独自フィルターフック一覧●

  Ktai Style 独自のフィルターフックを用意しています。以下のようにしてこのフック
を利用できます。
    add_filter('raw_content/ktai_style.php', '関数名');

・raw_content/ktai_style.php
    引数: $buffer
    テンプレートによって作成された直後のページ内容をフィルターできます。文字コー
    ドはウェブログの文字コードのままです (たいていは UTF-8)。
・encoding_converted/ktai_style.php
    引数: $buffer
    文字コードを携帯電話用に変換後、ページ分割前の内容をフィルターできます。絵文
    字や顔文字の変換、余分な XHTML タグや改行コードの削除はこのフィルターで実施
    しています。優先順位 10 でフィルター追加した場合、これらの処理が終わった後の
    内容をフィルターすることになります。
・split_page/ktai_style.php
    引数: $buffer, $page_num
    ページ分割後のページ全体をフィルターできます。携帯電話各社に応じた HTML/XHTML 
    タグ最適化はここで行なってください。ページ分割前に li, dt, dd, option などの
    閉じタグ削除を行なっても、ページ分割処理で補完されてしまうためです。

  上記フックでは既定のフィルターを定義していますが、以下の通りにして削除すること
も可能です。
	remove_filter('encoding_converted/ktai_style.php', array($Ktai_Style->ktai, 'shrink_pre_split'), 5);
	remove_filter('encoding_converted/ktai_style.php', array($Ktai_Style->ktai, 'replace_smiley'), 7);
	remove_filter('encoding_converted/ktai_style.php', array($Ktai_Style->ktai, 'convert_char'), 9);
	remove_filter('split_page/ktai_style.php', array($Ktai_Style->ktai, 'split_page'), 5);
	remove_filter('split_page/ktai_style.php', array($Ktai_Style->ktai, 'shrink_post_split'), 9);

●独自タグ一覧●
  出力される XHTML が簡略化されたテンプレートタグを用意しています。これらの関数
はテンプレートが読み込まれる直前に有効となるため、他のプラグインから使えません。

・ks_is_front()
    サイトの最初のページかどうかを判断します。is_home() かつ1ページ目であれば 
    TRUE となります。
・ks_is_comments_list()
    コメント一覧ページであれば TRUE になります。
・ks_is_comment_post()
    コメント投稿ページであれば TRUE になります。
・ks_is_comments()
    コメント一覧ページまたはコメント投稿ページであれば TRUE になります。
・ks_option($name)
    本プラグインのオプション設定値を返します。
    $name: オプション名
・ks_header()
    ヘッダーを出力します (get_header() は使えません)。
・ks_footer()
    ヘッダーを出力します (get_footer() は使えません)。
・ks_blogurl($echo)
    ウェブログの URL を出力します。ホスト名を省略した絶対パスに変換し、末尾にス
    ラッシュが付きます。
   $echo: TRUE の場合、画面に出力します。FALSE の場合、関数の返り値とします。
・ks_siteurl($echo)
    WordPress がインストールされている URL を出力します。ホスト名を省略した絶対
    パスに変換し、末尾にスラッシュが付きます。
    $echo: TRUE の場合、画面に出力します。FALSE の場合、関数の返り値とします。
・ks_plugin_url($echo)
    プラグインのあるディレクトリーにアクセスできる URL を出力します。末尾にスラ
    ッシュが付きます。
    $echo: TRUE の場合、画面に出力します。FALSE の場合、関数の返り値とします。
・ks_theme_url($echo)
    携帯電話用テーマのディレクトリーにアクセスできる URL を出力します。末尾にス
    ラッシュが付きます。
    $echo: TRUE の場合、画面に出力します。FALSE の場合、関数の返り値とします。
・ks_admin_url($echo)
    管理画面にログインしたときの最上位 URL を出力します。末尾にスラッシュが付き
    ます。
    $echo: TRUE の場合、画面に出力します。FALSE の場合、関数の返り値とします。
・ks_login_link($before, $after, $echo)
    ktai_style/admin ディレクトリーがあれば、ログイン画面へのリンクを出力します。
    $before: リンクの前に出力する文字列
    $after: リンクの後ろに出力する文字列
    $echo: TRUE の場合、画面に出力します。FALSE の場合、関数の返り値とします。
・ks_get_logout_url()
    ログアウト用の URL を返します。
・ks_is_loggedin()
    携帯電話でログインしているかどうかを返します。
・ks_session_id_form()
    コメントフォームなどで、ログイン中のセッション ID を引き継ぐための HTML を出
    力します。
・ks_get_wp_version()
    WordPress のバージョンを返します。WordPress ME の場合、「ME」という文字列
    を除いた数字部分となります。
・ks_term_name()
    携帯電話の機種名を表示します。不明時は N/A という文字列になります。au の場合、
    デバイス ID ではなく、一般的な機種名に変換します。
・ks_use_appl_xhtml()
    DoCoMo FOMA および SoftBank 3G のとき、MIME タイプを application/xhtml+xml 
    に変更します。header.php で使わないと有効ではありません。
・ks_force_text_html()
    MIME タイプを text/html に強制します。header.php で使わないと有効ではありま
    せん。
・ks_mimetype()
    携帯電話サイトの MIME タイプを出力します。
・ks_charset()
    携帯電話サイトの文字コードを出力します。
・ks_fix_encoding_form()
     入力フォームにおいて、文字化け防止のための文字コード判別用隠しフィールドを
     追加します。
・ks_detect_encoding()
     文字コード判別用隠しフィールドをもとに、文字コードを判別します。入力フォー
     ムの処理部分で使います。
・ks_mb_get_form($key, $charset)
    フォームの値をウェブログ文字コード (ほとんどの場合 UTF-8) に変換して返します。
    フォームには、ks_fix_encoding_form() で文字コード判別用隠しフィールドを埋め
    込んでおいてください。
・ks_is_required_term_id()
    端末 ID を要求している状態ならば TRUE になります。具体的には、管理画面で「コ
    メント投稿者の端末 ID 送信を必須とする」を「はい」にしていて、かつ、閲覧者が
    ドコモ／au／ソフトバンク端末の場合を示します。
・ks_require_term_id_form($action, $method)
     端末 ID を要求するフォームを作ります。
     $action: フォームの送信先
     $method: post, get のいずれか
・ks_title()
    ページのタイトルを出力します。ブラウザーウィンドウのタイトルに使われます。
    wp_title() よりも短い表示になります。投稿タイトルの出力は the_title() を使っ
    てください。
・ks_content()
    ウェブログの内容を携帯電話向けに変換して出力します。不要な XHTML 要素・属性
    を削除／外部へのリンクを削除／インライン画像をリンクに変換／拙作の Ktai 
    Location が挿入した位置情報 URL を削除など。
・ks_check_password($message)
    パスワード保護された投稿かどうか確認します。保護されていないか、正しいパスワ
    ードが入力されれば、NULL を返します。保護されていて、かつ、パスワードが正し
    くなければパスワード入力フォームを返します。
    $message: 入力フォームの上に出すメッセージ
・ks_time($year, $month_date, $time)
    現在日時に応じて適切に短縮した投稿日時を出力します。投稿日と現在が同じ年なら
    ば年を省略、同じ年月日ならば年月日を省略します。日だけの表示はおかしいので、
    年月だけが同じのときは、年だけの省略となります。フォーマットに使う文字列は 
    PHP の date() 関数と同じです。引数を省略すると、プラグイン設定画面に入力した
    フォーマットとなります。
    $year: 年月日を表示する場合のフォーマット (去年以前の日付)
    $month_date: 月日を表示する場合のフォーマット (今年の日付)
    $time: 時刻のフォーマット
・ks_mod_time($year, $month_date, $time)
    現在日時に応じて適切に短縮した修正日時を出力します。投稿日と現在が同じ年なら
    ば年を省略、同じ年月日ならば年月日を省略します。日だけの表示はおかしいので、
    年月だけが同じのときは、年だけの省略となります。フォーマットに使う文字列は 
    PHP の date() 関数と同じです。引数を省略すると、プラグイン設定画面に入力した
    フォーマットとなります。
    $year: 年月日を表示する場合のフォーマット (去年以前の日付)
    $month_date: 月日を表示する場合のフォーマット (今年の日付)
    $time: 時刻のフォーマット
・ks_comment_datetime($year, $month_date, $time)
    現在日時に応じて適切に短縮したコメント日時を出力します。コメント日と現在が同
    じ年ならば年を省略、同じ年月日ならば年月日を省略します。日だけの表示はおかし
    いので、年月だけが同じのときは、年だけの省略となります。フォーマットに使う文
    字列は PHP の date() 関数と同じです。引数を省略すると、プラグイン設定画面に
    入力したフォーマットとなります。
    $year: 年月日を表示する場合のフォーマット (去年以前の日付)
    $month_date: 月日を表示する場合のフォーマット (今年の日付)
    $time: 時刻のフォーマット
・ks_ordered_link($count, $max, $link, $desc)
    携帯電話の絵文字を使った数字付きリストの出力を行います。使い方は 
    themes/default/index.php を参照してください。
    $count: 出力したい数字。accesskey 用の番号にもなります。
    $max: 絵文字を使う最大値。これより $count が大きければ、絵文字の代わりに □ 
          (四角) になります。
    $link: リンク先URL
    $desc: リンク文字列。この引数を省略すると、閉じタグ (</a>) は出力しません。
・ks_link_pages($args)
    wp_link_pages() の代わりとなる、分割ページ用ナビゲートタグです。パスワード保
    護された投稿で認証ずみの場合は、アンカーリンクではなく、隠しフィールドにパス
    ワードを埋め込んだフォームボタンが表示されます。このため、パスワードの再入力
    なしにページ遷移が可能です。
    $args: 各種パラメーター (wp_link_pages() と同じ仕様)
・ks_pagenum($before, $after)
    指定したコンテンツが複数ページに分かれている場合、現在のページ番号を出力しま
    す。1ページのみの場合は何も出力されません。例えば、2007年9月の記事が2ページ
    に渡る場合、1/2, 2/2 などと表示されます。
・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, $before, $after)
    前後のページへのナビゲーションリンクを出力します。accesskey 対応です (* で前
    ページ、# で次ページ。
    $sep: 間に挟まれる分離文字列。
    $before: リンクの前に付ける HTML タグ
    $after: リンクの後ろに付ける HTML タグ
・ks_posts_nav_multi($num, $first, $last)
    複数の前後ページおよび先頭・末尾ページへのナビゲーションリンクを出力します。
    accesskey の表示は出ませんが前後ページへ移動に対応しています。
    $num: 前後何ページリンクするかの数
    $first: 「先頭」を示す文字列
    $last: 「末尾」を示す文字列
・ks_posts_nav_dropdown()
    ポップアップ (ドロップダウン) 式のページナビゲーションを出力します。ページ数
    が多くて吐き出す XHTML のサイズが携帯電話の制限を越える場合は、出力が抑制さ
    れます。index.php では出力されない場合が多いため使用しないでください。附属テ
    ンプレートでは archive.php にのみ使用しています。
・ks_get_comments_list_link($post_id)
    コメント一覧ページを示す URL を返します。
    $post_id: 対象とする投稿 ID。投稿ループの中では空でよい。
・ks_comments_link($icon, $zero, $one, $more, $none, $sec)
    コメント数を表示し、コメント一覧へのリンクとして出力します。
    $icon: コメント受付を示す絵文字。リンクの前に置かれます。
    $zero: コメントなしを示す文字列
    $one : コメント1件を示す文字列
    $more: コメント2件以上を示す文字列。「%」があればコメント数に置換されます。
    $none: コメント停止中を示す文字列
    $sec : パスワード保護している投稿の場合の文字列
・ks_comment_post_link($desc, $before, $after)
    コメント投稿フォームへのリンクを出力します。
    $desc: リンク先の説明
    $before: リンクの前に置く文字列 (絵文字等)
    $after: リンクの後に置く文字列
・ks_back_to_post($icon, $desc)
    記事に戻るリンクを出力します。
    $icon: リンクの前に置く絵文字
    $desc: リンク先の説明
・ks_get_recent_comments($num, $type)
    最新コメント一覧を配列で返します。
    $num: コメント表示数
    $type: コメントの種類を示す文字列
    - (なし): コメント・トラックバック・ピンバックを混在
    - comment: コメントのみ
    - trackback: トラックバックのみ
    - pingback: ピンバックのみ
    - trackback+pingback: トラックバック・ピンバックを混在 
・ks_category($separator)
    表示している投稿が属するカテゴリーの一覧を出力します。
    $separator: カテゴリーごとの区切り文字列
・ks_tags($before, $after, $separator)
    表示している投稿に付与されているタグ一覧を出力します。タグが付いてないときは
    何も出力しません。
    $before: 一覧の前に置く文字列 (絵文字等)
    $after: 一覧の後に置く文字列
    $separator: タグごとの区切り文字列
・ks_tag_cloud($args)
    タグクラウドを出力します。wp_tag_cloud() と同じ動作をしますが、余計な空白や 
    title 属性、rel 属性などを除去しています。
・ks_get_archives($args)
    アーカイブ一覧を出力します。wp_get_archives() の結果から、余計な空白や title 
    属性を除去して出力します。
    $arg: wp_get_archives() と同じ仕様のパラメーター
・ks_list_bookmarks($args)
    ブログロール一覧を出力します。wp_list_bookmarks() の結果から、余計な空白や 
    title, rel 属性を除去して出力します。
    $arg: wp_list_bookmarks() と同じ仕様のパラメーター
・ks_pages_menu($sep, $before, $after)
    固定ページへのナビゲーションを出力します。
    $sep: 項目ごとの区切り
    $before: 前に付ける HTML タグ
    $after: 後ろに付ける HTML タグ
・ks_switch_pc_view($before, $after)
    「その他」端末の場合、PC 表示に切り替えるかリンクを出力します。
    $before: リンクの前に置く文字列
    $after: リンクの後に置く文字列

○ページ分割機能用タグ
  <!--start paging-->
  <!--end paging-->
    ページ分割機能において、分割対象領域を示します。この2つに挟まれた区間が分割
    され、前者より上／後者より下にある XHTML コードはすべてのページに出力されま
    す (共通領域)。前者が存在しないときは <body> タグ、後者が存在しないときは
   「<hr /><a name="tail"」という文字列もしくは </body> タグを代わりに使います。
    なお、共通領域が広くて分割に使えるバイト数があまりに少ないとき (256 バイト未
    満) は、強制的に <body>?ページ終端を分割対象とします。

●他のプラグインとの連携●

  他のプラグインにおいて、PC 向け出力か携帯電話出力かを区別できるよう、以下の関
数を用意しています。

・is_ktai()
    携帯電話出力なら、事業者名を返します。PC 出力ならば FALSE を返します。
    (事業者名は DoCoMo, KDDI, SoftBank, WILLCOM, Unknown のいずれか)

  本プラグインが有効・無効にかかわらずエラーが出ないよう、次のようにして使ってく
ださい。

if (function_exists('is_ktai') && is_ktai())) { ?>
<img localsrc="334" alt="[new] " />
<?php }

  次は、携帯電話 *でない* 場合にスタイルシートを追加する例です。この判別方法は、
Mobile Eye+ を使っている場合や、WPhone Admin Plugin (*2) をインストールしている
場合にも対応します。
(*2) http://wphoneplugin.org/

if ((! function_exists('is_mobile') || ! is_mobile()) 
 && (! function_exists('is_ktai')   || ! is_ktai())) { ?>
<style type="text/css" media="all">
.locationurl { display:none; }
</style>
<?php }

  以前は、原則として is_mobile() 関数を提供し、WPhone Admin Plugin が存在すると
きのみ、名前の衝突を避けるため is_ktai() に名前を変えていました。

  しかし、WPhone プラグインの提供する is_mobile() 関数は SoftBank PDC 端末を検出
しないことが判明したため、is_mobile() だけで携帯電話かどうかの判定を行うことがで
きず、is_ktai() 関数も併用する必要が出てしまいました (具体的なコードは上記の通り)。
  そうなると、Mobile Eye+ との互換性を取るために、Mobile Eye+ でも使っている関数
名である is_mobile() という名前にする、という措置も無意味となってしまいました。
このため、バージョン 0.98 より is_ktai() 関数に一本化することとしました。

# WPhone Admin Plugin の作りが悪い、とも言えますね ;-)

以上