Обзор
Поле «Файл» позволяет загрузить и выбрать произвольный файл. Это поле использует встроенный загрузчик WordPress, который появляется в виде попапа и позволяет осуществить добавление фото.
Скриншоты
Настройки
| Имя | Описание |
|---|---|
| Возвращаемое значение | Определяет в каком формате должны возвращаться данные. Может быть Массив (массив), Ссылка на файл (строка) или ID файла (число). |
| Библиотека | Позволяет выбрать откуда будет доступен файл: только в текущем посте или во всей медиабиблиотеке. |
| Минимум | Добавляет проверку на размер файла (mb, число). Размер файла также можно указать строкой. Например, «400 KB». Добавлено в v5.1.9 |
| Максимум | Устанавливает максимальное значения размера файла. Добавлено в v5.1.9 |
| Допустимые типы файлов | Добавляет проверку на тип файла. Введите через запятую нужные типы файлов для возможности загрузки только их. Оставьте поле пустым, если хотите разрешить загрузку файлов с любым типом. Добавлено в v5.1.9 |
Использование в шаблоне
Поле Файл выводит массив, строку или число в зависимости от выбранной настройки Возвращаемое значение. Ниже примеры как вы можете это использовать. Учитывайте, что все примеры используют в качестве названия поля file и если вы работаете с повторителем, то должны заменить get_field и the_field, на get_sub_field и the_sub_field соответственно.
Базовый вывод (ID)
В этом примере показано как отобразить файл, используя возвращаемое значение ID. Этот тип данных позволяет загружать только необходимые данные.
<?php
$file = get_field('file');
if( $file ) {
$url = wp_get_attachment_url( $file );
?><a href="<?php echo $url; ?>" >Скачать файл</a><?php
}
?>Базовый вывод (массив)
В этом примере показано как вывести файл, используя возвращаемое значение Массив изображения. Этот возвращаемый тип позволяет легко получить доступ к дополнительным свойствам изображения таким как url и имя файла.
<?php
$file = get_field('file');
if( $file ): ?>
<a href="<?php echo $file['url']; ?>"><?php echo $file['filename']; ?></a>
<?php endif; ?>Продвинутый вывод (массив)
В этом примере показано как вывести файл определенного размера, используя возвращаемое значение Массив изображения. Для того чтобы узнать все доступные данные используйте отладку для переменной $file.
<?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 $url; ?>" title="<?php echo $title; ?>">
<img src="<?php echo $icon; ?>" />
<span><?php echo $title; ?></span>
</a>
<?php if( $caption ): ?>
<p class="wp-caption-text"><?php echo $caption; ?></p>
</div>
<?php endif; ?>
<?php endif; ?>Базовый вывод (Ссылка на файл)
В этом примере показано как отобразить файл, используя возвращаемое значение Ссылка на изображение. Этот возвращаемый тип позволяет легко получить ссылку, но не загружает дополнительные данные о файле.
<?php if( get_field('file') ): ?>
<a href="<?php the_field('file'); ?>" >Download File</a>
<?php endif; ?>