Homogénéiser les titres

Petit filtre pour homogénéiser l’apparence des titres sur les sites où interviennent de multiples rédacteurs.

Ce filtre fait 2 choses :
-  il tronque les titres à 60 caractères (sans coupure de mot, donc ça peut dépasser un peu cette limite)
-  il met en minuscules les titres écrits tout en majuscules, et, dans tous les cas, force la 1e lettre en majuscule.

Le filtre s’appelle « titre_homogene » et voici le code :

function titre_homogene($titre) {
  $titre = tronquer_titre($titre);
  return casse_titre($titre);
}

// tronque un titre à 60 caractères, sans coupure de mot
function tronquer_titre($texte) {
  return couper_texte($texte, 60);
}

// coupe une chaîne à $limite caractères, sans coupure de mot
// (un mot est considéré comme un groupe de caractères séparé par des espaces)
function couper_texte($texte, $limite) {
  // la longueur du texte est <= $limite, on retourne le texte entier
  if (strlen($texte) <= $limite) return $texte;
  // on fait la coupure avant le 1e espace après $limite caractères
  $texte = nl2br($texte);
  $pos = strpos(substr($texte, $limite), " ");
  // s'il y a un espace après $limite caractères ou juste après $limite caractères
  // on retourne la partie de $texte jusqu'avant cet espace
  if (is_integer($pos) && $pos) return substr($texte, 0, $limite+$pos) . " (...)";
  // sinon (pas d'espace après $limite caractères ou juste après $limite caractères) on retourne le texte
  else return $texte;
}

// vérifie la casse du titre afin de le mettre en minuscules
// s'il est tout en majuscules et de forcer la 1ère lettre en majuscule
function casse_titre($titre) {
  if (!ereg("([a-z|\.]+)", $titre)) $titre = strtolower($titre);
  // si le titre commence par un numéro (1. ), 
  // il faut mettre le 1er car qui suit en majuscules
  if (ereg("^[0-9]+\. ", $titre)) {
    $pos = strpos($titre, " ");
    if (is_integer($pos) && $pos) 
      return substr($titre, 0, $pos) . " " . ucfirst(substr($titre, $pos+1));
    else return $titre;
  }
  else return ucfirst($titre);
}

