Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.Vous ne disposez pas des autorisations suffisantes pour accéder à ces données.

Les ‘shortcodes’ ou ‘codes courts’ du plugin Contactic (CFDB) vous permettent d’afficher sur vos articles ou vos pages les données enregistrées au sein des formulaires.

Cela peut être utile dans le cas où vous souhaitiez rendre visible les soumissions :

  • d’un sondage que vous souhaitez partager avec l’ensemble des visiteurs,
  • d’un formulaire que vous souhaitez partager avec d’autres collaborateurs (sans avoir à leur donner accès à l’administration WordPress)
  • d’une enquête…

Il existent différents types de shortcodes prédéfinis avec des options exclusives. Pour y accédez, allez sur la page dédiée au code court (lien sur le nom du shortcode). Il vous est possible de réaliser également vos propres shortcodes.

Les shortcodes disponibles sont les suivants.

wdt_ID Shortcode Description
1 [cfdb-datatable] fournit un tableau filtrable et triable de manière dynamique sur votre page.
2 [cfdb-table] offre des options supplémentaires pour créer un style spécifique sur le tableau.
3 [cfdb-json] génère une balise dans le code HTML dans lequel il définit une variable Javascript égale à une représentation JSON des données.
4 [cfdb-value] permet de présenter une valeur dans la page au lieu d'un tableau ou d'un script JSON.
5 [cfdb-count] permet d'afficher simplement le nombre d'entrées au sein d'un formulaire.
6 [cfdb-html] permet d'afficher vos données au format HTML.
7 [cfdb-export-link] génère un lien cliquable qui permet de télécharger un fichier au format CSV ou XLSX...

Pour chaque shortcode, vous disposez des options communes suivantes. 

wdt_ID Option Exemple Description
1 form [cfdb-datatable form="monform"] Requis. Cela indique le formulaire à afficher. Toutes les colonnes et lignes sont affichées par défaut.
2 role [cfdb-datatable form="monform" role="Author"] Créer des shortcodes visibles uniquement pour certains rôles d'utilisateurs. Les rôles sont ceux autorisés et utilisés au sein de WordPress : Administrator, Editor, Author, Contributor, Subscriber, Anyone.
3 show [cfdb-datatable form="monform" show="col1,col2"] Limite les colonnes visibles à celles désignées (séparées par des virgules). Supporte des expressions régulières (cf. preg-match)
4 hide [cfdb-datatable form="monform" hide="col1,col2"] Inverse de show. N'affiche pas les colonnes listées (séparées par des virgules). Supporte des expressions régulières (cf. preg-match)
5 header [cfdb-table form="monform" header="false"] Montre ou pas l'entête du tableau. True (par défaut, visible) ou false (non visible)
6 headers [cfdb-table form="monform" headers="votre-nom=Nom, champ_1=Email"] Permet de changer les noms affichés dans les entêtes des colonnes. A la place du nom : 'champ_1', on affiche : 'Email'
7 limit [cfdb-datatable form="monform" limit="10"] Limite le nombre de ligne visible et commence par défaut par la ligne 0. limit="10" équivaut à limit="0,10". Si vous souhaitez commencer à la centième ligne et n'afficher que les 10 premières lignes, il faut indiquer limit="100,10"
11 random [cfdb-table form="monform" random="2"] Affiche X lignes aléatoires (2 dans l'exemple) parmi celles existantes dans le formulaire.
12 orderby [cfdb-datatable form="monform" orderby="nom,prenom"] Trie les lignes en fonction des colonnes désignées. Utilisez "nom desc" pour trier par ordre décroissant (par défaut, ordre croissant).
13 search [cfdb-datatable form="monform" search="Dupont"] Seules les lignes où une cellule contenant le texte de recherche, en l'espèce 'Dupont' (insensible à la casse) seront affichées.

Exemples d’options de shortcode

Nous allons utiliser un formulaire d’exemple avec 12 soumissions réalisées. Nous souhaitons les rendre visible sur notre site.

Prenons comme exemple un formulaire simple avec peu de champs : nom, prénom, email, sujet, message.

Le formulaire se nomme au sein de Contact Form 7 : « Form example« .

Pour l’afficher sur une page il faut ajouter le shortcode suivant (issu du plugin Contact Form 7) : [ contact-form-7 id= »XX » title= »Form example » ]

Option form

Utilisation de l’option form avec le code court suivant afin d’afficher le tableau des soumissions correspondant au formulaire appelé : 

[ cfdb-table form="Form example" ]

Vous pouvez voir le résultat du code court ci-dessous. On peut voir tous les enregistrements (12) à partir du formulaire avec toutes les colonnes (7).

Option role

Utilisation de l’option role avec le shortcode suivant afin de montrer le tableau en fonction des rôles des utilisateurs : 

[ cfdb-table form="Form example" role="Administrator" ]

Si vous n’êtes pas administrateur… vous devez voir une phrase indiquant que vous n’avez les droits suffisants !

Option show

Utilisation de l’option show avec le shortcode suivant afin de montrer que certaines colonnes: 

[ cfdb-table form="Form example" show="your-name,your-surname,your-email" ]

Vous ne devez voir que les colonnes qui sont appelées.

Option hide

Utilisation de l’option hide avec le shortcode suivant afin de cacher des colonnes : 

[ cfdb-table form="Form example" hide="your-name,your-surname,your-email" ]

Vous ne devez plus voir les colonnes indiquées.

Utilisation de l’option header avec le shortcode suivant afin de supprimer la ligne d’entête : 

[ cfdb-table form="Form example" header="false" ]

Vous ne devez plus voir l’entête du formulaire.

Option headers

Utilisation de l’option headers avec le shortcode suivant afin de changer le nom des entêtes : 

[ cfdb-table form="Form example" headers="Submitted=Date,your-name=Nom,your-surname=Prénom,your-email=Email,your-subject=Sujet,your-message=Message,Submitted From=IP" ]

Option limit

Utilisation de l’option limit avec le shortcode suivant afin de présenter qu’un nombre restreint de ligne (6) et à partir de la ligne souhaitée (4) : 

[ cfdb-table form="Form example" limit="4,6" ]

Option random

Utilisation de l’option random avec le shortcode suivant afin de présenter au hasard le nombre de lignes (2) indiqués : 

[ cfdb-table form="Form example" random="" ]

Option orderby

Utilisation de l’option orderby avec le shortcode suivant afin de trier les lignes selon les noms de colonnes désignés : 

[ cfdb-table form="Form example" orderby="your-name,your-surname" ]

Pour trier dans l’ordre inverse (z arrivera en premier), indiquez le code court suivant :

[ cfdb-table form="Form example" orderby="your-name desc,your-surname" ]

Utilisation de l’option search avec le shortcode suivant afin de changer le nom des entêtes : 

[ cfdb-table form="Form example" search="Dupont12" ]

Option filter

Utilisation de l’option filter avec le shortcode suivant afin de filtrer un contenu demandé dans une colonne en particulier : 

[ cfdb-table form="Form example" filter="your-name=Dupont7" ]

L’intérêt de l’option filter est qu’il peut supporter les expressions régulières et qu’il dispose d’opérateurs de filtre complet.

Total 0 Votes
0%

Help us to improve the article!

+ = Verify Human or Spambot ?

Tagué

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *