apply_filters( 'wpml_object_id', int $element_id, string $element_type, bool $return_original_if_missing, mixed $ulanguage_code )
- النوع
- filter
- الفئة
- استرداد المحتوى المحلي
- إصدار WPML
- 3.2
الوصف
يُرجع معرف العنصر في اللغة الحالية أو في لغة أخرى محددة.
بشكل افتراضي، يضبط WPML المعرفات تلقائياً لعرض جميع عناصر القالب في اللغة الحالية. هذا الإعداد مُفعّل بشكل افتراضي في صفحة WPML → إعدادات → اللغات. ولكن، إذا كنت تبني قالبك الخاص من الصفر، استخدم دالة wpml_object_id لضبط المعرفات يدوياً. هذا النهج أكثر كفاءة من حيث المعالجة.
الوسائط
- $element_id
- (int) (مطلوب) معرف نوع المنشور (post، page، attachment، custom post) أو مصطلح التصنيف (tag، category، custom taxonomy) المراد تصفيته
- $element_type
- (string) (مطلوب) نوع العنصر الذي ينتمي إليه المعرف. يمكن أن يكون post، page، {custom post type key}، nav_menu، nav_menu_item، category، post_tag، {custom taxonomy key}
- $return_original_if_missing
- (bool) (اختياري) إذا ضُبط على true، فسيرجع دائماً قيمة (القيمة الأصلية، إذا كانت الترجمة مفقودة). الافتراضي هو FALSE
- $ulanguage_code
- (mixed) (اختياري) إذا كان مفقوداً أو NULL، فسيستخدم اللغة الحالية. إذا ضُبط على رمز لغة، فسيرجع ترجمة لرمز اللغة هذا أو القيمة الأصلية إذا كانت الترجمة مفقودة وضُبط $return_original_if_missing على TRUE. الافتراضي هو NULL
مثال على الاستخدام
بعض الأمثلة الأساسية
// will return the post ID in the current language for post ID 1 echo apply_filters( 'wpml_object_id', 1, 'post' ); // will return the category ID in the current language for categoy ID 4. If the translation is missing it will return the original (here: category ID 4) echo apply_filters( 'wpml_object_id', 4, 'category', TRUE ); // will return the German attachment ID for attachment ID 25. If the translation is missing it will return NULL echo apply_filters( 'wpml_object_id', 25, 'attachment', FALSE, 'de' );
مثال أكثر تقدماً
/**
* Returns the translated object ID(post_type or term) or original if missing
*
* @param $object_id integer|string|array The ID/s of the objects to check and return
* @param $type the object type: post, page, {custom post type name}, nav_menu, nav_menu_item, category, tag etc.
* @return string or array of object ids
*/
function my_translate_object_id( $object_id, $type ) {
$current_language= apply_filters( 'wpml_current_language', NULL );
// if array
if( is_array( $object_id ) ){
$translated_object_ids = array();
foreach ( $object_id as $id ) {
$translated_object_ids[] = apply_filters( 'wpml_object_id', $id, $type, true, $current_language );
}
return $translated_object_ids;
}
// if string
elseif( is_string( $object_id ) ) {
// check if we have a comma separated ID string
$is_comma_separated = strpos( $object_id,"," );
if( $is_comma_separated !== FALSE ) {
// explode the comma to create an array of IDs
$object_id = explode( ',', $object_id );
$translated_object_ids = array();
foreach ( $object_id as $id ) {
$translated_object_ids[] = apply_filters ( 'wpml_object_id', $id, $type, true, $current_language );
}
// make sure the output is a comma separated string (the same way it came in!)
return implode ( ',', $translated_object_ids );
}
// if we don't find a comma in the string then this is a single ID
else {
return apply_filters( 'wpml_object_id', intval( $object_id ), $type, true, $current_language );
}
}
// if int
else {
return apply_filters( 'wpml_object_id', $object_id, $type, true, $current_language );
}
}
الخطاطيف ذات الصلة
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_permalink, wpml_unfiltered_admin_string