Aller au contenu principal

Image

Un champ pour télécharger des images, supportant divers formats d'image. Utile pour les images de produits, les avatars d'utilisateurs ou tout autre contenu visuel.

Captures d'écran​

Affichage du champ dans le formulaire :

aperçu du champ aperçu du champ aperçu du champ

Affichage modal du champ dans le formulaire :

aperçu du champ aperçu du champ

Affichage du champ dans le groupe de champs :

aperçu du champ

Configuration​

  • Paramètres :

    • Nom : L'étiquette du champ.
    • Slug : L'identifiant technique unique.

  • Validation :

    • Requis : Détermine si le champ doit être rempli.
    • Extensions autorisées : Spécifie les types de fichiers image autorisés (par exemple, jpg, png, gif).
    • Largeur min : La largeur minimale de l'image téléchargée.
    • Largeur max : La largeur maximale de l'image téléchargée.
    • Hauteur min : La hauteur minimale de l'image téléchargée.
    • Hauteur max : La hauteur maximale de l'image téléchargée.
    • Taille maximale du fichier : La taille maximale autorisée pour l'image téléchargée.

  • Design :

    • Instructions : Texte affiché à côté du champ fournissant des détails sur les données nécessaires.
    • Largeur : La largeur du champ dans le formulaire.
    • Classes : Classes CSS personnalisées pour le style du champ.
    • ID : Attribut ID personnalisé pour le champ.
    • Texte avant : Texte additionnel affiché avant le champ.
    • Texte après : Texte additionnel affiché après le champ.
    • Format de présentation : Tailles maximales prédéfinies pour les aperçus d'images (150x150, 300x300, 600x600, 1200x1200px).

Format de retour​

  • Type : array|null
  • Valeur :
[
  'id'          => 1,
  'name'        => 'Nom de l\'image',
  'file_name'   => 'image.png',
  'url'         => 'chemin/vers/l/image.png',
  'description' => 'Description de l\'image',
]

Utilisation​

/some-template.tpl
{* Object or Entity and Id *}
{assign var="data" value=$modules.customfieldgroups.data->get($product)}
{assign var="data" value=$modules.customfieldgroups.data->get('product', $product.id)}
  
{if $data.field_group_slug.field_slug}
  <img src="{$data.field_group_slug.field_slug.url}" alt="{$data.field_group_slug.field_slug.name}">
{/if}
/SomeClass.php
function someMethod()
{
    $dataRetriever = DataRetrieverFacade::getInstance();

    $data = $dataRetriever->get($object);               // Object
    $data = $dataRetriever->get('product', $idProduct); // Entity and id
    
    $imageDetails = $data['field_group_slug']['field_slug'];
}