(Les lignes commençant par un // peuvent être supprimées : elles servent à expliquer le code, au cas où vous voudriez le modifier)

Exemple :

<BOUCLE_articles(ARTICLES){id_rubrique}>
[(#TITRE|titre_homogene)]
</BOUCLE_articles>

Mais au fait, pourquoi ce filtre : un petite explication s’impose

Pour la maquette de mon premier site SPIP, je me suis inspiré des squelettes par défaut, dont le graphisme avaient une certaine élégance. Le client était content, moi aussi. Jusqu’au jour où est arrivé le « Communiqué de presse du Collectif National des Psychologues de la Fonction Publique Hospitalière » (92 signes). Comme si leurs titres n’étaient pas assez visibles, nos bavards psys se sont mis en tête de les mettre en majuscules…

Pour éviter de tels excès, j’ai écrit ce filtre qui a donc 2 buts :

-  limiter la longueur des titres à 60 signes,
-  forcer les titres en minuscules (avec la 1re lettre majuscule) pour homogénéiser les titres du site.

Comment utiliser ce filtre ?

Comme tous les filtres : (#TITRE.

Pour le filtre « titre_homogene », ce sera (#TITRE.

Où écrire ce filtre ?

SPIP met à votre disposition un fichier mes_fonctions.php3, vide à l’origine et destiné à recevoir tous vos filtres.

Donc ce fichier ressemblera à ça :

<?php
(tout le code de vos filtres, en particulier celui indiqué dans l'article « Homogénéiser les titres »)
?>

<?php et ?>

sont les balises de code PHP. Donc pas de balises HTML en dehors de ces balises PHP.

Si vous n’avez pas d’éditeur acceptant les fichiers PHP, vous pouvez écrire vos filtres avec le Bloc-Note de Windows.

Le filtre titre_homogene

Un filtre appelle une fonction PHP de mes_fonctions.php3, avec un seul argument : le texte à modifier (les filtres peuvent avoir plusieurs arguments à partir de la version 1.42).

Notre filtre appelle donc la fonction titre_homogene(), laquelle fait appel à 2 sous-filtres tronquer_titre et casse_titre qui ont respectivement les fonctions décrites plus haut, et que vous pouvez utiliser individuellement.

Le sous-filtre tronquer_titre

Il tronque le titre à 60 caractères (limite que vous pourrez modifier en changeant la valeur dans la fonction tronquer_titre()), sans coupure de mot. Ca veut dire que si le dernier mot est coupé, le titre est tronqué juste derrière ce mot.

La fonction appelle une fonction couper_texte() qui coupe un texte à la longueur demandée, sans coupure de mot :

function tronquer_titre($texte) {
  return couper_texte($texte, 60);
}

Si le titre est tronqué, "(…)" est rajouté à la fin, pour montrer que le titre n’est pas complet. Evidemment, ça n’a d’intérêt que pour les liens "Dans la même rubrique", par exemple.

Le sous-filtre casse_titre

Ce sous-filtre n’a rien l’intention de casser, mais seulement de changer la casse majuscules du titre en minuscules, avec la 1re lettre majuscule. Vous jugerez que ce n’est pas vraiment génial de transformer, par exemple : « LA FETE A COTE ! » en « La fete a cote ! » En fait, le but inavoué de ce filtre est de discipliner les rédacteurs afin qu’ils rédigent leurs titres en minuscules. En ce sens, oui, le filtre « casse » les titres majuscules.

La fonction casse_titre() détecte si le titre ne contient aucune minuscule. Si c’est le cas, elle le convertit en minuscules. Puis dans tous les cas, met la 1re lettre en majuscule.

Si le titre contient un numéro de type « 1. le titre », c’est le 1er caractère suivant ce numéro qui est converti en majuscule.

Compatibilité

Le filtre est compatible SPIP 1.3 et suivants, ainsi que PHP3 et suivants.

Note des admins.
L’utilisation de ce filtre n’est pas conseillée : il est beaucoup plus efficace de FORMER vos rédacteurs à écrire des titres appropriés, cours et sans majuscules. Cependant, ce filtre peut être utile pour certains, alors il a sa place sur spip-contrib.

Discussion

5 discussions

  • Merci de cette contrib. J’ai réutiliser un bout du code pour recréer un filtre « couper » qui garde le formatage du texte. Cela donne le filtre couper_formatage. En plus il ajoute un lien « lire la suite » (c’est pourquoi il utilise deux paramètres.

    pour l’utiliser il faudra donc faire

    (#TEXTE|couper_formatage300,#URL_ARTICLE)

    (en modifiant le 300, qui est le nombre de caracères, mais pas le #URL_ARTICLE

    Voici le code à mettre dans le fonctions.php3 :

    // coupe une chaîne à $limite caractères, sans coupure de mot
    // (un mot est considéré comme un groupe de caractères séparé par des espaces)
    function couper_formatage($texte, $limite,$url) {
      // la longueur du texte est <= $limite, on retourne le texte entier
      if (strlen($texte) <= $limite) return $texte;
      // on fait la coupure avant le 1e espace après $limite caractères
      $texte = nl2br($texte);
      //Il y a parfois des doublons </p><br /> que l'on supprime (ajoute perso)
      $texte = str_replace("</p><br />", "</p>", $texte);
      $pos = strpos(substr($texte, $limite), " ");
      // s'il y a un espace après $limite caractères ou juste après $limite caractères
      // on retourne la partie de $texte jusqu'avant cet espace
      //ajout d'une lien "Lire la suite", ajout perso
      if (is_integer($pos) && $pos) return substr($texte, 0, $limite+$pos) . " (...)"." <a href=\"$url\">Lire la suite</a>";
      // sinon (pas d'espace après $limite caractères ou juste après $limite caractères) on retourne le texte
      else return $texte;
    }

    Répondre à ce message

  • cesium5500

    Bonjour,

    Il y a déjà un bail que cet article a été écrit, j’espère que j’aurai une réponse...

    J’aimerais savoir qu’elles variables modifier pour dupliquer la fonction titre_homogène dans le fichier mes_fonctions.php3.

    En passant cet add-on est très intéressant et surtout, il fonctionne à merveille...

    Merci de cette contribution en mon nom et celui de la communauté...

    cesium

    Répondre à ce message

  •  :-)

    Bonsoir ;

    J’aime beaucoup votre anecdote conçernant votre client et je doit dire que ce filtre me sera très utile.

    @+

    EDou

    Répondre à ce message

  • Réponse au message de Marcello :

    Tous les filtres persos sont dans le fichier mes_fonctions.php3. Ce fichier doit commencer et finir par des tags PHP :

    <?php
    
    Les filtres
    
    ?>

    Répondre à ce message

  • Je cherche à comprendre spip pour créer mes propres squeletes.Onle met ou ce filtre ? :0)

    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 :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom