Image

Description

Le champ Image permet de télécharger et de sélectionner une image en utilisant la modale média native de WordPress.

Captures d’écran

Changelog

• Ajout du paramètre Minimum dans la version 5.1.9.
• Ajouté le paramètre Maximum dans la version 5.1.9.
• Ajouté le paramètre Allowed File Types dans la version 5.1.9.

Settings

• Return Format
  Spécifie le format des données retournées. Choisissez entre Object (tableau), URL (chaîne de caractères) ou ID (entier).

• Preview Size
  La taille de l’image WordPress affichée lors de l’édition des valeurs.

• Bibliothèque
  Limite la sélection des fichiers à ceux qui ont été téléchargés dans cet article, ou à toute la bibliothèque.

• Minimum
  Ajoute la validation du téléchargement pour la largeur minimale en pixels (nombre entier), la hauteur en pixels (nombre entier) et la taille des fichiers en Mo (nombre entier). La taille de fichier peut également être saisie sous forme de chaîne de caractères contenant l’unité, par exemple '400KB'.

• Maximum
  Ajoute la validation du téléchargement pour la largeur, la hauteur et la taille de fichier maximales.

• Types de fichiers autorisés
  Ajoute la validation du téléchargement pour des types de fichiers spécifiques. Entrez une liste séparée par des virgules pour spécifier les types de fichiers autorisés ou laissez vide pour accepter tous les types.

Utilisation du modèle

Le champ Image renverra soit un tableau, une chaîne de caractères ou une valeur entière selon la valeur de retour définie.

Afficher l’image (ID)

Cet exemple démontre comment afficher l’image sélectionnée lors de l’utilisation du type de retour Image ID. Cet exemple utilise la fonction wp_get_attachment_image() pour générer le HTML de l’image.

Affichage de l’image (tableau)

Cet exemple démontre comment afficher l’image sélectionnée lors de l’utilisation du type de retour Image Object. Ce type de retour permet d’accéder à des données d’image supplémentaires telles que le texte alt, la légende et les tailles.

<?php $image = get_field('image');if( !empty( $image ) ): ?> <img src="https://www.advancedcustomfields.com/resources/image/<?php echo esc_url($image); ?>" alt="<?php echo esc_attr($image); ?>" /><?php endif; ?>

Affichage personnalisé (tableau)

Cet exemple démontre comment afficher une taille personnalisée de l’image sélectionnée lors de l’utilisation du type de retour Image Object. Ce type de retour nous permet d’accéder à des données d’image supplémentaires telles que les tailles, la largeur, la hauteur et plus encore.

Affichage de l’image (URL)

Cet exemple démontre comment afficher l’image sélectionnée lors de l’utilisation du type de retour Image URL. Ce type de retour nous permet d’afficher efficacement une image de base mais nous empêche de charger des données supplémentaires sur l’image.

<?php if( get_field('image') ): ?> <img src="https://www.advancedcustomfields.com/resources/image/<?php the_field('image'); ?>" /><?php endif; ?>