Daftar isi
Persyaratan teknis
Untuk menjalankan skrip terjemahan Linguise , Anda memerlukan hal berikut:
- Jalankan PHP 7+ dan Laravel
- Apache, LiteSpeed, NGINX, server IIS
- Aktifkan penulisan ulang URL di konfigurasi server Anda
- Folder root Laravel public ”, pastikan untuk menginstal Linguise di dalam folder ini
1. Buat Kunci API
Kunci API inilah yang diperlukan untuk mengaktifkan terjemahan di situs web Anda. Pada dasarnya, kunci API akan memeriksa bahasa apa yang diaktifkan di domain apa dan akan memungkinkan pembuatan halaman terjemahan saraf.
Salin Kunci API dan simpan di clipboard Anda.
Kemudian dengan mengklik tab "Script PHP" Anda akan mendapatkan petunjuk instalasi yang akan kami ikuti secara detail di sini.
2. Unggah dan hubungkan skrip terjemahan Linguise
Script terjemahan Linguise perlu diupload ke server Anda, di folder tempat Laravel diinstal, dapat diunduh di sini:
Setelah skrip diunduh, unzip dan unggah ke folder root tempat Laravel diinstal.
- Pastikan berada pada level root dari Laravel (biasanya Laravel mengatur root pada folder “ public ” Anda dapat menginstal Linguise di sana)
- Pastikan folder tersebut bernama “ linguise ” (nama default saat folder dibuka ritsletingnya)
Kunci Linguise perlu disalin ke folder: …/ linguise /Configuration.php yang telah Anda unggah ke server Anda, edit file dan salin Kunci API Anda di antara tanda kutip sederhana, ganti teks REPLACE_BY_TOUR TOKEN.
3. Siapkan URL bahasa
URL berdasarkan bahasa perlu dikonfigurasi di file .htaccess, jika Anda memiliki "RewriteBase /" di file Anda, cukup salin setelah itu semua kode berikut:
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]
4. Aktifkan pengalih bahasa di Laravel
Pengalih bahasa adalah sembulan bendera untuk memilih bahasa yang Anda inginkan. Untuk memuatnya, Anda harus menyalin kode yang diberikan di bagian akhir konfigurasi situs web ( Dasbor Linguise ).
Script harus dimuat di bagian atas halaman HTML Anda yang ditangani oleh Laravel . Pengalih bahasa bendera kemudian akan dimuat secara otomatis.
Pengalih bahasa akan ditampilkan secara default di posisi mengambang di kanan atas situs web Anda. Anda dipersilakan untuk menyesuaikannya sesuai keinginan dengan CSS.
Catatan penting SEO: Jumlah bahasa yang Anda atur berdampak besar pada SEO. Saat Anda menyiapkan bahasa terjemahan, jika Anda memiliki banyak halaman yang diindeks (>500), mesin pencari mungkin memerlukan banyak waktu untuk memprosesnya. Ini dapat memengaruhi SEO Anda dalam bahasa asli Anda. Itu sebabnya kami menyarankan untuk menambahkan maksimal 5 bahasa terlebih dahulu, kemudian saat diindeks, Anda dapat menambahkan bahasa dalam batch 3 per bulan.
Siapkan pengalih bahasa
Pengalih bahasa dapat disesuaikan dari dasbor Linguise > Pengaturan > Tampilan bendera bahasa. Setiap modifikasi di sini akan tercermin di situs web.
Di sisi kanan layar Anda memiliki pratinjau pengalih bahasa. Berikut adalah elemen yang dapat Anda atur:
- 3 tata letak: berdampingan, dropdown atau popup
- Posisi pengalih bahasa
- Konten pengalih bahasa
- Nama bahasa dalam bahasa Inggris atau bahasa asli
- Bentuk dan ukuran bendera
- Warna dan bayangan kotak
Muat pengalih bahasa di konten Laravel
Untuk menampilkan pengalih Bahasa di tempat tertentu, di Laravel , Anda harus mengatur posisinya sebagai "Di tempat".
Setelah Anda mengatur posisinya di Linguise , Anda dapat menambahkan kode pendek di bawah ini untuk memasukkannya. Klik kode di bawah ini untuk menaruhnya di clipboard Anda.
Setelah ditambahkan, di bagian depan Anda akan melihat bendera dan nama bahasa ditampilkan di area HTML tempat Anda menambahkan kode.
Sistem cache lokal untuk halaman Laravel
Sebagai opsi, Anda dapat mengaktifkan sistem cache lokal yang menyimpan URL dan konten multibahasa terkait untuk menyajikan halaman lebih cepat. Cache lokal akan menyimpan beberapa transfer data antara server Linguise dan server situs web Anda. Cache hanya digunakan ketika halaman telah diterjemahkan dan belum diperbarui. Cache yang diprioritaskan akan menjadi cache dari halaman multibahasa yang paling banyak dilihat.
Sebagai opsi, Anda dapat menentukan jumlah cache yang disimpan dalam MB. Dalam contoh berikut, cache diaktifkan dan jumlah cache yang harus disimpan adalah 500MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Pengaturan khusus untuk Platform Laravel
Pada file Configuration.php kami juga memiliki pengaturan yang memungkinkan untuk melewatkan beberapa konfigurasi tertentu untuk CMS atau non-CMS. Secara default, ini otomatis, namun tim dukungan mungkin meminta Anda mempersonalisasikannya untuk menggunakan beberapa pengaturan khusus.
Berikut kode yang perlu ditambahkan untuk Laravel , ini nama CMS dalam huruf kecil:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
Dari SQLite hingga MySQL
Masih di Configuration.php ada pengaturan untuk memaksa penggunaan MySQL daripada SQLite, jika SQLite tidak diinstal di server.
Dalam hal ini, Anda perlu mengisi informasi MySQL di bagian file Configuration.php ini:
/** 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 = '';
Terjemahan otomatis di server Laravel + Windows IIS
Tambahkan baris yang sesuai dengan pembuat situs web Anda di file Web.config Anda.
Ini harus diatur sebelum pengalihan lainnya, terutama pengalihan ke file utama PHP Anda:
Terjemahan otomatis di server 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;