Aller au contenu principal

Fichier

Un champ pour télécharger des fichiers, supportant des formats dynamiques. Utile pour la documentation d'utilisation des produits, le téléchargement documents ou tout autre contenu téléchargeable.

Captures d'écran​

Affichage du champ dans le formulaire :

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 autorisés (par exemple, pdf, xls, csv).
    • Taille maximale du fichier : La taille maximale autorisée pour le fichier téléchargé.

  • 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 retour​

  • Type : array|null
  • Valeur :
[
  'id'          => 1,
  'name'        => 'Nom du fichier',
  'file_name'   => 'fichier.png',
  'url'         => 'chemin/vers/le/fichier.png',
  'description' => 'Description du fichier',
]

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}
  <a href="{$field_group.field_slug.url}" target="_blank">
    {$field_group.field_slug.name}
  </a>
{/if}
/SomeClass.php
function someMethod()
{
    $dataRetriever = DataRetrieverFacade::getInstance();

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