Aller au contenu principal

Utilisateur

Un champ de saisie de recherche pour sélectionner un utilisateur parmi la base de clients. Les données peuvent être recherchées par nom d'utilisateur ou adresse e-mail. Utile pour lier des utilisateurs associés ou ajouter des références d'utilisateurs dans des formulaires personnalisés. Ce champ peut être combiné avec un champ de type répéteur pour configurer des listes d'utilisateurs.

Captures d'écran​

Affichage du champ dans le formulaire :

aperçu du champ

Affichage du champ dans un groupe de champs :

aperçu du champ

Configuration​

  • Paramètres :

    • Nom : L'étiquette du champ.
    • Slug : L'identifiant technique unique.
    • Exclure les désactivés : Option pour exclure les catégories désactivées des résultats de recherche.
    • Genres : Option pour filtrer les utilisateurs par genre.
    • Groupes : Option pour filtrer les utilisateurs par groupes de clients spécifiques.

  • Validation :

    • Obligatoire : Détermine si le champ doit être rempli.

  • 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 supplémentaire affiché avant le champ.
    • Texte après : Texte supplémentaire affiché après le champ.

Format de retour​

  • Type : Objet (RelationFieldValue) ou null
  • Méthodes de l'objet : 
    // Retourner l'objet de l'entité associée
    $customer = $relationFieldValue->getEntity(); 

    // Retourner les groupes de champs de l'entité associée
    $fieldGroups = $relationFieldValue->getFieldGroups();
info

La valeur du champ retourne un objet au lieu d'un tableau pour effectuer le chargement différé des sous-valeurs (objet, groupes de champs et présentateur pour certaines entités) et garantir la performance du processus.

Usage​

/some-template.tpl
{* Object or Entity and Id *}
{assign var="data" value=$modules.customfieldgroups.data->get($customer)}
{assign var="data" value=$modules.customfieldgroups.data->get('customer', $customer.id)}
  
{if $data.field_group_slug.field_slug}
  <span>{$data.field_group_slug.field_slug->getEntity()->id}</span>
  
  {* Entity related field groups *}
  {assign var="entity_field_groups" value=$data.field_group_slug.field_slug->getFieldGroups()}
  <span>{entity_field_groups.field_group_slug.field_slug}</span>
{/if}
/SomeClass.php
function someMethod()
{
    $dataRetriever = DataRetrieverFacade::getInstance();

    $data = $dataRetriever->get($object);               // Object
    $data = $dataRetriever->get('product', $idProduct); // Entity and id

    $customerData = $data['field_group_slug']['field_slug'];
    $customerObject = $customerData ? $customerData->getEntity() : null;
    $customerFieldGroups = $customerData ? $customerData->getFieldGroups() : [];
}