目次
技術要件
Linguise 翻訳スクリプトを実行するには、次のものが必要です。
- PHP 7+と Laravel実行
- Apache、LiteSpeed、NGINX、IIS サーバー
- サーバー設定でURL書き換えを有効にする
- Laravelのルートフォルダは通常「 public このフォルダ内にLinguiseをインストールしてください。
1. APIキーを生成する
APIキーは、ウェブサイトで翻訳を有効化するために必要なものです。基本的に、APIキーはどのドメインでどの言語が有効化されているかを確認し、ニューラル翻訳ページの生成を可能にします。.
API キーをコピーしてクリップボードに保存します。.
次に、「Script PHP」タブをクリックすると、ここで詳しく説明するインストール手順が表示されます。.
2. Linguise 翻訳スクリプトをアップロードして接続する
Linguise 翻訳スクリプトは、サーバーの Laravel がインストールされているフォルダーにアップロードする必要があります。ここからダウンロードできます。
スクリプトをダウンロードしたら、解凍して、 Laravel がインストールされているルート フォルダーにアップロードします。.
- Laravelのルートレベルにあることを確認してください(通常、 Laravelルートを「 public Linguiseインストールできます)
- フォルダ名が「 linguise 」（フォルダを解凍したときのデフォルト名）
Linguise Script Interface にアクセスするにはどうすればいいですか?
Linguiseが完了したら、次のURL形式でウェブサイトにアクセスしてダッシュボードにアクセスできます:
https://www.domain.com/ linguise
ウェブサイトのアドレスに合わせてドメインアドレスを変更します*
Linguise適切な読み取りおよび書き込み権限があることを確認します
パスワードとデータベース接続の設定
スクリプト インターフェイスにアクセスすると、パスワードを作成して希望のデータベースに接続できるセットアップ画面が表示されます。.
あなたはできる：
- 今後このインターフェースにアクセスする際に必要となるパスワードを設定します。.
- 設定と好みに応じて、データベースの種類（MySQL または SQLite）を選択します。.
この初期設定により、安全なアクセスが確保され、環境に応じてスクリプトを構成できるようになります。.
MySQLデータベース接続
MySQL を選択した場合は、以下の MySQL 構成フィールドの接続詳細を尋ねる別のインターフェイスが表示されます。
MySQL データベースへの接続を正常に確立するには、情報が正しいことを確認してください。.
MySQLとSQLiteの違いとは？
MySQLとSQLiteはどちらも、ウェブサイトやアプリケーションのデータの保存と管理によく使われる人気のデータベースシステムです。しかし、それぞれ異なるユースケースを想定して設計されており、いくつかの重要な違いがあります。
| 機能 | SQLite | MySQL |
|---|---|---|
| 設定 | 非常に簡単（SQLiteのインストールが必要） | サーバーのセットアップが必要です |
| ストレージ | 単一ファイル | MySQLサーバーによって管理 |
| パフォーマンス | 小規模アプリに最適 | 大規模で高トラフィックのシステムに最適 |
| 使用事例 | ローカルアプリ、テスト、小規模サイト | ウェブアプリ、eコマース、エンタープライズシステム |
Linguise スクリプトインターフェース: PHP プラットフォームのセットアップ
これまで Joomla と WordPressのみに対応していた Linguise 翻訳ダッシュボードが、PHPをはじめとする他のプラットフォームにもサポートを拡大しました。このアップデートにより、ユーザーはCMSやフレームワークを問わず、統一されたインターフェースから、表示オプション、フラグスタイル、外観のカスタマイズといった言語設定をシームレスに行うことができます。.
管理者は、言語選択ポップアップ、影の効果、地域固有のフラグ選択のバリエーションといった一貫した機能により、 Linguise 設定をより効率的に管理できます。ダッシュボードはユーザーフレンドリーなデザインを維持しながら、多様なWeb環境への幅広い互換性を提供します。.
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 ページのヘッダーに読み込む必要があります。すると、フラグ言語スイッチャーが自動的に読み込まれます。.
言語スイッチャーは、ウェブサイトの右上にデフォルトで表示されます。CSSを使って自由にカスタマイズできます。.
SEOに関する重要な注意：設定する言語の数はSEOに大きな影響を与えます。翻訳言語を設定する際、インデックス登録されたページ数が多い場合（500ページ以上）、検索エンジンによる処理に時間がかかる可能性があります。これは、元の言語でのSEOに影響を与える可能性があります。そのため、最初は最大5言語を追加し、インデックス登録が完了したら、月に3言語ずつまとめて追加することをお勧めします。
言語スイッチャーの設定
言語スイッチャーは、 Linguise ダッシュボード > 設定 > 言語フラグ表示からカスタマイズできます。ここで行った変更はすべてウェブサイトに反映されます。.
画面右側に言語スイッチャーのプレビューが表示されます。設定できる要素は以下のとおりです。
- 3つのレイアウト: サイドバイサイド、ドロップダウン、ポップアップ
- 言語スイッチャーの位置
- 言語切り替えコンテンツ
- 英語または母国語での言語名
- 旗の形と大きさ
- 色とボックスシャドウ
Laravel コンテンツに言語スイッチャーをロードする
言語スイッチャーをLaravelコンテンツ内の特定の場所に表示するには、位置を「In place」に設定する必要があります。Linguise
で位置を設定したら、以下のショートコードを追加して表示できます。以下のコードをクリックすると、クリップボードにコピーされますLinguise
<div>[linguise]</div>
追加されると、フロントエンドで、コードを追加した HTML 領域にフラグと言語名が表示されます。.
Laravel ページ用のローカル キャッシュ システム
オプションとして、URLと関連する多言語コンテンツを保存するローカルキャッシュシステムを有効にすることで、ページの表示速度を向上できます。ローカルキャッシュは、 Linguise サーバーとお客様のウェブサイトサーバー間のデータ転送を節約します。このキャッシュは、ページが既に翻訳済みで更新されていない場合にのみ使用されます。優先的に保持されるキャッシュは、最も閲覧されている多言語ページのキャッシュです。.
オプションとして、保存するキャッシュの容量をMB単位で定義できます。以下の例では、キャッシュが有効になっており、保存するキャッシュの容量は500MBです。
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Laravel プラットフォームの特定の設定
Configuration.php ファイルには、CMS または非 CMS 向けの特定の設定を渡すための設定もあります。デフォルトでは自動的に設定されますが、サポートチームから特別な設定を使用するようカスタマイズをお願いする場合があります。
Laravelに追加するコードです。これは小文字の CMS 名です。
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
SQLiteからMySQLへ
また、Configuration.php には、サーバーに SQLite がインストールされていない場合に、SQLite ではなく MySQL の使用を強制する設定があります。.
この場合、 Configuration.php ファイルのこの部分に MySQL 情報を入力する必要があります。
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
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サーバーでの自動翻訳
rewrite ^/(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 last;