Tabel Isi
Persyaratan teknis Craft CMS
Terjemahan otomatis neural yang akan digunakan dengan Craft 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
- Craft CMS 3 atau 4 dan di atasnya
- Biasanya, Craft CMS diatur pada folder “ /web ”.
1. Hasilkan Kunci API
Setelah itu Anda akan mendapatkan:
- Kunci API yang memvalidasi keanggotaan Anda
- Tautan ke skrip Linguise untuk pengalih bahasa
Kunci API adalah yang dibutuhkan untuk mengaktifkan terjemahan di situs web Craft 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 clipboard Anda.
2. Unggah dan hubungkan skrip terjemahan Linguise
Skrip terjemahan Linguise perlu diunggah ke server tempat Craft CMS terinstal:
Setelah skrip diunduh, ekstrak file tersebut dan unggah ke folder utama tempat Craft CMS diinstal.
- Pastikan letaknya di direktori utama situs web Anda (tempat Craft CMS berada, secara default berada di dalam folder /web
- Pastikan folder tersebut tetap menggunakan nama default “ linguise ”.
Bagaimana cara mengakses antarmuka Linguise Script?
Setelah menyelesaikan Linguise , Anda dapat mengakses dasbor dengan mengunjungi situs web Anda menggunakan format URL berikut
linguise https://www.domain.com/linguise
Ubah alamat domain sesuai dengan alamat situs web Anda*
Pastikan Linguise memiliki izin baca dan tulis yang tepat*
Atur Kata Sandi dan Koneksi Basis Data
Setelah Anda mengakses antarmuka skrip, Anda akan diperhadapkan dengan layar pengaturan tempat Anda dapat membuat kata sandi dan terhubung ke basis data pilihan Anda.
Anda dapat:
- Tetapkan kata sandi, yang akan diperlukan untuk akses ke antarmuka ini di masa mendatang.
- Pilih jenis basis data Anda — baik MySQL atau SQLite, tergantung pada pengaturan dan preferensi Anda.
Pengaturan awal ini memastikan akses yang aman dan memungkinkan Anda untuk mengkonfigurasi skrip sesuai dengan lingkungan Anda.
Koneksi basis data MySQL
Jika Anda memilih MySQL, antarmuka yang berbeda akan muncul dan meminta detail koneksi berikut dari Kolom Konfigurasi MySQL di bawah ini:
Pastikan informasi yang dimasukkan sudah benar agar koneksi ke database MySQL Anda berhasil.
MySQL vs SQLite – Apa Perbedaannya?
Baik MySQL maupun SQLite adalah sistem basis data populer yang digunakan untuk menyimpan dan mengelola data untuk situs web dan aplikasi. Namun, keduanya dirancang untuk kasus penggunaan yang berbeda dan memiliki beberapa perbedaan utama:
| Fitur | SQLite | MySQL |
|---|---|---|
| Pengaturan | Sangat mudah (diperlukan instalasi SQLite) | Membutuhkan pengaturan server |
| Penyimpanan | Berbaris satu per satu | Dikelola oleh server MySQL |
| Kinerja | Cocok untuk aplikasi skala kecil | Lebih cocok untuk sistem besar dengan lalu lintas tinggi |
| Kasus penggunaan | Aplikasi lokal, pengujian, situs kecil | Aplikasi web, e-commerce, sistem perusahaan |
Antarmuka Skrip Linguise : Pengaturan untuk platform PHP
Dasbor terjemahan Linguise , yang sebelumnya hanya tersedia untuk Joomla dan WordPress, kini memperluas dukungannya ke PHP dan platform tambahan. Pembaruan ini memungkinkan pengguna untuk mengkonfigurasi pengaturan bahasa dengan mudah—seperti opsi tampilan, gaya bendera, dan penyesuaian tampilan—langsung dari antarmuka terpadu, terlepas dari CMS atau kerangka kerja yang mereka gunakan.
Administrator dapat mengelola pengaturan Linguise dengan lebih efisien, dengan fitur-fitur yang konsisten seperti popup pemilihan bahasa, efek bayangan, dan varian pilihan bendera khusus wilayah. Dasbor mempertahankan desain yang ramah pengguna sambil menawarkan kompatibilitas yang lebih luas untuk berbagai lingkungan web.
3. Menyiapkan penulisan ulang URL Craft CMS
Secara default, penulisan ulang URL aktif di Craft CMS. Jika tidak, Anda dapat mengaktifkannya dari penyedia hosting Anda.
URL berdasarkan bahasa perlu dikonfigurasi di file .htaccess. Cukup salin kode di bawah ini setelah kode “ RewriteEngine on ” Craft CMS default. .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, file .htaccess Craft CMS Anda seharusnya terlihat seperti ini:
<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]
# Send would-be 404 requests to Craft
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/(favicon\.ico|apple-touch-icon.*\.png)$ [NC]
RewriteRule (.+) index.php?p=$1 [QSA,L]
</IfModule>
Sekarang Anda dapat memuat semua halaman terjemahan Anda menggunakan URL, misalnya: www.shop.com/fr/
Sekarang mari kita buka pengalih bahasa.
4. Aktifkan pengalih bahasa
4.1 Memuat skrip Linguise JS
Tautan skrip Linguise JS perlu dimuat di semua halaman Craft CMS Anda agar pengalih bahasa dengan flag dan URL alternatif dapat ditampilkan di header HTML Anda (untuk tujuan SEO).
Untuk menyalin tautan skrip, dari dasbor Linguise buka pengaturan domain dan salin tautan skrip tersebut.
Cara termudah untuk memuat kode ini di craft CMS adalah dengan menambahkannya ke indeks template Anda. Buka folder /template dan edit file indeks untuk menyertakan tautan skrip di bagian header.
Pengalih bahasa adalah jendela pop-up berbentuk bendera untuk memilih bahasa yang Anda inginkan. Untuk memuatnya, Anda perlu menyalin kode yang diberikan di akhir konfigurasi situs web ke bagian head halaman HTML Anda. Pengalih bahasa berbentuk bendera kemudian akan dimuat secara otomatis.
Pengalih bahasa akan ditampilkan secara default di posisi kanan atas yang mengambang di situs web Anda. Anda dapat menyesuaikannya seperti yang dijelaskan di bab berikutnya.
Catatan penting SEO: Jumlah bahasa yang Anda atur sangat berpengaruh pada SEO. Saat Anda mengatur bahasa terjemahan, jika Anda memiliki banyak halaman yang terindeks (>500), mesin pencari mungkin membutuhkan waktu lama untuk memprosesnya. Hal ini dapat memengaruhi SEO Anda dalam bahasa asli. Karena itu, kami merekomendasikan untuk menambahkan maksimal 5 bahasa terlebih dahulu, kemudian setelah terindeks, Anda dapat menambahkan bahasa secara bertahap, masing-masing 3 bahasa per bulan.
Atur pemilih bahasa
Pengalih bahasa dapat disesuaikan dari dasbor Linguise > Pengaturan > Tampilan bendera bahasa. Setiap perubahan di sini akan tercermin di situs web.
Di sisi kanan layar, Anda dapat melihat pratinjau pengalih bahasa. Berikut adalah elemen-elemen yang dapat Anda atur:
- 3 tata letak: berdampingan, tarik-turun atau munculan
- Posisi pengalih bahasa
- Konten pengalih bahasa
- Nama-nama bahasa dalam bahasa Inggris atau bahasa asli
- Bentuk dan ukuran bendera
- Warna dan bayangan kotak
Muat pengalih bahasa di konten Craft CMS
Untuk menampilkan pengalih bahasa di tempat tertentu dalam Craft CMS , Anda harus mengatur posisinya sebagai “Di tempat”.
Setelah Anda mengatur posisinya di Linguise , Anda dapat menambahkan kode pendek di bawah ini untuk menyertakannya. Klik kode di bawah ini untuk menyalinnya ke clipboard Anda.
<div>[linguise]</div>
Setelah ditambahkan, di bagian frontend Anda akan melihat nama bendera dan bahasa ditampilkan di area HTML tempat Anda menambahkan kode tersebut.
Aktifkan opsi sistem cache lokal
Sebagai pilihan, Anda dapat mengaktifkan sistem cache lokal yang menyimpan URL dan konten multibahasa terkait untuk mempercepat penyajian halaman. Cache lokal akan menghemat transfer data antara server Linguise dan server situs web Anda. Cache hanya digunakan ketika sebuah halaman telah diterjemahkan dan belum diperbarui. Cache yang diprioritaskan adalah cache dari halaman multibahasa yang paling banyak dilihat.
Sebagai pelengkap, Anda dapat menentukan jumlah cache yang disimpan dalam MB. Pada contoh berikut, cache diaktifkan dan jumlah cache yang akan disimpan adalah 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Terjemahan otomatis pada server Windows IIS
Tambahkan baris yang sesuai dengan pembuat situs web Anda di file Web.config Anda.
Baris 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 pada 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;