İçindekiler
Teknik gereksinimler
Linguise çeviri komut dosyasını çalıştırmak için aşağıdakilere ihtiyacınız olacak:
- PHP 7+ ve Laravel çalıştırın
- Apache, LiteSpeed, NGINX, IIS sunucusu
- Sunucu yapılandırmanızda URL yeniden yazmayı etkinleştirin
- Laravel kök klasörü genellikle " public Linguise bu klasöre kurduğunuzdan emin olun
1. API Anahtarını oluşturun
Linguise kontrol panelinize bağlandıktan sonra , API Anahtarını almak için önce yeni bir alan adı kurmanız ve ayarlarını kaydetmeniz gerekir.
API anahtarı, web sitenizdeki çeviriyi etkinleştirmek için gereken şeydir. Temel olarak, API anahtarı hangi dilin hangi alanda etkinleştirildiğini kontrol edecek ve nöral çeviri sayfalarının oluşturulmasına izin verecektir.
API Anahtarını kopyalayın ve panonuzda tutun.
Daha sonra “Script PHP” sekmesine tıklayarak, burada detaylarıyla takip edeceğimiz kurulum talimatlarını alacaksınız.
2. Linguise çeviri komut dosyasını yükleyin ve bağlayın
Linguise çeviri komut dosyasının sunucunuza yüklenmesi gerekiyor, Laravel kurulu olduğu klasörde, buradan indirilebilir:
Betik indirildikten sonra sıkıştırılmış dosyayı açın ve Laravel kurulu olduğu kök klasöre yükleyin.
- Laravel kurulumunuzun kök seviyesinde olduğundan emin olun (genellikle Laravel kökü “ public burada Linguise kurabilirsiniz
- linguise olarak adlandırıldığından emin olun (klasör varsayılan ad)
Linguise sunucunuza yüklediğiniz …/ linguise /Configuration.php klasörüne kopyalanması gerekecek Linguise
3. Dil URL'lerini ayarlayın
Dile göre URL'nin .htaccess dosyasında yapılandırılması gerekir, eğer dosyanızda bir "RewriteBase /" varsa, bundan sonra aşağıdaki tüm kodu kopyalayın:
<IfModule mod_rewrite.c>
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]
</IfModule>
4. Laravel dil değiştiriciyi etkinleştirin
Dil değiştirici, istediğiniz dili seçmek için açılan bayrak penceresidir. Yüklemek için, web sitesi yapılandırmasının sonunda verilen kodu kopyalamanız gerekir (Linguise kontrol paneli).
Betiğin Laraveltarafından işlenen HTML sayfalarınızın başlığına yüklenmesi gerekir. Bayrak dili değiştirici daha sonra otomatik olarak yüklenecektir.
Dil değiştirici, varsayılan olarak web sitenizde kayan bir sağ üst konumda görüntülenecektir. CSS ile dilediğiniz gibi özelleştirebilirsiniz.
SEO için önemli not: Kurduğunuz dil sayısının SEO üzerinde büyük etkisi vardır. Çeviri dillerinizi ayarladığınızda, çok sayıda dizine alınmış sayfanız varsa (>500), arama motorunun bunları işlemesi çok zaman alabilir. SEO'nuzu orijinal dilinizde etkileyebilir. Bu nedenle, ilk başta en fazla 5 dil eklemenizi öneririz, ardından dizine eklendiğinde, dilleri ayda 3'lük bir grup halinde ekleyebilirsiniz.
Dil değiştiriciyi kurun
Dil değiştirici, Linguise panosu > Ayarlar > Dil bayrakları ekranından özelleştirilebilir. Buradaki her değişiklik web sitesine yansıtılacaktır.
Ekranın sağ tarafında, dil değiştiricinin önizlemesini görürsünüz. Kurabileceğiniz öğeler şunlardır:
- 3 düzen: yan yana, açılır veya açılır pencere
- Dil değiştirici konumu
- Dil değiştirici içeriği
- İngilizce veya ana dilde dil adları
- Bayrak şekilleri ve boyutu
- Renkler ve kutu gölgesi
Dil değiştiriciyi Laravel içeriğine yükleyin
Laravel içeriğinde belirli bir yerde görüntülemek için konumu “Yerinde” olarak ayarlamanız gerekir. Linguise
panelinde konumu ayarladıktan sonra , eklemek için aşağıdaki kısa kodu ekleyebilirsiniz. Aşağıdaki kodu panonuza eklemek için tıklayın.
Eklendikten sonra ön uçta, kodu eklediğiniz HTML alanında bayrak ve dil adları görüntülenir.
Laravel sayfaları için yerel önbellek sistemi
Bir seçenek olarak, sayfaların daha hızlı sunulması için URL'leri ve ilgili çok dilli içeriği depolayan yerel bir önbellek sistemini etkinleştirebilirsiniz. Yerel önbellek, Linguise sunucusu ile web sitesi sunucunuz arasındaki bazı veri aktarımlarını kaydedecektir. Önbellek yalnızca bir sayfa çevrildiğinde ve güncellenmediğinde kullanılır. Öncelikli tutulan önbellek, en çok görüntülenen çok dilli sayfaların önbelleği olacaktır.
Bir seçenek olarak, MB cinsinden saklanan önbellek miktarını tanımlayabilirsiniz. Aşağıdaki örnekte, önbellek etkinleştirilmiştir ve tutulacak önbellek miktarı 500 MB'dir:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Laravel Platformu için özel ayarlar
Configuration.php dosyasında ayrıca CMS veya CMS dışı için bazı özel konfigürasyonların aktarılmasına izin veren bir ayarımız vardır. Varsayılan olarak otomatiktir, ancak destek ekibi sizden bazı özel ayarları kullanacak şekilde kişiselleştirmenizi isteyebilir.
Laravel için eklenecek kod , bu CMS adının küçük harfidir:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
SQLite'tan MySQL'e
Yine de Configuration.php dosyasında, SQLite'ın sunucuda kurulu olmaması durumunda, SQLite yerine MySQL kullanımını zorunlu kılan bir ayar bulunmaktadır.
Configuration.php dosyasının bu bölümündeki MySQL bilgilerini doldurmanız gerekecektir
/** 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 = '';
Laravel + Windows IIS sunucularında otomatik çeviri
Web sitesi oluşturucunuza karşılık gelen satırı Web.config dosyanıza ekleyin.
Diğer yönlendirmelerden önce, özellikle PHP ana dosyanıza yönlendirmeden önce ayarlanmalıdır:
<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>
Laravel + NGINX sunucularında otomatik çeviri
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;