جدول المحتويات
المتطلبات الفنية PrestaShop
استخدام الترجمة الآلية العصبية مع PrestaShop استخدام سكربت PHP (يمكن تنزيله أدناه). لتثبيت Linguise ، ستحتاج إلى المتطلبات التالية:
- قم بتشغيل PHP 8+
- خادم Apache، LiteSpeed، NGINX، IIS
- قم بتفعيل إعادة كتابة عنوان URL من خلال إعدادات PrestaShop
كيفية تثبيت ترجمة PrestaShop
1. إنشاء مفتاح API
بعد اتصالك بلوحة تحكم Linguise ، ستحتاج إلى إعداد نطاق جديد أولاً وحفظ إعداداته للحصول على مفتاح API.
مفتاح API هو المطلوب لتفعيل الترجمة على موقع PrestaShop الخاص بك. ببساطة، يتحقق مفتاح API من اللغة المُفعّلة على كل نطاق، ويسمح بإنشاء صفحات الترجمة الآلية.
انسخ مفتاح API واحتفظ به في الحافظة.
ثم بالنقر على علامة التبويب "Script PHP" ستحصل على تعليمات التثبيت التي سنتبعها هنا بالتفصيل.
2. قم بتحميل وتوصيل نص ترجمة Linguise
يجب تحميل برنامج الترجمة Linguise على الخادم الخاص بك حيث تم تثبيت PrestaShop :
بعد تنزيل البرنامج النصي، قم بفك ضغطه وتحميله إلى المجلد الرئيسي حيث تم تثبيت نظام إدارة المحتوى.
- تأكد من وجوده في المستوى الجذر لموقعك الإلكتروني (حيث توجد ملفات PrestaShop
- تأكد من أن المجلد يحتفظ باسمه الافتراضي " 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 افتراضيًا في PrestaShop لأغراض تحسين محركات البحث. إذا لم يكن الأمر كذلك، يمكنك العثور على الإعداد في معلمات المتجر > حركة المرور وتحسين محركات البحث > عناوين URL سهلة الاستخدام. لمزيد من المعلومات، راجع وثائق PrestaShop الرسمية
يجب ضبط عنوان URL حسب اللغة في ملف .htaccess. ما عليك سوى نسخ هذا الكود بعد الكود " RewriteEngine on " PrestaShop الافتراضية ملف .htaccess:
<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]
</IfModule>
وأخيرًا، يجب أن يبدو ملف .htaccess PrestaShop الخاص بك على النحو التالي:
4. فعّل مُبدِّل اللغة
يمكنك الآن تحميل جميع صفحاتك المترجمة باستخدام عنوان URL، على سبيل المثال: www.shop.com/fr/
مُبدِّل اللغة هو نافذة منبثقة تتيح لك اختيار اللغة التي تريدها. لتحميله، عليك نسخ الكود الموجود في نهاية إعدادات الموقع إلى قسم <head> في صفحة HTML الخاصة بك. سيتم تحميل مُبدِّل اللغة تلقائيًا بعد ذلك.
يجب تحميله في رأس صفحتك، في Prestashop يمكنك نسخ الكود إلى: …/themes/your-theme/templates/_partials/head.tpl
سيظهر مُبدِّل اللغة افتراضيًا في أعلى يمين موقعك الإلكتروني. يمكنك تخصيصه كما تشاء باستخدام CSS.
ملاحظة هامة لتحسين محركات البحث: يؤثر عدد اللغات التي تُضيفها بشكل كبير على تحسين محركات البحث. عند إعداد لغات الترجمة، إذا كان لديك عدد كبير من الصفحات المفهرسة (أكثر من 500 صفحة)، فقد يستغرق محرك البحث وقتًا طويلاً لمعالجتها، مما قد يؤثر سلبًا على تحسين محركات البحث في لغتك الأصلية. لذا، ننصح بإضافة 5 لغات كحد أقصى في البداية، ثم بعد اكتمال فهرسة الموقع، يمكنك إضافة 3 لغات على دفعات شهرية.
إعداد مفتاح اللغة
يمكن تخصيص مُبدِّل اللغة Linguise > الإعدادات > عرض علامات اللغة. ستنعكس جميع التعديلات التي تُجرى هنا على الموقع الإلكتروني.
على الجانب الأيمن من الشاشة، ستجد معاينة لمبدل اللغة. إليك العناصر التي يمكنك ضبطها:
- 3 تخطيطات: جنبًا إلى جنب، أو منسدلة أو منبثقة
- موقع مبدل اللغة
- محتوى مفتاح تبديل اللغة
- أسماء اللغات باللغة الإنجليزية أو اللغة الأم
- أشكال الأعلام والحجم
- الألوان وظل الصندوق
قم بتحميل أداة تبديل اللغة في محتوى PrestaShop
لعرض مُبدِّل اللغة في مكان مُحدد ضمن محتوى نظام إدارة المحتوى، يجب ضبط الموضع على "في مكانه".
بعد ضبط الموضع في Linguise ، يُمكنك إضافة الرمز المختصر أدناه لتضمينه. انقر على الرمز أدناه لنسخه إلى الحافظة.
<div>[linguise]</div>
بمجرد إضافته، ستظهر لك أسماء العلم واللغة في واجهة المستخدم في منطقة HTML التي أضفت إليها الكود.
تفعيل نظام التخزين المؤقت المحلي
كخيار إضافي، يمكنك تفعيل نظام التخزين المؤقت المحلي الذي يخزن عناوين URL ومحتواها متعدد اللغات لتسريع تحميل الصفحات. سيساهم التخزين المؤقت المحلي في تقليل نقل البيانات بين خادم Linguise وخادم موقعك الإلكتروني. يُستخدم التخزين المؤقت فقط عندما تكون الصفحة مترجمة مسبقًا ولم يتم تحديثها. وستكون الأولوية في التخزين المؤقت للصفحات متعددة اللغات الأكثر مشاهدة.
كخيار إضافي، يمكنك تحديد حجم ذاكرة التخزين المؤقت المخزنة بالميغابايت. في المثال التالي، تم تفعيل ذاكرة التخزين المؤقت، وحجمها المطلوب الاحتفاظ به هو 500 ميغابايت:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
الترجمة التلقائية على خوادم ويندوز 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>
الترجمة التلقائية على خوادم 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;