apply_filters('wpforms_datetime_date_dropdowns', array $dates, int $form_id, array $field)

Descrição

O filtro wpforms_datetime_date_dropdowns define os rótulos e opções dentro do formato de lista pendente do campo de data.

Parâmetros

$datas

(array) (Obrigatório) Rótulos e intervalos numéricos usados nas listas pendentes de datas.

$id_formulario

(int) (Obrigatório) ID do formulário.

$campo

(array) (Obrigatório) Valores e propriedades do campo de data.

Origem

wpforms/pro/includes/fields/class-date-time.php

Mais Informações

O filtro wpforms_datetime_date_dropdowns é aplicado a um array que contém as opções de lista pendente de data. Pode ser usado para personalizar os rótulos para as listas pendentes de mês, dia e ano, bem como quais opções são incluídas em cada uma destas listas pendentes.

Nota: Os intervalos para dias, meses e anos só podem aceitar valores inteiros.

Exemplos

Limitar as datas

Neste exemplo mostrado abaixo, a função limitará os meses de janeiro a junho, os dias do 1º ao 15º e o ano começará em 1980.

A função também está a alterar os rótulos do padrão MM/DD/YYYY para M/D/Y.

Lembre-se apenas de alterar o ID do formulário de 25 para corresponder ao ID específico do formulário no qual pretende executar o seu código. Remover esta verificação executaria para todos os formulários.

/**
 * Filters labels and options within the date field’s dropdown format.

 * @link   https://wpforms.com/developers/wpforms_datetime_date_dropdowns/
 * 
 * @param  array  $dates    Months, Days, and Years arguments.
 * @param  int    $form_id  Form ID.
 * @param  array  $field    Date field values and properties.
 *
 * @return array
 */

function wpf_dev_datetime_date_dropdowns( $dates, $form_id, $field ) {

        // Only run on my form with ID = 25
        if ( absint( $form_id ) !== 25 ) {
            return $ranges;
        }  

	$ranges = array(
		'months'       => range( 1, 6 ),
		'days'         => range( 1, 15 ),
		'years'        => range( date( 'Y' ), 1980 ),
		'months_label' => esc_html__( 'M', 'wpforms' ),
		'days_label'   => esc_html__( 'D', 'wpforms' ),
		'years_label'  => esc_html__( 'Y', 'wpforms' ),
	);
	
	return $ranges;
	
}
add_filter( 'wpforms_datetime_date_dropdowns', 'wpf_dev_datetime_date_dropdowns', 10, 3 );

Expandir os anos

Se desejar expandir os anos para que não terminem em 2023, por favor, use este trecho e altere o ano máximo de 2050 para o que desejar.

/**
 * Filters labels and options within the date field’s dropdown format.
 
 * @link   https://wpforms.com/developers/wpforms_datetime_date_dropdowns/
 * 
 * @param  array  $dates    Months, Days, and Years arguments.
 * @param  int    $form_id  Form ID.
 * @param  array  $field    Date field values and properties.
 *
 * @return array
 */
 
function wpf_dev_datetime_date_dropdowns( $dates, $form_id, $field ) {
 
    $ranges = array(
        'months'       => range( 1, 12 ),
        'days'         => range( 1, 31 ),
        'years'        => range( date( 'Y' ), 2050 ),
        'months_label' => esc_html__( 'MM', 'wpforms' ),
        'days_label'   => esc_html__( 'DD', 'wpforms' ),
        'years_label'  => esc_html__( 'YYYY', 'wpforms' ),
    );
     
    return $ranges;
     
}
add_filter( 'wpforms_datetime_date_dropdowns', 'wpf_dev_datetime_date_dropdowns', 10, 3 );

Relacionado

Referência do Artigo: Personalizar as Opções de Data do Campo Data e Hora