WordPress как на ладони
wordpress jino

(taxonomy)_edit_form_fields хук-событие . WP 3.0

Позволяет добавить дополнительные поля (произвольные поля или метаполя) на страницу редактирования элементов таксономии (термина).

Используйте (taxonomy)_add_form_fields, когда нужно добавить поля на страницу добавления термина.

Использование

add_action( '{$taxonomy}_edit_form_fields', '____action_function_name', 10, 2 );
function ____action_function_name( $tag, $taxonomy ) {
	// Действие...
}
$tag(объект)
Объект текущей таксономии

Примеры

#1 Добавим метаполя при создании и редактировании элемента таксономии.

В этом примере мы добавим 2 поля «Заголовок» и «Описание», для стандартной таксономии category т.е. для рубрик WordPress.

<?php
$taxname = 'category';

// Поля при добавлении элемента таксономии
add_action("{$taxname}_add_form_fields", 'add_new_custom_fields');
// Поля при редактировании элемента таксономии
add_action("{$taxname}_edit_form_fields", 'edit_new_custom_fields');

// Сохранение при добавлении элемента таксономии
add_action("create_{$taxname}", 'save_custom_taxonomy_meta');
// Сохранение при редактировании элемента таксономии
add_action("edited_{$taxname}", 'save_custom_taxonomy_meta');

function edit_new_custom_fields( $term ) {
	?>
		<tr class="form-field">
			<th scope="row" valign="top"><label>Заголовок</label></th>
			<td>
				<input type="text" name="extra[title]" value="<?php echo esc_attr( get_term_meta( $term->term_id, 'title', 1 ) ) ?>"><br />
				<span class="description">SEO заголовок (title)</span>
			</td>
		</tr>
		<tr class="form-field">
			<th scope="row" valign="top"><label>Описание</label></th>
			<td>
				<input type="text" name="extra[description]" value="<?php echo esc_attr( get_term_meta( $term->term_id, 'description', 1 ) ) ?>"><br />
				<span class="description">SEO описание (description)</span>
			</td>
		</tr>
		<tr class="form-field">
			<th scope="row" valign="top"><label>Ключевые слова</label></th>
			<td>
				<input type="text" name="extra[keywords]" value="<?php echo esc_attr( get_term_meta( $term->term_id, 'keywords', 1 ) ) ?>"><br />
				<span class="keywords">SEO ключевые слова (keywords)</span>
			</td>
		</tr>
	<?php
}

function add_new_custom_fields( $taxonomy_slug ){
	?>
	<div class="form-field">
		<label for="tag-title">Заголовок</label>
		<input name="extra[title]" id="tag-title" type="text" value="" />
		<p>SEO заголовок (title)</p>
	</div>
	<div class="form-field">
		<label for="tag-description">Описание</label>
		<input name="extra[description]" id="tag-description" type="text" value="" />
		<p>SEO описание (description)</p>
	</div>
	<div class="form-field">
		<label for="tag-keywords">Ключевые слова</label>
		<input name="extra[keywords]" id="tag-keywords" type="text" value="" />
		<p>SEO ключевые слова (keywords)</p>
	</div>
	<?php
}

function save_custom_taxonomy_meta( $term_id ) {
	if ( ! isset($_POST['extra']) ) return;
	if ( ! current_user_can('edit_term', $term_id) ) return;
	if (
		! wp_verify_nonce( $_POST['_wpnonce'], "update-tag_$term_id" ) && // wp_nonce_field( 'update-tag_' . $tag_ID );
		! wp_verify_nonce( $_POST['_wpnonce_add-tag'], "add-tag" ) // wp_nonce_field('add-tag', '_wpnonce_add-tag');
	) return;

	// Все ОК! Теперь, нужно сохранить/удалить данные
	$extra = wp_unslash($_POST['extra']);

	foreach( $extra as $key => $val ){
		// проверка ключа
		$_key = sanitize_key( $key );
		if( $_key !== $key ) wp_die( 'bad key'. esc_html($key) );

		// очистка
		if( $_key === 'tag_posts_shortcode_links' )
			$val = sanitize_textarea_field( strip_tags($val) );
		else
			$val = sanitize_text_field( $val );

		// сохранение
		if( ! $val )
			delete_term_meta( $term_id, $_key );
		else
			update_term_meta( $term_id, $_key, $val );
	}

	return $term_id;
}

Получить эти метаполя затем можно в шаблоне или где-либо еще с помощью функции get_term_meta(). Например ID термина 10, тогда:

$title =  get_term_meta( 10 , 'title', 1 );
$description =  get_term_meta( 10 , 'description', 1 );

Связи хука

Используется в файле: wp-admin/edit-tag-form.php

Остальные хуки из файла: wp-admin/edit-tag-form.php:

