İçindekiler
TYPO3 CMS teknik gereksinimleri
TYPO3 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, LiteSpeed, NGINX, IIS sunucusu
- URL yeniden yazmanın sunucunuzda etkinleştirildiğinden emin olun
- TYPO3 CMS 9 ve üzeri
1. 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ı, TYPO3 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.
2. Linguise çeviri komut dosyasını yükleyin ve bağlayın
Linguise çeviri komut dosyasının TYPO3 CMS'nin kurulu olduğu sunucunuza yüklenmesi gerekir:
Betik indirildikten sonra sıkıştırılmış dosyayı açın ve TYPO3 CMS'nin kurulu olduğu kök klasöre yükleyin.
- Web sitenizin kök düzeyinde olduğundan emin olun TYPO3 CMS dosyalarınızın bulunduğu yer)
- Klasörün " linguise " varsayılan adını koruduğundan
Linguise sunucunuza yüklediğiniz Configuration.php dosyasına kopyalanması gerekecek Linguise
3. TYPO3 CMS URL'lerinin yeniden yazılmasını ayarlayın
Varsayılan olarak URL yeniden yazma özelliği TYPO3 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 TYPO3 CMS “ RewriteEngine on ” kodunun ardından aşağıdaki kodu kopyalamanız yeterlidir .
# Set PHP version to 7.4 >> Please Add this code before the Rewrite rules to ensure Linguise works in PHP v7.4
AddHandler application/x-httpd-php74 .php
<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 TYPO3 CMS .htaccess dosyanız şöyle görünmelidir:
# Set PHP version to 7.4
AddHandler application/x-httpd-php74 .php
<IfModule mod_rewrite.c>
# Enable URL rewriting
RewriteEngine On
RewriteBase /typo10/ # Set the RewriteBase to the subfolder
# Add a condition to check if the request starts with the subfolder
RewriteCond %{REQUEST_URI} !^/typo10/
# Rewrite requests that don't start with the subfolder to include it
RewriteRule ^(.*)$ /typo10/$1 [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-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)(?:$|/)(.*)$ /typo10/linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
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.
4. Dil değiştiriciyi etkinleştirin
4.1 Linguise JS betiğini 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 JS komut dosyası bağlantısının tüm TYPO3 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.
TYPO3 CMS'ye yüklemenin en kolay yolu , onu web sitenizin başlığına veya kod. TYPO3 CMS özel bir ortamla birlikte gelir ve başlığa bir komut dosyası eklemek için belirli bir dosya oluşturması gerekir.
Aşağıdaki adımları izleyerek bunu başarabilirsiniz:
- Typo3 giriş yapın ,
- “ Sayfa ” > “ +İçerik ”i seçin > Özel öğeler sekmesine tıklayın > Düz HTML
Komut dosyası bağlantısını aşağıdaki gibi HTML kodu 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.
TYPO3 CMS'de 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 TYPO3 CMS içeriğine yükleyin
TYPO3 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 = '';