|label_nettoyer

JLuc, YannX — 2021-09-23T10:34:47Z

Les chaines de langues (historiques) de SPIP contiennent parfois des ' :', parfois pas ; les fonctions label_nettoyer et label_ponctuer permettent de choisir l'une ou l'autre selon le contexte. [1]

Le filtre |label_nettoyer élimine tout ' : ' et espace terminale éventuellement présents dans une chaîne de langue de SPIP ou de vos squelettes. Cela permet de les utiliser proprement comme étiquettes de formulaire.

Exemple : <:info_maximum|label_nettoyer:>

Voir aussi
|label_ponctuer

[1] Il convient dans les chaines de langues de labels de préférer les écritures sans ' :'.

|label_ponctuer

JLuc, YannX — 2021-09-23T07:34:54Z

Le filtre |label_ponctuer permet d'ajouter si besoin un ' : ' terminal aux chaînes de texte utilisées comme étiquettes de formulaire.

Il commence par mettre la première lettre de la chaîne en majuscule et par retirer de la fin de celle-ci le ' :' et l'éventuel espace précédent, au moyen du filtre |label_nettoyer, puis il ajoute la terminaison adaptée en tenant compte du contexte de langue.

Exemple : <:info_maximum|label_ponctuer:>

Il est possible
- de ne pas mettre la première lettre en majuscule en passant un argument vide au filtre : <:info_maximum|label_ponctuer{''}:>
- de modifier le caractère final et l'espace qui le précède éventuellement en modifiant la chaîne de langue 'label_ponctuer', localement dans votre fichier de langue (voir « article 2128 »).

Voir aussi
|label_nettoyer

[1] Il convient dans les chaines de langues de labels de préférer les écritures sans ' :'.

Les filtres de texte

chankalan, tcharlss, YannX — 2017-02-11T11:35:00Z

Ce tableau récapitule les filtres modifiant le rendu des balises produisant du texte au format HTML, ce qu'ils font et dans quels cas les utiliser.

