WP Manifestindependent plugin directory
manifest / content / saito-faq

Saito FAQ

Plugin WordPress/WooCommerce : FAQ sur articles, pages, produits et catégories, avec regroupement par thème et schéma FAQPage (JSON-LD).

by Troteseil Lucas · github.com/lucas-tsl/saito-faq · website

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/lucas-tsl/saito-faq/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/lucas-tsl/saito-faq ↗

Plugin WordPress/WooCommerce : questions/réponses sur les articles, pages, produits et catégories de produits, avec schéma FAQPage (JSON-LD) et regroupement optionnel des questions par thème (affichage en onglets).

Développé comme plugin compagnon de Saito Navi.

📖 Documentation complète (captures d'écran + explications) (version Notion)

Pourquoi ce plugin

Les plugins FAQ existants (ex. FAQ Magic) gèrent les articles, pages et produits, mais pas les catégories de produits WooCommerce — pas de moyen natif d'ajouter une FAQ à une page d'archive de catégorie. Saito FAQ comble ce manque, avec une structure de données propre et un regroupement des questions par thème (ex. "Livraison", "Le produit") pour les FAQ plus étoffées.

Fonctionnalités

  • Couverture : articles, pages, produits, catégories de produits (product_cat) — extensible via les filtres saito_faq_post_types et saito_faq_taxonomies.
  • Admin : un encart FAQ sur les fiches article/page/produit, un champ identique sur l'écran d'édition de catégorie — même interface partagée, ajout/suppression de questions en JS, sans rechargement de page.
  • Thème par question (optionnel) : donner le même thème à plusieurs questions les regroupe automatiquement sous un même onglet en front. Une seule catégorie de thème (ou aucune) : accordéon simple, pas d'onglets inutiles.
  • Affichage front :
    • [saito_faq] — FAQ du contexte courant (article/page/produit affiché, ou page d'archive d'une taxonomie couverte).
    • [saito_faq_all] — toutes les FAQ du site, groupées par titre, pour une page "Questions fréquentes" centralisée.
    • Affichage automatique en haut des pages d'archive de catégorie (pas de zone de contenu où poser un shortcode à la main sur ce type de page).
  • Schéma FAQPage (JSON-LD) généré côté serveur, uniquement là où le contenu est réellement visible (recommandation Google) : toujours sur une catégorie couverte, seulement si [saito_faq] est posé dans le contenu sur un article/une page/un produit.
  • Accessibilité : navigation clavier flèches gauche/droite/Home/End entre les onglets de thème (pattern ARIA Tabs).

Installation

  1. Copier le dossier saito-faq/ dans wp-content/plugins/.
  2. Activer le plugin depuis le menu Extensions.

Structure des données

Chaque FAQ (post ou terme de taxonomie) est stockée dans une seule meta (_saito_faq_items), tableau de :

array(
    'question' => 'Livrez-vous à l\'international ?',
    'answer'   => '<p>Oui, ...</p>', // HTML limité (wp_kses_post)
    'group'    => 'Commandes & Livraison', // optionnel, '' = pas de thème
)

Statut

Version 0.1.0 — base fonctionnelle testée en environnement de développement local. Pas encore soumis à WordPress.org.