Описание
Поле File позволяет загружать и выбирать файл с помощью стандартного медиапопапа WordPress.
Скриншоты
История изменений
- Настройка
minimumдобавлена в версии 5.1.9. - Настройка
maximumдобавлена в версии 5.1.9. - Настройка
allowed file typesдобавлена в версии 5.1.9.
Настройки
Возвращаемое значение
Определяет формат возвращаемых данных. Выберите File Array (массив), File URL (строка) или File ID (целое число).Библиотека
Ограничивает выбор файлов только файлами, загруженными в эту запись, или позволяет выбирать файлы из всей библиотеки.Минимальный размер
Добавляет проверку загружаемого файла на минимальный размер в МБ (целое число). Размер файла также можно указать строкой с единицей измерения, например «400 KB».Максимальный размер
Добавляет проверку загружаемого файла на максимальный размер.Разрешённые типы файлов
Добавляет проверку загружаемого файла на соответствие определённым типам. Введите список разрешённых типов через запятую или оставьте поле пустым, чтобы разрешить все типы.
Использование в шаблоне
Поле File возвращает массив, строку или целое число в зависимости от выбранного параметра Return Value. Ниже приведены примеры использования этих данных.
Базовое отображение (массив)
В этом примере показано, как отобразить выбранный файл при использовании типа возвращаемого значения array. Этот тип позволяет легко получать такие данные, как url и filename.
<?php
$file = get_field('file');
if( $file ): ?>
<a href="<?php echo $file['url']; ?>"><?php echo $file['filename']; ?></a>
<?php endif; ?>Расширенное отображение (массив)
В этом примере показано, как отобразить пользовательскую ссылку при использовании типа возвращаемого значения array. Этот тип позволяет легко получать такие данные, как url, title, type и другие.
<?php
$file = get_field('file');
if( $file ):
// Извлечь переменные.
$url = $file['url'];
$title = $file['title'];
$caption = $file['caption'];
$icon = $file['icon'];
// По возможности отобразить миниатюру изображения.
if( $file['type'] == 'image' ) {
$icon = $file['sizes']['thumbnail'];
}
// Начать обёртку подписи.
if( $caption ): ?>
<div class="wp-caption">
<?php endif; ?>
<a href="<?php echo esc_attr($url); ?>" title="<?php echo esc_attr($title); ?>">
<img src="<?php echo esc_attr($icon); ?>" />
<span><?php echo esc_html($title); ?></span>
</a>
<?php
// Завершить обёртку подписи.
if( $caption ): ?>
<p class="wp-caption-text"><?php echo esc_html($caption); ?></p>
</div>
<?php endif; ?>
<?php endif; ?>Базовое отображение (ID)
В этом примере показано, как отобразить выбранный файл при использовании типа возвращаемого значения ID.
<?php
$file = get_field('file');
if( $file ):
$url = wp_get_attachment_url( $file ); ?>
<a href="<?php echo esc_html($url); ?>" >Скачать файл</a>
<?php endif; ?>Базовое отображение (URL)
В этом примере показано, как отобразить выбранный файл при использовании типа возвращаемого значения URL.
<?php if( get_field('file') ): ?>
<a href="<?php the_field('file'); ?>" >Скачать файл</a>
<?php endif; ?>Обновлено: 30.09.2026