Фрагменты кода хука (taxonomy)_edit_form_fields

Фрагмент из: wp-admin/edit-tag-form.php WP 4.9
...
			 * @param object $tag Current tag term object.
			 */
			do_action( 'edit_tag_form_fields', $tag );
		}
		/**
		 * Fires after the Edit Term form fields are displayed.
		 *
		 * The dynamic portion of the hook name, `$taxonomy`, refers to
		 * the taxonomy slug.
		 *
		 * @since 3.0.0
		 *
		 * @param object $tag      Current taxonomy term object.
		 * @param string $taxonomy Current taxonomy slug.
		 */
		do_action( "{$taxonomy}_edit_form_fields", $tag, $taxonomy );
		?>
	</table>
<?php
// Back compat hooks
if ( 'category' == $taxonomy ) {
	/** This action is documented in wp-admin/edit-tags.php */
	do_action( 'edit_category_form', $tag );
} elseif ( 'link_category' == $taxonomy ) {
	/** This action is documented in wp-admin/edit-tags.php */
	do_action( 'edit_link_category_form', $tag );
} else {
	/**
	 * Fires at the end of the Edit Term form.
	 *
	 * @since 2.5.0
...
(taxonomy)_edit_form_fields 17 комментариев
Полезные 1 Все
  • Влад

    Как добавить таким образом например чекбокс?

    1
    Ответить1.7 года назад #
    • Kama4659

      Аналогично:

      <tr class="form-field">
      	<th scope="row" valign="top"><label for="extra1">Мой чекбокс</label></th>
      	<td>
      		<input type="hidden" name="extra[my_name]" value="">
      		<input type="checkbox" name="extra[my_name]" value="1" <?php checked( get_term_meta( $term->term_id, 'my_name', 1 ), 1 ); ?> ><br />
      		<span class="description">Мой чекбокс</span>
      	</td>
      </tr>
      Ответить1.7 года назад #
  • campusboy1948 cайт: www.youtube.com/c/wpplus

    Ё-май, сразу готовый код. Копируй, вставляй и наслаждайся. Тимур, как всегда на высоте smile Я уже каску приготовил и настойку пустырника, думал воевать как всегда придётся с такой задачей, а тут всё так просто. Просто супер!

    1
    Ответить1.4 года назад #
  • Александр

    Как это вообще может работать?! В $_POST при добавлении терма никак не может приходить мое собственное поле, так как передача идет аяксом, а аякс не получает это поле. Поэтому $_POST на эти хуки будет без моего поля:

    // Сохранение при добавлении элемента таксономии
    add_action("create_{$taxname}", 'save_custom_taxonomy_meta');
    // Сохранение при редактировании элемента таксономии
    add_action("edited_{$taxname}", 'save_custom_taxonomy_meta');
    

    В чем я не прав?

    Ответить1.3 года назад #
  • Дмитрий

    Что делать если в слаге таксономии есть дефис, т.е.

    function save_taxname-name() {
    	// code...
    }

    Как решить? (переименовать таксономию не вариант)

    Ответитьгод назад #
    • Kama4659

      Слаг указывается в названии хука, а не в названии функции. Разберись в том что выше написано... Дефис никак не мешает в результате...

      1
      Ответитьгод назад #
  • Nick

    Не ясно как вывести эти мета поля?

    Ответитьгод назад #
    • Kama4659

      Например ID термина 10, тогда:

      $title =  get_term_meta( 10 , 'title', 1 );
      $description =  get_term_meta( 10 , 'description', 1 );
      Ответитьгод назад #
  • Дмитрий

    Как данный пример отобразить в метках (в дополнительно созданных метках и рубриках), очень хорошо было бы с подробными пояснениями

    • Kama4659

      Замени category в $taxname = 'category'; на название нужной тебе таксономии.

  • tester

    $termeta - массив, который не определен в примере. код не рабочий...

    1
    Ответить4 месяца назад #
  • Артур

    Поставил готовый код в functions.php Сохраняет только title. Описание и ключевые слова нет. В чем может быть проблема?

    Ответить24 дня назад #
  • Еле нашел плагин - в тесте ещё не был но на взгляд чистенький и ничего лишнего как в других

    это для тех кому иногда лень ручками заполнять или для таких невнимательных как я

    примеры использования

        // для первого плагина 
    	echo $MetaValue = get_term_meta( 31 , 'slug_name', 1 );
    
    	// для второго плагина (массив)
    	$arrayMetaList = get_all_wp_terms_meta(31); 
    	print_r($arrayMetaList);
    	// для второго плагина (одно поле)
    	echo $MetaValue = wp_get_terms_meta(31, 'slug_name' ,true);
    
    1
    Ответить18 дней назад #

Здравствуйте, !

Ваш комментарий