woocommerce_form_field()

В зависимости от переданных параметров возвращает или выводит HTML поля формы.

woocommerce_form_field( $key, $args, $value = null );

Параметры функции woocommerce_form_field()

$key
(строка) Одновременно атрибут name и id поля, если только значение id не передано отдельно внутри массива $args.
$args
(массив) Массив параметров поля.
type
Тип поля, принимает значения:
  • text
  • select
  • radio
  • password
  • datetime
  • datetime-local
  • date
  • month
  • time
  • week
  • number
  • email
  • url
  • tel
  • country – выпадающий список стран, поддерживаемых вашим интернет-магазином, которые установлены в настройках WooCommerce > Настройки > Основные. Также интересный момент, что если вы укажете значение параметра $key равным shipping_country, то в выпадающем списке будут присутствовать только те страны, в которые вы доставляете товары (тоже настраивается в настройках).
  • state – выпадающий список штатов/регионов в зависимости от страны.
country
(строка) Только для полей типа state. Укажите страну, регионы которой нужно получить. Если не указано, функция будет пытаться получить текущее значение страны из платёжного адреса или адреса доставки.
label
(строка) Лейбл поля.
description
(строка) Произвольный текст или HTML, который будет добавлен сразу под полем.
placeholder
(строка) Можно использовать этот параметр для добавления плейсхолдера к полям поддерживающим его, например text или textarea.
maxlength
(целое) Добавляет maxlength HTML-атрибут к полю. to the field. По умолчанию – false (не добавлять).
required
(логическое) Всего лишь добавляет звёздочку * рядом с названием поля.
autocomplete
(строка) Позволяет добавить autocomplete HTML-атрибут к полю. По умолчанию – false. Корректные значения это on или off.
id
(строка) Если вы хотите, чтобы атрибут id поля отличался от атрибута name, то укажите его здесь.
class
(массив) Можно передать список CSS-классов в виде массива, наример array( 'mishaclass' ), array( 'misha', 'wp-misha' ). Будут добавлены не на само поле, а на элемент-контейнер..
label_class
(массив) CSS-классы, которые будут добавлены на тег <label> поля.
input_class
(массив) CSS-классы, которые будут добавлены непосредственно на HTML-элемент поля.
return
(логическое) По умолчанию функция выводит результат, но вы можете указать этот параметр в значение true и тогда результат будет возвращён.
options
(массив) Только для типов полей select или radio! В качестве значения передайте массив параметров в виде:
array( '' => 'Select...', 'val1' => 'Title 1')
custom_attributes
(массив) Вы можете передавать любое количество дополнительных HTML-атрибутов в виде ассоциативного массива, например:
array( 'data-length' => 500 ).
default
Значение поля по умолчанию.
autofocus
(логическое) Если вы хотите, чтобы фокус на поле происходил автоматически при загрузке страницы. По умолчанию – false. Если на странице у вас несколько полей с автофокусом, то фокус будет на первом.
$value
(строка) Значение поля

Пример – выводим поле возраста

woocommerce_form_field( 
	'age', 
	array(
		'type'        => 'text',
		'required'    => true,
		'label'       => 'Возвраст',
		'description' => 'Пожалуйста, укажите свой возраст',
	)
);

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Оставить комментарий

Если вы хотите добавить код, не забудьте обернуть его в <pre lang="php"></pre>, если же код меньше одной строчки, то можно и в <code></code>.

Нажав на кнопку, вы соглашаетесь с тем, как обрабатываются персональные данные.