qchan's sandbox: Japanese Mail Helper

The Japanese Mail Helper module allows you to convert mail text encoding from UTF-8 to iso-2022-jp ( JIS ) for Drupal.
It collaborates with Mime Mail Module.
There are many mobile phones that can't read UTF-8 text encoding mail in Japan.
Also it can convert Multi part mail (HTML) text encoding.

We've tested following modules' mail

* Drupal Core User registeration
* Contact form
* Webform
* Simplenews

Dependancies

Mime Mail Module 7.x

How to Setup

1. Enable mimemail module.
dependencies:Mail System module

2. Enable jp_mail_helper module

3. Change mail engine which drupal use to send mail.
Head to "admin/config/system/mimemail"
Select "E-mail engine" section >> Japanese Mail Helper : customize mimemail for japanese character set.

4. Recommend Settings for Mimemail module

Uncheck "Include site style sheets"

notes

You shoud avoid using half-size font characters and machine dependable characters at mail title.
See details >> PHP: 日本語のマルチバイト文字に関する基本事項 - Manual

Todo

* Support Views Send Module.
* Support PHPMailer Module.

+++++++++++++++++++++++++++++++++++++++++++++++++++

Japanese Instructions

注意
---------------------

* Mimemail module 7.x が必要です。
http://drupal.org/project/mimemail

はじめに
---------------------

* mimemailモジュールを利用して送信されるメールを、ヘッダiso-2022-jp、本文iso-2022-jp-msへ変換します。
※ ヘッダに半角カナ等iso-2022-jpで扱えない文字コードを利用した場合には文字化けが発生します。
"PHP: 日本語のマルチバイト文字に関する基本事項 - Manual":http://jp2.php.net/manual/ja/mbstring.ja-basic.php

* マルチパートメール対応

インストール・設定
---------------------

1. mimemailモジュールをインストール/有効化します。

2. jp_mail_helperモジュールを有効にします。

3. Drupalが利用するメールエンジンを変更します。
管理 > 環境設定 > システム > Mime Mail
"E-mail engine" セクション
Jp Mail Helper : customize mimemail for japanese character set. を選択します。

4. mimemailモジュールの推奨設定
管理 > 環境設定 > システム > Mime Mail
"Include site style sheets" :
チェックを外します。
チェックされている場合はCSSがHTML内に展開されます。
(メールのファイルサイズが大きくなり、端末によっては表示できない可能性があります。)

使い方
---------------------

システムから送信されるメールは自動的にiso-2022-jpへと変換されます。
変換を確認している機能/モジュールは次の通りです。

アカウントの設定機能(コア)
・ウェルカム（管理者作成のユーザー）(アクティブなタブ)
・ウェルカム（承認待ち）
・ウェルカム（承認不要）
・アカウントの有効化
・アカウントブロック
・アカウント無効化の確認
・アカウント無効化
・パスワード再発行

Contactモジュール(コア)

Webformモジュール
http://drupal.org/project/webform

Simplenewsモジュール
http://drupal.org/project/simplenews
設定方法
管理 > 環境設定 > シンプルニュース >メール送信
"Mail system"セクション
MimeMailを選択します。

※ UTF-8でメールが送信される場合は、
管理 > 環境設定 > システム > Mail System
"MAIL SYSTEM SETTINGS" セクションに表示されているコンボボックスが
"MimeMailSystem" になっていることを確認してください。

今後の予定
---------------------

* views_sendモジュール対応 (2011/10/04 現在 Drupal7版未リリース)
* PHPMailerモジュール対応