目次
技術要件
Linguise 翻訳スクリプトを実行するには、以下が必要です：
- PHP 7+ と Laravel を実行してください
- Apache、LiteSpeed、NGINX、IIS サーバー
- サーバー設定で URL 書き換えを有効にする
- Laravel’s ルートフォルダーは通常 “public” フォルダー、Linguise をこのフォルダー内にインストールしてください
1. API キーを生成する
Linguiseダッシュボードへの接続後、 Linguise dashboard 新しいドメインをまず設定し、その設定を保存してAPIキーを取得する必要があります。
API キーは、ウェブサイトで翻訳を有効化するために必要なものです。基本的に、API キーはどのドメインでどの言語が有効になっているかを確認し、ニューラル翻訳ページの生成を可能にします。.
API キーをコピーして、クリップボードに保存してください。.
次に、タブ “Script PHP” をクリックすると、ここで詳しく説明するインストール手順が取得できます。.
2. Linguise 翻訳スクリプトをアップロードして接続する
Linguise 翻訳スクリプトは、Laravel がインストールされているフォルダーにサーバーへアップロードする必要があります。こちらからダウンロードできます：
スクリプトをダウンロードした後、解凍してLaravelがインストールされているルートフォルダにアップロードしてください。.
- 必ずそれが’s ルートレベル の Laravel インストール (通常 Laravel はルートを “ に設定しますpublic” フォルダーに Linguise をインストールできます)
- フォルダーを確認してください は “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. 言語 URL の設定
言語ごとのURLは .htaccess ファイルで設定する必要があります。ファイルに “RewriteBase /” がある場合は、その後に以下のコードをすべてコピーしてください。
<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^linguise/linguise.php$ - [L] 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>
4. Laravel で言語スイッチャーを有効化する
言語スイッチャーは、希望する言語を選択するためのフラッグポップアップです。ロードするには、ウェブサイト設定の最後にあるコード（Linguise ダッシュボード）をコピーする必要があります。.
スクリプトは、Laravel が処理する HTML ページの head にロードする必要があります。フラッグ言語スイッチャーは自動的にロードされます。.
言語スイッチャーはデフォルトで、ウェブサイトの右上の浮動位置に表示されます。CSS を使用して好きなようにカスタマイズしてください。.
SEO 重要な注意点: 設定する言語数は SEO に大きな影響を与えます。翻訳言語を設定する際、インデックスされたページが多数（>500）ある場合、検索エンジンの処理に多くの時間がかかることがあります。これにより、元の言語での SEO に影響が出る可能性があります。That’は、最初に最大5言語を追加することを推奨する理由です。その後、インデックスが完了したら、月に3言語ずつ追加できます。
言語スイッチャーの設定
言語スイッチャーは Linguise ダッシュボード > 設定 > 言語フラッグ表示 からカスタマイズできます。ここでのすべての変更はウェブサイトに反映されます。.
画面の右側に言語スイッチャーのプレビューがあります。設定できる要素は以下の通りです：
- 3つのレイアウト：横並び、ドロップダウン、ポップアップ
- 言語スイッチャーの位置
- 言語スイッチャーの内容
- 英語または母国語での言語名
- 旗の形状とサイズ
- 色とボックスシャドウ
Laravel コンテンツで言語スイッチャーを読み込む
特定の場所に言語スイッチャーを表示するには、Laravel コンテンツ内で位置を “In place” に設定する必要があります。
Linguise ダッシュボードで位置を設定したら、以下のショートコードを追加して組み込むことができます。下のコードをクリックしてクリップボードにコピーしてください。
<div>[linguise]</div>
一度それ’が追加されたら、フロントエンドであなた’はフラグと語名が表示され、コードを追加したHTML領域に表示されます。.
Laravelページ用のローカルキャッシュシステム
オプションとして、URL とそれに関連する多言語コンテンツを保存し、ページを高速に提供するローカルキャッシュシステムを有効化できます。ローカルキャッシュは Linguise サーバーとウェブサイトサーバー間のデータ転送を削減します。キャッシュは、ページが既に翻訳済みで更新されていない場合にのみ使用されます。優先的に保持されるキャッシュは、最も閲覧された多言語ページのキャッシュです。.
オプションとして、キャッシュの容量をMB単位で定義できます。以下の例ではキャッシュが有効化され、保持するキャッシュ容量は500MBです：
/** 基本設定 **/ public $cache_enabled = true; public $cache_max_size = 500; // メガバイト単位
Laravelプラットフォームの特定設定
Configuration.php ファイルには、CMS または非 CMS 用の特定の設定を渡すことができる設定もあります。 デフォルトでは自動ですが、サポートチームから特別な設定を使用するようにカスタマイズを求められることがあります。
Laravel 用に追加するコードは次のとおりです、 これは小文字の CMS 名です：
/** 基本設定 **/ /* * CMS に応じて CMS の値を更新します * 利用可能な CMS は: laravel, prestashop */ public static $cms = 'laravel';
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 = '';
Laravel + Windows IIS サーバーでの自動翻訳
Web.config ファイルに、あなたのウェブサイトビルダーに対応する行を追加してください。
他のリダイレクトよりも先に設定すべきです。特に、PHP のメインファイルへのリダイレクトの前に設定してください。
<rule name="Linguise" stopProcessing="true"> <match url="^(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)(?:$|/)(.*)$" ignoreCase="false" /> <conditions logicalGrouping="MatchAll" trackAllCaptures="false" /> <action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" /> </rule>
Laravel + 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 最後;