目次
MODX CMSの技術要件
MODXコンテンツ管理フレームワークで使用する自動翻訳には、以下のPHPスクリプトの使用が必要です（以下からダウンロード可能）。Linguiseスクリプトをインストールするには、次の要件が必要です：
- PHP 7+ を実行
- Apache、LiteSpeed、NGINX、IIS サーバー
- サーバーでURLリライトが有効になっていることを確認してください
- MODX CMS 2.xまたは3以上
1. API キーを生成する
Linguise ダッシュボードへの接続または登録が完了したら、 Linguise dashboard、まず新しいドメインを設定し、その設定を保存して API キーを取得する必要があります。
このドキュメントやソース言語・対象言語のように、Linguise の登録ドメインを進めるために “Other PHP” プラットフォームを選択できます。.
その後、以下が取得できます：
- メンバーシップを検証する API キー
- 言語スイッチャー用の Linguise スクリプトへのリンク
APIキーは、MODX CMSウェブサイトで翻訳を有効化するために必要なものです。基本的に、APIキーはドメインで有効化されている言語を確認し、コンテンツの自動翻訳を可能にします。.
今のところ、APIキーをコピーしてクリップボードに保存できます。.
2. Linguise 翻訳スクリプトをアップロードして接続する
Linguise翻訳スクリプトは、MODX CMSがインストールされているサーバーにアップロードする必要があります：
スクリプトをダウンロードした後、解凍して、MODX CMSがインストールされているルートフォルダーにアップロードしてください。.
- 必ずそれが ルートレベル あなたのウェブサイト (MODX CMS ファイルが配置されている場所)
- フォルダーが デフォルト名 「linguise」
Linguiseスクリプトインターフェースへのアクセス方法は？
Linguise のインストールが完了したら、次の URL 形式でウェブサイトにアクセスしてダッシュボードに入ることができます:
https://www.domain.com/linguise
ウェブサイトのアドレスに合わせてドメインアドレスを変更してください*
Linguise に適切な読み取り・書き込み権限があることを確認してください*
パスワードとデータベース接続の設定
スクリプトインターフェースにアクセスすると、設定画面が表示され、パスワードを作成し、希望のデータベースに接続できます。.
以下が可能です:
- このインターフェースへの今後のアクセスに必要となるパスワードを設定してください。.
- データベースの種類を選択してください — MySQL または SQLite のいずれか、設定や好みに応じて。.
この初期設定により安全なアクセスが確保され、環境に合わせてスクリプトを構成できるようになります。.
MySQL データベース接続
MySQL を選択した場合、以下の MySQL 設定項目の接続詳細を入力する別のインターフェースが表示されます。
情報が正しいことを確認し、MySQL データベースへの接続を成功させてください。.
MySQL vs SQLite – What’s の違いは何ですか？
MySQL と SQLite は、ウェブサイトやアプリケーションのデータを保存・管理するために使用される人気のデータベースシステムです。ただし、用途が異なり、いくつかの重要な違いがあります：
| 機能 | SQLite | MySQL |
|---|---|---|
| 設定 | 非常に簡単（SQLite のインストールが必要） | サーバーの設定が必要 |
| ストレージ | 単一ファイル | MySQL サーバーによって管理されます |
| パフォーマンス | 小規模アプリに最適 | 大規模でトラフィックの多いシステムに最適 |
| ユースケース | ローカルアプリ、テスト、小規模サイト | ウェブアプリ、eコマース、エンタープライズシステム |
Linguise スクリプトインターフェース：PHP プラットフォームの設定
Linguise 翻訳ダッシュボードは、以前は Joomla と WordPress のみで利用可能でしたが、現在は PHP およびその他のプラットフォームにも対応しています。このアップデートにより、ユーザーは CMS やフレームワークに関係なく、統一されたインターフェースから直接、言語設定—表示オプションやフラッグスタイル、外観カスタマイズなど—をシームレスに構成できるようになります。.
管理者は Linguise の設定をより効率的に管理でき、言語選択ポップアップや影効果、地域別フラグ選択バリエーションなどの一貫した機能を備えています。ダッシュボードはユーザーフレンドリーなデザインを保ちつつ、多様なウェブ環境に対する互換性を拡大しています。.
3. MODX CMS の URL 書き換えを設定する
デフォルトでは、URL 書き換えはすでに MODX CMS で有効になっています。もしそれが’そうでない場合、ホスティングプロバイダーから有効化できます。.
.htaccessで言語別のURLを設定する必要があります。以下のコードをコードの後にコピーしてください “RewriteEngine on” デフォルトで利用可能な MODX CMS .htaccess。
<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA] </IfModule>
最終的に、あなたの MODX CMS の .htaccess は次のようになります:
<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA] </IfModule> # 以下のルールにより、LetsEncrypt が使用する .well-known ディレクトリの書き換えを防止します RewriteRule "^\.well-known/" - [L] # .git のような隠しディレクトリ（ドットで始まるディレクトリ）が公開されるのを防止します # ただし、LetsEncrypt が使用する .well-known ディレクトリは除外します RewriteRule "/\.|^\.(?!well-known/)" - [F]
URL を使用して、すべての翻訳ページをロードできます。例: www.shop.com/fr/
言語スイッチャーをロードします。.
4. 言語スイッチャーを有効化
4.1 Linguise JS スクリプトをロード
Linguise JS スクリプトリンクは、すべての MODX CMS ページで読み込まれる必要があります。フラグと代替 URL を使用した言語スイッチャーを HTML ヘッダーに表示します（SEO 目的）。.
スクリプトリンクをコピーするには、Linguise ダッシュボードのドメイン設定へ移動し、スクリプトリンクをコピーしてください。.
このコードを MODX CMS にロードする最も簡単な方法は、ウェブサイトのヘッダー内に追加することです <head> コード。
これを実現するには、開く MODX マネージャーページ / 管理ページ。 次に Elements に移動し、選択 BaseTemplate, スクロールダウンすると、表示が テンプレートコード (HTML)、 コードを編集して、head コード内にスクリプトリンクを含めます。
言語スイッチャーは、希望する言語を選択するためのフラッグポップアップです。これを読み込むには、ウェブサイト設定の最後に示されたコードをHTMLページの<head>にコピーする必要があります。フラッグ言語スイッチャーは自動的に読み込まれます。.
言語スイッチャーはデフォルトで、ウェブサイトの右上の浮かんだ位置に表示されます。次の章で説明されているように、カスタマイズしていただいて構いません。.
SEO 重要な注意点: 設定する言語数は SEO に大きな影響を与えます。翻訳言語を設定する際、インデックスされたページが多数（>500）ある場合、検索エンジンの処理に多くの時間がかかることがあります。これにより、元の言語での SEO に影響が出る可能性があります。That’は、最初に最大5言語を追加することを推奨する理由です。その後、インデックスが完了したら、月に3言語ずつ追加できます。
言語スイッチャーの設定
言語スイッチャーは Linguise ダッシュボード > 設定 > 言語フラッグ表示 からカスタマイズできます。ここでのすべての変更はウェブサイトに反映されます。.
画面の右側に言語スイッチャーのプレビューがあります。設定できる要素は以下の通りです：
- 3つのレイアウト：横並び、ドロップダウン、ポップアップ
- 言語スイッチャーの位置
- 言語スイッチャーの内容
- 英語または母国語での言語名
- 旗の形状とサイズ
- 色とボックスシャドウ
MODX CMS コンテンツに言語スイッチャーを読み込む
特定の場所に言語スイッチャーを表示するには、MODX コンテンツ内で位置を “In place” に設定する必要があります。
Linguise ダッシュボードで位置を設定したら、以下のショートコードを追加して組み込むことができます。下のコードをクリックしてクリップボードにコピーしてください。
<div>[linguise]</div>
一度それ’が追加されたら、フロントエンドであなた’はフラグと語名が表示され、コードを追加したHTML領域に表示されます。.
ローカルキャッシュシステムオプションを有効化する
オプションとして、URL とそれに関連する多言語コンテンツを保存し、ページを高速に提供するローカルキャッシュシステムを有効化できます。ローカルキャッシュは Linguise サーバーとウェブサイトサーバー間のデータ転送を削減します。キャッシュは、ページが既に翻訳済みで更新されていない場合にのみ使用されます。優先的に保持されるキャッシュは、最も閲覧された多言語ページのキャッシュです。.
それを補完するために、キャッシュの容量を MB 単位で定義できます。以下の例では、キャッシュが有効化され、保持するキャッシュ容量は 500 MB です。.
/** 基本設定 **/ public $cache_enabled = true; public $cache_max_size = 500; // メガバイト単位
NGINX サーバーでの自動翻訳
書き換え ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 最後;