add_meta_boxes
Дозволяє зареєструвати метаблок будь-якого типу запису. Спрацьовує після того, як усі вбудовані метаблоки були додані.
Отримує два параметри: $post_type, $post .
Також є аналогічний хук add_meta_boxes_{post_type} — спрацьовує лише сторінці редагування записи типу {post_type}
, тобто. можна відразу вказати тип запису на якому спрацьовуватиме хук. Оскільки тип запису вказується заздалегідь, хук отримує лише один параметр: $post .
Використання
add_action( 'add_meta_boxes', 'wp_kama_add_meta_boxes_action', 10, 2); /** * Function for `add_meta_boxes` action-hook. * * @param string $post_type Post type. * @param WP_Post $post Post об'єкт. * * @return void */ function wp_kama_add_meta_boxes_action( $post_type, $post ){ // action... }
-
$post_type
(рядок) - Назва типу запису, на сторінці редагування якого викликається хук.
-
$post
(WP_Post) - Об’єкт запису: WP_Post.
Приклади
#1 Додамо мета блок на сторінку редагування запису типуpost
add_action( 'add_meta_boxes', 'adding_custom_meta_boxes', 10, 2); function adding_custom_meta_boxes( $post_type, $post ) { add_meta_box( 'my-meta-box', 'Мій метаблок', 'render_my_meta_box', 'post', 'normal', 'default'); } function render_my_meta_box(){ echo 'HTML метаблоку'; }
#2 Використання аналогічного хука:add_meta_boxes_{post_type}
Цей код робить те саме, що й перший приклад. Тільки тут тип запису вказується одразу в назві хука.
add_action( 'add_meta_boxes_'.'post', 'adding_custom_meta_boxes' ); function adding_custom_meta_boxes( $post ) { add_meta_box( 'my-meta-box', 'Мій метаблок', 'render_my_meta_box', 'post', 'normal', 'default'); } function render_my_meta_box(){ echo 'HTML метаблоку'; }
список змін
З версії 3.0.0 | Введено. |
Де викликається хук
wp-admin/edit-link-form.php 37
do_action( 'add_meta_boxes', 'link', $link );
Де використовується хук у WordPress
Використання не знайдено.