$converted_url = apply_filters( 'wpml_permalink', string $permalink, string $language_code = null, bool $full_resolution = false );
- النوع
- filter
- الفئة
- استرداد المحتوى المحلي
- إصدار WPML
- 3.2.2
الوصف
يُصفّي الرابط الدائم لـ WordPress ويحوّله إلى رابط دائم خاص باللغة بناءً على تنسيق عنوان URL للغة المحدّد في إعدادات اللغة في WPML.
هذا يعني أنه عند ضبط «تنسيق عنوان URL للغة» على «لغات مختلفة في أدلة»، سيتم إرجاع الرابط الدائم بصيغة http://domain.com/de. وعند تحديد «نطاق مختلف لكل لغة»، سيُحوَّل الرابط الدائم ليتضمن النطاق الصحيح المخصص للغة المطلوبة.
الوسطاء
- $permalink
- (سلسلة نصية) (مطلوب) عنوان URL المُنشأ بواسطة WordPress لتصفيته.
- $language_code
- (سلسلة نصية) (اختياري) اللغة التي سيتم تحويل عنوان URL إليها. تقبل رمزاً مكوّناً من حرفين. عند التعيين إلى
null، فإنها تعود إلى اللغة الافتراضية للصفحة الجذرية، أو اللغة الحالية في جميع الحالات الأخرى. الافتراضي هوnull - $full_resolution
- (قيمة منطقية) (اختياري) تمكين التحويل الكامل لعناوين URL المبرمجة بشكل ثابت.
مثال على الاستخدام
المثال 1
على سبيل المثال، إذا حددنا «لغات مختلفة في أدلة»، فيمكننا استخدام الكود التالي:
// will return http://domain.com/de/contact $wpml_permalink = apply_filters( 'wpml_permalink', 'http://domain.com/contact', 'de' );
المثال 2
لدينا صفحة http://example.org/hello/ وترجمتها http://example.org/fr/bonjour/. لنفترض أننا نستدعي المرشّح أثناء عرض الصفحة الرئيسية http://example.org.
// displays http://example.org/fr/hello/ (wrong) echo apply_filters( 'wpml_permalink', 'http://example.org/hello/', 'fr' ); // displays http://example.org/fr/bonjour/ (correct) echo apply_filters( 'wpml_permalink', 'http://example.org/hello/', 'fr', true );
ملاحظات هامة حول المثال الثاني:
- تُعد عملية التحويل الكامل عملية ثقيلة، لذا يجب على WPML حفظ عناوين URL المحوّلة في قاعدة البيانات. من المفترض أن يؤدي الاستدعاء الأول لـ wpml_permalink إلى زيادة استعلامات قاعدة البيانات ووقت التحميل بشكل كبير. لكن الاستدعاءات اللاحقة لن تزيد العبء على العملية.
- يتم مسح البيانات المحفوظة في قاعدة البيانات جزئياً عند تحديث المقالات/المصطلحات أو حذفها. ويتم مسحها بالكامل عند زيارة إعدادات -> الروابط الدائمة (يُعد هذا خياراً جيداً ضمن استكشاف الأخطاء وإصلاحها في حال واجهت أي مشاكل).
- في حال تعذّر تحويل عنوان URL، سيعيد المرشّح wpml_permalink عنوان URL الأصلي.
خطاطيف ذات صلة
wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_single_string, wpml_translate_string, wpml_elements_without_translations, wpml_unfiltered_admin_string, wpml_element_link