目次
Zen Cart CMS の技術要件
Zen Cart CMSで使用するニューラル自動翻訳には、PHPスクリプトの使用が必要です（以下からダウンロード可能）。Linguiseスクリプトをインストールするには、次の要件が必要です：
- PHP 7+ を実行
- Apache、NGINX
- サーバーでURLリライトが有効になっていることを確認してください
- Zen Cart CMS 1.5.x 以上
1. API キーを生成する
Linguise ダッシュボードへの接続または登録が完了したら、 Linguise dashboard、まず新しいドメインを設定し、その設定を保存して API キーを取得する必要があります。
このドキュメントやソース言語・対象言語のように、Linguise の登録ドメインを進めるために “Other PHP” プラットフォームを選択できます。.
その後、以下が取得できます：
- メンバーシップを検証する API キー
- 言語スイッチャー用の Linguise スクリプトへのリンク
APIキーは、Zen Cart CMSサイトで翻訳を有効化するために必要なものです。基本的に、APIキーはドメインで有効化されている言語を確認し、コンテンツの自動翻訳を可能にします。.
今のところ、APIキーをコピーしてクリップボードに保存できます。.
2. Linguise 翻訳スクリプトをアップロードして接続する
Linguise翻訳スクリプトは、Zen Cart CMSがインストールされているサーバーにアップロードする必要があります。こちらからダウンロードしてください。.
スクリプトをダウンロードしたら、解凍してZen Cart CMSがインストールされているルートフォルダーにアップロードしてください。.
- 必ず’配置してください ルートレベル あなたのウェブサイト（Zen Cart 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. Zen Cart CMS の URL 書き換えを設定する
デフォルトでは、Zen Cart CMS で URL 書き換えが有効になっています。もし that’s でない場合は、ホスティングプロバイダーから有効化できます。.
.htaccessで言語別のURLを設定する必要があります。以下のコードを、コードの後にコピーしてください “RewriteEngine on” デフォルトで利用可能 Zen Cart 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>
URL を使用して、すべての翻訳ページをロードできます。例: www.shop.com/fr/
言語スイッチャーをロードします。.
4. 言語スイッチャーを有効化
4.1 Linguise JS スクリプトをロード
Linguise JS スクリプトリンクは、すべての Zen Cart CMS ページで読み込む必要があります。フラグと代替 URL を含む言語スイッチャーを HTML ヘッダーに表示するためです（SEO目的）。.
スクリプトリンクをコピーするには、Linguise ダッシュボードのドメイン設定へ移動し、スクリプトリンクをコピーしてください。.
Zen Cart CMSでこのコードをロードする最も簡単な方法は、ウェブサイトのヘッダー内に追加することですまたは <head> コード。 Zen Cart CMSにはヘッダー用のパーツが含まれたテンプレートがあり、ヘッダー部分にLinguiseスクリプトをロードするための特定のファイルが用意されています。
それ’は tpl_header.php 以下のCMSインストールフォルダーに移動することで見つけることができます。この例では、it’s デフォルトの Zen Cart CMS テンプレート と呼ばれる responsive_classic:
/includes/template/*YOUR_TEMPLATE*/common/tpl_header.php.
以下のように、ヘッダーセクションにスクリプトリンクを含めるようにスクリプトファイルを編集してください。.
言語スイッチャーはデフォルトで、ウェブサイトの右下に浮動表示されます。次の章で説明されているように、カスタマイズしていただいて構いません。.
SEO 重要な注意点: 設定する言語数は SEO に大きな影響を与えます。翻訳言語を設定する際、インデックスされたページが多数（>500）ある場合、検索エンジンの処理に多くの時間がかかることがあります。これにより、元の言語での SEO に影響が出る可能性があります。That’は、最初に最大5言語を追加することを推奨する理由です。その後、インデックスが完了したら、月に3言語ずつ追加できます。
言語スイッチャーの設定
言語スイッチャーは Linguise ダッシュボード > 設定 > 言語フラッグ表示 からカスタマイズできます。ここでのすべての変更はウェブサイトに反映されます。.
画面の右側に言語スイッチャーのプレビューがあります。設定できる要素は以下の通りです：
- 3つのレイアウト：横並び、ドロップダウン、ポップアップ
- 言語スイッチャーの位置
- 言語スイッチャーの内容
- 英語または母国語での言語名
- 旗の形状とサイズ
- 色とボックスシャドウ
Zen Cart コンテンツに言語スイッチャーを読み込む
特定の場所に言語スイッチャーを表示するには、Zen Cart のコンテンツ内で位置を “インプレイス” に設定する必要があります。
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 最後;
SQLite から MySQL へ
Configuration.php の中には、サーバーに SQLite がインストールされていない場合に備えて、SQLite の代わりに MySQL の使用を強制する設定があります。.
この場合、MySQL の情報を入力する必要があります Configuration.php ファイルのこの部分：
/** 高度なデータベース構成 **/ /* * SQLiteを使用したくない場合は、MySQLを使用できます * そのためには、以下の変数を入力する必要があります * Linguiseがテーブルを作成します */ public static $db_host = ''; public static $db_user = ''; public static $db_password = ''; public static $db_name = ''; public static $db_prefix = '';