İçindekiler
Kirby CMS teknik gereksinimleri
Kirby CMS ile kullanılacak sinirsel otomatik çeviri, PHP betiğini kullanmayı gerektirecektir (aşağıdan indirilebilir). Linguise betiğini yüklemek için aşağıdaki gereksinimlere ihtiyacınız olacak:
- PHP 7+ sürümünü çalıştırın
- Apache, IIS veya NGINX sunucusu
- URL yeniden yazmanın sunucunuzda etkinleştirildiğinden emin olun
API Anahtarını oluşturun
Linguise kontrol panelinize bağlandıktan veya kaydolduktan sonra , API Anahtarını almak için önce yeni bir alan adı oluşturmanız ve ayarlarını kaydetmeniz gerekir.
Bu dokümantasyon ve kaynak ve hedef diller gibi Linguise kayıt etki alanına devam etmek için “Diğer PHP” platformunu seçebilirsiniz.
Bundan sonra şunları alacaksınız:
- Üyeliğinizi doğrulayan API anahtarı
- Dil değiştirici için Linguise komut dosyasına bağlantı
API anahtarı, Kirby CMS web sitenizdeki çeviriyi etkinleştirmek için gerekli olan şeydir. Temel olarak API anahtarı, alan adınızda hangi dilin etkinleştirildiğini kontrol eder ve içeriğin otomatik olarak çevrilmesine olanak tanır.
Şimdilik, API Anahtarını kopyalayabilir ve panonuzda tutabilirsiniz.
Linguise çeviri betiğini yükleyin ve bağlayın
Linguise çeviri komut dosyasının Kirby CMS'nin kurulu olduğu sunucunuza yüklenmesi gerekir. Buradan indir.
Betik indirildikten sonra sıkıştırılmış dosyayı açın ve Kirby CMS'nin kurulu olduğu kök klasöre yükleyin.
- Web sitenizin kök seviyesine yerleştirildiğinden emin olun
- Klasörün " linguise " varsayılan adını koruduğundan
Linguise sunucunuza yüklediğiniz Configuration.php dosyasına kopyalanması gerekecek Linguise
Kirby CMS URL'lerinin yeniden yazılmasını ayarlayın
Varsayılan olarak, URL yeniden yazma özelliği Kirby CMS'de etkindir. Aksi takdirde barındırma sağlayıcınızdan etkinleştirebilirsiniz.
URL'nin dile göre .htaccess'te yapılandırılması gerekir. Varsayılan Kirby CMS “ RewriteEngine on ” kodunun ardından aşağıdaki kodu kopyalamanız yeterlidir .
<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>
Artık çevrilmiş tüm sayfalarınızı URL'yi kullanarak yükleyebilirsiniz, örneğin: www.shop.com /fr/
Şimdi dil değiştiriciyi yükleyelim.
Dil değiştiriciyi etkinleştir
Linguise Javascript'i yükleyin
Dil değiştiriciyi HTML başlıklarınızda bayraklar ve alternatif URL'lerle görüntülemek için (SEO amacıyla) Linguise Javascript bağlantısının tüm Kirby CMS sayfalarınıza yüklenmesi gerekir.
Komut dosyası bağlantısını kopyalamak için, Linguise panosundan etki alanı ayarlarına gidin ve komut dosyası bağlantısını kopyalayın.
Bu kodu Kirby CMS'ye yüklemenin en kolay yolu, onu web sitenizin başlığına.php veya kodu.
Bunu şu adımları izleyerek ayarlayabilirsiniz: Kök klasöre Site > Parçacıklar > başlık.php dosyasına gidin . Varsayılan olarak bu yöntemi kullanabilirsiniz.
Komut dosyası bağlantısını aşağıdaki gibi başlık bölümüne dahil edecek şekilde düzenleyin.
Dil değiştirici, varsayılan olarak web sitenizde kayan bir sağ üst konumda görüntülenecektir. Bir sonraki bölümde açıklandığı 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 Kirby CMS içeriğine yükleyin
Dil değiştiriciyi CMS 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.
Yerel önbellek sistemi seçeneğini etkinleştirin
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.
Bunu tamamlamak için MB'de 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
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;
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>
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 = '';