Champs spéciaux

Dernière édition : Octobre 2020

Introduction

Depuis la version 5.5, ZADS permet d’ajouter aux annonces (ou annonceurs) des champs personnels (ou spéciaux) liés à une activité ou catégorie d'annonce et ainsi transformer ZADS en une place de marché dédiée à un secteur ou une activité particulière.

En reliant ces champs à des catégories, on peut compléter les annonces avec des informations plus précises qui pourront ensuite devenir un critère de recherche. Exemple : la taille d’un vêtement, la cylindrée ou boite de vitesse d’une voiture, le DPE pour une annonce immobilière, etc .

Saisie des champs site-vfields-create-car

Affichage des champs site-vfields-display-car

Il est possible d’avoir des champs de recherche qui sont liés à ces champs spéciaux et permettre ainsi de faire une recherche ciblée.

Activation

Il faut d’abord s’assurer globalement que les champs spéciaux sont activés. Rendez-vous dans ADMIN > CONFIG > CHAMPS et activez le mode ACTIVER CHAMPS VIRTUELS pour permettre la saisie dans les annonces et RECHERCHE peur permettre l'utilisation comme critères de récherche. admin-vfields-onoff

Gestion des champs

La gestion s’effectue depuis le menu ADMIN > GESTION DES CHAMPS.
admin-vfields-list

Le principe est de créer des champs et ensuite les associer à une catégorie. Il exister 2 types principaux de champs :

  • les champs de saisie (catégorie)
  • les champs de recherche (recherche)

Lors de le création, les principaux champs sont :

  • Nom interne : nom interne utilisé en administration pour vous y retrouver
  • Nom affiché : mom affiché sur le site
  • Pour : indiquer si c’est un champ pour les annonces ou pour les usagers/annonceurs
  • Unité : l’unité qui sera affiché après le champ
  • Type HTML: indique le mode d’affichage de ce champ
    • "type input" : "champ texte (input)",
    • "type radio" : "bouton d'option (radio)",
    • "type checkbox" : "case à cocher (checkbox)",
    • "type select" : "liste de selection (select)",
    • "type select enum" : "liste de selection auto-générée (select enum)",
    • "type slider min/max" : "champ glissière min-max (slider)",
    • "type select autofill" : "liste de selection à chargement dynamique (select result of ajax response)",

Les valeurs possible du champ peuvent être :

  • saisie une à une
  • autogénérée (pour les valeur numériques) à partir un min., max. et pas.
  • issues d'un base de donnée admin-vfields-enter-value

Création de champ SAISIE

On doit principalement indiquer, les noms, le type HTML et les valeurs. admin-vfields-cat

Création de champ RECHERCHE

On doit principalement indiquer les noms mais surtout le champ associé sur lequel se fera la recherche. admin-vfields-search

Pour un champ de recherche, les valeurs doivent être identique au champ cible! Pour faciliter la saisie, une fonction de clonage existe sur un champ initial de type SAISIE vers sont clone de type RECHERCHE pour éviter la resaisie des valeurs.

Association à une catégorie

Choisir la catégorie via ADMIN > CATEGORIE et editer la catégorie.

Cliquez sur ajouter un champ spécial et choisissez parmis la liste des champs existant. Vous pouvez associer des champs de saisie OU les champs de recherche (indiqués en Jaune). admin-vfields-associate

Si le champ n’apparait pas, faire un rafraichissement de la page (F5)

Les champs apparissent ensuite dans le liste des catégories avec un marqueur pour les annonce de type SAISIE (ici 10 champs) et RECHERCHE (ici 8 champs). admin-vfields-incatlist

Vérifier le résultat en créant une annonce dans la catégorie modifiée et les nouveaux champs de saisie apparaissent. Si vous avez relié des champs de recherche, ils apparaissent aussi lors de la recherche avancée en sélectionnant la catégorie.

Dans l'interface d'administration, un indicateur permet de vérifier que les champs de recherche sont liés. Si c'est pas le cas, une icone warning est affichée comme ci-dessous. admin-vfields-warning

Cas des champs immobiliers spéciaux

SPECIAL NOTE : Pour des raisons légales françaises, les annonces immobilières doivent afficher un graphique concernant la performance Energétique . Il est possible via ZADS de gérer cela via des champs spéciaux et de préciser dans ADMIN > CONFIG > CHAMPS SUPL. les IDs de ces champs pour un affichage automatique des graphiques admin-vfields-immo

Si ces champs sont renseignés, les annonces se présentent sous cette forme : creation d'une annonce site-vfields-immo-create affichage d'une annonce site-vfields-immo-display

Champs liés à une base de donnée

Depuis la version 7.0, il est possible de d’avoir un champ dont les valeurs proviennent d'un base de donnée dynamique et dont la clef provient dun' autre champ (Maitre). Exemple : on choisit une marque de voiture qui ensuite propose automatiquement un champ « modèle de voiture » qui n’affiche que les modèles de voiture de cette marque.

Configuration Le champ maitre (ici la marque) est relié à un champ esclave (ici le modèle (ID = 67)) via la variable brand . admin-vfields-master

La variable « brand » dans cet exemple servira de filtre à la base de donnée LIST (ci-dessous un exemple) qui listera tous les modèles d’une marque donnée. Ainsi , si l’utilisateur choisit la marque PEUGEOT, une liste de modèle va s’afficher dynamiquement.

admin-vfields-slave

Attention de bien indiquer le type SELECT RESULT OF AJAX RESPONSE au champ esclave.

Les valeurs proviendont de la table list de la base de donnée qui devra être structurée de la façon suivante sql-vfields-table

Champs obligatoires lors de la saisie d’une annonce

On peut forcer l’utilisateur à renseigner certains champs spéciaux lors de la saisie d'une annonce (uniquement pour les champs de SAISIE) admin-vfields-mandatory

Les champs obligatoires sont indiqués par une étoile rouge et vérifiés lors de la sauvegarde du formulaire. site-vfields-mandatory

Une option globale,accessible via ADMIN > CONFIG. > CHAMPS SUPL., permet de focer tous les champs obligatoires quelque soit l'indication "obligatoire" du champ. admin-vfields-mandatoryall

Champs de recherche dynamiques fonction de la catégorie

Les champs de recherche sont automatiquement affichés en dessous de la barre de recherche lors de la sélection d'une catégorie à laquelle est atachés des champs de recherche.

site-vfields-search

Sur un mobile, l'affichage est le suivant : site-vfields-searchmob

Lorsque la barre est en mode conpact , ces champs sont toujours affichés. Lorsque la barre de recherche est en mode personnalisé, il faudra indiquer le tag champs dynamiques pour que les champs soient affichés. admin-vfields-searchtag

La barre s'affiche alors comme cela
site-vfields-searchcustom

Forcage systématique d'un champ de recherche dans la barre

Cette eoption n'est possible que pour une barre de recherche est en mode personnalisé

On peut forcer dans la barre de recherche un ou des champs spéciaux. Ils seront alors toujours affichés, indépendemment de la selection d'une catégorie. Il faut placer l'ID des champs souhaités dans la barre avec le keyword= »champ spécial » admin-vfields-searchforced

Extra style (css)

Il est possible d'ajouter un nom de style CSS aux champs et ainsi pouvoir modifier leur présentation et aspects fonction de sa feuille de stype personnalisée. admin-vfields-css

Exemple avec un champ taille de vêtement : AVANT site-vfields-cssbefore

Exemple avec un champ taille de vêtement : APRES site-vfields-cssafter