Функция add_post_type_support() в WordPress с примерами.

Функция add_post_type_support() в WordPress используется для добавления поддержки различных функциональных возможностей к пользовательским типам записей. Это позволяет расширить функциональность пользовательских типов записей, добавляя к ним стандартные возможности, такие как поддержка миниатюр, тегов, настроек публикации и др.

add_post_type_support( string $post_type, string|array $supports, ...$args );

Параметры

• $post_type (строка): Идентификатор пользовательского типа записи, к которому добавляется поддержка.
• $supports (строка|массив): Один или несколько типов поддержки, которые нужно добавить. Возможные значения:
  • title — поддержка заголовка.
  • editor — поддержка редактора контента.
  • author — поддержка выбора автора.
  • thumbnail — поддержка миниатюры.
  • excerpt — поддержка краткого описания.
  • trackbacks — поддержка трекбэков.
  • custom-fields — поддержка пользовательских полей.
  • comments — поддержка комментариев.
  • revisions — поддержка ревизий.
  • page-attributes — поддержка атрибутов страницы, таких как шаблоны и древовидная структура.
  • post-formats — поддержка форматов записей, если они включены в тему.
• ...$args (разное): Дополнительные аргументы, которые будут переданы в указанную возможность в $supports. Это имеет смысл только при указании одной возможности (строка).

Возвращаемое значение

Функция не возвращает значений.

Примечания

• Использование функции: Рекомендуется вызывать add_post_type_support() в событии init, чтобы гарантировать, что тип записи уже зарегистрирован. Это важно, поскольку функция работает с глобальной переменной $_wp_post_type_features, в которой тип записи должен существовать.
• Расширение возможностей: Функция полезна для добавления дополнительных возможностей к уже зарегистрированным типам записей, которые не были указаны при их регистрации через register_post_type().

Пример 1: Добавление различных возможностей

В этом примере мы добавляем поддержку комментариев и пользовательских полей к пользовательскому типу записи my_post_type.

add_post_type_support( 'my_post_type', 'comments' );
add_post_type_support( 'my_post_type', ['author', 'excerpt'] );
add_post_type_support( 'my_post_type', 'my_feature', ['field' => 'value'] );

Пример 2: Поддержка цитат у постоянных страниц

Этот пример демонстрирует, как добавить блок для ввода краткого описания (цитаты) к постоянным страницам (тип записи page), что обычно доступно для записей, но не для страниц.

add_action( 'init', 'my_custom_init' );
function my_custom_init() {
    add_post_type_support( 'page', 'excerpt' );
}

Пример 3: Добавление метаполей к уже зарегистрированному типу записи

Если у вас есть тип записи book, и вы хотите добавить поддержку пользовательских полей только для администраторов, используйте следующий код:

add_action( 'init', 'true_metaboxes_to_game' );
function true_metaboxes_to_game() {
    if ( ! current_user_can('manage_options') ) {
        return;
    }

    add_post_type_support( 'book', ['custom-fields'] );
}

Пример 4: Практическое применение

В следующем примере добавляется поддержка миниатюр и настроек публикации к пользовательскому типу записи с идентификатором my_custom_post_type.

function my_custom_post_type_setup() {
    // Регистрируем пользовательский тип записи
    register_post_type( 'my_custom_post_type', array(
        'labels' => array(
            'name' => 'Custom Posts',
            'singular_name' => 'Custom Post',
        ),
        'public' => true,
        'has_archive' => true,
    ) );

    // Добавляем поддержку миниатюр
    add_post_type_support( 'my_custom_post_type', 'thumbnail' );
    
    // Добавляем поддержку атрибутов страницы
    add_post_type_support( 'my_custom_post_type', 'page-attributes' );
}

// Хук к инициализации темы
add_action( 'init', 'my_custom_post_type_setup' );

Заключение

Функция add_post_type_support() предоставляет гибкость для расширения возможностей пользовательских типов записей в WordPress. Используя эту функцию, вы можете легко добавлять поддержу различных метабоксов и функциональных возможностей, которые могут быть необходимы для вашей кастомной структуры контента.