plugins:mobilewithsinglepage

差分

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

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

plugins:mobilewithsinglepage [2011/03/23 21:28]
plugins:mobilewithsinglepage [2011/03/23 21:28] (現在)
ライン 1: ライン 1:
 +:!: **このプラグインには不具合が潜在している可能性があります** :!:
  
 +====== NP_MobileWithSinglePage.php ======
 +
 +===== ver.2.xx 系列 =====
 +
 +携帯電話での閲覧用にスキンを修整し、文字エンコードをShift-JISに変換して出力するプラグインです。
 +
 +^General Plugin info ^^
 +^作者 | [[plugins:​authors:​nkjg|NKJG]] |
 +^最新のバージョン | 2.1.0 beta |
 +^入手先 | [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1787|フォーラムの記事よりダウンロード]] |
 +^ソース | [[plugins:​mobilewithsinglepage:​mobilewithsinglepage_code2|NP_MobileWithSinglePage.phpのソースコード]]|
 +^ソース (bug fix & 機能追加)| [[plugins:​mobilewithsinglepage:​mobilewithsinglepage_code2fix|NP_MobileWithSinglePage.php ブログオプション追加版のソースコード]]|
 +^フォーラム参照先 |[[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1787|Read]]|
 +
 +==== インストール方法 ====
 +  - Zipファイルを展開して、中のファイルをサーバーのプラグインディレクトリにアップロードする
 +  - 必要なPEARライブラリを用意し、アップロードする ([[#​PEARライブラリ|後述]])
 +  - 管理画面からプラグインをインストールする
 +  - オプションを設定する ([[#​オプション|後述]])
 +
 +=== ver.1.xx 系列からのアップデート ===
 +
 +ver.1.xx系列からアップデートする場合は、一度アンインストールしておく必要があります。
 +
 +=== PEARライブラリ ===
 +
 +このプラグインはPEAR::​Net_UserAgent_Mobileと、PEAR::​XML_HTMLSaxを使用します。
 +これらのファイルが存在しない場合は、PEARからダウンロードし、以下のような構成でアップロードする必要があります。
 +
 +  * プラグインディレクトリ (通常は"​plugins"​)
 +    * "​sharedlibs"​ディレクトリ
 +      * **"​PEAR.php"​**
 +      * **"​XML"​ディレクトリ**
 +        * **"​XML_HTMLSax.php"​**
 +        * **"​HTMLSax"​ディレクトリ (およびその中身)**
 +          * **...**
 +      * **"​Net"​ディレクトリ**
 +        * **"​UserAgent"​ディレクトリ**
 +          * **"​Mobile.php"​**
 +            * **"​Mobile"​ディレクトリ (およびその中身)**
 +
 +==== このプラグインの使い方 ====
 +  * インストールするだけで動作します。
 +
 +==== スキン/​テンプレートへの記述 ====
 +  * テンプレート変数 <​%MobileWithSinglePage(name)%>​\\ 「name」で指定したUserAgentの情報を表示
 +    * carrierLongName => キャリアの名称
 +    * carrierShortName => キャリアの短縮名
 +    * name => ブラウザ
 +    * version => ブラウザのバージョン
 +    * height => 画面サイズ縦
 +    * width => 画面サイズ横
 +    * color => カラー or モノクロ
 +    * depth => 色
 +
 +  * テンプレート変数 <​%if(MobileWithSinglePage,​key,​value)%>​\\ 「key」で指定したUserAgentの情報をvalueと比較
 +    * 例:<​%if(MobileWithSinglePage,​carrierLongName,​EZweb)%>​EzWeb用の記述<​%endif%>​
 +
 +
 +==== オプション ====
 +
 +  * **"​Skin for mobile"​**
 +    * 携帯電話用のページで使用されるスキンの名前を指定します。
 +    * 詳しい動作は後述します。
 +  * **"​Select IMG convert-type"​**
 +    * img要素(<​img src="​..."​ />​)をどのように変換するかについての設定です。
 +      * "to text"
 +        * テキストに変換します。
 +      * "to link"
 +        * 画像のURLに対するリンクに変換します。
 +        * リンク内の画像についてはリンクを張りません。
 +      * "no convert"​
 +        * 変換しません。画像のまま表示します。
 +  * **"​Remove quotation of attributes"​**
 +    * (X)HTMLの属性値を囲む引用符を削除するかどうかの設定です。
 +      * この設定をyesにした場合で、属性値が空でなく、また属性値が空白を含んでいない場合のみ引用符が削除されます。
 +  * **"​Convert Zenkaku to Hankaku"​**
 +    * "​yes"​にすると、全角カナを半角カナに変換します。
 +  * **"​HTML tags to be retained"​**
 +    * 変換時に削除**されない**HTMLタグの名前です。
 +    * "​**|**"​で区切って記述します。
 +  * **"​HTML attributes to be retained"​**
 +    * 変換時に削除**されない**HTML属性の名前です。
 +    * "​**|**"​で区切って記述します。
 +
 +==== 使用されるスキン ====
 +
 +携帯電話用ページで使用されるスキンについては、以下のように優先順位が決定されています。
 +
 +  - オプションで指定したスキンの名前/​キャリアを示す文字列
 +  - オプションで指定したスキンの名前
 +  - もともと使用される予定だったスキンの名前/​キャリアを示す文字列
 +  - もともと使用される予定だったスキンの名前/​mobile
 +
 +これらがこのプラグインが使用しようとするスキンの名前で、上に行くほど優先度が高くなります。
 +
 +たとえば、もともと"​default"​という名前のスキンで表示されるページを、DoCoMoの携帯電話で見る場合で、オプションで使用するスキンを"​keitai"​にした場合、
 +
 +  - "​keitai/​docomo"​というスキンを探す → 存在すればそれを使用
 +  - 以上全て見つからない場合は"​keitai"​というスキンを探す → 存在すればそれを使用
 +  - 以上全て見つからない場合は"​default/​docomo"​というスキンを探す → 存在すればそれを使用
 +  - 以上全て見つからない場合は"​default/​mobile"​というスキンを探す → 存在すればそれを使用
 +  - 以上全て見つからない場合はもともとの"​default"​を使用
 +
 +という手順で使用するスキンを決定します。
 +
 +スキンに関するオプションを空欄にした場合は、それらについての判断(リストの1,​ 2)は行われません。
 +
 +キャリアを示す文字列はPEAR::​Net_UserAgent_Mobileに依存します。ver.0.28.0現在では
 +
 +  * docomo
 +  * ezweb
 +  * airh
 +  * vodafone
 +
 +のいずれかです。\\ ​
 +注:ver1.39では「airh」ではなく「willcom」になっています
 +
 +==== その他 ====
 +=== srcipt要素について ===
 +
 +script要素はその中身を含めて問答無用で削除されます。
 +
 +==== Tipsと裏技 ====
 +
 +==== 希望事項 ====
 +
 +==== バグ ====
 +
 +==== 開発履歴 ====
 +  * ver.1.xx
 +    * Version 1.0 最初のリリース <​2006/​02/​17>​
 +    * Version 1.1 バグフィックス <​2006/​02/​20>​
 +      * コメントの除去ができていなかったバグの修正
 +    * Version 1.2 バグフィックス <​2006/​03/​15>​
 +      * 携帯用ページから投稿したコメントが文字化けする問題の修正
 +      * 管理画面を変換の対象外に
 +    * Version 1.3 バグフィックス <​2006/​03/​23>​
 +      * 出力バッファリングに関するコードの修正
 +    * Version 1.4 バグフィックス <​2006/​04/​07>​
 +      * 一部関数の引数に&​が欠落していた問題の修正(気分の問題)
 +    * Version 1.5 バグフィックス <​2006/​04/​24>​
 +      * スキンの変更に失敗していた不具合の修正
 +    * Version 1.5.1 バグフィックス <​2006/​04/​27>​
 +      * 管理画面の判定に失敗していた不具合の修正
 +  * ver.2.xx
 +    * Version 2.0.0 リライト <​2006/​10/​24>​
 +    * Version 2.0.1 バグフィックス <​2006/​10/​24>​
 +      * img要素の終了タグの処理ができていなかったのを修正
 +
 +----
 +
 +===== ver.1.xx 系列 =====
 +
 +携帯電話での閲覧時にスキンを変更し、不要な要素や宣言、コメントを取り除いた後、Shift-JISに変更して出力するプラグインです。
 +オリジナルは[[plugins:​authors:​jun|Jun]]さん制作の[[plugins:​Mobile|NP_Mobile]]です。
 +
 +^General Plugin info ^^
 +^作者 | [[plugins:​authors:​nkjg|NKJG]] |
 +^最新のバージョン | 1.5.1 |
 +^入手先 | [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1787|フォーラムの記事よりダウンロード]] |
 +^ソース | [[plugins:​mobilewithsinglepage:​mobilewithsinglepage_code|NP_MobileWithSinglePage.phpのソースコード]]|
 +^フォーラム参照先 |[[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1787|Read]]|
 +
 +
 +==== インストール方法 ====
 +  - Zipファイルを展開して、NP_MobileWithSinglePage.phpをサーバーのプラグインディレクトリにアップロードする
 +  - 管理画面からプラグインをインストールする
 +  - オプションを設定する(後述)
 +
 +==== このプラグインの使い方 ====
 +  * インストールするだけで動作します。
 +
 +==== スキン/​テンプレートへの記述 ====
 +  * 必要ありません。
 +
 +==== オプション ====
 +  * Select mobile skin :
 +    * 携帯用ページで使用するスキンの名前です。
 +    * 該当するスキンが存在しない場合はデフォルトのスキンが使用されます。
 +  * Convert IMG into :
 +    * img要素をどのように変換するかの設定です。
 +      * '​text'​は代替テキスト('​alt'​属性)を代わりに表示。代替テキストが無い場合は何もなくなります。
 +      * '​link'​は画像に対するハイパーリンクを作成。(不具合があります。後述)
 +      * '​blank'​はimg要素を無視します。
 +      * '​noconvert'​はimg要素を変換しません。
 +  * Convert Zenkaku-Katakana into Hankaku :
 +    * 全角カタカナを半角に変換するかどうかの設定です。
 +  * Tags will NOT be removed :
 +    * 削除**しない**タグを『|』で区切って記述します。
 +    * ここに設定されていないタグは変換時に全て削除されます。
 +  * Remove attributes :
 +    * 属性についての記述を削除するかどうかの設定です。
 +  * Remove quotation mark of attributes :
 +    * 属性の値の引用符を削除するかどうかの設定です。
 +  * Attributes will NOT be removed :
 +    * 削除**しない**属性名を『|』で区切って記述します。
 +  * User-Agents of Mobile :
 +    * User-Agent判別時に用いる、携帯電話のUser-Agentの一部です。
 +    * 『|』区切りで記入してください。
 +    * 正規表現の特殊文字にはエスケープが必要です。
 +
 +==== Tipsと裏技 ====
 +  * キャリアごとに携帯用スキンを変更する (Andyさんありがとうございます)
 +    * [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=1927|Nucleus(JP)フォーラム :: トピックを表示 - NP_Mobile キャリア別にスキンを振り分ける方法について]]
 +
 +==== 希望事項 ====
 +
 +==== バグ ====
 +  * img要素変換のオプションでlinkを指定した場合、リンク中のimg要素をa要素に変換するため、a要素がネストしてしまいます。
 +
 +==== 開発履歴 ====
 +  * Version 1.0 最初のリリース <​2006/​02/​17>​
 +  * Version 1.1 バグフィックス <​2006/​02/​20>​
 +    * コメントの除去ができていなかったバグの修正
 +  * Version 1.2 バグフィックス <​2006/​03/​15>​
 +    * 携帯用ページから投稿したコメントが文字化けする問題の修正
 +    * 管理画面を変換の対象外に
 +  * Version 1.3 バグフィックス <​2006/​03/​23>​
 +    * 出力バッファリングに関するコードの修正
 +  * Version 1.4 バグフィックス <​2006/​04/​07>​
 +    * 一部関数の引数に&​が欠落していた問題の修正(気分の問題)
 +  * Version 1.5 バグフィックス <​2006/​04/​24>​
 +    * スキンの変更に失敗していた不具合の修正
 +  * Version 1.5.1 バグフィックス <​2006/​04/​27>​
 +    * 管理画面の判定に失敗していた不具合の修正
 
plugins/mobilewithsinglepage.txt · 最終更新: 2011/03/23 21:28 (外部編集)