منذ بضع سنوات، نساعد مطوّري الإضافات والقوالب في كتابة دروس تعليمية تشرح كيفية عمل منتجاتهم بطريقة متعددة اللغات. لقد اكتشفنا أن التوثيق جزء أساسي من أي دورة تطوير، وأن توضيح كيفية استخدام قالبك أو إضافتك مع WPML لعملائك له فوائد أكثر.
ما هي فوائد كتابة توثيق حول توافق قالبك/إضافتك مع WPML؟
سيشرح التوثيق كيفية بناء مواقع متعددة اللغات باستخدام قالبك/إضافتك، مما سيساعد عملاءك على استخدام قالبك/إضافتك في المواقع متعددة اللغات ويقلل العبء على منتديات الدعم الخاصة بك. وقد يساعد أيضاً في زيادة مبيعاتك، حيث تزداد احتمالية شراء العملاء لمنتجك لإنشاء موقع متعدد اللغات. ستتم إضافة رابط إلى توثيقك في صفحة قالبك/إضافتك على wpml.org.
النقاط المقترحة لتوثيق القالب/الإضافة (الهيكل)
- مقدمة: بضع كلمات عن القالب/الإضافة وتكامله مع WPML. يمكنك أيضاً تضمين رابط إلى موقع اختبار عام لـ WPML لذلك القالب (مثال: http://YOURTHEME.compatibility.wpml.org/) حيث يمكن للعملاء رؤية القالب/الإضافة متعدد اللغات أثناء عمله.
- ما ستحتاج إليه: إصدار القالب/الإضافة ورابط التنزيل، وأي إضافات مطلوبة (إن وُجدت)، وإصدار إضافة WPML وملحقات WPML الضرورية.
- الموارد الأساسية: روابط إلى توثيقك أو أي جزء من توثيق WPML قد يكون مفيداً للعميل.
- المحتوى: قائمة بالنقاط التي سيتضمنها التوثيق.
- البدء: اشرح كيفية تفعيل وإعداد القالب إلى جانب WPML وملحقاته. قد يكون من المفيد أيضاً تضمين إرشادات لاستيراد المحتوى التجريبي أو بيانات العينة (إن وُجدت).
- الترجمة: خطوات تفصيلية حول كيفية ترجمة عناصر قالبك أو مخرجات إضافتك. بالنسبة للقوالب، قد ترغب في تضمين النقاط التالية:
- ترجمة الصفحة الرئيسية.
- ترجمة الصفحات الأخرى، والمقالات، وأنواع المنشورات المخصصة، والتصنيفات المخصصة.
- ترجمة خيارات القالب.
- ترجمة نصوص القالب الأخرى.
- ترجمة القوائم.
- ترجمة الإضافات الخارجية المطلوبة (على سبيل المثال، إذا كنت تستخدم Slider Revolution في قالبك، فقد ترغب في الإشارة إلى توثيقه هنا).
- الخاتمة: النتيجة التي يمكن تحقيقها من تكامل قالبك/إضافتك مع WPML.
قد ترغب في الإشارة إلى بعض النقاط في توثيق WPML:
- دليل البدء
- إعداد اللغة
- استخدام إدارة الترجمة الخاصة بـ WPML
- تعريب القوالب والإضافات
- ترجمة النصوص
- ترجمة القوائم
- ترجمة الودجات
- مبدل لغة مخصص
- ترجمة المعرّفات النصية للروابط
أمثلة على التوثيق
- مثال على توثيق قالب (استخدام WPML مع قالب AVADA)
- مثال على توثيق إضافة (إنشاء أشرطة تمرير متعددة اللغات باستخدام Slider Revolution وWPML)
إضافة Multilingual Tools
يمكن أن تساعدك إضافة Multilingual Tools في اختبار قدرات تعدد اللغات لقالبك/إضافتك. ستضيف تلقائياً رمز اللغة أو إشعارات مخصصة إلى المحتوى المترجم، مما يتيح لك مراجعة ما يعمل بشكل صحيح وما يتطلب تعديلاً ليتم ترجمته.
باستخدام هذه الأداة، يمكنك:
- إنشاء السلاسل للترجمات تلقائياً.
- إضافة معلومات اللغة إلى المقالات المكررة.
- إنشاء ملف تكوين WPML (wpml-config.xml).
راجع توثيقنا الكامل لـ إضافة Multilingual Tools.
