Formidable Tablesorter — afficher, trier et filtrer vos réponses

Publié le : 2 décembre 2019 – Dernière modification le 22 septembre 2023 – par Maïeul – 27 commentaires

1
2
3
4
5
12 votes

Le plugin Formidable Tablesorter, s’appuyant sur la librairie JS éponyme, permet d’afficher les réponses à un formulaire Formidable sous la forme d’un tableau, triable, filtrable, imprimable et exportable.

La présente documentation est valable à partir de la version 2.0 du plugin.

Installation

Le plugin nécessite, outre Formidable, le plugin Tablesorter dans sa version 2.0 ou supérieure.

Par défaut, le plugin Tablesorter intègre la librairie Tablesorter sur toutes les pages publiques et privées du site. Si l’usage est uniquement pour Formidable Tablesorter, il est recommandé de désactiver, via la configuration du plugin, cette insertion.

Accès au tableau

Une fois le plugin installé, un lien apparaît dans l’espace privé à gauche de la liste des réponses d’un formulaire, ainsi qu’à côté de la page du formulaire.

Lien vers le tableau de réponse

En suivant l’un de ces liens, nous accédons au tableau à double entrée.

Par défaut, celui-ci affiche :

  • tout d’abord, les onglets permettant de filtrer les réponses selon le statut ;
  • puis des boutons d’action et une aide contextuel
  • de haut en bas : toutes les réponses du statut sélectionné
  • de gauche à droite :
    • l’identifiant et la date de chaque réponse
    • les champs extras éventuels associés à la réponse
    • les champs de la réponse

Il sera possible par la suite de masquer des colonnes et des lignes.

Le nombre de lignes est limité à 100 par pages, mais une pagination est proposée au delà.

Exemple de tableau

Tri du tableau

Les entêtes de colonnes permettent de trier le tableau selon la valeur d’une colonne.

Attention : le tri se fait côté serveur, il faut donc parfois patienter un peu

Masquage et déplacement de colonnes / de champs

Selon le besoin, il est possible de masquer certaines colonnes. En cliquant sur le bouton « choix des colonnes », la liste des colonnes apparaît. Il suffit de décocher les colonnes que l’on veut masquer.

Il est possible de déplacer des colonnes, en cliquant sur sur les flèches en haut des colonnes.
Attention, le réordonnancement se fait côté serveur, et peut donc prendre du temps.

Formulaire de masquage de colonne

Filtrage des lignes / des réponses

Il est possible de filtrer les réponses selon la valeur des champs. En dessous de chaque entête de colonne se trouve un champ de saisie. Il suffit d’y mettre la valeur que l’on veut conserver, puis de faire un retour ligne : seules les lignes contenant la valeur saisie s’afficheront désormais.

Le filtrage est souple :

  • pour des champs de type numérique, il est possible d’utiliser les opérateurs de comparaison. Mettre <10 pour afficher uniquement les réponses donnant une valeur inférieure à 10.
  • pour des champs de type texte, ne seront affichés que les réponses contenant la valeur saisie, mais il n’est pas nécessaire que la valeur du champ soit strictement identique à cette valeur. Ainsi, écrire « janvier » permettra d’afficher les réponses ayant « janvier 2019 » comme « janvier 2020 ».
  • pour en savoir plus, sachez que le plugin utilise la syntaxe des tests des affichages conditionnel du plugin Saisies, en omettant simplement le @@ initial.

Attention : le filtrage se fait côté serveur, il faut donc parfois patienter un peu

Sauvegarde des réglages

Les paramètres de filtres, de masquages, de tri de colonne, etc., sont conservés localement par le navigateur. Ils seront donc repris à la prochaine consultation depuis le même navigateur. Le navigateur doit supporter le système WebStorage.

Impression

Un bouton d’impression permet d’imprimer le tableau filtré, sans les colonnes et les lignes masquées.

Export

Des boutons permettent d’exporter le tableau filtré, sans les colonnes et les lignes masquées, dans des formats lisibles par les principaux tableurs du marché.

Réinitialisation

Deux boutons permettent de réinitialiser :

  1. Uniquement les filtres
  2. L’ensemble des réglages

Affichage côté public

Il est possible d’afficher le tableur côté public, en insérant dans un article le modèle <formidable_ts|id_formulaire=xxx>, où xxx est le numéro du formulaire.

