Aller au contenu

Module v1.0.0

Configurer Recherche

Ajoute un champ de recherche qui parcourt les pages, les articles et la FAQ de votre site.

search Ce que ce module apporte →

Ce qu'il fait

Recherche interne du site : moteur générique (Kit\Modules\Search\Search::query) qui déclenche le filtre search.results — chaque module de contenu actif (pages, articles, faq…) y branche sa propre contribution selon son activation (cf. README des modules concernés). Fonction du front, aucun écran admin (Règle C).

  • Cherche dans les pages, les articles et la FAQ
  • Se branche automatiquement aux modules actifs
  • Les pages sont cherchables d'emblée ; articles et FAQ le deviennent dès que leur adresse publique est réglée

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

  • chercher lecture seule

    Cherche dans le site comme le champ de recherche d'un visiteur : rend le titre, le type (page, article, faq…), l'adresse et un extrait de chaque résultat, 20 au plus. Requête de 2 à 80 caractères. Ne rend que du contenu public.

    « est-ce que mon site parle de livraison ? » « cherche où j'ai écrit « délai de fabrication » »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 1
search.results
Filter — chaque module de contenu ajoute ses résultats à la liste. Args: [array $results, string $q, int $limit]. Chaque résultat ajouté : {title: string, url: string, excerpt: string, type: string}.

Ses prises front

Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.

views/search-form.php 3 classes
  • s-search
  • s-search-input
  • s-search-submit
views/search-results.php 8 classes
  • s-search-empty
  • s-search-result
  • s-search-result-<?=
  • s-search-result-<type>
  • s-search-result-excerpt
  • s-search-result-title
  • s-search-result-type
  • s-search-results