add_theme_support()

Регистрирует поддержку темы для указанной функции
Функция WordPress
INT 2.9.0
WordPress Icon

Описание функции

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

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

add_theme_support( string $feature, mixed $args ): void|false;

Функция add_theme_support() принимает два обязательных параметра: $feature и $args. Она регистрирует поддержку определенной функции темы.

  • $feature (обязательный): Функция, которую необходимо добавить. Возможные значения включают: ‘admin-bar’, ‘align-wide’, ‘automatic-feed-links’, ‘core-block-patterns’, ‘custom-background’, ‘custom-header’, ‘custom-line-height’, ‘custom-logo’, ‘customize-selective-refresh-widgets’, ‘custom-spacing’, ‘custom-units’, ‘dark-editor-style’, ‘disable-custom-colors’, ‘disable-custom-font-sizes’, ‘editor-color-palette’, ‘editor-gradient-presets’, ‘editor-font-sizes’, ‘editor-styles’, ‘featured-content’, ‘html5’, ‘menus’, ‘post-formats’, ‘post-thumbnails’, ‘responsive-embeds’, ‘starter-content’, ‘title-tag’, ‘wp-block-styles’, ‘widgets’, ‘widgets-block-editor’.
  • $args (необязательный): Дополнительные аргументы, которые можно передать для определенных функций.

Функция add_theme_support() возвращает void в случае успешного выполнения и false в случае ошибки.

<?php
// Регистрация поддержки миниатюр записей
add_theme_support( 'post-thumbnails' );
// Регистрация поддержки пользовательского логотипа
add_theme_support( 'custom-logo', array(
    'height'      => 100,
    'width'       => 400,
    'flex-height' => true,
    'flex-width'  => true,
) );
// Регистрация поддержки пользовательского фона
add_theme_support( 'custom-background', array(
    'default-color' => 'ffffff',
    'default-image' => get_template_directory_uri() . '/images/background.jpg',
) );
?>

В этом примере кода мы регистрируем поддержку миниатюр записей, пользовательского логотипа и пользовательского фона. Для пользовательского логотипа мы указываем высоту, ширину и другие параметры, а для пользовательского фона мы указываем цвет по умолчанию и изображение по умолчанию.

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

Регистрация поддержки функции add_theme_support()


add_theme_support( 'custom-logo' );

Этот пример кода регистрирует поддержку пользовательского логотипа в теме WordPress. После вызова этой функции, пользователи смогут загружать и устанавливать свой собственный логотип через интерфейс администратора.

Настройка цветовой палитры редактора


add_theme_support( 'editor-color-palette', array(
    array(
        'name'  => __( 'Primary Color', 'text-domain' ),
        'slug'  => 'primary',
        'color' => '#ff0000',
    ),
    array(
        'name'  => __( 'Secondary Color', 'text-domain' ),
        'slug'  => 'secondary',
        'color' => '#00ff00',
    ),
) );

Этот пример кода настраивает цветовую палитру редактора WordPress. Он добавляет два цвета в палитру: «Primary Color» с красным цветом и «Secondary Color» с зеленым цветом. После вызова этой функции, редактор будет предлагать эти цвета для использования при создании и редактировании контента.

Добавление поддержки виджетов


add_theme_support( 'widgets' );

Этот пример кода добавляет поддержку виджетов в тему WordPress. После вызова этой функции, пользователи смогут использовать виджеты и управлять ими через интерфейс администратора.

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


function theme_prefix_setup() {
    add_theme_support( 'custom-logo', array(
        'height'      => 100,
        'width'       => 400,
        'flex-height' => true,
        'flex-width'  => true,
    ) );
}
add_action( 'after_setup_theme', 'theme_prefix_setup' );

Этот пример кода настраивает поддержку пользовательского логотипа в теме WordPress с дополнительными параметрами. Он устанавливает высоту логотипа в 100 пикселей, ширину в 400 пикселей и разрешает гибкое изменение размеров логотипа. Функция «theme_prefix_setup» вызывается после загрузки темы, чтобы зарегистрировать поддержку логотипа.

Настройка ширины блоков


add_theme_support( 'align-wide' );

Этот пример кода добавляет поддержку широких блоков в тему WordPress. После вызова этой функции, пользователи смогут использовать широкие блоки при создании и редактировании контента.

Вопросы и ответы

Как зарегистрировать поддержку административной панели в теме?

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

Пример кода:

add_theme_support( 'admin-bar' );

Как включить поддержку широкого выравнивания в теме?

Если вы хотите добавить поддержку широкого выравнивания в вашей теме WordPress, вы можете использовать функцию add_theme_support() с параметром 'align-wide'.

Пример кода:

add_theme_support( 'align-wide' );

Как добавить автоматические ссылки на ленту в тему?

Чтобы добавить автоматические ссылки на ленту в вашей теме WordPress, используйте функцию add_theme_support() с параметром 'automatic-feed-links'.

Пример кода:

add_theme_support( 'automatic-feed-links' );

Функция add_theme_support() регистрирует поддержку различных функций в вашей теме WordPress. Она принимает два параметра: $feature и $args.

Параметр $feature — это строка, которая указывает на функциональность, которую вы хотите добавить. Некоторые из возможных значений включают ‘admin-bar’, ‘align-wide’, ‘automatic-feed-links’ и другие.

Параметр $args — это дополнительные аргументы, которые могут быть переданы вместе с определенными функциями. Они являются необязательными.

Функция возвращает void в случае успеха и false в случае неудачи.

Используйте функцию add_theme_support() для добавления необходимой функциональности в вашу тему WordPress и создания более гибкого и мощного пользовательского интерфейса.

Как использовать ядро блочных шаблонов в теме?

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

add_theme_support( 'core-block-patterns' );

Это позволит использовать предустановленные блочные шаблоны в редакторе блоков.

Как добавить поддержку настраиваемого фона в тему?

Чтобы добавить поддержку настраиваемого фона в тему, используйте функцию add_theme_support() с параметром 'custom-background'.

add_theme_support( 'custom-background' );

Теперь пользователи смогут настраивать фон своего сайта через настройки темы в административной панели.

Как добавить поддержку настраиваемого заголовка в тему?

Для добавления поддержки настраиваемого заголовка в тему, используйте функцию add_theme_support() с параметром 'custom-header'.

add_theme_support( 'custom-header' );

Теперь пользователи смогут настраивать заголовок своего сайта через настройки темы в административной панели.

Как настроить настраиваемую высоту строки в теме?

Для настройки настраиваемой высоты строки в теме WordPress можно использовать функцию add_theme_support(). Эта функция позволяет зарегистрировать поддержку определенной функции в теме.

Для настройки настраиваемой высоты строки необходимо использовать параметр 'custom-line-height' при вызове функции add_theme_support(). Например:

add_theme_support( 'custom-line-height' );

Как добавить поддержку настраиваемого логотипа в тему?

Для добавления поддержки настраиваемого логотипа в тему WordPress также используется функция add_theme_support(). Для этого нужно передать параметр 'custom-logo' при вызове функции. Например:

add_theme_support( 'custom-logo' );

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

Для использования выборочного обновления виджетов в теме WordPress можно воспользоваться функцией add_theme_support(). Для этого нужно передать параметр 'customize-selective-refresh-widgets' при вызове функции. Например:

add_theme_support( 'customize-selective-refresh-widgets' );

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

Связанные элементы

  • Функция add_editor_style(): регистрирует стили редактора для использования в редакторе контента.
  • Функция add_image_size(): регистрирует новый размер изображения.
  • Функция add_post_type_support(): добавляет поддержку определенного типа записи для указанной функции.
  • Хук after_setup_theme: вызывается после загрузки активной темы и регистрации основных функций темы.
  • Хук customize_register: вызывается при регистрации настроек пользовательского интерфейса темы в реальном времени.
  • Класс WP_Customize_Manager: предоставляет методы для настройки пользовательского интерфейса темы в реальном времени.
  • Класс WP_Customize_Section: представляет секцию пользовательского интерфейса темы в настройках в реальном времени.
  • Класс WP_Customize_Setting: представляет настройку пользовательского интерфейса темы в настройках в реальном времени.
Обсуждение