Par mesure de sécurité, seul les personnes ayant le droit côté privé de voir les réponses peuvent voir les réponses.
Si vous voulez rendre cela public, il vous faudra surcharger vos autorisations. Pour rendre accessible l’ensemble des réponses de l’ensemble des formulaires, mettez dans votre fichiers mes_options.php le code suivant :

$GLOBALS['spip_pipeline']['autoriser'] .= "|mes_autorisations";

function mes_autorisations(){
	function autoriser_formulairesreponse_voir($faire, $type, $id, $qui, $opt) {
		return true;
	}
}

Il vous faudra également inclure les feuille de style CSS fournit par le plugin, mais qui ne sont présente que côté privée par défaut :

  • css/tablesorter.min.css ;
  • css/formidable_ts.css ;
  • css/formidable_ts_prive_bloc_entete.css

Principaux changements entre la version 1.x et la version 2.x

  • Ajout d’une pagination
  • Aide contextuelle
  • Ajout de la possibilité d’éditer les champs avec les crayons
  • Amélioration du déplacement des colonnes
  • Différentes améliorations des styles CSS
  • Séparation des réponses en onglet, selon les statuts
  • Amélioration du tri sur les champs de date et sur les champs évènements
  • Possibilité d’insérer le tableau côté public via un modèle
  • Aspects techniques :
    • Uniformisation du code, pour utiliser tout le temps formidable_ts et non pas formidable_tablesorter
    • Utilisation de la librairie SPOUT pour les exports en tableaux ;
    • Gestion asynchrone des filtres, tri et ordonanncement des colonnes : tout se fait côté PHP, qui renvoie un fichier JSON

Discussion

5 ans 1 an 3 mois Sans limite
par date
Filtrer

