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

Description

Le filtre wpforms_datetime_date_dropdowns permet de modifier les étiquettes et les options du format de date des listes déroulantes.

Paramètres

$dates

(array) (Requis) Étiquettes et plages de nombres utilisées dans les listes déroulantes de date.

$id_formulaire

(int) (Requis) ID du formulaire.

$field

(array) (Requis) Valeurs et propriétés du champ de date.

Source

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

Plus d'informations

Le filtre wpforms_datetime_date_dropdowns est appliqué à un tableau contenant les options des listes déroulantes de date. Il peut être utilisé pour personnaliser les étiquettes des listes déroulantes de mois, de jour et d'année, ainsi que les options incluses dans chacune de ces listes.

Note : Les plages pour les jours, les mois et les années ne peuvent accepter que des valeurs entières.

Exemples

Limiter les dates

Dans cet exemple ci-dessous, la fonction limitera les mois de janvier à juin, les jours du 1er au 15 et l'année commencera en 1980.

La fonction modifie également les étiquettes du format par défaut MM/DD/YYYY en M/D/Y.

N'oubliez pas de changer l'ID du formulaire de 25 pour qu'il corresponde à l'ID spécifique du formulaire sur lequel vous souhaitez exécuter votre code. La suppression de cette vérification s'appliquerait à tous les formulaires.

/**
 * 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 );

Étendre les années

Si vous souhaitez étendre les années afin qu'elles ne s'arrêtent pas à 2023, veuillez utiliser cet extrait et changer l'année maximale de 2050 à ce que vous souhaitez.

/**
 * 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 );

Articles associés

Référence d'article : Personnaliser les options de date du champ Date et Heure