قم بتثبيت Linguise على مواقع الويب المعتمدة على Laravel

متطلبات تقنية

لتشغيل البرنامج النصي لترجمة Linguise ، ستحتاج إلى ما يلي:

قم بتشغيل PHP 7+ و Laravel
خادم Apache و LiteSpeed و NGINX و IIS
قم بتنشيط إعادة كتابة عنوان URL في تكوين الخادم الخاص بك
عادةً ما يتم تعيين المجلد الجذر لـ Laravel العامة "، تأكد من تثبيت Linguise داخل هذا المجلد

1. إنشاء مفتاح API

بعد اتصالك بلوحة Linguise ، ستحتاج إلى إعداد مجال جديد أولاً وحفظ إعداداته للحصول على مفتاح API.

مفتاح API هو المطلوب لتفعيل الترجمة على موقع الويب الخاص بك. بشكل أساسي ، سيتحقق مفتاح API من اللغة التي يتم تنشيطها على أي مجال وسيسمح بإنشاء صفحات الترجمة العصبية.

انسخ مفتاح API واحتفظ به في الحافظة الخاصة بك.

ثم بالنقر فوق علامة التبويب "Script PHP" ، ستحصل على إرشادات التثبيت التي سنتبعها هنا بالتفصيل.

2. قم بتحميل وتوصيل نص ترجمة Linguise

يجب تحميل نص ترجمة Linguise إلى خادمك، في المجلد الذي تم تثبيت Laravel فيه، ويمكن تنزيله هنا:

بعد تنزيل البرنامج النصي، قم بفك ضغطه وتحميله إلى المجلد الجذر حيث تم تثبيت Laravel .

تأكد من وجوده على مستوى الجذر لتثبيت Laravel (عادةً ما Laravel بتعيين الجذر على المجلد " العامة " حيث يمكنك تثبيت Linguise هناك)
تسمية المجلد linguise " (الاسم الافتراضي عند فك ضغط المجلد)

يجب نسخ مفتاح Linguise API إلى المجلد: ... Linguise linguise linguise الملف الذي قمت بتحميله إلى خادمك ، قم بتحرير الملف ونسخ مفتاح API الخاص بك بين علامات الاقتباس البسيطة ، واستبدل النص REPLACE_BY_TOUR TOKEN.

نحن ندرك أن تكوين عناوين URL ومحول اللغة يعد أمرًا تقنيًا بعض الشيء للتهيئة؛ لكن أخبار جيدة! نحن نقدم التثبيت المجاني

اتصل بالدعم الفني لدينا

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 dashboard).

يجب تحميل البرنامج النصي في رأس صفحات HTML التي يعالجها Laravel . سيتم بعد ذلك تحميل محوّل لغة العلم تلقائيًا.

سيتم عرض محوّل اللغة افتراضيًا في موضع علوي يمين عائم على موقع الويب الخاص بك. نرحب بك لتخصيصه كما يحلو لك باستخدام CSS.

ملاحظة مهمة بشأن تحسين محركات البحث: عدد اللغات التي تقوم بإعدادها له تأثير كبير على تحسين محركات البحث. عند إعداد لغات الترجمة الخاصة بك ، إذا كان لديك عدد كبير من الصفحات المفهرسة (> 500) ، فقد يستغرق محرك البحث وقتًا طويلاً لمعالجتها. قد يؤثر ذلك على مُحسّنات محرّكات البحث بلغتك الأصلية. لهذا السبب نوصي بإضافة 5 لغات كحد أقصى في البداية ، ثم عند فهرستها ، يمكنك إضافة لغات في دفعة من 3 لغات شهريًا.

قم بإعداد محوّل اللغة

يمكن تخصيص محوّل اللغة من لوحة معلومات Linguise > الإعدادات> عرض أعلام اللغة. سينعكس كل تعديل هنا على الموقع.

على الجانب الأيمن من الشاشة لديك معاينة لمحوّل اللغة. فيما يلي العناصر التي يمكنك إعدادها:

3 تخطيطات: جنبًا إلى جنب أو قائمة منسدلة أو منبثقة
موضع محوّل اللغة
محتوى محوّل اللغة
أسماء اللغات باللغة الإنجليزية أو اللغة الأم
أشكال الأعلام وحجمها
الألوان وظل الصندوق

قم بتحميل محوّل اللغة في محتوى Laravel

لعرض محوّل اللغة في مكان محدد، في Laravel ، يجب عليك تعيين الموضع على أنه "في المكان".
بمجرد قيامك بتعيين الموضع في Linguise ، يمكنك إضافة الرمز القصير أدناه لتضمينه. انقر على الرمز أدناه لوضعه في الحافظة الخاصة بك.

[ linguise ]

');return false;"> [ linguise ]

بمجرد إضافتها، سيكون لديك في الواجهة الأمامية العلم وأسماء اللغات معروضة في منطقة HTML التي قمت بإضافة الكود إليها.

نظام التخزين المؤقت المحلي لصفحات Laravel

كخيار ، يمكنك تنشيط نظام ذاكرة تخزين مؤقت محلي يخزن عناوين URL ومحتوياتها متعددة اللغات ذات الصلة لخدمة الصفحات بشكل أسرع. ستوفر ذاكرة التخزين المؤقت المحلية بعض عمليات نقل البيانات بين خادم Linguise وخادم موقع الويب الخاص بك. يتم استخدام ذاكرة التخزين المؤقت فقط عندما تكون الصفحة قد تمت ترجمتها بالفعل ولم يتم تحديثها. ستكون ذاكرة التخزين المؤقت ذات الأولوية هي ذاكرة التخزين المؤقت للصفحات متعددة اللغات الأكثر مشاهدة.

كخيار ، يمكنك تحديد مقدار ذاكرة التخزين المؤقت المخزنة بالميغابايت. في المثال التالي ، يتم تنشيط ذاكرة التخزين المؤقت ويبلغ حجم ذاكرة التخزين المؤقت التي يجب الاحتفاظ بها 500 ميجابايت:

				
					    /** Basic configuration **/
    public $cache_enabled = true;
    public $cache_max_size = 500; // In megabyte

إعدادات محددة لمنصة Laravel

في ملف Configuration.php لدينا أيضًا إعداد يسمح بتمرير بعض التكوينات المحددة لنظام إدارة المحتوى (CMS) أو غير نظام إدارة المحتوى (CMS). بشكل افتراضي، يكون ذلك تلقائيًا، ولكن قد يطلب منك فريق الدعم تخصيصه لاستخدام بعض الإعدادات الخاصة.

إليك الكود الذي يجب إضافته إلى Laravel ، وهذا هو اسم CMS بأحرف صغيرة:

				
					    /** 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}&amp;original_url={R:2}" appendQueryString="true" />
</rule>

الترجمة الآلية على خوادم Laravel + NGINX

أضف السطر المقابل لنظام إدارة المحتوى الخاص بك في كتلة تكوين خادم NGINX.

يجب تعيينه قبل أي إعادة توجيه أخرى ، وخاصة إعادة التوجيه في ملف PHP الرئيسي.

				
					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;