قم بتثبيت برنامج الترجمة الآلية Linguise على نظام إدارة التعلم Moodle

جدول المحتويات

المتطلبات الفنية لنظام إدارة التعلم Moodle

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

  • قم بتشغيل PHP 7+
  • خادم Apache أو IIS أو NGINX
  • تأكد من تفعيل إعادة كتابة عناوين URL على خادمك

قم بإنشاء مفتاح API

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

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

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

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

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

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

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

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

يجب تحميل برنامج الترجمة Linguise على خادمك حيث تم تثبيت نظام إدارة التعلم Moodle . حمّله من هنا.

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

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

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

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

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

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

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

أنت تستطيع:

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

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

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

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

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

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

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

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

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

واجهة برمجة التطبيقات

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

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

إعداد إعادة كتابة عناوين URL لنظام إدارة التعلم Moodle

يتم تفعيل خاصية إعادة كتابة عناوين URL بشكل افتراضي في نظام إدارة التعلم Moodle . إذا لم تكن كذلك، يمكنك تفعيلها من خلال مزود خدمة الاستضافة الخاص بك.

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

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

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

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

قم بتفعيل مُبدِّل اللغة

قم بتحميل جافا سكريبت Linguise

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

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

رسم بياني يوضح خطوات تثبيت وحدة. يظهر الرسم البياني خطاً أزرق منقطاً متجهاً للأعلى.

أسهل طريقة لتحميل هذا الكود في Moodle هي إضافته داخل موقعك الإلكتروني شفرة.

يمكنك إعداد ذلك باتباع الخطوات التالية: ادخل إلى إدارة الموقع ، ثم انتقل إلى الإعدادات > إدارة الموقع > المظهر > HTML إضافي. يمكنك استخدام هذه الطريقة افتراضيًا.

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

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

ExpressionEngine-cms-language-switcher

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

إعداد مفتاح تبديل اللغة

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

لقطة شاشة توضح قائمة منسدلة لاختيار إعدادات اللغة مع خيارات للغة الإنجليزية.

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

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

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

وضع العلم في مكانه

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

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

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

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

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

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

مثال على كود تهيئة الترجمة Laravel . تهيئة لإعداد الترجمات.
				
					    /** 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 = '';