Description
Champis.net est le forum francophone de mycologie. Cette extension permet aux sociétés de mycologie d’afficher sur leur site, avec trois blocs ou de simples codes courts, des informations publiées sur champis.net :
- les prochains événements mycologiques (expositions, sorties, journées d’étude…) annoncés sur le forum ;
- la liste des espèces d’une exposition saisie par votre société sur champis.net ;
- des clés de détermination de champignons en accès libre, à parcourir choix après choix.
L’affichage reprend la police et les couleurs de votre thème, et s’adapte aux petits écrans.
Le mode d’emploi est sur champis.net : Plugin WordPress.
Liste des espèces d’une exposition
Le bloc « Exposition champis.net » propose dans un menu les expositions des sociétés qui ont autorisé votre site sur champis.net (voir la FAQ), et montre la liste dans l’éditeur. Son réglage « Espèces affichées » fixe le nombre d’espèces montrées au chargement de la page, puis à chaque clic sur « Afficher plus » (20 par défaut).
Le code court [champis-expo-N], où N est le numéro de l’exposition, affiche la même liste, avec 20 espèces à la fois.
La liste comprend :
- les dates de l’exposition, son lieu et son nombre d’espèces ;
- pour chaque espèce, son nom scientifique (avec un lien vers sa page sur champis.net) et son nom vernaculaire, son numéro si l’exposition numérote ses espèces, et une miniature de ses photos ;
- les remarques saisies par votre société pour une espèce : une icône « i » à côté de son nom les ouvre dans une petite fenêtre ;
- une recherche par nom (et par numéro si l’exposition numérote ses espèces), qui ne tient pas compte des accents ;
- un menu « Trier par » : numéro (par défaut si l’exposition numérote ses espèces), nom scientifique (sinon), nom vernaculaire, derniers ou premiers ajouts ;
- les 20 premières espèces (ou le nombre choisi dans le bloc), puis autant de plus à chaque clic sur « Afficher plus » ;
- un diaporama de toutes les photos de la liste, à partir de la première ou de celle d’une espèce (flèches de l’écran ou du clavier, glissement du doigt), légendées de leur numéro, nom scientifique et nom vernaculaire ;
- des liens pour télécharger la liste complète au format Excel ou PDF, préparée par champis.net.
Prochains événements
Le bloc « Événements champis.net » affiche les prochains événements : dates, titre (avec un lien vers l’annonce sur champis.net), lieu et lien vers le site de l’événement. Leur nombre se règle dans le bloc, de 1 à 50 (10 par défaut).
Le code court [champis-evenements] affiche les 10 prochains événements.
Clés de détermination
Le bloc « Clés de détermination champis.net » et le code court [champis-cles] affichent les clés de détermination en accès libre de champis.net, plus de 570, les mêmes que l’onglet Clés de l’application Champis. Ce sont des clés au format de Mycoclé, le logiciel de G. Fannechère, qui a autorisé champis.net à les diffuser. Leur source, « Mycoclé, G. Fannechère », est citée sous la liste et sous chaque clé, avec un lien vers Mycoclé.
- La liste se cherche par titre ou auteur, sans tenir compte des accents, et se filtre par langue. Elle montre 20 clés, puis 20 de plus à chaque clic sur « Afficher plus ».
- Une clé ouverte remplace la liste : ses choix s’affichent étape par étape, jusqu’au nom de l’espèce. « Retour » revient à l’étape précédente, « Recommencer » à la première, et le parcours suivi permet de revenir à n’importe quel choix fait.
- L’adresse de la page indique la clé ouverte (
#cle-N) : le bouton Précédent du navigateur revient à la liste, et l’adresse peut être partagée. - Le réglage « Langue » du bloc choisit les clés montrées au chargement de la page (toutes par défaut) ; les visiteurs peuvent en choisir une autre. Avec le code court :
[champis-cles langue="Français"].
Les clés codées de Mycoclé et les clés en PDF, qu’on ne peut que télécharger, restent sur champis.net/keys.
Services externes
Les blocs et les codes courts lisent des données publiques sur le forum champis.net, directement depuis le navigateur du visiteur : les expositions, les événements, la liste des clés de détermination, puis chaque clé que le visiteur ouvre. Aucune donnée des visiteurs du site n’y est envoyée, hormis ce que contient toute requête web (adresse IP, navigateur). Dans l’éditeur, le bloc « Exposition champis.net » envoie aussi à champis.net l’adresse du site, pour connaître les expositions qui l’autorisent. Les noms d’espèces renvoient vers les pages espèces de champis.net, les clés vers leur page sur champis.net et vers Mycoclé (mycolim.free.fr), le logiciel dont elles viennent.
Conditions d’utilisation et confidentialité : https://champis.net
Développement
Les widgets des codes courts sont dans assets/js/ et sont compilés dans assets/dist/ par esbuild (build.mjs). Les blocs sont dans src/ et sont compilés dans build/ par @wordpress/scripts, comme dans le tutoriel de WordPress. Une seule commande compile les deux :
npm install
npm run build
expo.js, `events.js` et `cles.js` utilisent le React fourni par WordPress. Les styles de `expo.js` et `cles.js` (`assets/js/expo.css`, `assets/js/cles.css`) y sont embarqués. Dans l'éditeur, chaque bloc affiche le même composant (`expo-widget.jsx`, `events-list.jsx`, `cles-widget.jsx`).
Pour tester avec une autre instance du forum, définissez la constante CHAMPIS_FLARUM_API_BASE (par exemple dans wp-config.php) avant le chargement de l’extension.
Installation
- Installez l’extension depuis le menu Extensions > Ajouter une extension (recherchez « Champis.net »), puis activez-la.
- Dans une page ou un article, ajoutez le bloc « Exposition champis.net », « Événements champis.net » ou « Clés de détermination champis.net » (cherchez « champis » dans l’outil d’insertion), puis choisissez l’exposition, le nombre d’événements ou la langue des clés dans le bloc.
- Enregistrez : la liste s’affiche sur la page publiée.
Les codes courts [champis-expo-N], [champis-evenements] et [champis-cles] restent disponibles, dans un bloc « Code court ».
Le mode d’emploi complet : Plugin WordPress sur champis.net.
FAQ
Mon exposition n’apparaît pas dans le menu du bloc
Le menu ne propose que les expositions des sociétés qui ont autorisé votre site. Sur champis.net, ouvrez la page de votre société, cliquez sur « Modifier » et ajoutez l’adresse de votre site (par exemple https://www.exemple.ch, celle de la page d’accueil, sans chemin) aux « Domaines autorisés (partage externe) ». « Visible sans compte » doit aussi être coché.
Où trouver le numéro de mon exposition ?
Ouvrez l’exposition sur champis.net : son numéro est à la fin de son adresse. Pour https://champis.net/exhibitions/879, utilisez [champis-expo-879].
Le site affiche « Cette exposition n’existe pas ou n’est pas publique »
Vérifiez le numéro de l’exposition, puis les réglages de votre société sur champis.net : « Visible sans compte » doit être coché, et si « Domaines autorisés (partage externe) » est rempli, l’adresse de votre site doit y figurer (par exemple https://www.exemple.ch).
Combien de temps faut-il pour qu’une modification apparaisse sur mon site ?
Au plus 5 minutes : le navigateur de chaque visiteur garde la liste en mémoire pendant ce temps.
Les clés de détermination demandent-elles une autorisation ?
Non : les clés libres de champis.net s’affichent sur tout site, sans réglage sur champis.net. Seules les expositions demandent que votre société autorise votre site.
Où obtenir de l’aide ?
Le mode d’emploi de l’extension est sur champis.net : Plugin WordPress. Le lien « Aide » sous l’extension, dans la liste des extensions, et celui des réglages de chaque bloc y mènent aussi. Pour une question, écrivez à info@champis.net.
Changelog
3.5.0
- Nouveau bloc « Clés de détermination champis.net » et nouveau code court
[champis-cles]: les clés de détermination en accès libre de champis.net (plus de 570, celles de l’application Champis), à chercher par titre ou auteur, à filtrer par langue et à parcourir choix après choix jusqu’au nom de l’espèce. La source, « Mycoclé, G. Fannechère », est citée. Le réglage « Langue » du bloc, oulangue="…"dans le code court, choisit les clés montrées d’abord. - Aide : un lien vers le mode d’emploi de l’extension sur champis.net (https://champis.net/article/2011478) dans la liste des extensions, dans les réglages de chaque bloc et dans ce fichier. Il remplace l’ancien lien vers le forum, qui ne fonctionnait plus.
3.4.0
- Nouveau bloc « Exposition champis.net » : l’exposition se choisit dans un menu, qui propose celles des sociétés ayant indiqué l’adresse du site dans leurs « Domaines autorisés (partage externe) » sur champis.net. La liste s’affiche dans l’éditeur. Le réglage « Espèces affichées » fixe le nombre d’espèces montrées d’abord et à chaque clic sur « Afficher plus ».
- Nouveau bloc « Événements champis.net » : les prochains événements, avec leur nombre en réglage (de 1 à 50).
- Les codes courts
[champis-expo-N]et[champis-evenements]fonctionnent comme avant.
3.3.0
- Expositions : les remarques saisies pour une espèce sur champis.net s’affichent, comme sur la page publique de l’exposition. Une icône « i » à côté du nom de l’espèce les ouvre dans une petite fenêtre (aussi au clavier et avec un lecteur d’écran) ; Échap, le bouton Fermer ou un clic à côté la ferment.
3.2.2
- Expositions : des boutons « Diaporama » et « Afficher plus » plus discrets, avec un contour fin plutôt que le bouton plein du thème. « Diaporama » rejoint la ligne du résumé, « Afficher plus » est centré sous la liste.
- Expositions : une icône devant les liens Excel et PDF.
- Expositions : le champ de recherche indique « Chercher par nom ou numéro… », ou seulement « Chercher par nom… » si l’exposition ne numérote pas ses espèces.
3.2.1
- Expositions : la liste reste lisible quel que soit le thème (taille du texte, champs, boutons et tableau), par exemple avec Divi.
- Retrait des anciens codes courts
[champis-events]et[champis-exhibition-N], dont les services (api.champis.net et intranet.champis.net) n’existent plus. Utilisez[champis-evenements]et[champis-expo-N].
3.2.0
- Expositions : un script environ 15 fois plus léger (16 Ko au lieu de 236), sans bibliothèque d’interface ; la liste prend le style des champs, listes et boutons du thème.
- Expositions : une colonne « Espèce » réunit le nom scientifique et le nom vernaculaire, la colonne Famille est retirée ; le tri se fait par un menu « Trier par », qui propose aussi les derniers et les premiers ajouts.
- Expositions : « Afficher plus » (20 espèces de plus à chaque clic) remplace la pagination par pages.
- Expositions : un diaporama de toutes les photos de la liste ; une miniature l’ouvre à la photo de son espèce.
- Expositions : les fichiers Excel et PDF sont ceux de champis.net (la bibliothèque Excel n’est plus chargée), et le PDF est nouveau.
3.1.0
- Expositions : si l’exposition numérote ses espèces, une colonne N° (triable) s’affiche en premier et la liste est d’abord dans l’ordre des numéros (« 2a » avant « 10a »), y compris dans l’export Excel. Sans numéros, rien ne change : pas de colonne N° et ordre alphabétique par nom scientifique.
3.0.3
- Expositions : le texte de la liste n’est plus affiché en tout petit avec les thèmes qui réduisent la taille de base de la page (par exemple html { font-size: 62.5% }).
3.0.2
- Expositions : le nom de l’exposition n’est plus affiché au-dessus de la liste, il faisait doublon avec le titre de l’article ou de la page.
3.0.1
- Expositions : la colonne Photos n’apparaît que si l’exposition a des photos.
3.0.0
- Nouveau code court
[champis-expo-N]: liste des espèces d’une exposition, lue depuis le nouveau forum champis.net. - Nouveau code court
[champis-evenements]: prochains événements, lus depuis le nouveau forum champis.net. - Expositions : recherche par nom vernaculaire et famille sans tenir compte des accents, tri par colonne, colonne Famille, miniatures des photos, visionneuse avec légende, flèches du clavier et glissement du doigt, dates et nombre d’espèces, liens vers les pages espèces de champis.net, export Excel complet (numéro, auteur, famille), messages d’erreur, adaptation aux petits écrans.
- Événements : les adresses e-mail deviennent des liens, les liens affichent le nom du site plutôt que l’adresse complète, message en cas de panne.
- L’affichage reprend la police et la couleur des liens du thème.
- Les scripts ne sont chargés que sur les pages qui les utilisent, utilisent la version de React fournie par WordPress, et la bibliothèque Excel n’est chargée qu’au clic sur « Télécharger ».
- Nécessite WordPress 6.6 ou plus récent.