MODX İçerik Yönetimi Çerçevesi ile kullanılacak otomatik çeviri, PHP betiğinin kullanılmasını gerektirecektir (aşağıdan indirilebilir). Linguise betiğini yüklemek için aşağıdaki gereksinimlere ihtiyacınız olacak:
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:
API anahtarı, MODX 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 komut dosyasının MODX CMS'nin kurulu olduğu sunucunuza yüklenmesi gerekir:
Betik indirildikten sonra sıkıştırılmış dosyayı açın ve MODX CMS'nin kurulu olduğu kök klasöre yükleyin.
Linguise sunucunuza yüklediğiniz Configuration.php dosyasına kopyalanması gerekecek Linguise
Varsayılan olarak, URL yeniden yazma özelliği MODX CMS'de zaten 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. MODX CMS dosyasında bulunan “ 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>
Son olarak, MODX CMS .htaccess dosyanız şöyle görünmelidir:
<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> # Prevent rewrite the .well-known directory used by LetsEncrypt by rules below of this rule RewriteRule "^\.well-known/" - [L] # Prevent dot directories (hidden directories like .git) to be exposed to the public # Except for the .well-known directory used by LetsEncrypt a.o RewriteRule "/\.|^\.(?!well-known/)" - [F]
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 HTML başlıklarınızda bayraklar ve alternatif URL'lerle görüntülemek için (SEO amacıyla) Linguise JS komut dosyası bağlantısının tüm MODX 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.
MODX CMS'ye yüklemenin en kolay yolu , onu web sitenizin başlığına eklemek veya kod.
Bunu başarmak için MODX Yöneticisi sayfalarını / yönetici sayfalarını açın. Daha sonra Elements'a gidin, BaseTemplate'i Şablon Kodu (HTML) görüntülenecektir kodu, komut dosyası bağlantısını başlık koduna dahil edecek şekilde düzenleyin.
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 HTML sayfanızın başına kopyalamanız 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. 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ş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:
MODX 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.
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
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;
