جدول المحتويات
المتطلبات الفنية Magento
ستتطلب الترجمة التلقائية العصبية المستخدمة مع Magento لتثبيت Linguise ، ستحتاج إلى المتطلبات التالية:
- قم بتشغيل PHP 7+
- خادم Apache و LiteSpeed و NGINX و IIS
- قم بتنشيط إعادة كتابة عنوان URL من خلال تكوين Magento
- Magento 2+
- عادةً ما يتم تعيين المجلد الجذر لـ Magento /pub "، تأكد من تثبيت Linguise داخل هذا المجلد
قم بإنشاء مفتاح API
مفتاح API هو المطلوب لتنشيط الترجمة على موقع Magento الإلكتروني الخاص بك. في الأساس، سيتحقق مفتاح API من اللغة التي تم تنشيطها وفي أي مجال وسيسمح بإنشاء صفحات الترجمة العصبية.
انسخ مفتاح API واحتفظ به في الحافظة الخاصة بك.
ثم بالنقر فوق علامة التبويب "Script PHP" ، ستحصل على إرشادات التثبيت التي سنتبعها هنا بالتفصيل.
قم بتحميل وتوصيل نص ترجمة Linguise
يجب تحميل البرنامج النصي للترجمة Linguise على الخادم الخاص بك حيث تم تثبيت Magento :
بعد تنزيل البرنامج النصي ، قم بفك ضغطه وتحميله إلى المجلد الجذر حيث تم تثبيت CMS.
- تأكد من وجوده في المستوى الجذر لموقع الويب الخاص بك (حيث توجد ملفات Magento مجلد /pub
- تأكد من احتفاظ المجلد باسمه الافتراضي " linguise "
يجب نسخ مفتاح Linguise API في ملف Linguise الذي قمت بتحميله على الخادم الخاص بك ، وقم بتحرير الملف ونسخ مفتاح API الخاص بك بين علامات الاقتباس البسيطة ، واستبدل النص REPLACE_BY_TOUR TOKEN.
تكوين إضافي Magento
في الشريط الجانبي للمشرف، انتقل إلى المتاجر > الإعدادات > التكوين > عام > الويب > خيارات URL وقم بتعيين "إضافة رمز المتجر إلى عناوين URL على أنه " لا ".
قم بالوصول إلى رمز موقع الويب الخاص بك وافتح app/etc/env.php . اضبط "document_root_is_pub" على "صحيح".
تأكد من ضبط هاتين الخطوتين، واستمر في إعادة كتابة عنوان URL الخاص بالإعداد للتأكد من إمكانية تشغيل Linguise بشكل صحيح على موقع Magento الإلكتروني الخاص بك دون مشكلة.
قم بإعداد إعادة كتابة عناوين URL
يجب تكوين عنوان URL حسب اللغة في ملف htaccess. ما عليك سوى نسخ هذا الرمز بعد الرمز " RewriteEngine on " Magento 2 الافتراضي :
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,END]
أخيرًا، يجب أن يبدو ملف Magento .htaccess الخاص بك كما يلي:
قم بتنشيط محوّل اللغة
قم بتحميل البرنامج النصي Linguise JS
يمكنك الآن تحميل جميع صفحاتك المترجمة باستخدام عنوان URL ، على سبيل المثال: www.shop.com / fr /
محوّل اللغة هو العلامة المنبثقة لتحديد اللغة التي تريدها. لتحميله ، ستحتاج إلى نسخ الكود الوارد في نهاية تكوين موقع الويب إلى رأس صفحة HTML الخاصة بك. سيتم بعد ذلك تحميل محوّل لغة العلم تلقائيًا.
الكود المراد نسخه وتحميله في رأس موقع الويب الخاص بك متاح في Linguise > المجال الخاص بك> الإعداد> علامة التبويب: Script PHP
يجب أن يتم تحميله في رأس صفحتك. يمنحك Magento 2 القدرة على إضافة محتوى في رأس صفحتك من خلال التكوين.
في لوحة الإدارة ، انتقل إلى المحتوى> التكوين ، وقم بتحرير عرض سمة المتجر الافتراضي ، ثم انقر فوق قسم HTML Head وأضف البرنامج النصي المنسوخ إلى إدخال البرامج النصية وأوراق الأنماط. أخيرًا ، احفظ التكوين.
قم بتثبيت وحدة الأمان Magento
منذ Magento 2.3.5، أنت بحاجة إلى إضافة وحدة أمان للسماح Magento بتحميل الملفات من مجال Linguise . إذا كنت معتادًا على استخدام Magento ، فلن تكون هناك مشكلة، وإلا فإليك دليل خطوة بخطوة:
- قم بتنزيل الوحدة من هذا الرابط
- قم بفك ضغط محتوى الملف المضغوط في تثبيت Magento الخاص بك في الدليل app/code/
- ثم قم بتشغيل الأوامر:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
سيتم عرض محوّل اللغة افتراضيًا في موضع يمين سفلي عائم على موقع الويب الخاص بك. نرحب بك لتخصيصه من لوحة معلومات Linguise .
ملاحظة مهمة بشأن تحسين محركات البحث: عدد اللغات التي تقوم بإعدادها له تأثير كبير على تحسين محركات البحث. عند إعداد لغات الترجمة الخاصة بك ، إذا كان لديك عدد كبير من الصفحات المفهرسة (> 500) ، فقد يستغرق محرك البحث وقتًا طويلاً لمعالجتها. قد يؤثر ذلك على مُحسّنات محرّكات البحث بلغتك الأصلية. لهذا السبب نوصي بإضافة 5 لغات كحد أقصى في البداية ، ثم عند فهرستها ، يمكنك إضافة لغات في دفعة من 3 لغات شهريًا.
قم بإعداد محوّل اللغة
يمكن تخصيص محوّل اللغة من لوحة معلومات Linguise > الإعدادات> عرض أعلام اللغة. سينعكس كل تعديل هنا على الموقع.
على الجانب الأيمن من الشاشة لديك معاينة لمحوّل اللغة. فيما يلي العناصر التي يمكنك إعدادها:
- 3 تخطيطات: جنبًا إلى جنب أو قائمة منسدلة أو منبثقة
- موضع محوّل اللغة
- محتوى محوّل اللغة
- أسماء اللغات باللغة الإنجليزية أو اللغة الأم
- أشكال الأعلام وحجمها
- الألوان وظل الصندوق
قم بتحميل محوّل اللغة في محتوى Magento
لعرض محوّل اللغة في مكان محدد، في Magento ، يجب عليك تعيين الموضع على أنه "في المكان".
بمجرد قيامك بتعيين الموضع في Linguise ، يمكنك إضافة الرمز القصير أدناه لتضمينه. انقر على الرمز أدناه لوضعه في الحافظة الخاصة بك.
بمجرد إضافتها، سيكون لديك في الواجهة الأمامية العلم وأسماء اللغات معروضة في منطقة HTML التي قمت بإضافة الكود إليها.
تفعيل نظام التخزين المؤقت المحلي
كخيار ، يمكنك تنشيط نظام ذاكرة تخزين مؤقت محلي يخزن عناوين URL ومحتوياتها متعددة اللغات ذات الصلة لخدمة الصفحات بشكل أسرع. ستوفر ذاكرة التخزين المؤقت المحلية بعض عمليات نقل البيانات بين خادم Linguise وخادم موقع الويب الخاص بك. يتم استخدام ذاكرة التخزين المؤقت فقط عندما تكون الصفحة قد تمت ترجمتها بالفعل ولم يتم تحديثها. ستكون ذاكرة التخزين المؤقت ذات الأولوية هي ذاكرة التخزين المؤقت للصفحات متعددة اللغات الأكثر مشاهدة.
كخيار ، يمكنك تحديد مقدار ذاكرة التخزين المؤقت المخزنة بالميغابايت. في المثال التالي ، يتم تنشيط ذاكرة التخزين المؤقت ويبلغ حجم ذاكرة التخزين المؤقت التي يجب الاحتفاظ بها 500 ميجابايت:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte