واجهة برمجة تطبيقات (API) لخطاطيف WPML
يقدم WPML خطاطيف للمرشحات والإجراءات يمكن استخدامها في قالب أو إضافة WordPress الخاصة بك لتوفير الدعم الصحيح للمواقع متعددة اللغات. تصفح مرجع واجهة برمجة التطبيقات (API) للخطاطيف للحصول على تفاصيل حول كل خطّاف.
أكواد WPML المختصرة
يوفر WPML أكواداً مختصرة يمكنك استخدامها في كل من المحتوى وكود PHP الخاص بك. وهي مدرجة في صفحة أكواد WPML المختصرة.
ثوابت WPML
يوفر WPML ثوابت معرّفة بواسطة إضافة WPML الأساسية وإضافاتنا الملحقة. يمكنك استخدامها في ملفات PHP وقوالب إضافة أو قالب موقعك. للحصول على قائمة كاملة، راجع صفحتنا حول ثوابت WPML.
ثوابت اللغة
يعرّف WPML الثوابت التالية التي يمكن استخدامها في القالب:
| الثابت | الوصف | مثال |
|---|---|---|
| ICL_LANGUAGE_CODE | كود اللغة الحالية | fr |
| ICL_LANGUAGE_NAME | اسم اللغة الحالية، باللغة الحالية نفسها | Français |
| ICL_LANGUAGE_NAME_EN | اسم اللغة الحالية باللغة الإنجليزية | French |
لا نوصي باستخدام هذه الثوابت للحصول على اللغة الحالية لموقعك نظراً لأنه تم إيقاف استخدامها. بدلاً من ذلك، يُرجى الرجوع إلى مقال الأسئلة الشائعة حول كيفية الحصول على اللغة الحالية باستخدام WPML.
تعطيل ملفات CSS و JS الخاصة بـ WPML
يأتي WPML مزوداً بملفات CSS و JS الخاصة به والتي تنسق التصفح وشكل مبدل اللغة.
يعتمد تحميل ملفات الأنماط (stylesheet) وملفات javascript لشكل مبدل اللغة على المبدل المختار. إذا لم تكن بحاجة إليها في قالبك، يمكنك إخبار WPML بعدم تحميل هذه الملفات.
توجد هذه الملفات في المجلد التالي:
../wp-content/plugins/sitepress-multilingual-cms/templates/language-switchers/YOUR_CHOSEN_LANGUAGE_SWITCHER_THEME/
للقيام بذلك، عرّف الثوابت التالية في قالبك:
| الثابت | الملف الذي يعطله |
|---|---|
| ICL_DONT_LOAD_NAVIGATION_CSS | ملفات أنماط التصفح – cms-navigation-base.css و cms-navigation.css |
| ICL_DONT_LOAD_LANGUAGE_SELECTOR_CSS | style.css?ver=1 |
| ICL_DONT_LOAD_LANGUAGES_JS | script.js?ver=1 |
لتعيين هذه الثوابت، عرّفها في ملف functions.php الخاص بالقالب. على سبيل المثال:
define('ICL_DONT_LOAD_NAVIGATION_CSS', true);
تعطيل الاتصالات الحرجة مع خدمات الترجمة لمواقع الاختبار
كجزء من سير العمل المعتاد لتطوير مواقع الويب، قد تحتاج إلى تكرار موقعك المباشر والعمل في موقع مختلف أو بيئة تجريبية. هذا إجراء شائع ونوصي به تماماً. ومع ذلك، سيتصل موقع الاختبار المنفصل هذا افتراضياً بخدمة الترجمة تماماً مثل الموقع المباشر الرئيسي. يمكن أن يؤدي ذلك إلى حدوث تعارضات في اتصالات الموقع الرئيسي بخدمة الترجمة.
إليك مثال نموذجي للمساعدة في توضيح هذه المشكلة:
- يجلب موقع الاختبار الخاص بك ترجمة مكتملة من خدمة الترجمة.
- تضع خدمة الترجمة علامة «مُسلَّمة» على هذه العناصر.
- لن تتمكن بعد ذلك من جلب هذه الترجمات المُسلَّمة على موقعك المباشر.
لتجنب مثل هذه المشكلات، نوصي بـ «إخبار» WPML بأن الموقع التجريبي مخصص لأغراض الاختبار فقط. يمكنك القيام بذلك عن طريق إضافة السطر التالي إلى ملف wp-config.php الخاص بموقعك:
define( 'WPML_ENVIRONMENT', 'test' );ملاحظة: سيؤدي هذا إلى حظر الطلبات الحرجة فقط، ولكن ستظل معظم الطلبات متاحة. على سبيل المثال، ستُعرض قائمة خدمات الترجمة كالمعتاد.