EastCoder;

本家版、日本語版 WordPress のマルチバイト文字の取り扱いに関する不具合の累積的修正と強化を行うプラグインです。
本家版、日本語版で日本語を正しく処理する為に必要となる機能を網羅しておりますのでなんらかの対策を行っていない場合は導入をお勧めします。

ダウンロード

上記いずれのリリースには日本語処理に特化した拡張機能（エクステンション）が含まれています。
リリースノート

Attention international users:
WP Multibyte Patch 0.9.5 defaultly uses Japanese Extension. Unless your main language is Japanese, please rename the folder /ext/default to /ext/ja. This will limit the WPMP functions only to “For All Languages” types of multibyte enhancement which cover Incoming Trackbacks, Incoming Pingbacks and Excerpt functions.
English documentation is coming soon.

主な機能 （バージョン 0.9.5、1.0）

メール送信

• 機種依存文字等の変換可否をチェックし、自動的に ISO-2022-JP （7bit） か UTF-8 （base64） から最適な日本語のエンコーディングを選択してメールを送信します。 [ja]
• そのままの本家版とは異なり、UTF-8 モードではボディ部も base64 エンコード （7bit） しますので配送途中でいわゆる “ビット落ち” が起ることはありません。（そのままの本家版で日本語のメールを送った場合、古いMTAを介した際に文字化けを起こす可能性があります。） [ja]
• PHPMailer により MIME ヘッダが破壊される問題、また一部 MTA によりヘッダの改行がおかしくなる問題の対策が施されています。 [ja]
• 日本語エクステンションの設定ファイル （/ext/（default もしくは ja）/config.php） にて前述の自動判別 （デフォルト）、JIS （ISO-2022-JP） 固定、UTF-8 固定 の三つから好みのモードを選ぶことができます。 [ja]

トラックバック受信

• 日本語系を含む多くの文字コードのデータが破壊される問題を修正します。
• そのままの本家版の不適切な文字コード検出ロジックを廃し、より精度の高い方法を採用しています。

ピンバック受信

• マルチバイト文字で書かれたページからのピンバックの処理機能一式 （エンコーディング検出、変換、トリム）を実装しています。 （そのままの本家版はマルチバイト対策が一切されていません！）

EXCERPT 系関数

• マルチバイト文字列が適切な位置で切断されない問題を修正します。
• 出力文字列の長さを設定ファイル（wpmp-config.php） からコントロールできます。
• 具体的には、wp_trim_excerpt() と get_comment_excerpt() をマルチバイト対応化させていますので同時に下流にある the_excerpt()、 the_excerpt_rss()、comment_excerpt() などの関数もマルチバイト対応化します。

検索

• 全角スペースでも AND 検索となります。 [ja]
• 検索文字列内の重複するスペースを取り除きます。 [ja]

アドミンエリア

• アドミンページのヘッダ部に独自の外部 CSS ファイル （admin.css） を読み込む機能を実装しています。CSS ファイルを編集することによりユーザーがアドミンページの見かけをカスタマイズすることもできます。 [ja]
• 日本語のフォント表示を考慮し上記機能を用いてフォントファミリーを sans-serif 系に統一、一部文字サイズを調整しています。 [ja]

その他

• 設定ファイル （wpmp-config.php） から各機能を個別に有効化・無効化できます。
• 日本語圏以外のユーザー用途にも対応できるようロケール別に拡張クラス （エクステンション） をロードする機能が組み込まれています。

※ 末尾に [ja] と書かれているものは付属の日本語処理用エクステンションが有効な場合に付加される機能です。

インストール方法

1. ZIP を解凍し、フォルダごと /wp-content/plugins/ の中に入れてください。
2. 設定ファイルを利用する場合は下記のようにそれぞれ変名してください。 wpmp-config-sample.php -> wpmp-config.php
   config-sample.php -> config.php
3. アドミンのプラグインページで WP Multibyte Patch を有効にしてください。

前バージョンからのアップグレード

