Cet article a pour but de lister les balises, critères et fonctions définies dans SPIP Bonux, afin qu’on ne les oublie pas, mais la documentation de ces éléments ne figure pas ici (voir pour cela les autres articles de documentation de Spip Bonux, ou le code source).
Rq : Pour éviter les conflits, certaines de ces fonctionnalités ne sont définies par Bonux que si elles ne sont pas déjà définies par ailleurs.
Balises et critères de boucles
Balises
#SET_PUSH Empile un élément dans un tableau déclaré par #SET{tableau,#ARRAY}
#SET_MERGE
#COMPTEUR
#SOMME
#COMPTE
#MOYENNE
#MINIMUM
#MAXIMUM
#STATS
Les balises #COMPTEUR, #COMPTE, #SOMME, #MOYENNE, #MINIMUM, #MAXIMUM, #STATS requièrent l’usage d’un critère qui spécifie le champ sur lequel porte le calcul de la balise.
Contrairement au critère {compteur table}
, ces critères ne calculent pas de jointures.
Exemples d’usage :
- #SET_PUSH :
#SET_PUSH{tableau,valeur}
Critères statistiques
{compteur}
{compteur_left}
{somme}
{compte}
{moyenne}
{minimum}
{maximum}
{stats}
Exemples d’usage
- Supposons qu’un champ ’distance’ ait été ajouté aux objets ARTICLE.
La boucle suivante calcule la somme des distances des articles de la rubrique 1 :
<BOUCLE_a(ARTICLES){id_rubrique=1}{somme distance}></BOUCLE_a>
#SOMME{distance}
</B_a>
- Dans le plugin ’abonnement’ le fichier ’abonnements_stats’ donne plusieurs exemples d’utilisation de ces critères.
Par exemple :
<BOUCLE_nombre(AUTEURS_ELARGIS_ABONNEMENTS){id_abonnement}{statut_paiement=ok}{somme montant}{compte montant}{fusion id_abonnement}>
<td>#COMPTE{montant}</td>
<td>[(#SOMME{montant}|number_format{2, ',', ' '}|replace{' ',' '})]</td>
</BOUCLE_nombre>
Autre critère : fusion_supprimer
{fusion_supprimer}
: ce critère supprime de la requête sql la condition GROUP BY
qui y est présente à cette étape de la compilation. Ce peut être utile pour s’affranchir d’un GROUP BY
ajouté par défaut par le compilateur SPIP lors d’une jointure et qui interfère. Il est ensuite possible d’y ajouter le critère d’une fusion désirée (cf #3209)
Dans la boucle suivante il est nécessaire d’ajouter {fusion_supprimer}
pour obtenir la fusion sur les dates, car le compilateur ajoute ajoute automatiquement un GOUP BY id_article
pour la jointure de la table ARTICLES avec la table MOTS :
<BOUCLE_facette_annee(ARTICLES){id_mot=27}{fusion_supprimer}{fusion YEAR(date)}>
[(#DATE|annee)]<br />
</BOUCLE_facette_annee>
Depuis SPIP 4, ce critère n’est plus fourni par le plugin SPIP_Bonux mais par le noyau de SPIP. Voir https://www.spip.net/6626
Fonctions php
Bonux définit aussi tout un ensemble de fonctions qui peuvent servir comme filtre, ou pour d’autres plugins.
/** Récupérer les champs date_$suffixe et heure_$suffixe dans l'environnement,
vérifier leur cohérence et les reformater */
function verifier_corriger_date_saisie($suffixe,$horaire,&$erreurs);
/** Renvoie le charset d'une ligne à importer */
function importer_csv_importcharset($texte);
/** Enlève les accents des clés sinon ca pose des problemes ... */
function importer_csv_nettoie_key($key);
/** Lit un fichier csv et retourne un tableau
si $head est true, la premiere ligne est utilisee en header pour générer un tableau associatif*/
function inc_importer_csv_dist($file, $head = false, $delim = ",", $enclos = '"', $len = 10000) ;
/** Exporter un champ pour un export CSV */
function exporter_csv_champ($champ) ;
/** Exporter une ligne complète au format CSV, avec délimiteur spécifié */
function exporter_csv_ligne($ligne, $delim = ',', $importer_charset = null) ;
/** exporter au format CSV. $ressource est un array ou une ressource sql ouverte en lecture */
function inc_exporter_csv_dist($titre, $resource, $delim=',', $entetes = null,$envoyer = true);
/** generer une balise img a partir d'un nom de fichier */
function tag_img($img,$alt="",$class="");
/** générer une clé temporaire valable 12h pour l'url courante */
function previsu_cle_temporaire($date=null);
/** vérifier qu'une clé temporaire valable 12h est bien valable */
function previsu_verifier_cle_temporaire($cle);
function _T_ou_typo($valeur, $mode_typo='toujours') ;
function spip_array_insert($arr1, $cle, $arr2, $avant=false);
function array_replace_recursive($array, $array1);
function recurse($array, $array1);
/** Coupe une chaine à la longueur demandée, sans abîmer les tags HTML , et avec options : texte de fin si coupé, coupe à la longueur exacte ou en respectant les mots... */
function text_truncate($text, $length = 100, $options = array())
/** retourner un tableau constitué de toutes les valeurs d'une colonne d'un tableau bi-dimensionnel (avec éventuellement les valeurs d'une autre colonne comme index) */
function array_column($input = null, $columnKey = null, $indexKey = null);
filtre text_truncate
function text_truncate($text, $length = 100, $options = array());
Le tableau d’options peut contenir plusieurs couples clé-valeur :
- ’ending’ => la chaine ajoutée à la fin du texte s’il est coupé. Typiquement, c’est ’...’ ou ’lire la suite’.
- ’exact’ => un booléen indiquant si la coupe se fait à la longueur indiquée exacte, même si c’est au milieu d’un mot, ou si la coupe se fait juste avant ce dernier mot.
- ’html’ => un booléen indiquant si le texte contient des tags HTML qu’il faut veiller à ne pas couper incorrectement.
fonction array_column
Charge la fonction array_column de PHP 5.5 pour les versions inférieures.
Lire le détail sur : Array_column pour SPIP
Renommés
- le filtre |aoustrong
a disparu : il est devenu |lien_ou_expose
et a été intégré dans SPIP : voir https://www.spip.net/4004
Relecture temporaire
Le plugin active la possibilité de faire une « Relecture temporaire », en ajoutant un bouton dans la barre d’administration dans la partie publique..
Ce bouton fournit une adresse publique temporaire qui peut être partagée et permet la relecture de l’article sans à avoir à se connecter à SPIP. Cette adresse n’est valable que quelques heures.
Voir aussi la contante _PREVIEW_TOKEN gérée par le noyau de SPIP.
Discussions par date d’activité
7 discussions
Yaurait ptet une erreur dans ce passage de la doc qui indique « Contrairement au critère
{compteur table}
, ces critères ne calculent pas de jointures. » ? car il est au milieu de la présentation des balises.Répondre à ce message
Avec SPIP 4.1.5 et tous les plugins à jour, le champ extra sélecteur d’article ne marche plus (alors que sélecteur article ou rubrique marche bien) (on peut bien sélectionner des articles, mais ils ne sont pas visibles dans la fiche article après enregistrement de l’article) : spip enregistre dans la base articles|25 et non article|25.
Si, via phpmyadmin on supprime le S, alors tout marche bien.
Je ne sais pas trop qui gère ce libellé : saisie ? Bonux ? Iextra ?
Une idée de l’origine de ce s intempestif ?
Merci de votre aide.
Julien
Il semblerait que ce soit ce bug https://git.spip.net/spip/spip/issues/5307 corrigé en https://git.spip.net/spip/spip/pulls/5312
Je reviens sur ce problème : SPIP 4.0.8, et bonux 4.1.1, j’ai toujours le problème du S dans articles|45 (et non article|45) quand j’utilise l’ajout rapide en indiquant un n° d’article. Si j’utilise l’arborescence, pas de problème...
J’ai bien vu le patch 5307 (qui ne semble pas être dans SPIP 4.0.8 - le fichier /ecrire/inc/filtres_selecteur_generique.php n’est pas le fichier résultat du patch 5307), mais même en recopiant le fichier du patch, cela ne marche pas...
Une idée ?
Merci !
Julien
À mon avis c’est plus sur les pages du ticket ou de la PR qu’il faudrait poser tes questions.
Répondre à ce message
Bonjour,
Le changement de borne dans paquet.xml semble fonctionner pour rendre ce plugin compatible SPIP 4.0
compatibilite="[3.0.0;4.0.*]"
dd
Il y a deja une version marquée comme compat spip 4 :)
Répondre à ce message
Bonjour,
Petit problème de compatibilité PHP pour le fichier inc/exporter_csv.php.
à partir de la ligne 119->139
à remplacer par
Merci
C’est corrigé.
Note que désormais il est possible de faire facilement une demande d’accès à git.spip.net, ce qui t’aurais permis de faire la PR toi même :)
Répondre à ce message
Suite à une de mes demandes sur le forum, on m’a conseillé de venir expliquer mon souci ici :
Je souhaite utiliser le text_truncate de Bonux sur mon site, or celui-ci rajoute des balises et mets a mal ma css.
Si j’utilise la coupe de texte proposé par Spip :
J’obtiens ceci dans mon code source et tout va bien :
En revanche la même chose avec Bonux :
J’obtiens ceci :
Mes div sont entouré d’un Strong, un code bizarre
<smal (...)<="" p="">
Merci de m’aider !
Et je suis sous Spip 3.3.0Dev
Bien à vous
Glop,
Je t’avais aussi demandé de nous donner le texte d’origine non coupé :)
Soit le html, soit le texte spip brut.
Ok,
Tu veux dire, tout le code complet de mon squelette ?
Voici le code complet de la rubrique, à la ligne 53 et commenté le code que j’utilise pour truncate :
Non pas le squelette, le code HTML compilé.
Depuis ton navigateur → afficher le code source, et copier le passage concerné.
Le but c’est qu’on puisse comparer le avant/après, pour l’instant on a juste le « après ».
Irf !!!! J’ai compris ;-)
Je prépare ça, merci
Alors, voici la version qui est ok :
Et la mauvaise avec truncate :
C’est bon pour vous ?
Merci
La mauvaise version avec Truncate
La bonne, version couper avec Spip :
Ça y est presque, mais pas encore :)
Il faut la version sans aucun filtre, uniquement la balise
#TEXTE
sans |couper ni rien d’autre. Le filtre |couper retire toutes les balises html donc ça fausse complètement le résultat.Le but est de connaître le contenu exact que reçoit la fonction texte_truncate en entrée.
Question subsidiaire : je vois qu’il y a un
<span class="caps">
, est-ce que tu as le plugin orthotypographie d’activé ? Si oui essaye en le désactivant pour voir si ça a un rapport.Ca ne change rien avec le plug Ortho-Typographie
Voici, si j’ais bien compris :
Top, merci.
Un dernier truc qui pourrait aider pour déboguer, ça serait d’avoir également le texte brut Spip (le texte de l’article en mode édition, avec les raccourcis typo et cie).
D’accord, voici le bloc #TEXTE.
Il y a un modèle made in moi : <travauxXXX|center> qui est un tableau.
Et sinon :
Ok, merci pour les infos, j’ai pu reproduire chez moi.
En fait la réponse était toute bête : par défaut ça coupe le texte sans se soucier des balises html, donc quand il y en a ça les laisse ouvertes... Pas glop.
Du coup pour du texte de contenus éditoriaux il faut toujours passer le paramètre « html » à true :
Ceci dit je me demande pourquoi ça n’est pas sa valeur par défaut, ça me paraît problématique. Je vais voir avec les autres pour faire évoluer ça.
Roooo merci !!!!
Ca marche bien :-)
Pour reprendre ton terme : glop glop !!
Exemple ici
Merci beaucoup d’avoir pris le temps…
Merci beaucoup :-)
Et comme tu dis c’est Glop glop :-)
Ca marche très bien super
Répondre à ce message
Et je suis sous Spip 3.3.0Dev
Répondre à ce message
Bonjour,
Depuis une mise à jour très récente du plugin (3.5.0), certaines pages de mes sites plantent complètement, chrome me dit ca :
En activant le débogage, j’ai ca :
J’ai réussi à corriger le soucis en remplaçant une ligne (91) dans spip_bonux_options.php
if (spip_version_compare($GLOBALS['spip_version_branche'], '3.2', '>=')) {
au lieu de
if (spip_version_compare(spip_version(), '3.2', '>=')) {
J’ai mis un hotfix sur mes sites, mais bon, une nouvelle version de Spip Bonux serait la bienvenue ;)
Merci infiniment pour ce super plugin !
JuL
La version 3.5.2 devrait corriger le problème :)
Bonjour Maïeul,
Merci infiniment pour ta réactivité, j’attends avec impatience la 3.5.2 alors.
Excellente journée.
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 :
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.
Suivre les commentaires : |