İçindekiler
Magento teknik gereksinimleri
Magento ile kullanılacak sinirsel otomatik çeviri için PHP betiği (aşağıdan indirilebilir) kullanılması gerekecektir. Linguise betiğini kurmak için aşağıdaki gereksinimlere ihtiyacınız olacak:
- PHP 7 ve üzeri sürümleri çalıştırın
- Apache, LiteSpeed, NGINX, IIS sunucusu
- Magento ayarları üzerinden URL yeniden yazmayı etkinleştirin
- Magento 2+
- Magento /pub klasöründe bulunur Linguise bu klasörün içine kurduğunuzdan emin olun.
API Anahtarını Oluştur
API anahtarı, Magento web sitenizde çeviriyi etkinleştirmek için gereken şeydir. Temel olarak, API anahtarı hangi alanda hangi dilin etkinleştirildiğini kontrol eder ve nöral çeviri sayfalarının oluşturulmasına olanak tanır.
API anahtarını kopyalayın ve panoya kaydedin.

Ardından "Script PHP" sekmesine tıklayarak burada ayrıntılı olarak ele alacağımız kurulum talimatlarını görebilirsiniz.

Linguise çeviri betiğini yükleyin ve bağlayın
Linguise çeviri betiğinin Magento kurulu olduğu sunucunuza yüklenmesi gerekiyor:
Komut dosyası indirildikten sonra, sıkıştırılmış dosyayı açın ve CMS'nin kurulu olduğu kök klasöre yükleyin.
- Dosyanın web sitenizin kök dizininde Magento dosyalarınızın bulunduğu yerde, varsayılan olarak /pub klasöründe) olduğundan emin olun
- Klasörün " linguise " adını koruduğundan

Linguise Script Arayüzüne nasıl erişilir?
Linguise tamamladıktan sonra
linguise formatını kullanarak web sitenizi ziyaret ederek kontrol paneline erişebilirsiniz: https://www.domain.com/linguise
Alan adınızı web sitenizin adresine göre değiştirin.*
Linguise gerekli okuma ve yazma izinlerine sahip olduğundan emin olun
Parola ve Veritabanı Bağlantısı Kurulumu
Komut dosyası arayüzüne eriştiğinizde, parola oluşturabileceğiniz ve tercih ettiğiniz veritabanına bağlanabileceğiniz bir kurulum ekranıyla karşılaşacaksınız.
Yapabilirsiniz:
- Bu arayüze ileride erişim için gerekli olacak bir parola belirleyin.
- Veritabanı türünüzü seçin; kurulumunuza ve tercihinize bağlı olarak MySQL veya SQLite'tan birini tercih edebilirsiniz.
Bu ilk kurulum, güvenli erişim sağlar ve komut dosyasını ortamınıza göre yapılandırmanıza olanak tanır.

MySQL veritabanı bağlantısı
MySQL'i seçerseniz, aşağıdaki MySQL yapılandırma alanlarına ait bağlantı bilgilerini isteyen farklı bir arayüz görünecektir:

MySQL veritabanınıza başarılı bir bağlantı kurmak için bilgilerin doğru olduğundan emin olun.
MySQL ve SQLite Arasındaki Fark Nedir?
Hem MySQL hem de SQLite, web siteleri ve uygulamalar için veri depolamak ve yönetmek amacıyla kullanılan popüler veritabanı sistemleridir. Ancak, farklı kullanım durumları için tasarlanmışlardır ve bazı önemli farklılıkları vardır:
| Özellik | SQLite | MySQL |
|---|---|---|
| Kurmak | Çok kolay (SQLite kurulumu gereklidir) | Sunucu kurulumu gerektirir |
| Depolama | Tek sıra | MySQL sunucusu tarafından yönetilir |
| Performans | Küçük ölçekli uygulamalar için harika | Büyük ve yoğun trafikli sistemler için daha uygundur |
| Kullanım durumu | Yerel uygulamalar, test etme, küçük siteler | Web uygulamaları, e-ticaret, kurumsal sistemler |
Linguise Betik Arayüzü: PHP platformu için kurulum
Daha önce yalnızca Joomla ve WordPressiçin kullanılabilen Linguise çeviri kontrol paneli, artık PHP ve diğer platformları da destekliyor. Bu güncelleme, kullanıcıların CMS veya çerçevelerinden bağımsız olarak, dil ayarlarını (görüntüleme seçenekleri, bayrak stilleri ve görünüm özelleştirmesi gibi) tek bir arayüzden sorunsuz bir şekilde yapılandırmalarına olanak tanıyor.

Yöneticiler, dil seçimi açılır pencereleri, gölge efektleri ve bölgeye özgü bayrak seçenekleri gibi tutarlı özelliklerle Linguise ayarlarını daha verimli bir şekilde yönetebilirler. Kontrol paneli, kullanıcı dostu tasarımını korurken, çeşitli web ortamları için daha geniş uyumluluk sunar.


Ekstra Magento Yapılandırması
Yönetici panelindeki kenar çubuğunda Mağazalar > Ayarlar > Yapılandırma > Genel > Web > URL seçenekleri ve " URL'lere Mağaza Kodu Ekle" seçeneğini " Hayır " olarak ayarlayın.

Web sitenizin koduna erişin ve app/etc/env.php . 'document_root_is_pub' değerini true olarak ayarlayın.