Les filtres de texte
Filtre	Effet & utilité	Texte en entrée / texte en sortie
textebrut	Remplace les , et les doubles retours à la ligne par de simples retours à la ligne ; les espaces insécables et les doubles espaces par des espaces simples. S'utilise pour insérer le texte dans les tags , et autres balises HTML.	`William Shakespeare : né à Stratford-sur-Avon`
textebrut		`William Shakespeare : né à Stratford-sur-Avon`
texte_backend	Formate le texte pour les flux XML. Particulièrement utile dans des squelettes de fil RSS.	`William Shakespeare naquit à Stratford-sur-Avon`
texte_backend		`William Shakespeare naquit à Stratford-sur-Avon`
attribut_html	Formate le texte pour les attributs HTML. S'utilise typiquement, dans les attributs </code>, <code class='spip_code spip_code_inline' dir='ltr'><alt></code>...</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>2 est "supérieur" à 1 </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>2 est "supérieur" à 1 </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="texte_script"></a><a href='https://www.spip.net/fr_article4281.html' class="spip_in"><strong>texte_script</strong></a></td> <td rowspan='2' headers='id048d_c1'>Formate le texte pour les <strong>scripts PHP et JS</strong>.<br />Echappe les quotes</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>SPIP, Système de publication pour l'internet </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>SPIP, Système de publication pour l\'internet </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="safehtml"></a><a href='https://www.spip.net/fr_article4310.html' class="spip_in"><strong>safehtml</strong></a></td> <td rowspan='2' headers='id048d_c1'>Echappe le <strong>code PHP et JS</strong> <br />À utiliser pour sécuriser les textes issus de l'extérieur (forums, syndications...)</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><script type="text/javascript">...</script></code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre data-language="javascript" class='spip_code spip_code_block language-javascript' dir='ltr' style='text-align:left;'><code><script type="text/javascript">...</script> </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="supprimer_tags"></a><a href='https://www.spip.net/fr_article4315.html' class="spip_in"><strong>supprimer_tags</strong></a></td> <td rowspan='2' headers='id048d_c1'>Supprime tous les tags HTML tout en conservant le contenu de ces même tags.<br />Permet d'obtenir un texte « brut de pomme »</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><p><strong>William Shakespeare</strong> naquit à <em>Stratford-sur-Avon</em></p> </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>William Shakespeare naquit à Stratford-sur-Avon </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="charset2unicode"></a><a href='https://www.spip.net/fr_article5450.html' class="spip_in"><strong>charset2unicode</strong></a></td> <td rowspan='2' headers='id048d_c1'>Transforme en <strong>entités unicode</strong> <code class='spip_code spip_code_inline' dir='ltr'></code>.<br />L'intérêt de ce filtre est qu'il n'impacte pas les balises html.</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>2 est "supérieur" à 1 </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>2 est "supérieur" à 1 </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="echapper_tags"></a><a href='https://www.spip.net/fr_article5515.html' class="spip_in"><strong>echapper_tags</strong></a></td> <td rowspan='2' headers='id048d_c1'>Transforme les chevrons de tag <code class='spip_code spip_code_inline' dir='ltr'><...></code> en entité HTML. <br />Utile pour du texte entre balises <code class='spip_code spip_code_inline' dir='ltr'><pre></code>.</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><p><strong>William Shakespeare</strong> naquit à Stratford-sur-Avon</p> </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><p><strong>William Shakespeare</strong> naquit à Stratford-sur-Avon</p> </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="PtoBR"></a><a href='https://www.spip.net/fr_article4308.html' class="spip_in"><strong>PtoBR</strong></a></td> <td rowspan='2' headers='id048d_c1'>Transforme les sauts de paragraphe <code class='spip_code spip_code_inline' dir='ltr'><p></code> en simples retours à la ligne.<br />Permet de « resserrer » une mise en page.</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><p><strong>William Shakespeare :</strong></p><p style="color:navy;">né à Stratford-sur-Avon </p> </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><strong>William Shakespeare :</strong><br />né à Stratford-sur-Avon </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="liens_absolus"></a><a href='https://www.spip.net/fr_article4126.html' class="spip_in"><strong>liens_absolus</strong></a></td> <td rowspan='2' headers='id048d_c1'>Transforme <strong>tous les liens</strong> (<code class='spip_code spip_code_inline' dir='ltr'><a href=...</code>, <code class='spip_code spip_code_inline' dir='ltr'><link href:...</code>, <code class='spip_code spip_code_inline' dir='ltr'> et <code class='spip_code spip_code_inline' dir='ltr'><script src=...</code>) en liens absolus.<br />Particulièrement utile dans des squelettes de fil RSS.</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> </code></pre></div></td></tr> <tr class='row_odd odd'> <td rowspan='2' headers='id048d_c0'><a id="liens_ouvrants"></a><a href='https://www.spip.net/fr_article4297.html' class="spip_in"><strong>liens_ouvrants</strong></a></td> <td rowspan='2' headers='id048d_c1'>Transforme <strong>les liens SPIP</strong> qui mènent vers des sites extérieurs pour qu'ils s'ouvrent dans une nouvelle fenêtre ou onglet.</td> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><a href="http://www.spip.net/page.html"> </code></pre></div></td></tr> <tr class='row_even even'> <td headers='id048d_c2'><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><a href="http://www.spip.net/page.html" target="_blank"> </code></pre></div></td></tr> </tbody> </table> <p>A signaler que le filtre <code class='spip_code spip_code_inline' dir='ltr'>lignes_longues</code> peut toujours être utilisé mais est déprécié. Il est préférable de couper les lignes longues avec des propriétés CSS comme <code class='spip_code spip_code_inline' dir='ltr'>word-wrap</code></p> <table class="table spip"> <tbody> <tr class='row_odd odd'> <td rowspan='2'><a id="lignes_longues"></a><a href='https://www.spip.net/fr_article4298.html' class="spip_in"><strong>lignes_longues</strong></a></td> <td rowspan='2'>Introduit des <strong>césures</strong> dans les mots « trop longs ».</td> <td><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>http://www.spip.net/spip.php?page=recherche&recherche=lignes_longues </code></pre></div></td></tr> <tr class='row_even even'> <td><div class="precode"><pre data-language="html" class='spip_code spip_code_block language-html' dir='ltr' style='text-align:left;'><code>http://www.spip.net /spip. php?page=recherche &recherche=lignes_longues </code></pre></div></td></tr> </tbody> </table></div> <div class='rss_ps'><p>Voir également la liste complète de tous les filtres : <a href='https://www.spip.net/fr_article901.html' class="spip_in">Les filtres de SPIP</a></p></div> </article> <article> <h1>\|sinon_interdire_acces</h1> <p>YannX — 2016-02-06T13:34:46Z</p> <div class='rss_texte'><!--sommaire--><div class="well nav-sommaire nav-sommaire-1" id="nav69f2ee23c05fa8.03872287"> <h2>Sommaire</h2><ul class="spip" role="list"><li> <a id="s-Voir-aussi"></a><a href="#Voir-aussi" class="spip_ancre">Voir aussi</a></li></ul></div><!--/sommaire--><p>Le filtre <code class='spip_code spip_code_inline' dir='ltr'>\|sinon_interdire_acces</code> permet de rediriger vers une page d'erreur s'il est appliqué à une variable valant <code class='spip_code spip_code_inline' dir='ltr'>false</code>. Ce filtre est souvent appliquée au résultat d'une balise <code class='spip_code spip_code_inline' dir='ltr'>#AUTORISER</code><span class="spip_note_ref"> [<a href="#nb3-1" class="spip_note" rel="appendix" title="Voir la description de la balise #AUTORISER et l'API correspondante." id="nh3-1">1</a>]</span>, il peut être insérée n'importe où dans le squelette, et même dans les inclusions.</p> <p>Le code suivant redirigera vers une page d'erreur standard (par défaut sur une 403 dans l'espace privé et 404 dans l'espace public) si l'internaute n'a pas les droits de webmestre.</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>[(#AUTORISER{webmestre}\|sinon_interdire_acces)] </code></pre></div> <p>Plutôt que de simplement rediriger l'internaute vers une page d'erreur standard, on peut renseigner une URL de redirection en premier paramètre, et préciser le code d'erreur en second paramètre.</p> <p>L'exemple suivant vérifie que l'internaute est bien identifié, sinon une erreur 403 sera renvoyée.</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>[(#SESSION{id_auteur}\|sinon_interdire_acces{'',403})] </code></pre></div> <p>À noter, si vous souhaitez utiliser un autre code d'erreur que 301 ou 302, il ne faut pas spécifier d'URL de redirection.</p> <section class="sommaire-section sommaire-section_niveau1 sommaire-section_h2" aria-labelledby="Voir-aussi"><h2 class="h2" id='Voir-aussi'>Voir aussi <a class='sommaire-back sommaire-back-1' href='#s-Voir-aussi' title='Retour au sommaire'></a></h2> <p><strong>les autres filtres de test</strong></p> <ul class="spip" role="list"><li> <a href='https://www.spip.net/fr_article4615.html' class="spip_in">\|oui</a></li><li> <a href='https://www.spip.net/fr_article4616.html' class="spip_in">\|non</a></li><li> <a href='https://www.spip.net/fr_article4186.html' class="spip_in">\| ?<i>sioui, sinon</i></a></li><li> <a href='https://www.spip.net/fr_article4313.html' class="spip_in">\|sinon</a></li></ul> <p><strong>les filtres logiques </strong></p> <ul class="spip" role="list"><li> <a href='https://www.spip.net/fr_article4617.html' class="spip_in">\|et</a></li><li> <a href='https://www.spip.net/fr_article4619.html' class="spip_in">\|ou</a></li><li> <a href='https://www.spip.net/fr_article4618.html' class="spip_in">\|xou</a></li></ul></section></div> <hr /> <div class='rss_notes'><div id="nb3-1"> <p><span class="spip_note_ref">[<a href="#nh3-1" class="spip_note" title="Notes 3-1" rev="appendix">1</a>] </span>Voir la description de la balise <a href='https://www.spip.net/fr_article3896.html' class="spip_in">#AUTORISER</a> et l'<a href='https://www.spip.net/fr_article5528.html' class="spip_in">API correspondante</a>.</p> </div></div> </article> <article> <h1>_TITRER_DOCUMENTS</h1> <p>YannX — 2015-06-20T10:55:35Z</p> <div class='rss_chapo'><p>La constante <code class='spip_code spip_code_inline' dir='ltr'>_TITRER_DOCUMENTS</code> va forcer le titrage des documents à partir du nom du fichier.</p></div> <div class='rss_texte'><!--sommaire--><div class="well nav-sommaire nav-sommaire-3" id="nav69f2ee23c2c417.51605665"> <h2>Sommaire</h2><ul class="spip" role="list"><li> <a id="s-Fonctionnement"></a><a href="#Fonctionnement" class="spip_ancre">Fonctionnement</a></li><li> <a id="s-Activation"></a><a href="#Activation" class="spip_ancre">Activation</a></li><li> <a id="s-Voir-aussi"></a><a href="#Voir-aussi" class="spip_ancre">Voir aussi</a></li></ul></div><!--/sommaire--><section class="sommaire-section sommaire-section_niveau1 sommaire-section_h2" aria-labelledby="Fonctionnement"><h2 class="h2" id='Fonctionnement'>Fonctionnement<a class='sommaire-back sommaire-back-3' href='#s-Fonctionnement' title='Retour au sommaire'></a></h2> <p>À l'ajout d'un nouveau document, cette constante va forcer SPIP à prendre le nom du fichier comme le "titre" du document.</p> <p>Le titre est basé sur le nom du fichier sans son extension. Les ponctuations (y compris "_" et les "-") sont remplacées par des espaces. Les majuscules et les accents sont conservés.</p> <p><strong>Exemple : </strong> <br class='autobr' /> À l'ajout du fichier <code class='spip_code spip_code_inline' dir='ltr'>Mon_super-fichier.pdf</code>, le nom enregistré en base sera "Mon super fichier".</p> <div class='info'> Note : par défaut, le titre est laissé vide. </div></section><section class="sommaire-section sommaire-section_niveau1 sommaire-section_h2" aria-labelledby="Activation"><h2 class="h2" id='Activation'>Activation<a class='sommaire-back sommaire-back-3' href='#s-Activation' title='Retour au sommaire'></a></h2> <p>Dans votre fichier <code class='spip_code spip_code_inline' dir='ltr'>config/mes_options.php</code> (voir <a href='https://www.spip.net/fr_article4654.html' class="spip_in">l'article qui lui est consacré</a>) :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// Titrer les documents joints à partir du nom du fichier if (!defined('_TITRER_DOCUMENTS')) { define('_TITRER_DOCUMENTS', true); } </code></pre></div></section><section class="sommaire-section sommaire-section_niveau1 sommaire-section_h2" aria-labelledby="Voir-aussi"><h2 class="h2" id='Voir-aussi'>Voir aussi<a class='sommaire-back sommaire-back-3' href='#s-Voir-aussi' title='Retour au sommaire'></a></h2><ul class="spip" role="list"><li> <a href='https://www.spip.net/fr_article1823.html' class="spip_in">La boucle DOCUMENTS</a></li><li> <a href='https://www.spip.net/article2002.html'>article 2002</a></li></ul></section></div> </article> <article> <h1>_LOGIN_TROP_COURT</h1> <p>YannX — 2013-09-27T18:39:39Z</p> <div class='rss_texte'><p>Cette constante permet de définir la taille minimale autorisée pour les logins des utilisateurs. Par défaut, sa valeur est de <code class='spip_code spip_code_inline' dir='ltr'>4</code>, ce qui force la taille minimale des logins à 4 caractères.</p> <p>Comme pour toutes les <a href='https://www.spip.net/fr_article1825.html' class="spip_in">variables de personnalisation</a> de SPIP, il est possible de personnaliser la valeur de cette constante, dans votre fichier <code class='spip_code spip_code_inline' dir='ltr'>config/mes_options.php</code> (voir <a href='https://www.spip.net/fr_article4654.html' class="spip_in">l'article qui lui est consacré</a>).</p> <p>Par exemple, vous autoriserez les utilisateurs à utiliser des logins de 3 caractères minimum en définissant la valeur de cette constante à 3.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// permettre aux auteurs de choisir un login de 3 caractères define('_LOGIN_TROP_COURT', 3); </code></pre></div> <p>Vous pouvez aussi contrôler la longueur minimale des mots de passe avec <a href='https://www.spip.net/fr_article5548.html' class="spip_in">_PASS_LONGUEUR_MINI</a>.</p></div> </article> </main></body></html>