Daftar isi
Persyaratan teknis Magento
Terjemahan otomatis saraf yang akan digunakan dengan Magento memerlukan penggunaan skrip PHP (dapat diunduh di bawah). Untuk menginstal Linguise , Anda memerlukan persyaratan berikut:
- Jalankan PHP 7+
- Apache, LiteSpeed, NGINX, server IIS
- Aktifkan penulisan ulang URL melalui konfigurasi Magento
- Magento 2+
- Folder root Magento biasanya terletak di Magento /pub ”, pastikan untuk menginstal Linguise di dalam folder ini
Hasilkan Kunci API
Kunci API inilah yang diperlukan untuk mengaktifkan terjemahan di situs Magento 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.
Unggah dan hubungkan skrip terjemahan Linguise
Skrip terjemahan Linguise perlu diunggah ke server Anda tempat Magento diinstal:
Setelah skrip diunduh, unzip dan unggah ke folder root tempat CMS diinstal.
- Pastikan itu berada di tingkat root situs web Anda (tempat Magento berada, secara default ada di dalam folder /pub
- Pastikan folder menyimpan nama default " linguise "
Kunci Linguise perlu disalin dalam Configuration.php yang telah Anda unggah di server Anda, edit file dan salin Kunci API Anda di antara tanda kutip sederhana, ganti teks REPLACE_BY_TOUR TOKEN.
Konfigurasi Magento Ekstra
Di Sidebar admin, buka Toko > Pengaturan > Konfigurasi > Umum > Web > Opsi URL dan atur opsi Tambahkan Kode Toko ke Url sebagai “ Tidak “.
Akses kode situs web Anda dan buka app/etc/env.php . Setel 'document_root_is_pub' ke benar.
Pastikan Anda mengatur kedua langkah ini, dan lanjutkan ke Penyiapan penulisan ulang URL untuk memastikan Linguise dapat berjalan dengan baik di situs Magento Anda tanpa masalah.
Siapkan penulisan ulang URL
Di Sidebar admin, buka Toko > Pengaturan > Konfigurasi > Umum > Web > Optimasi Mesin Pencari dan aktifkan Gunakan Penulisan Ulang Server Web . Informasi lebih lanjut di dokumentasi resmi Magento
URL berdasarkan bahasa perlu dikonfigurasi di .htaccess. Copy saja kode ini setelah kode “ RewriteEngine on ” yang tersedia di default Magento 2 .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,END]
</IfModule>
Terakhir, Magento .htaccess Anda akan terlihat seperti ini:
Aktifkan pengalih bahasa
Muat skrip Linguise JS
Anda sekarang dapat memuat semua halaman terjemahan menggunakan URL, misalnya: www.shop.com /fr/
Pengalih bahasa adalah popup bendera untuk memilih bahasa yang Anda inginkan. Untuk memuatnya, Anda perlu menyalin kode yang diberikan di akhir konfigurasi situs web ke bagian atas halaman HTML Anda. Pengalih bahasa bendera kemudian akan dimuat secara otomatis.
Kode untuk disalin dan dimuat di header situs web Anda tersedia di Linguise > Domain Anda > Setelan > Tab: Script PHP
Itu perlu dimuat di header halaman Anda. Magento 2 memberi Anda kemampuan untuk menambahkan konten di bagian atas halaman Anda melalui konfigurasi.
Di panel admin, buka Content > Configuration , edit tampilan tema toko default Anda, lalu klik bagian HTML Head dan tambahkan skrip yang disalin ke input Scripts and Style Sheets. Terakhir, simpan konfigurasi.
Instal modul keamanan Magento
Sejak Magento 2.3.5 Anda perlu menambahkan modul keamanan untuk memungkinkan Magento memuat file dari domain Linguise . Jika Anda terbiasa dengan Magento , hal itu tidak akan menjadi masalah, jika tidak, berikut adalah panduan langkah demi langkah:
- Unduh modul dari tautan ini
- Buka zip konten zip ke dalam instalasi Magento Anda di direktori app/code/
- Kemudian jalankan perintah:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
Pengalih bahasa akan ditampilkan secara default di posisi kanan bawah mengambang di situs web Anda. Anda dapat menyesuaikannya dari dasbor Linguise .
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 Magento
Untuk menampilkan Pengalih Bahasa di tempat tertentu, di Magento , 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.
Aktifkan 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.
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