Bu adımların her ikisini de ayarladığınızdan emin olun ve Linguise Magento web sitenizde sorunsuz bir şekilde çalışabilmesi için URL yeniden yazma ayarlarını yapmaya devam edin.
URL yeniden yazma ayarlarını yapın
Yönetici panelinde, Mağazalar > Ayarlar > Yapılandırma > Genel > Web > Arama Motoru Optimizasyonu Web Sunucusu Yeniden Yazma Kullan etkinleştirin . Daha fazla bilgi için resmi Magento belgelerine

Dil bazında URL ayarlarının .htaccess dosyasında yapılması gerekiyor. Varsayılan Magento 2 “ RewriteEngine on ” :
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]
Son olarak, Magento .htaccess dosyanız aşağıdaki gibi görünmelidir:

Dil değiştiriciyi etkinleştirin
Linguise JS betiğini yükleyin
Artık çevrilmiş tüm sayfalarınızı şu URL'yi kullanarak yükleyebilirsiniz: örneğin: www.shop.com/fr/

Dil değiştirme penceresi, istediğiniz dili seçmenizi sağlayan açılır bir penceredir. Bunu yüklemek için, web sitesi yapılandırmasının sonunda verilen kodu HTML sayfanızın <head> bölümüne kopyalamanız gerekecektir. Ardından, dil değiştirme penceresi otomatik olarak yüklenecektir.
Linguise kontrol panelinizde > Alan adınız > Ayarlar > Sekme: PHP Komut Dosyası bölümünde mevcuttur.

Sayfanızın başlığına yüklenmesi gerekiyor. Magento 2, yapılandırma ayarları aracılığıyla sayfanızın başlığına içerik ekleme olanağı sunuyor.

Yönetici panelinde İçerik > Yapılandırma , varsayılan mağaza tema görünümünüzü düzenleyin, ardından HTML Başlık bölümüne ve kopyaladığınız betiği Komut Dosyaları ve Stil Sayfaları girişine ekleyin. Son olarak, yapılandırmayı kaydedin.

Magento güvenlik modülünü yükleyin
Magento 2.3.5 sürümünden itibaren, Magento Linguise alan adından dosya yüklemesine izin vermek için bir güvenlik modülü eklemeniz gerekiyor. Magento aşina iseniz bu bir sorun olmayacaktır, aksi takdirde işte adım adım bir kılavuz:
- Modülü bu bağlantıdan
- Zip dosyasının içeriğini Magento kurulumunuzdaki app/code/ dizinine çıkarın
- Ardından şu komutları çalıştırın:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
Dil değiştirme düğmesi, varsayılan olarak web sitenizin sağ alt köşesinde kayan bir konumda görüntülenecektir. Bunu Linguise kontrol panelinden özelleştirebilirsiniz.

SEO için önemli not: Kurduğunuz dil sayısı SEO üzerinde büyük bir etkiye sahiptir. Çeviri dillerinizi kurduğunuzda, çok sayıda dizine eklenmiş sayfanız (>500) varsa, arama motorunun bunları işlemesi çok zaman alabilir. Bu, orijinal dilinizdeki SEO'nuzu etkileyebilir. Bu nedenle, başlangıçta en fazla 5 dil eklemenizi, ardından dizine eklendikten sonra ayda 3'er dil ekleyerek devam etmenizi öneririz.
Dil değiştiriciyi kurun
Dil değiştirme özelliği, Linguise kontrol panelinden > Ayarlar > Dil bayrakları görüntüleme bölümünden özelleştirilebilir. Burada yapılan her değişiklik web sitesine de yansıtılacaktır.

Ekranın sağ tarafında dil değiştirici önizlemesi yer almaktadır. İşte ayarlayabileceğiniz öğeler:
- 3 düzen: yan yana, açılır menü veya açılır pencere
- Dil değiştirici konumu
- Dil değiştirici içerik
- Dil adları İngilizce veya yerel dilde
- Bayrak şekilleri ve boyutu
- Renkler ve kutu gölgesi
Magento içeriğine dil değiştiriciyi yükleyin

Magento içeriğinde belirli bir yerde görüntülemek için , konumu "Yerinde" olarak ayarlamanız gerekir. Linguise
panelinde konumu ayarladıktan sonra , aşağıdaki kısa kodu ekleyerek özelliği dahil edebilirsiniz. Kodu panonuza kopyalamak için aşağıdaki koda tıklayın.
[linguise]
Eklendikten sonra, ön uçta, kodu eklediğiniz HTML alanında bayrak ve dil adları görüntülenecektir.
Yerel önbellek sistemini etkinleştirin
İsteğe bağlı olarak, sayfaları daha hızlı sunmak için URL'leri ve ilgili çok dilli içeriği depolayan yerel bir önbellek sistemini etkinleştirebilirsiniz. Yerel önbellek, Linguise sunucusu ile web sitenizin sunucusu arasındaki veri aktarımını azaltacaktır. Önbellek yalnızca bir sayfa zaten çevrilmiş ve güncellenmemiş olduğunda kullanılır. Öncelikli olarak saklanan önbellek, en çok görüntülenen çok dilli sayfaların önbelleği olacaktır.

İsteğe bağlı olarak, saklanacak önbellek miktarını MB cinsinden tanımlayabilirsiniz. Aşağıdaki örnekte önbellek etkinleştirilmiş ve saklanacak önbellek miktarı 500 MB olarak belirlenmiştir:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte