Download the PHP package tarohida/tfa-message-ja without Composer
On this page you can find all versions of the php package tarohida/tfa-message-ja. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tarohida/tfa-message-ja
More information about tarohida/tfa-message-ja
Files in tarohida/tfa-message-ja
Package tfa-message-ja
Short Description TFAモジュールのエラーメッセージを日本語に対応(時間表記の自動変換)
License MIT
Homepage https://github.com/tarohida/tfa-message-ja
Informations about the package tfa-message-ja
TFA Message Japanese
Drupal の Two-Factor Authentication (TFA) モジュールのエラーメッセージを日本語に対応させるモジュールです。
概要
TFA モジュールが表示するエラーメッセージに含まれる英語の時間表記(例: "5 min", "10 sec")を、日本語表記(例: "5分", "10秒")に自動変換します。
問題
TFA モジュールのエラーメッセージでは、Drupal の formatInterval() 関数が返す時間表記が含まれます。日本語ロケールでも英語形式で出力されることがあり、日本語訳と組み合わせると不自然な表現になります。
変換前の例:
変換後の例:
主な機能
-
時間表記の自動日本語化: エラーメッセージ内の英語時間表記を日本語に変換
- "5 min" → "5分"
- "10 sec" → "10秒"
- "1 hour" → "1時間"
- "2 days" → "2日"
- その他: year(年), month(ヶ月), week(週間)にも対応
-
HTMLタグの適切なレンダリング: プレースホルダーなどのHTMLマークアップを正しく表示
- 日本語ロケール限定: 日本語(ja)ロケールの場合のみ動作し、他の言語には影響しません
要件
- Drupal: 10.x または 11.x
- PHP: 8.1 以上
- 依存モジュール: TFA (Two-Factor Authentication)
インストール
Composer 経由(推奨)
モジュールを有効化:
手動インストール
- このリポジトリをダウンロード
web/modules/contrib/tfa_message_jaまたはweb/modules/custom/tfa_message_jaに配置- モジュールを有効化:
使い方
モジュールを有効化するだけで自動的に動作します。設定画面はありません。
動作確認方法
- TFA を有効化したユーザーでログイン
- 意図的に間違った認証コードを複数回入力
- Flood 制御によるロックアウトメッセージが日本語で表示されることを確認
技術仕様
実装方法
- hook_form_alter():
tfa_entry_formにカスタムバリデーションハンドラーを追加 - 正規表現による変換: 時間表記パターン
(\d+)\s*(year|month|week|day|hour|min|sec)s?をマッチング - FormattableMarkup: 変換後のメッセージを
FormattableMarkupでラップし、HTMLタグを保持
対応する時間単位
| 英語 | 日本語 |
|---|---|
| year(s) | 年 |
| month(s) | ヶ月 |
| week(s) | 週間 |
| day(s) | 日 |
| hour(s) | 時間 |
| min | 分 |
| sec | 秒 |
ディレクトリ構成
トラブルシューティング
メッセージが変換されない
-
日本語ロケールの確認
jaになっているか確認 -
キャッシュクリア
- モジュールの有効化確認
他のモジュールとの互換性
このモジュールは TFA のエラーメッセージのみを対象とし、他のモジュールには影響しません。
他のモジュールとの組み合わせ
tfa_custom モジュールとの併用
tfa_custom モジュールと併用可能です:
- tfa_custom: ログイン後のリダイレクト制御、メール送信制御
- tfa_message_ja: エラーメッセージの日本語化
両方を有効化することで、より快適な日本語環境を実現できます。
コントリビューション
バグ報告や機能リクエストは GitHub Issues までお願いします。
プルリクエストも歓迎します!
ライセンス
このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE.txt をご覧ください。
作者
- tarohida - GitHub