Купить

Файл (File)

Обзор

Поле «Файл» позволяет загрузить и выбрать произвольный файл. Это поле использует встроенный загрузчик 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; ?>