جدول المحتويات
المتطلبات الفنية
لتشغيل برنامج الترجمة 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 التالي:
https://www.domain.com/ linguise
قم بتغيير عنوان المجال وفقًا لعنوان موقع الويب الخاص بك*
تأكد من أن Linguise لديك إذن القراءة والكتابة المناسبة*
إعداد كلمة المرور واتصال قاعدة البيانات
بمجرد الوصول إلى واجهة البرنامج النصي ، سيتم تقديم شاشة إعداد حيث يمكنك إنشاء كلمة مرور والاتصال بقاعدة البيانات المفضلة لديك.
أنت تستطيع:
- اضبط كلمة مرور ، والتي ستكون مطلوبة للوصول المستقبلي إلى هذه الواجهة.
- اختر نوع قاعدة البيانات الخاص بك - إما MySQL أو SQLite ، اعتمادًا على الإعداد والتفضيل.
يضمن هذا الإعداد الأولي الوصول الآمن ويسمح لك بتكوين البرنامج النصي وفقًا لبيئتك.
اتصال قاعدة بيانات MySQL
إذا اخترت MySQL ، ستظهر واجهة مختلفة تطلب تفاصيل الاتصال التالية لحقول تكوين MySQL أدناه:
تأكد من أن المعلومات صحيحة لإنشاء اتصال ناجح بقاعدة بيانات MySQL الخاصة بك.
MySQL vs Sqlite - ما هو الفرق؟
يعد كل من MySQL و SQLite أنظمة قاعدة بيانات شهيرة تستخدم لتخزين وإدارة البيانات لمواقع الويب والتطبيقات. ومع ذلك ، فهي مصممة لحالات الاستخدام المختلفة ولها بعض الاختلافات الرئيسية:
| ميزة | sqlite | MySQL |
|---|---|---|
| يثبت | سهل للغاية (مطلوب تثبيت sqlite) | يتطلب إعداد الخادم |
| التخزين | ملف واحد | يديره خادم MySQL |
| الأداء | رائع للتطبيقات الصغيرة | أفضل للأنظمة الكبيرة ذات العبور العالية |
| حالة الاستخدام | التطبيقات المحلية والاختبار والمواقع الصغيرة | تطبيقات الويب ، التجارة الإلكترونية ، أنظمة المؤسسة |
واجهة سيناريو Linguise : إعداد لمنصة PHP
تمتد لوحة معلومات ترجمة Linguise ، التي كانت متوفرة مسبقًا فقط لـ Joomla و WordPress، الآن إلى دعم PHP والمنصات الإضافية. يتيح هذا التحديث للمستخدمين تكوين إعدادات اللغة بسلاسة - مثل خيارات العرض ، وأنماط العلم ، وتخصيص المظهر - بشكل مختلف من واجهة موحدة ، بغض النظر عن CMS أو إطار عملها.
يمكن للمسؤولين إدارة إعدادات 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 > الإعدادات> عرض أعلام اللغة. سينعكس كل تعديل هنا على الموقع.
على الجانب الأيمن من الشاشة لديك معاينة لمحوّل اللغة. فيما يلي العناصر التي يمكنك إعدادها:
- 3 تخطيطات: جنبًا إلى جنب، أو منسدلة أو منبثقة
- موقع مبدل اللغة
- محتوى مفتاح تبديل اللغة
- أسماء اللغات باللغة الإنجليزية أو اللغة الأم
- أشكال الأعلام والحجم
- الألوان وظل الصندوق
قم بتحميل أداة تبديل اللغة في محتوى 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;