قم بتثبيت الترجمة التلقائية Linguise على نظام إدارة المحتوى TYPO3

المتطلبات الفنية لنظام إدارة المحتوى TYPO3

يتطلب استخدام الترجمة الآلية العصبية مع نظام إدارة المحتوى TYPO3 استخدام سكربت PHP (يمكن تنزيله أدناه). لتثبيت سكربت Linguise ، ستحتاج إلى المتطلبات التالية:

قم بتشغيل PHP 7+
خادم Apache، LiteSpeed، NGINX، IIS
تأكد من تفعيل إعادة كتابة عناوين URL على خادمك
نظام إدارة المحتوى TYPO3 الإصدار 9 وما فوق

1. إنشاء مفتاح API

بعد اتصالك أو تسجيلك في لوحة تحكم Linguise ، ستحتاج إلى إعداد نطاق جديد أولاً وحفظ إعداداته للحصول على مفتاح API.

يمكنك اختيار منصة "PHP أخرى" للمتابعة في تسجيل نطاق Linguise ، كما هو الحال في هذه الوثائق ولغات المصدر والوجهة.

بعد ذلك ستحصل على:

مفتاح API الذي يتحقق من عضويتك
رابط نص Linguise الخاص بمبدل اللغة

مفتاح API هو المطلوب لتفعيل الترجمة على موقعك الإلكتروني المبني على نظام إدارة المحتوى TYPO3 . ببساطة، يتحقق مفتاح API من اللغة المُفعّلة على نطاقك، مما يسمح بالترجمة التلقائية للمحتوى.

في الوقت الحالي، يمكنك نسخ مفتاح API والاحتفاظ به في الحافظة.

2. قم بتحميل وتوصيل نص ترجمة Linguise

يجب تحميل برنامج الترجمة Linguise على الخادم الخاص بك حيث تم تثبيت نظام إدارة المحتوى TYPO3 :

بعد تنزيل البرنامج النصي، قم بفك ضغطه وتحميله إلى المجلد الرئيسي حيث تم تثبيت نظام إدارة المحتوى TYPO3 .

