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