8 discussions

  • 1
    Kingrise

    Bonjour et merci pour cet excellent plugin...

    J’ai un soucis pour exporter l’ensemble du tableau en excel... Il n’exporte que les 100 ligne affichées...

    J’ai lu plus haut : Le nombre de lignes est limité à 100 par pages, mais une pagination est proposée au delà.

    Est-il possible d’y remédier ?

    Merci

    • Kingrise

      Ok, j’ai trouvé l’occurrence à modifier dans le fichier du plugin /formidable_ts/v3.1.0/javascript/formidable_ts.js

      ligne 62 : pager_size : 100,//Nombre de lignes par page → Il suffit de modifier la pagination selon vos besoins. Ce serait bien d’inclure cette fonction dans un fichier de configuration ;-)

      Bonne journée

    Répondre à ce message

  • 5
    AlainF

    Bonjour,
    dans le cas :

    Par mesure de sécurité, seul les personnes ayant le droit côté privé de voir les réponses peuvent voir les réponses.

    Déconnecté, je n’ai pas les réponse, OK, mais j’ai quand même les boutons et le tableau ?
    J’aurais souhaité que l’ensemble ne s’affiche que lorsque l’on est identifié ; ai-je loupé une étape ?, Merci Alain

    • Maïeul

      Effectivement, c’est sans doute un bug. Pouvez vous ouvrir un ticket ?

    • AlainF

      Merci de la réponse, il me faudrait également savoir comment on ouvre un ticket...

    • Maïeul

      1. Demande un accès à la forge via le lien « S’inscrire pour contribuer »
      2. pour (quasi) chaque plugin sur contrib, tu as à droite un lien vers l’espace de tickets de ce plugin

    • Maïeul

      Bon, entretemps il se trouve que j’ai du bosser sur le plugin, donc j’ai intégré cela dans la v2.0.19.

      Cependant la méthode reste valable, et c’est bien pour rapporter des bugs.

    • AlainF

      Merci beaucoup,
      je n’ai pas pris le temps pour faire remonter l’info sur la forge, mais je ferais le nécessaire la prochaine fois.

    Répondre à ce message

  • 2
    graphie

    Bonjour,

    Lors de l’affichage du tableau de réponses ou d’un export CSV, le fichier contient bien :

    • tous les champs Formidable
    • le statut de la réponse
    • la date d’enregistrement du formulaire
    • le #ID_FORMULAIRE_REPONSE
    • mais pas l’Utilisateur / Adresse IP / Auteur

    On pourrait contourner ce manque en ajoutant un champ caché dans le formulaire qui enregistrerait l’Utilisateur / Adresse IP, mais quelle est la syntaxe qui permettrait de la faire : genre @nom_auteur@ ?

    Merci,
    François

    Répondre à ce message

  • 2
    Carole

    Bonjour,

    Merci pour ce plugin vraiment très utile. Je n’arrive pas à faire fonctionner les filtres mathématiques (opérateurs de comparaison) : quelles sont les conditions pour qu’un champ d’un formulaire Formidable soit reconnu de type numérique par Tablesorter ?

    Voici la définition du champ dans le fichier .yaml

    18:
    options: { label: 'Montant total', defaut: '0', autocomplete: defaut, obligatoire: on, info_obligatoire: '*', nom: input_7 }
    verifier: { type: entier, options: { min: '0', max: '5000' } }
    identifiant: '@627e79d6700a0'
    saisie: input

    Merci !

    • Maïeul

      En théorie, il n’y a rien de spécial à faire, la reconnaissance est automatique. Cela étant, je me rend compte qu’en ce moment c’est cassé.

      Pourrais tu ouvrir un ticket ? je ne suis pas très disponible en ce moment pour du debugage, donc il faudrait que je garde une trace...

    • Carole

      Merci beaucoup pour cette réponse très rapide.
      Je vais donc ouvrir un ticket, dès que ma demande de création de compte sur git.spip.net sera validée !

    Répondre à ce message

  • 4
    DD

    Sur un site en SPIP 3.2.13

    avec Tablesorter 2.1.3 - stable
    et
    Tablesorter pour Formidable 2.0.11 - stable

    les tableaux sont bloqués quelque part : je les vois, le contenu des réponses y est mais le tableau est grisé avec le spin qui mouline et « Chargement » en rouge.

    Je joins une capture

    A priori sur un site en SPIP 4.0.0 cela fonctionne.

    Merci

    Répondre à ce message

  • AlainF65

    Bonjour et bravo pour le travail.,
    J’utilise ce plugin pour des inscriptions à 2 journées par bouton radio, donc soit l’une soit l’autre.
    Et un nombre de participants par inscrit soit « Dupont » : « 2 » participants
    C’est géographique, donc une inscription voit TOUS ces participants à la même journée

    J’aimerai juste un récapitulatif (total de participants par journée) pour les autres membres (affichage sur une page à part sans autorisation spécifique sauf l’adresse, ça je gère) :
    Journée 1 Total de participants : xx
    Journée 2 Total de participants : xx
    Comment puis-je faire ?
    par avance, merci
    Alain.

    Répondre à ce message

  • graphie

    Bonjour et merci pour cet outil @Maïeul !

    Une remarque pour les personnes qui souhaitent utiliser les champs de filtres pour les dates : avec un formulaire qui utilise un champ de type DATE, il faut utiliser la syntaxe suivante pour filtres une colonne :
    03.06.2021.18:30:00 filtrera 03/06/2021 18:30:00 dans une colonne.

    TableSorter 2.1.1 + TableSorter pour Formidable 2.0.14.

    Répondre à ce message

  • 5
    Ilovespip

    Bonjour
    Merci pour ce plugin.
    Y’aurait-il un moyen simple d’exporter le tri sorter des résultats sur une page publique ?
    Avec mes remerciements

    • Maïeul

      que voulez vous exporter ? l’ibterface ? ou bien le resultat d’un filtrage ?

    • Ilovespip

      L’interface tableau tri-sorter et les réponses du formulaire.
      Merci beaucoup pour votre réponse Maïeul

    • Maïeul

      Hum, j’hésite vraiment pour ca. Mais a priori je pourrais créer un modèle oui.

    • Maïeul

      Alors j’hésite vraiment, vraiment, vraiment. Pour deux raisosn :
      -  en terme de confidentialité des données, il faut pouvoir s’assurer que les gens sachent ce qu’ils font
      -  en terme d’interface publique, risque de conflit js/css

      Dans tous les cas cela ne sera pas avnt la version 1.3.0 car je suis en train de faire une grosse grosse refonte.

      Je vous invite à ouvrir un ticket https://git.spip.net/spip-contrib-extensions/formidable_tablesorter/issues pour me rappeler de tenir compte de cela.

    • Maïeul

      pour info c’est désormais possible, mais il vous faut à la main régler l’autorisation d’affichage public.

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom