Пакетные решения для WordPress и WooCommerce от топовых Российских авторов!
Функция has_blocks() проверяет, содержит ли заданное содержимое запись блоки. Она используется для определения, необходимо ли применять определенные стили или сценарии на основе наличия блоков.
Эта функция полезна для разработчиков тем и плагинов, которые хотят адаптировать свои стили или поведение в зависимости от типа содержимого записи.
Тип: string
Обязательный: Да
По умолчанию: null
Описание: Содержимое записи, которое нужно проверить на наличие блоков
Возможные значения:
Тип: bool
Описание: Возвращает true, если блоки найдены, иначе false
Возможные значения:
• true — если блоки присутствуют
• false — если блоков нет
Базовый пример проверки наличия блоков в содержимом
$content = 'Текст параграфа';
if (has_blocks($content)) {
echo 'Содержимое содержит блоки';
} else {
echo 'Содержимое не содержит блоки';
}
Вывод: Содержимое содержит блоки
Проверка пустого содержимого на наличие блоков
$content = '';
if (has_blocks($content)) {
echo 'Содержимое содержит блоки';
} else {
echo 'Содержимое не содержит блоки';
}
Вывод: Содержимое не содержит блоки
Валидация входных данных: Функция проверяет тип входных данных и ожидает строку
Санитизация: Не требуется дополнительная очистка для этого параметра
Рекомендации: Убедитесь, что передаваемая строка является корректным HTML-содержимым
Отображает блок на основе его идентификатора и атрибутов
Парсит содержимое записи и возвращает массив блоков
Функция может не определить блоки из нестандартных форматов
Функция get_row() используется для получения одной строки результатов запроса к базе данных. Она возвращает данные в виде объекта или массива, что позволяет легко работать с полученными значениями.
Функция применяется, когда необходимо извлечь информацию о записи без необходимости получать все строки, например, для получения настроек, метаданных или других единичных значений.
Тип: string
Обязательный: Да
Описание: SQL-запрос для выполнения
Возможные значения:
Тип: string
Обязательный: Нет
По умолчанию: OBJECT
Описание: Формат возвращаемых данных
Возможные значения:
0: ARRAY_A
1: ARRAY_N
2: OBJECT
Тип: mixed
Описание: Возвращает строку результатов запроса в указанном формате
Возможные значения:
• Объект WPDB при использовании OBJECT
• Ассоциативный массив при использовании ARRAY_A
• Индексационный массив при использовании ARRAY_N
• NULL если ничего не найдено
Базовый пример получения названия блога
$row = $wpdb->get_row('SELECT * FROM wp_options WHERE option_name = "blogname"');
echo $row->option_value; // Выводит название блога
Название блога будет выведено
Получение данных пользователя в виде ассоциативного массива
$row = $wpdb->get_row('SELECT * FROM wp_users WHERE ID = 1', ARRAY_A);
print_r($row); // Выводит данные пользователя как массив
Данные пользователя будут выведены в массиве
Проверка на наличие записи и вывод сообщения об ошибке
$row = $wpdb->get_row('SELECT * FROM wp_options WHERE option_name = "invalid_option"');
if (is_null($row)) {
echo 'Запись не найдена';
}
Если запись не найдена, выводится сообщение
Валидация входных данных: SQL-запросы должны тщательно проверяться перед выполнением
Санитизация: Используйте $wpdb->prepare() для безопасного выполнения запросов
Рекомендации: Не передавайте пользовательские данные напрямую в запросы
Получает несколько строк результатов запроса
Получает одно значение из базы данных
Функция возвращает только одну строку; для получения нескольких строк используйте get_results()
Функция get_fields() используется для получения всех пользовательских полей (custom fields) для конкретного поста, страницы или пользовательского типа записи. Она возвращает массив значений пользовательских полей, которые могут быть добавлены с помощью плагина Advanced Custom Fields (ACF).
Функция полезна для работы с метаполями и позволяет легко извлекать данные, добавленные к записям.
Тип: int
Обязательный: Да
Описание: ID поста или страницы, для которого необходимо получить пользовательские поля
Возможные значения:
Тип: array|null
Описание: Массив пользовательских полей или null
Возможные значения:
• Массив значений пользовательских полей при успешном выполнении
• null если пользовательские поля не найдены
Базовый пример получения пользовательских полей поста с ID 1
$fields = get_fields(1);
if ($fields) {
foreach ($fields as $key => $value) {
echo $key . ': ' . $value . '<br>';
}
}
Вывод всех пользовательских полей поста
Проверка на наличие пользовательских полей для поста с ID 2
$fields = get_fields(2);
if ($fields === null) {
echo 'Нет пользовательских полей';
}
Вывод сообщения, если поля отсутствуют
Валидация входных данных: ID поста должен быть целым числом
Санитизация: Данные, возвращаемые функцией, очищаются автоматически
Рекомендации: При выводе данных используйте esc_html() для защиты от XSS
Получает одно пользовательское поле по его ключу
Обновляет значение пользовательского поля
Фильтрует массив пользовательских полей перед их возвратом
Работает только с пользовательскими полями, созданными с помощью ACF
Функция get_field() используется для получения значений произвольных полей, созданных с помощью плагина Advanced Custom Fields (ACF). Она позволяет извлекать данные, ассоциированные с постами, страницами и другими объектами, с целью их дальнейшего использования в шаблонах.
Функция поддерживает различные типы данных, включая текст, изображения, массивы и объекты
Тип: string
Обязательный: Да
Описание: Имя поля, значение которого нужно получить
Возможные значения:
Тип: mixed
Обязательный: Нет
По умолчанию: null
Описание: ID поста, для которого нужно получить значение поля. Если не указано, будет использован текущий пост
Возможные значения:
Тип: mixed
Описание: Возвращает значение поля, если оно существует и доступно
Возможные значения:
• Значение поля (например, строка, массив, объект)
• null если поле не существует
• false в случае ошибки
Получение значения произвольного поля для текущего поста
$value = get_field('my_custom_field');
// Вывод значения произвольного поля
echo $value;
Выводит значение поля, если оно существует
Получение значения произвольного поля для поста с указанным ID
$value = get_field('my_custom_field', 123);
// Вывод значения произвольного поля для поста с ID 123
echo $value;
ID поста должен существовать
Проверка на существование поля перед выводом
$value = get_field('non_existent_field');
if ($value === null) {
echo 'Поле не найдено';
} else {
echo $value;
}
Выводит сообщение об ошибке, если поле не найдено
Использование произвольного поля в шаблоне темы
$subtitle = get_field('subtitle');
if ($subtitle) {
echo '<h2>' . esc_html($subtitle) . '</h2>';
}
Выводит подзаголовок если он существует
Валидация входных данных: Функция проверяет наличие поля перед его получением
Санитизация: Рекомендуется использовать esc_html() для вывода данных
Рекомендации: Проверяйте существование поля перед использованием его значения
Обновляет значение произвольного поля
Удаляет значение произвольного поля
Фильтрует значение поля перед его возвратом
Работает только с полями, созданными с помощью ACF
Функция add_row() добавляет новую строку в таблицу пользовательских полей (custom fields) для заданного поста. Она используется в основном в контексте пользовательских полей или мета-полей, позволяя разработчикам динамически добавлять данные к записям, страницам или пользовательским типам записей.
Функция полезна для работы с полями повторителей, когда нужно добавлять несколько значений для одного мета-поля.
Тип: string
Обязательный: Да
Описание: Ключ мета-поля, в которое будет добавлена строка
Возможные значения:
Тип: mixed
Обязательный: Да
Описание: Значение, которое будет добавлено в строку мета-поля
Возможные значения:
Тип: int
Обязательный: Да
Описание: ID поста, к которому будет добавлено значение
Возможные значения:
Тип: int|false
Описание: Возвращает ID добавленной строки или false в случае ошибки
Возможные значения:
• ID строки при успешном выполнении
• false при ошибке
Базовый пример добавления новой строки в мета-поле
$result = add_row('my_repeater_field', 'значение', 123);
// Проверка результата
if ($result) {
echo 'Строка добавлена с ID: ' . $result;
} else {
echo 'Ошибка при добавлении строки';
}
Строка добавлена с ID: 4
Добавление массива значений к мета-полю
$values = array('первое', 'второе');
$result = add_row('my_repeater_field', $values, 123);
Добавляет массив значений в одну строку
Проверка на наличие ошибок при добавлении строки
$result = add_row('my_repeater_field', 'значение', 999);
if ($result === false) {
// Обработка ошибки
echo 'Не удалось добавить строку';
}
Сообщение об ошибке, если строка не добавлена
Валидация входных данных: Необходимо проверить правильность post_id перед вызовом функции
Санитизация: Функция самостоятельно обрабатывает значения перед добавлением
Рекомендации: Используйте esc_html() для вывода данных из мета-полей
Получает значение мета-поля по ключу
Обновляет существующую строку в мета-поле
Не работает с мета-полями, не поддерживающими повторители
Функция acf_with_default() используется для получения значения поля, созданного с помощью плагина Advanced Custom Fields (ACF), и возвращает заданное значение по умолчанию, если поле не заполнено. Это позволяет избежать появления пустых значений и упрощает работу с данными ACF.
Функция используется в шаблонах тем и плагинах для обработки пользовательских полей, созданных с помощью ACF.
Тип: string
Обязательный: Да
Описание: Ключ поля ACF, значение которого нужно получить
Возможные значения:
Тип: mixed
Обязательный: Нет
Описание: Значение по умолчанию, возвращаемое, если поле не заполнено
Возможные значения:
Тип: mixed
Описание: Значение поля ACF или значение по умолчанию
Возможные значения:
• Значение поля, если оно заполнено
• Значение по умолчанию, если поле пустое
Базовый пример получения значения поля с использованием значения по умолчанию
$value = acf_with_default('field_1234567890abc', 'default text');
// Если поле пустое, $value будет 'default text'
Получение числового значения с использованием значения по умолчанию
$number = acf_with_default('field_9876543210def', 10);
// Если поле пустое, $number будет 10
Пример обработки ошибки при получении значения с неверным ключом
$value = acf_with_default('field_invalid_key', 'fallback');
// Если ключ неверный, $value будет 'fallback'
Применение функции в шаблоне темы для вывода подзаголовка
$subtitle = acf_with_default('field_subtitle', 'No subtitle available');
// Используется для вывода подзаголовка на странице
Валидация входных данных: Функция не требует явной валидации входных параметров, но ключ поля должен быть корректным
Санитизация: Рекомендуется очищать значения перед выводом
Рекомендации: Используйте функции esc_html() и esc_attr() для вывода значений на экран
Получает значение поля ACF без значения по умолчанию
Выводит значение поля ACF на экран
Функция зависит от наличия установленного и активного плагина ACF
Функция acf_strlen() предназначена для получения длины строки, учитывая особенности кодировки. Она используется в плагине Advanced Custom Fields (ACF) для обработки пользовательских полей. Функция обеспечивает правильное вычисление длины строки, что особенно важно для работы с многоязычными сайтами и символами за пределами ASCII
Функция работает на основе стандартной функции mb_strlen, что позволяет избежать проблем с многобайтовыми кодировками
Тип: string
Обязательный: Да
Описание: Строка, длину которой необходимо вычислить
Возможные значения:
Тип: string
Обязательный: Нет
По умолчанию: UTF-8
Описание: Кодировка строки. Если не указана, будет использована кодировка по умолчанию UTF-8
Возможные значения:
0: UTF-8
1: ISO-8859-1
2: Windows-1251
Тип: int
Описание: Длина строки в символах
Возможные значения:
• Положительное целое число, представляющее длину строки
• 0, если строка пустая
Базовый пример получения длины строки
$length = acf_strlen('Привет, мир!');
// $length будет равно 12
Длина строки ‘Привет, мир!’ составляет 12 символов
Получение длины строки с использованием кодировки Windows-1251
$length = acf_strlen('Тест', 'Windows-1251');
// $length будет равно 4
Строка ‘Тест’ имеет длину 4 символа
Валидация входных данных: Функция проверяет входную строку на корректность
Санитизация: Не требуется дополнительной очистки входящих параметров
Рекомендации: Убедитесь, что строка не содержит небезопасных данных перед использованием
Стандартная функция для получения длины строки с поддержкой многобайтовых кодировок
Функция для получения длины строки в байтах
Не поддерживает строки с неподдерживаемыми кодировками
Функция acf_shortcode() позволяет создавать шорткоды для полей, созданных с помощью плагина Advanced Custom Fields (ACF). Она используется для вывода значений пользовательских полей ACF в контенте постов или страниц, что делает их доступными для редактирования через визуальный редактор.
Функция особенно полезна для разработчиков, создающих динамические контенты на своем сайте.
Тип: array
Обязательный: Да
По умолчанию: {}
Описание: Массив атрибутов шорткода, содержащий ключи для полей ACF
Возможные значения:
field: Имя поля ACF
post_id: ID поста, для которого получаем поле
format: value, label
Тип: mixed
Описание: Значение поля ACF или значение по умолчанию
Возможные значения:
• Строка с значением поля ACF при успешном выполнении
• null если поле не найдено или пустое
• WP_Error в случае ошибки
Вывод значения поля ACF с именем ‘my_custom_field’
[acf field='my_custom_field']
Если поле пустое, то ничего не будет выведено
Вывод значения поля ACF для поста с ID 123
[acf field='my_custom_field' post_id='123']
Важно указывать корректный ID поста
Валидация входных данных: Параметры шорткода валидируются внутри функции
Санитизация: Значения полей автоматически очищаются WordPress
Рекомендации: Используйте esc_html() для вывода значений полей
Получает значение одного поля ACF
Выводит значение одного поля ACF напрямую
Фильтрует атрибуты шорткода перед его выполнением
Некоторые поля могут требовать специфической обработки
Функция acf_get_object_type() используется для получения типа объекта (например, пост, пользователь, термин) для значения ACF (Advanced Custom Fields). Она особенно полезна при работе с пользовательскими полями, позволяя определить, к какому типу данных принадлежит конкретное значение ACF.
Эта функция может использоваться в различных контекстах, когда требуется знать тип объекта для обработки данных пользовательских полей.
Тип: mixed
Обязательный: Да
Описание: Значение ACF, для которого нужно получить тип объекта
Возможные значения:
Тип: string|null
Описание: Тип объекта, соответствующий переданному значению ACF
Возможные значения:
• ‘post’
• ‘user’
• ‘term’
• null
Базовый пример получения типа объекта для ID поста
$object_type = acf_get_object_type(123);
// $object_type будет 'post'
Получение типа объекта для объекта пользователя
$user = get_user_by('ID', 456);
$object_type = acf_get_object_type($user);
// $object_type будет 'user'
Проверка на null в случае, если тип объекта не определен
$object_type = acf_get_object_type($non_existent_value);
if ($object_type === null) {
echo 'Тип объекта не найден';
}
Использование функции в контексте получения пользовательского поля
$value = get_field('custom_field');
$object_type = acf_get_object_type($value);
// В зависимости от значения ACF, мы можем предпринять действия
Валидация входных данных: Функция проверяет входные данные на корректность
Санитизация: Не требуется дополнительная очистка, так как функция работает с уже проверенными значениями ACF
Рекомендации: Убедитесь, что значения, передаваемые в функцию, получены из безопасных источников
Получает значение пользовательского поля ACF
Получает значение ACF, включая обработку типов объектов
Функция может не возвращать значения для нестандартных типов объектов
Функция acf_form_head() инициализирует поддержку форм Advanced Custom Fields (ACF) в WordPress. Она должна быть вызвана перед выводом заголовка страницы, чтобы корректно подключить необходимые стили и скрипты ACF.
Эта функция используется при создании форм для редактирования пользовательских полей на фронтенде сайта.
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки формы ACF
Возможные значения:
post_id: ID записи, к которой будут привязаны поля
form_attributes: Массив дополнительных атрибутов для формы
field_groups: ID групп полей ACF для отображения
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
• Вызов функции приводит к инициализации ACF форм
• Никаких значений не возвращается
Инициализация ACF форм перед выводом контента страницы
acf_form_head();
// После этого можно выводить форму ACF на странице
Необходимо вызывать до вызова wp_head()
Передача параметров для настройки ACF формы
$args = array(
'post_id' => 'new_post',
'field_groups' => array(123),
'form_attributes' => array('class' => 'my-form')
);
acf_form_head($args);
Замените 123 на ID вашей группы полей
Валидация входных данных: Параметры проверяются на корректность внутри функции ACF
Санитизация: ACF автоматически очищает входные данные
Рекомендации: Убедитесь, что пользователь имеет права на редактирование поля перед его отображением
Отображает форму ACF на странице
Добавляет локальную группу полей ACF
Функция должна вызываться до вывода заголовка страницы
Авторизуйтесь, чтобы продолжить *
Пакетные решения для WordPress и WooCommerce
Ещё один сайт на WordPress 💛