جدول المحتويات
المتطلبات الفنية
لتشغيل برنامج الترجمة Linguise ، ستحتاج إلى ما يلي:
- قم بتشغيل PHP 7+ و Laravel
- خادم Apache، LiteSpeed، NGINX، IIS
- قم بتفعيل إعادة كتابة عنوان URL في إعدادات الخادم الخاص بك
- عادةً ما يتم تعيين المجلد الرئيسي لـ Laravel public "، تأكد من تثبيت Linguise داخل هذا المجلد.
1. إنشاء مفتاح API
بعد اتصالك بلوحة تحكم Linguise ، ستحتاج إلى إعداد نطاق جديد أولاً وحفظ إعداداته للحصول على مفتاح API.
مفتاح واجهة برمجة التطبيقات (API) هو المطلوب لتفعيل الترجمة على موقعك الإلكتروني. ببساطة، يتحقق مفتاح واجهة برمجة التطبيقات من اللغة المُفعّلة على كل نطاق، ويسمح بإنشاء صفحات الترجمة الآلية.
انسخ مفتاح API واحتفظ به في الحافظة.
ثم بالنقر على علامة التبويب "Script PHP" ستحصل على تعليمات التثبيت التي سنتبعها هنا بالتفصيل.
2. قم بتحميل وتوصيل نص ترجمة Linguise
يجب تحميل برنامج الترجمة Linguise إلى خادمك، في المجلد الذي تم تثبيت Laravel فيه، ويمكنك تنزيله من هنا:
بعد تنزيل البرنامج النصي، قم بفك ضغطه وتحميله إلى المجلد الرئيسي حيث تم تثبيت Laravel .
- تأكد من وجوده في المستوى الجذر Laravel الخاص بك (عادةً ما Laravel بتعيين الجذر على مجلد " public "، يمكنك تثبيت Linguise هناك).
- تأكد من أن اسم المجلد هو " 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 للغات
يجب ضبط عنوان URL حسب اللغة في ملف .htaccess، إذا كان لديك "RewriteBase /" في ملفك، فما عليك سوى نسخ الكود التالي بعد ذلك:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^linguise/linguise.php$ - [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)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
</IfModule>
4. فعّل مُبدِّل اللغة في Laravel
مُبدِّل اللغة هو نافذة منبثقة لاختيار اللغة التي تريدها. لتحميله، ستحتاج إلى نسخ الكود الموجود في نهاية إعدادات الموقع (لوحة تحكمLinguise ).
يجب تحميل البرنامج النصي في قسم <head> من صفحات HTML التي يديرها Laravel. سيتم بعد ذلك تحميل مُبدِّل لغة العلم تلقائيًا.
سيظهر مُبدِّل اللغة افتراضيًا في أعلى يمين موقعك الإلكتروني. يمكنك تخصيصه كما تشاء باستخدام CSS.
ملاحظة هامة لتحسين محركات البحث: يؤثر عدد اللغات التي تُضيفها بشكل كبير على تحسين محركات البحث. عند إعداد لغات الترجمة، إذا كان لديك عدد كبير من الصفحات المفهرسة (أكثر من 500 صفحة)، فقد يستغرق محرك البحث وقتًا طويلاً لمعالجتها، مما قد يؤثر سلبًا على تحسين محركات البحث في لغتك الأصلية. لذا، ننصح بإضافة 5 لغات كحد أقصى في البداية، ثم بعد اكتمال فهرسة الموقع، يمكنك إضافة 3 لغات على دفعات شهرية.
إعداد مفتاح تبديل اللغة
يمكن تخصيص مُبدِّل اللغة من لوحة تحكم Linguise > الإعدادات > عرض علامات اللغة. ستنعكس جميع التعديلات التي تُجرى هنا على الموقع الإلكتروني.
على الجانب الأيمن من الشاشة، ستجد معاينة لمبدل اللغة. إليك العناصر التي يمكنك ضبطها:
- ثلاثة تصميمات: جنبًا إلى جنب، أو قائمة منسدلة، أو نافذة منبثقة
- موقع مفتاح تبديل اللغة
- محتوى مفتاح تبديل اللغة
- أسماء اللغات باللغة الإنجليزية أو اللغة الأم
- أشكال الأعلام والحجم
- الألوان وظل الصندوق
قم بتحميل أداة تبديل اللغة في محتوى Laravel
لعرض مُبدِّل اللغة في مكان مُحدد ضمن Laravel ، يجب ضبط الموضع على "في مكانه".
بعد ضبط الموضع في Linguise ، يُمكنك إضافة الكود المختصر أدناه لتضمينه. انقر على الكود أدناه لنسخه إلى الحافظة.
<div>[linguise]</div>
بمجرد إضافته، ستظهر لك أسماء العلم واللغة في واجهة المستخدم في منطقة HTML التي أضفت إليها الكود.
نظام التخزين المؤقت المحلي لصفحات Laravel
كخيار إضافي، يمكنك تفعيل نظام التخزين المؤقت المحلي الذي يخزن عناوين URL ومحتواها متعدد اللغات لتسريع تحميل الصفحات. سيساهم التخزين المؤقت المحلي في تقليل نقل البيانات بين خادم Linguise وخادم موقعك الإلكتروني. يُستخدم التخزين المؤقت فقط عندما تكون الصفحة مترجمة مسبقًا ولم يتم تحديثها. وستكون الأولوية في التخزين المؤقت للصفحات متعددة اللغات الأكثر مشاهدة.
كخيار إضافي، يمكنك تحديد حجم ذاكرة التخزين المؤقت المخزنة بالميغابايت. في المثال التالي، تم تفعيل ذاكرة التخزين المؤقت، وحجمها المطلوب الاحتفاظ به هو 500 ميغابايت:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
إعدادات خاصة بمنصة Laravel
يحتوي ملف Configuration.php أيضًا على إعداد يسمح بتمرير بعض التكوينات الخاصة بنظام إدارة المحتوى أو غيره. يتم ذلك تلقائيًا بشكل افتراضي، ولكن قد يطلب منك فريق الدعم تخصيصه لاستخدام بعض الإعدادات الخاصة.
إليك الكود الذي يجب إضافته لـ Laravel ، وهذا هو اسم نظام إدارة المحتوى بأحرف صغيرة:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
من 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 = '';
الترجمة الآلية على خوادم Laravel + Windows 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}&original_url={R:2}" appendQueryString="true" />
</rule>
الترجمة الآلية على خوادم Laravel + 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;