Daftar isi
Persyaratan teknis CMS ProcessWire
Terjemahan otomatis neural yang akan digunakan dengan ProcessWire CMS memerlukan penggunaan skrip PHP (dapat diunduh di bawah). Untuk menginstal skrip Linguise , Anda memerlukan persyaratan berikut:
- Jalankan PHP 7+
- Apache, LiteSpeed, NGINX, server IIS
- Pastikan penulisan ulang URL diaktifkan di server Anda
- ProcessWire CMS 2.x atau 3 ke atas
1. Buat Kunci API
Setelah terhubung atau mendaftar ke dasbor Linguise , Anda harus menyiapkan domain baru terlebih dahulu dan menyimpan setelannya untuk mendapatkan Kunci API.
Anda dapat memilih platform “PHP Lainnya” untuk melanjutkan pendaftaran domain Linguise , seperti dokumentasi ini dan bahasa sumber dan tujuan.
Setelah itu Anda akan mendapatkan:
- Kunci API yang memvalidasi keanggotaan Anda
- Tautan ke skrip Linguise untuk pengalih bahasa
Kunci API inilah yang diperlukan untuk mengaktifkan terjemahan di situs web ProcessWire CMS Anda. Pada dasarnya, kunci API akan memeriksa bahasa apa yang diaktifkan di domain Anda dan memungkinkan terjemahan konten secara otomatis.
Untuk saat ini, Anda dapat menyalin Kunci API dan menyimpannya di papan klip.
2. Unggah dan hubungkan skrip terjemahan Linguise
Skrip terjemahan Linguise perlu diunggah ke server Anda tempat ProcessWire CMS diinstal:
Setelah skrip diunduh, unzip dan unggah ke folder root tempat ProcessWire CMS diinstal.
- Pastikan itu berada di tingkat root situs web Anda (tempat ProcessWire berada)
- Pastikan folder tetap menggunakan nama default " linguise "
Kunci Linguise perlu disalin ke dalam 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. Atur penulisan ulang URL CMS ProcessWire
Secara default, penulisan ulang URL aktif di ProcessWire CMS. Jika tidak, Anda dapat mengaktifkannya dari penyedia hosting Anda.
URL menurut bahasa perlu dikonfigurasi di .htaccess. Copy saja kode di bawah ini setelah kode “ RewriteEngine on ” CMS bawaan ProcessWire .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>
Terakhir, ProcessWire CMS .htaccess Anda akan terlihat seperti ini:
# 8. Enable Apache mod_rewrite (required)
# -----------------------------------------------------------------------------------------------
<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]
# 8A. Optionally (O) set a rewrite base if rewrites are not working properly on your server.
# -----------------------------------------------------------------------------------------------
Anda sekarang dapat memuat semua halaman terjemahan menggunakan URL, misalnya: www.shop.com /fr/
Sekarang mari memuat pengalih bahasa.
4. Aktifkan pengalih bahasa
4.1 Muat skrip Linguise JS
Tautan skrip Linguise JS perlu dimuat di semua halaman CMS ProcessWire Anda untuk menampilkan pengalih bahasa dengan tanda dan URL alternatif di header HTML Anda (untuk tujuan SEO).
Untuk menyalin tautan skrip, dari dasbor Linguise buka pengaturan domain dan salin tautan skrip.
Cara termudah untuk memuat kode ini di ProcessWire CMS adalah dengan menambahkannya di dalam header situs web Anda atau bagian. ProcessWire CMS hadir memiliki file khusus untuk memuat skrip ke header.
Itu terletak di _main.php Anda dapat menemukannya dengan menavigasi ke site/templates/_main.php . Edit file skrip untuk menyertakan tautan skrip di bagian header.
Pengalih bahasa dengan tanda sekarang seharusnya dimuat secara otomatis.
Pengalih bahasa akan ditampilkan secara default di posisi kanan atas mengambang di situs web Anda. Anda dipersilakan untuk menyesuaikannya seperti yang dijelaskan di bab berikutnya.
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
Sakelar bahasa dapat disesuaikan dari Dashboard 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 ProcessWire
Untuk menampilkan Pengalih Bahasa di tempat tertentu, di ProcessWire , 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.
<div>[linguise]</div>
Setelah ditambahkan, di bagian depan Anda akan melihat bendera dan nama bahasa ditampilkan di area HTML tempat Anda menambahkan kode.
Aktifkan opsi sistem cache lokal
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.
Untuk melengkapi itu, Anda dapat menentukan jumlah cache yang disimpan dalam MB. Dalam contoh berikut, cache diaktifkan dan jumlah cache yang disimpan adalah 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Terjemahan otomatis di server 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:
<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>
Terjemahan otomatis di server 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;