Aller au contenu principal

Groupe

Un champ de groupe est utilisé pour créer une collection de champs ou de sous-groupes organisés ensemble. Cela vous permet de regrouper plusieurs champs ou sous-groupes en une unité cohérente, qui peut être gérée et configurée comme une seule entité. Utile pour structurer des formulaires complexes où les champs et sous-groupes connexes doivent être groupés pour une meilleure organisation.

Captures d'écran​

Affichage du champ dans le formulaire :

aperçu du champ group

Affichage du champ dans le groupe de champs :

aperçu du champ group

Configuration​

  • Paramètres :

    • Nom : L'étiquette du champ.
    • Slug : L'identifiant technique unique.
    • Champs : Les champs individuels ou sous-groupes inclus dans ce groupe.

  • 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
  • Valeur :
[
  // Valeurs des sous-champs sous forme de slug => valeur
  'sub_field_slug' => $value,   
  'sub_group_slug' => [],       
]

Usage​

/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)}
  
<div>
  <span>{$data.field_group_slug.field_slug_txt}</span>
  
  {if $data.field_group_slug.field_slug_img}
    <img src="{$data.field_group_slug.field_slug_img.url}" 
         alt="{$data.field_group_slug.field_slug_img.name}"
    >
  {/if}
</div>
/SomeClass.php
function someMethod()
{
    $dataRetriever = DataRetrieverFacade::getInstance();

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