تأكد من وجوده في المستوى الجذر لموقعك الإلكتروني (حيث توجد ملفات نظام إدارة المحتوى TYPO3
تأكد من أن المجلد يحتفظ باسمه الافتراضي " linguise ".

كيفية الوصول إلى واجهة برمجة النصوص Linguise ؟

بعد إتمام Linguise ، يمكنك الوصول إلى لوحة التحكم من خلال زيارة موقعك الإلكتروني باستخدام تنسيق عنوان URL التالي
linguise https://www.domain.com/linguise

غيّر عنوان النطاق ليتوافق مع عنوان موقعك الإلكتروني*
 تأكد من أن Linguise لديه صلاحيات القراءة والكتابة المناسبة*

إعداد كلمة المرور والاتصال بقاعدة البيانات

بمجرد دخولك إلى واجهة البرنامج النصي، ستظهر لك شاشة إعداد حيث يمكنك إنشاء كلمة مرور والاتصال بقاعدة البيانات المفضلة لديك.

أنت تستطيع:

قم بتعيين كلمة مرور، والتي ستكون مطلوبة للوصول إلى هذه الواجهة في المستقبل.
اختر نوع قاعدة البيانات الخاصة بك - إما MySQL أو SQLite، حسب إعدادك وتفضيلاتك.

يضمن هذا الإعداد الأولي الوصول الآمن ويسمح لك بتكوين البرنامج النصي وفقًا لبيئتك.

اتصال بقاعدة بيانات MySQL

إذا اخترت MySQL، فستظهر واجهة مختلفة تطلب تفاصيل الاتصال التالية لحقول تكوين MySQL أدناه:

تأكد من صحة المعلومات لإنشاء اتصال ناجح بقاعدة بيانات MySQL الخاصة بك.

MySQL مقابل SQLite - ما الفرق؟
يُعد كل من MySQL وSQLite نظامي قواعد بيانات شائعين يُستخدمان لتخزين وإدارة البيانات للمواقع الإلكترونية والتطبيقات. ومع ذلك، فقد صُمما لحالات استخدام مختلفة، ويختلفان في بعض الجوانب الرئيسية:

ميزة	SQLite	MySQL
يثبت	سهل للغاية (يتطلب تثبيت SQLite)	يتطلب إعداد الخادم
التخزين	ملف واحد	تتم إدارتها بواسطة خادم MySQL
الأداء	مثالي للتطبيقات الصغيرة	أفضل للأنظمة الكبيرة ذات حركة المرور العالية
حالة الاستخدام	تطبيقات محلية، اختبار، مواقع صغيرة	تطبيقات الويب، والتجارة الإلكترونية، وأنظمة المؤسسات

واجهة برمجة Linguise : إعداد لمنصة PHP

لوحة تحكم الترجمة Linguise ، التي كانت متاحة سابقًا فقط لمنصتي Joomla و WordPress، تدعم الآن لغة PHP ومنصات إضافية. يتيح هذا التحديث للمستخدمين ضبط إعدادات اللغة بسلاسة، مثل خيارات العرض وأنماط العلامات وتخصيص المظهر، مباشرةً من واجهة موحدة، بغض النظر عن نظام إدارة المحتوى أو إطار العمل المستخدم.

يستطيع المسؤولون إدارة إعدادات Linguise بكفاءة أكبر، بفضل ميزات متسقة مثل نوافذ اختيار اللغة المنبثقة، وتأثيرات الظل، وخيارات العلامات الخاصة بكل منطقة. تحافظ لوحة التحكم على تصميمها سهل الاستخدام مع توفير توافق أوسع مع بيئات الويب المتنوعة.

ندرك أن ضبط عناوين المواقع الإلكترونية وتغيير اللغة قد يكون معقدًا بعض الشيء؛ ولكن لدينا أخبار سارة! نقدم خدمة التثبيت مجانًا

اتصل بدعمنا الفني

3. إعداد إعادة كتابة عناوين URL في نظام إدارة المحتوى TYPO3

يتم تفعيل خاصية إعادة كتابة عناوين المواقع الإلكترونية (URL) افتراضياً في نظام إدارة المحتوى TYPO3 . إذا لم تكن كذلك، يمكنك تفعيلها من خلال مزود خدمة الاستضافة.

يجب ضبط عنوان URL حسب اللغة في ملف .htaccess. ما عليك سوى نسخ الكود أدناه بعد الكود " RewriteEngine on " الموجود في ملف .htaccess الافتراضي لنظام إدارة المحتوى TYPO3 .

				
					# 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>

وأخيرًا، يجب أن يبدو ملف .htaccess الخاص بنظام إدارة المحتوى TYPO3 الخاص بك على النحو التالي:

				
					# 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]

يمكنك الآن تحميل جميع صفحاتك المترجمة باستخدام عنوان URL، على سبيل المثال: www.shop.com /fr/

لنقم الآن بتحميل مُبدِّل اللغة.

اتصل بدعمنا الفني

4. فعّل مُبدِّل اللغة

4.1 تحميل سكربت Linguise JS

يجب تحميل رابط برنامج Linguise JS النصي على جميع صفحات TYPO3 CMS الخاصة بك لعرض مبدل اللغة مع العلامات وعناوين URL البديلة في رؤوس HTML الخاصة بك (لأغراض تحسين محركات البحث).

لنسخ رابط البرنامج النصي، انتقل من لوحة تحكم Linguise إلى إعدادات النطاق وانسخ رابط البرنامج النصي.

أسهل طريقة لتحميل هذا الكود في TYPO3 هي إضافته داخل رأس موقعك الإلكتروني أو يأتي نظام إدارة المحتوى TYPO3 ببيئة خاصة، ويتعين عليه إنشاء ملف محدد لإضافة نص برمجي إلى رأس الصفحة.

يمكنك تحقيق ذلك باتباع الخطوات التالية:

قم بتسجيل الدخول إلى Typo3 ،
حدد " الصفحة " > " +المحتوى " > انقر على علامة تبويب العناصر الخاصة > HTML عادي

قم بتعديل ملف البرنامج النصي لإضافة رابط البرنامج النصي في قسم كود HTML كما هو موضح أدناه.

سيظهر مُبدِّل اللغة افتراضيًا في أعلى يمين موقعك الإلكتروني. يمكنك تخصيصه كما هو موضح في الفصل التالي.

ملاحظة هامة لتحسين محركات البحث: يؤثر عدد اللغات التي تُضيفها بشكل كبير على تحسين محركات البحث. عند إعداد لغات الترجمة، إذا كان لديك عدد كبير من الصفحات المفهرسة (أكثر من 500 صفحة)، فقد يستغرق محرك البحث وقتًا طويلاً لمعالجتها، مما قد يؤثر سلبًا على تحسين محركات البحث في لغتك الأصلية. لذا، ننصح بإضافة 5 لغات كحد أقصى في البداية، ثم بعد اكتمال فهرسة الموقع، يمكنك إضافة 3 لغات على دفعات شهرية.

قم بإعداد مُبدِّل اللغة في نظام إدارة المحتوى TYPO3

يمكن تخصيص مُبدِّل اللغة من لوحة تحكم Linguise > الإعدادات > عرض علامات اللغة. ستنعكس جميع التعديلات التي تُجرى هنا على الموقع الإلكتروني.

على الجانب الأيمن من الشاشة، ستجد معاينة لمبدل اللغة. إليك العناصر التي يمكنك ضبطها:

3 تخطيطات: جنبًا إلى جنب، أو منسدلة أو منبثقة
موقع مبدل اللغة
محتوى مفتاح تبديل اللغة
أسماء اللغات باللغة الإنجليزية أو اللغة الأم
أشكال الأعلام والحجم
الألوان وظل الصندوق

قم بتحميل أداة تبديل اللغة في محتوى نظام إدارة المحتوى TYPO3

لعرض مُبدِّل اللغة في مكان مُحدد ضمن TYPO3 ، يجب ضبط الموضع على "في مكانه".
بعد ضبط الموضع في Linguise ، يُمكنك إضافة الرمز المختصر أدناه لتضمينه. انقر على الرمز أدناه لنسخه إلى الحافظة.

				
					<div>&#091;linguise&#093;</div>

بمجرد إضافته، ستظهر لك أسماء العلم واللغة في واجهة المستخدم في منطقة HTML التي أضفت إليها الكود.

تفعيل خيار نظام التخزين المؤقت المحلي

كخيار إضافي، يمكنك تفعيل نظام التخزين المؤقت المحلي الذي يخزن عناوين URL ومحتواها متعدد اللغات لتسريع تحميل الصفحات. سيساهم التخزين المؤقت المحلي في تقليل نقل البيانات بين خادم Linguise وخادم موقعك الإلكتروني. يُستخدم التخزين المؤقت فقط عندما تكون الصفحة مترجمة مسبقًا ولم يتم تحديثها. وستكون الأولوية في التخزين المؤقت للصفحات متعددة اللغات الأكثر مشاهدة.

بالإضافة إلى ذلك، يمكنك تحديد حجم ذاكرة التخزين المؤقت المخزنة بالميغابايت. في المثال التالي، تم تفعيل ذاكرة التخزين المؤقت، وحجمها المطلوب الاحتفاظ به هو 500 ميغابايت.

				
					    /** Basic configuration **/
    public $cache_enabled = true;
    public $cache_max_size = 500; // In megabyte

الترجمة التلقائية على خوادم NGINX

أضف السطر المقابل لنظام إدارة المحتوى الخاص بك في قسم تكوين خادم NGINX.

يجب ضبطه قبل أي عملية إعادة توجيه أخرى، وخاصة إعادة التوجيه في ملف PHP الرئيسي الخاص بك.

				
					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;

الترجمة التلقائية على خوادم ويندوز IIS

أضف السطر الخاص بمنشئ موقعك الإلكتروني في ملف Web.config.
يجب ضبطه قبل أي عملية إعادة توجيه أخرى، وخاصةً إعادة التوجيه إلى ملف PHP الرئيسي.

				
					<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}&amp;original_url={R:2}" appendQueryString="true" />
</rule>

من 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 = '';