İçindekiler
Teknik gereksinimler
Linguise çeviri betiğini çalıştırmak için aşağıdakilere ihtiyacınız olacak:
- PHP 7+ ve Laravel sürümlerini çalıştırın
- Apache, LiteSpeed, NGINX, IIS sunucusu
- Sunucu yapılandırmanızda URL yeniden yazmayı etkinleştirin
- Laravel public bulunur Linguise bu klasörün içine 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 sitenizde çeviriyi etkinleştirmek için gereken şeydir. Temel olarak, API anahtarı hangi alanda hangi dilin etkinleştirildiğini kontrol edecek ve sinirsel ç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 betiği, Laravel kurulu olduğu klasöre, sunucunuza yüklenmelidir; buradan indirebilirsiniz:
Komut dosyası 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 dizininde olduğundan emin olun (genellikle Laravel kök dizini " public Linguise oraya kurabilirsiniz
- Klasörün adının " linguise " olduğundan emin olun (klasör sıkıştırılmış dosyadan çıkarıldığında varsayılan ad budur).
Linguise Script Arabirimine Nasıl Erişilir?
Linguise tamamladıktan sonra , web sitenizi aşağıdaki URL formatıyla ziyaret ederek gösterge tablosuna erişebilirsiniz:
https://www.domain.com/ linguise
Alan Adresini Web sitenize göre değiştirin*
Linguise uygun okuma ve yazma iznine sahip olduğundan emin olun
Şifre ve veritabanı bağlantısını ayarlayın
Komut dosyası arayüzüne eriştikten sonra, bir şifre oluşturabileceğiniz ve tercih ettiğiniz veritabanına bağlanabileceğiniz bir kurulum ekranı sunulacaksınız.
Yapabilirsiniz:
- Bu arayüze gelecekteki erişim için gerekli olacak bir şifre ayarlayın.
- Kurulumunuza ve tercihinize bağlı olarak veritabanı türünüzü seçin - MySQL veya SQLITE.
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ının aşağıdaki bağlantı ayrıntılarını 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 vs SQLite - Fark nedir?
Hem MySQL hem de SQLite, web siteleri ve uygulamalar için verileri depolamak ve yönetmek için kullanılan popüler veritabanı sistemleridir. Ancak, farklı kullanım durumları için tasarlanmıştır ve bazı önemli farklılıklar vardır:
| Özellik | Sqlite | MySQL |
|---|---|---|
| Kurmak | Çok kolay (SQLITE kurulumu gerekli) | Sunucu kurulumu gerektirir |
| Depolamak | Tek dosya | MySQL Server tarafından yönetildi |
| Performans | Küçük ölçekli uygulamalar için harika | Büyük, yüksek trafikli sistemler için daha iyi |
| Kullanım örneği | Yerel uygulamalar, testler, küçük siteler | Web Uygulamaları, E -Ticaret, Kurumsal Sistemler |
Linguise Script Arayüzü: PHP Platformu için Kurulum
Daha önce yalnızca Joomla ve WordPressiçin mevcut olan Linguise Tercüme Gösterge Tablosu, şimdi PHP'ye ve ek platformlara desteği genişletiyor. Bu güncelleme, kullanıcıların CM'lerinden veya çerçevelerine bakılmaksızın, doğrudan birleştirilmiş bir arayüzden doğrudan birleştirilmiş bir arayüzden dil ayarlarını (ekran seçenekleri, bayrak stilleri ve görünüm özelleştirmesi gibi) sorunsuz bir şekilde yapılandırmasına olanak tanır.
Yöneticiler, dil seçimi açılır pencereleri, gölge efektleri ve bölgeye özgü bayrak seçenekleri varyantları gibi tutarlı özelliklerle Linguise ortamlarını daha verimli bir şekilde yönetebilir. Gösterge tablosu, çeşitli web ortamları için daha geniş uyumluluk sunarken kullanıcı dostu tasarımını korur.
3. Dil URL'lerini ayarlayın
Dil bazında URL yapılandırması .htaccess dosyasında yapılmalıdır; eğer dosyanızda "RewriteBase /" varsa, aşağıdaki kodun tamamını ondan sonra 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çmenizi sağlayan açılır penceredir. Bunu yüklemek için, web sitesi yapılandırmasının sonunda verilen kodu kopyalamanız gerekecektir (Linguise kontrol paneli).
Bu betik, Laraveltarafından işlenen HTML sayfalarınızın <head> bölümüne yüklenmelidir. Ardından, dil değiştirme bayrağı otomatik olarak yüklenecektir.
Dil değiştirme düğmesi varsayılan olarak web sitenizin sağ üst köşesinde kayan bir konumda görüntülenecektir. Bunu 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
Laravel içeriğinde dil değiştiriciyi 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 , aşağıdaki kısa kodu ekleyerek dahil edebilirsiniz. Kodu panonuza kopyalamak için aşağıdaki koda tıklayın.
<div>[linguise]</div>
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, CMS veya CMS dışı sistemler için belirli yapılandırmaları geçirmeye olanak tanıyan bir ayar da bulunmaktadır. Varsayılan olarak otomatiktir, ancak destek ekibi bazı özel ayarları kullanmak için kişiselleştirmenizi isteyebilir.
Laravel için eklemeniz gereken kod , bu da küçük harflerle yazılmış CMS adı:
/** 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 ve 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;