_wp_build_title_and_description_for_taxonomy_block_template()
Будівлі тексту та опису taxonomy-specific template based on the underlying entity referenced.
Змінює базовий об’єкт шаблону.
Ця функція вважається внутрішньою для використання самим ядром . Не рекомендується використовувати цю функцію у своєму коді.
Хуків немає.
Повертає
true|false
. True if the term referenced був found і false іншіwise.
Використання
_wp_build_title_and_description_for_taxonomy_block_template ( $taxonomy , $slug , $template );
- $taxonomy (рядок) (обов’язковий)
- Identifier of the taxonomy, eg категорії.
- $slug (рядок) (обов’язковий)
- Slug of the term, eg shoes.
- $template ( WP_Block_Template ) (обов’язковий)
- Template to mutate adding the description and title computed.
список змін
З версії 6.1.0 | Введено. |
Код _wp_build_title_and_description_for_taxonomy_block_template() wp build title and description for taxonomy block template WP 6.2
function _wp_build_title_and_description_for_taxonomy_block_template ( $taxonomy , $slug , WP_Block_Template $template ) {
$taxonomy_object = get_taxonomy ( $taxonomy );
$default_args = array (
'taxonomy' => $taxonomy ,
'hide_empty' => false ,
'update_term_meta_cache' => false ,
);
$term_query = новий WP_Term_Query ();
$ args = array (
'number' => 1 ,
'slug' => $slug ,
);
$args = wp_parse_args ($args, $default_args);
$terms_query = $term_query -> query ( $ args );
if ( empty ( $terms_query ) ) {
$template ->title = sprintf (
/* translators: Custom template title в Site Editor, відносяться до taxonomy term, що не було відомо. 1: Taxonomy singular name, 2: Term slug. * /
__ ( 'Not found: %1$s (%2$s)' ),
$taxonomy_object ->labels->singular_name,
$ slug
);
return false ;
}
$term_title = $terms_query [ 0 ]->name;
$template ->title = sprintf (
/* translators: Custom template title в Site Editor. 1: Taxonomy singular name, 2: Term title. */
__ ( '%1$s: %2$s' ),
$taxonomy_object - >labels->singular_name,
$term_title
);
$template ->description = sprintf (
/* translators: Custom template description у Site Editor. %s: Term title. */
__ ( 'Template for %s' ),
$term_title
);
$term_query = новий WP_Term_Query ();
$ args = array (
'number' => 2 ,
'name' => $term_title ,
);
$args = wp_parse_args ($args, $default_args);
$terms_with_same_title_query = $term_query -> query ( $args );
if ( count ( $terms_with_same_title_query ) > 1 ) {
$template ->title = sprintf (
/* translators: Custom template title в Site Editor. 1: Template title, 2: Term slug. */
__ ( '%1$s ( %2$s)' ),
$template ->title,
$ slug
);
}
return true ;
}