• フォルダごと中身を上書きしてください。
• バージョン 1.0 よりインストール時の日本語エクステンションフォルダ名が ‘default’ から ‘ja’ に変わっています。古い日本語エクステンションのフォルダ名が ‘default’ である場合は上書きされませんので念のため削除してください。
  （エクステンションフォルダは /wp-multibyte-patch/ext 以下にあります。）

アンインストール方法

フォルダごと削除してください。データベースへの設定値の保存、ファイル生成等は一切行っていません。

設定ファイルの説明

共通設定ファイル （wpmp-config.php）

• $wpmp_conf['excerpt_length'] = 55;
  wp_trim_excerpt() とその下流の関数で文字列の ASCII 比率が多い時に単語数で切り詰められる時の数
• $wpmp_conf['excerpt_mblength'] = 110;
  wp_trim_excerpt() とその下流の関数で文字列の ASCII 比率が少ない時に文字数で切り詰められる時の数
• $wpmp_conf['comment_excerpt_length'] = 20;
  get_comment_excerpt() とその下流の関数で文字列のASCII 比率が多い時に単語数で切り詰められる時の数
• $wpmp_conf['comment_excerpt_mblength'] = 40;
  get_comment_excerpt() とその下流の関数で文字列の ASCII 比率が少ない時に文字数で切り詰められる時の数
• $wpmp_conf['patch_wp_mail'] = true;
  メール送信機能のマルチバイトパッチ有効化（true）、無効化（false）
• $wpmp_conf['patch_incoming_trackback'] = true;
  トラックバック受信機能のマルチバイトパッチ有効化（true）、無効化（false）
• $wpmp_conf['patch_incoming_pingback'] = true;
  ピンバック受信機能のマルチバイトパッチ有効化（true）、無効化（false）
• $wpmp_conf['patch_wp_trim_excerpt'] = true;
  wp_trim_excerpt() とその下流関数のマルチバイトパッチ有効化（true）、無効化（false）
• $wpmp_conf['patch_get_comment_excerpt'] = true;
  get_comment_excerpt() とその下流関数のマルチバイトパッチ有効化（true）、無効化（false）
• $wpmp_conf['patch_process_search_terms'] = true;
  検索機能のマルチバイトパッチ有効化（true）、無効化（false）
• $wpmp_conf['patch_admin_custom_css'] = true;
  アドミンページの独自外部 CSS 読込み機能の有効化（true）、無効化（false）

日本語エクステンション設定ファイル （/ext/（default もしくは ja）/config.php）

• $wpmp_conf['mail_mode'] = ‘auto’;
  送信メールのエンコーディングのモードを、auto、 jis、 UTF-8 の中から選択
  ※ 主に携帯でメールを読まれる場合は jis モードを試してみてください。

注意事項

システム要件について

PHP の mbstring 系の関数を多く使用しています。プラグインが有効化できない場合はこれらがお使いのシステムで利用可能な状態にあるかご確認ください。

コンフリクトについて

こちらの「メールの件名の文字化け防止パッチの実証プラグイン」と本プラグインのメール機能を同時に使用することはできません。メール部分だけ上記を利用したい場合は、wpmp-config.php を以下のように修正し本プラグインのメール機能を無効にしてください。

$wpmp_conf['patch_wp_mail'] = false;

※ 他の同様のプラグインとの同時使用においてもコンフリクトが起る可能性は高いと思いますのでご注意ください。

今後の予定と課題

• 本体のリリースにあわせて可能な限りアップデートを行う。
• 日本語ドキュメント、英語ドキュメントの充実。
• wordpress.org Extend の Plugins に登録する。
• 他のマルチバイト言語用のエクステンションの開発 （日本語以外の言語の文字コード事情に詳しい方、興味のある方はご連絡ください）。
• このプラグインで扱っているバグ修正と強化のうち重要なものは本体にマージされるように働きかける （多くは既に trac に報告され、未解決のままになっている問題）。

バグを見つけたら

該当するリリースのエントリー、またはこのページにコメントを残してくださると助かります。可能な限り早く対処したいと思います。