WPMLフックAPI
WPMLは、WordPressテーマやプラグインで正しい多言語サポートを提供するために使用できるフィルターおよびアクションフックを提供しています。各フックの詳細については、フックリファレンスAPIを参照してください。
WPMLショートコード
WPMLは、コンテンツとPHPコードの両方で使用できるショートコードを提供しています。これらはWPMLショートコードページにリストされています。
WPML定数
WPMLは、WPMLコアプラグインおよびアドオンプラグインで定義された定数を提供しています。これらは、テーマやプラグインのPHPファイルやテンプレートで使用できます。完全なリストについては、WPML定数に関するページを参照してください。
言語定数
WPMLは、テーマで使用できる以下の定数を定義しています。
| 定数 | 説明 | 例 |
|---|---|---|
| ICL_LANGUAGE_CODE | 現在の言語のコード | fr |
| ICL_LANGUAGE_NAME | 現在の言語での、現在の言語の名前 | Français |
| ICL_LANGUAGE_NAME_EN | 英語での現在の言語の名前 | French |
これらの定数は非推奨となっているため、サイトの現在の言語を取得するために使用することはお勧めしません。代わりに、WPMLで現在の言語を取得する方法に関するFAQ記事を参照してください。
WPMLのCSSおよびJSファイルの無効化
WPMLには、ナビゲーションや言語スイッチャーのスタイルを設定するための独自のCSSおよびJSファイルが付属しています。
言語スイッチャーのスタイル用のスタイルシートおよびJavaScriptファイルの読み込みは、選択したスイッチャーによって異なります。テーマでこれらが不要な場合は、これらのファイルを読み込まないようWPMLに指示できます。
これらのファイルは以下のフォルダーにあります。
../wp-content/plugins/sitepress-multilingual-cms/templates/language-switchers/YOUR_CHOSEN_LANGUAGE_SWITCHER_THEME/
これを行うには、テーマで以下の定数を定義します。
| 定数 | 無効化されるファイル |
|---|---|
| ICL_DONT_LOAD_NAVIGATION_CSS | ナビゲーションスタイルシート – cms-navigation-base.cssおよびcms-navigation.css |
| ICL_DONT_LOAD_LANGUAGE_SELECTOR_CSS | style.css?ver=1 |
| ICL_DONT_LOAD_LANGUAGES_JS | script.js?ver=1 |
これらの定数を設定するには、テーマのfunctions.phpファイルで定義します。例:
define('ICL_DONT_LOAD_NAVIGATION_CSS', true);
テストサイトでの翻訳サービスとの重要な通信の無効化
Webサイト開発の通常のワークフローの一環として、本番サイトを複製し、別の場所やステージング環境で作業する必要がある場合があります。これは一般的な方法であり、強く推奨されています。しかし、この分離されたテストサイトは、デフォルトではメインの本番サイトとまったく同じように翻訳サービスに接続します。これにより、メインサイトと翻訳サービスとの通信に矛盾が生じる可能性があります。
この問題をわかりやすく説明するための典型的な例を以下に示します。
- テストサイトが翻訳サービスから完了した翻訳を取得します。
- 翻訳サービスがこれらのアイテムを「納品済み」としてマークします。
- 本番サイトでこれらの納品済みの翻訳を取得できなくなります。
このような問題を回避するため、ステージングサイトがテスト目的のみであることをWPMLに「伝える」ことをお勧めします。これを行うには、サイトのwp-config.phpに以下の行を追加します。
define( 'WPML_ENVIRONMENT', 'test' );注意: これにより重要なリクエストのみがブロックされますが、ほとんどのリクエストは引き続き利用できます。たとえば、翻訳サービスのリストは通常通り表示されます。