Описание
Поле Link позволяет выбрать или задать ссылку (URL, заголовок и цель) с помощью стандартного всплывающего окна ссылок WordPress.
Скриншоты
История изменений
- Добавлено в версии 5.6.0.
Настройки
- Возвращаемое значение
Определяет формат возвращаемых данных. Выберите Link Array (массив данных) или Link URL (строка).
Использование в шаблоне
Поле Link возвращает массив или строку в зависимости от настройки возвращаемого значения. Ниже приведены примеры использования этих данных.
Базовое отображение (массив)
В этом примере показано, как отобразить выбранную ссылку при использовании типа возвращаемого значения Link Array.
<?php
$link = get_field('link');
if( $link ):
$link_url = $link['url'];
$link_title = $link['title'];
$link_target = $link['target'] ? $link['target'] : '_self';
?>
<a class="button" href="<?php echo esc_url( $link_url ); ?>" target="<?php echo esc_attr( $link_target ); ?>"><?php echo esc_html( $link_title ); ?></a>
<?php endif; ?>
Базовое отображение (строка)
В этом примере показано, как отобразить выбранную ссылку при использовании типа возвращаемого значения Link URL.
<?php
$link = get_field('link');
if( $link ): ?>
<a class="button" href="<?php echo esc_url( $link ); ?>">Продолжить чтение</a>
<?php endif; ?>
Обязательный ввод в поле ссылки
В зависимости от того, как вы используете данные поля ссылки, может потребоваться сделать текст ссылки обязательным, особенно если он используется в целях обеспечения доступности.
Добавить собственную функцию валидации, требующую заполнить текст ссылки, можно с помощью фильтра acf/validate_value следующим образом:
function my_custom_validation_callback_function( $valid, $value, $field, $input_name ) {
// Если проверяемое поле имеет тип link, формат возврата — "array", а заголовок пуст.
if ( 'link' === $field['type'] && 'array' === $field['return_format'] && empty( $value['title'] ) ) {
// Показать сообщение об ошибке.
return __( 'Убедитесь, что вы ввели значение для текста ссылки.' );
}
// В противном случае ничего не изменять.
return $valid;
}
add_filter( 'acf/validate_value', 'my_custom_validation_callback_function', 10, 4 );
Обновлено: 30.09.2026