جدول المحتويات
المتطلبات الفنية لـ TYPO3 CMS
ستتطلب الترجمة التلقائية العصبية المستخدمة مع TYPO3 CMS استخدام برنامج PHP النصي (يمكن تنزيله أدناه). لتثبيت البرنامج النصي Linguise ، ستحتاج إلى المتطلبات التالية:
- قم بتشغيل PHP 7+
- خادم Apache و LiteSpeed و NGINX و IIS
- تأكد من تنشيط إعادة كتابة عنوان URL على الخادم الخاص بك
- TYPO3 CMS 9 وما فوق
1. إنشاء مفتاح API
بعد ذلك ستحصل على:
- مفتاح API الذي يتحقق من عضويتك
- الرابط إلى نص Linguise لمحوّل اللغة
مفتاح API هو المطلوب لتنشيط الترجمة على موقع TYPO3 CMS الخاص بك. في الأساس، سيتحقق مفتاح API من اللغة التي تم تنشيطها في نطاقك ويسمح بالترجمة التلقائية للمحتوى.
في الوقت الحالي ، يمكنك نسخ مفتاح API والاحتفاظ به في الحافظة الخاصة بك.
2. قم بتحميل وتوصيل نص ترجمة Linguise
يجب تحميل البرنامج النصي للترجمة Linguise على الخادم الخاص بك حيث تم تثبيت TYPO3 CMS:
بعد تنزيل البرنامج النصي، قم بفك ضغطه وتحميله إلى المجلد الجذر حيث تم تثبيت TYPO3 CMS.
- تأكد من وجوده في المستوى الجذر لموقع الويب الخاص بك (حيث توجد ملفات TYPO3
- تأكد من احتفاظ المجلد باسمه الافتراضي " linguise "
يجب نسخ مفتاح Linguise API إلى ملف Linguise الذي قمت بتحميله إلى الخادم الخاص بك ، وقم بتحرير الملف ونسخ مفتاح API الخاص بك بين علامات الاقتباس البسيطة ، واستبدل النص REPLACE_BY_TOUR TOKEN.
3. قم بإعداد إعادة كتابة عناوين URL الخاصة TYPO3 CMS
بشكل افتراضي، تكون إعادة كتابة عنوان URL نشطة في TYPO3 CMS. إذا لم يكن الأمر كذلك، فيمكنك تنشيطه من مزود الاستضافة الخاص بك.
يجب تكوين عنوان URL حسب اللغة في ملف htaccess. ما عليك سوى نسخ الكود أدناه بعد الكود " RewriteEngine on " TYPO3 CMS الافتراضي .
# 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
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]
أخيرًا، يجب أن يبدو ملف .htaccess الخاص بـ TYPO3 CMS كما يلي:
# Set PHP version to 7.4
AddHandler application/x-httpd-php74 .php
# 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]
يمكنك الآن تحميل جميع صفحاتك المترجمة باستخدام عنوان URL ، على سبيل المثال: www.shop.com / fr /
لنقم الآن بتحميل محوّل اللغة.
4. قم بتنشيط محوّل اللغة
4.1 قم بتحميل سكربت Linguise JS
يجب تحميل رابط البرنامج النصي Linguise JS على جميع صفحات TYPO3 CMS الخاصة بك لعرض محوّل اللغة مع العلامات وعناوين URL البديلة في رؤوس HTML (لأغراض تحسين محركات البحث).
لنسخ رابط البرنامج النصي ، من لوحة معلومات Linguise ، انتقل إلى إعدادات النطاق وانسخ رابط البرنامج النصي.
أسهل طريقة لتحميل هذا الرمز في TYPO3 CMS هي إضافته داخل رأس موقع الويب الخاص بك أو شفرة. TYPO3 CMS مزودًا ببيئة خاصة ويجب عليه إنشاء ملف محدد لإضافة برنامج نصي إلى الرأس.
ويمكنك تحقيق ذلك باتباع الخطوات التالية:
- تسجيل الدخول إلى مسؤول Typo3
- حدد " الصفحة " > " +المحتوى " > انقر فوق علامة تبويب العناصر الخاصة > HTML العادي
قم بتحرير ملف البرنامج النصي لتضمين رابط البرنامج النصي في قسم كود HTML كما هو موضح أدناه.
سيتم عرض محوّل اللغة افتراضيًا في موضع علوي يمين عائم على موقع الويب الخاص بك. نرحب بك لتخصيصه كما هو موضح في الفصل التالي.
ملاحظة مهمة بشأن تحسين محركات البحث: عدد اللغات التي تقوم بإعدادها له تأثير كبير على تحسين محركات البحث. عند إعداد لغات الترجمة الخاصة بك ، إذا كان لديك عدد كبير من الصفحات المفهرسة (> 500) ، فقد يستغرق محرك البحث وقتًا طويلاً لمعالجتها. قد يؤثر ذلك على مُحسّنات محرّكات البحث بلغتك الأصلية. لهذا السبب نوصي بإضافة 5 لغات كحد أقصى في البداية ، ثم عند فهرستها ، يمكنك إضافة لغات في دفعة من 3 لغات شهريًا.
قم بإعداد محوّل اللغة في TYPO3 CMS
يمكن تخصيص محوّل اللغة من لوحة معلومات Linguise > الإعدادات> عرض أعلام اللغة. سينعكس كل تعديل هنا على الموقع.
على الجانب الأيمن من الشاشة لديك معاينة لمحوّل اللغة. فيما يلي العناصر التي يمكنك إعدادها:
- 3 تخطيطات: جنبًا إلى جنب أو قائمة منسدلة أو منبثقة
- موضع محوّل اللغة
- محتوى محوّل اللغة
- أسماء اللغات باللغة الإنجليزية أو اللغة الأم
- أشكال الأعلام وحجمها
- الألوان وظل الصندوق
قم بتحميل محوّل اللغة في محتوى TYPO3 CMS
لعرض محوّل اللغة في مكان محدد، في TYPO3 ، يجب عليك تعيين الموضع على أنه "في المكان".
بمجرد قيامك بتعيين الموضع في Linguise ، يمكنك إضافة الرمز القصير أدناه لتضمينه. انقر على الرمز أدناه لوضعه في الحافظة الخاصة بك.
بمجرد إضافتها، سيكون لديك في الواجهة الأمامية العلم وأسماء اللغات معروضة في منطقة HTML التي قمت بإضافة الكود إليها.
قم بتنشيط خيار نظام التخزين المؤقت المحلي
كخيار ، يمكنك تنشيط نظام ذاكرة تخزين مؤقت محلي يخزن عناوين URL ومحتوياتها متعددة اللغات ذات الصلة لخدمة الصفحات بشكل أسرع. ستوفر ذاكرة التخزين المؤقت المحلية بعض عمليات نقل البيانات بين خادم Linguise وخادم موقع الويب الخاص بك. يتم استخدام ذاكرة التخزين المؤقت فقط عندما تكون الصفحة قد تمت ترجمتها بالفعل ولم يتم تحديثها. ستكون ذاكرة التخزين المؤقت ذات الأولوية هي ذاكرة التخزين المؤقت للصفحات متعددة اللغات الأكثر مشاهدة.
لاستكمال ذلك ، يمكنك تحديد مقدار ذاكرة التخزين المؤقت المخزنة بالميغابايت. في المثال التالي ، يتم تنشيط ذاكرة التخزين المؤقت ويبلغ حجم ذاكرة التخزين المؤقت التي يجب الاحتفاظ بها 500 ميجابايت.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
الترجمة الآلية على خوادم NGINX
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
أضف السطر المقابل لمنشئ موقع الويب الخاص بك في ملف Web.config الخاص بك.
يجب تعيينه قبل أي إعادة توجيه أخرى ، وخاصة إعادة التوجيه إلى ملف PHP الرئيسي الخاص بك:
من SQLite إلى MySQL
لا يزال هناك إعداد في Configuration.php لفرض استخدام MySQL بدلاً من SQLite، في حالة عدم تثبيت SQLite على الخادم.
في هذه الحالة، ستحتاج إلى ملء معلومات MySQL في هذا الجزء من ملف Configuration.php:
/** 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 = '';