Des liens internes dans le texte

Fonction permettant de créer des liens automatiques internes depuis un texte quelconque.

Dans mes sites (Guide Méditerranée, Guide Manche et Guide Atlantique), chaque article correspond à un port ou un mouillage. Et sur chaque fiche, il peut être fait référence à un autre port ou mouillage, par exemple concernant les Distances entre ports, ou dans un texte explicatif.
Je voulais que ces références à un autre port deviennent automatiquement un lien vers le lieu concerné.
J’ai donc pioché à droite et à gauche - et me suis inspiré notamment d’une contrib de Spipage.levillage.org (disparu ?) - pour créer la fonction liens_auto suivante.

Le principe :
Le principe est de sélectionner dans la table voulue tous les items possibles - ici le « titre » - et de les comparer au texte assorti du filtre « liens_auto ».
La fonction liens_auto peut opérer cette recherche sur n’importe quelle table spip (ici spip_rubriques et spip_articles).
Il est évidemment possible de sélectionner les champs que l’on désire dans ces tables pour les comparer au texte.

les variables :

  • $texte : le texte auquel s’applique la fonction
  • $texteorg : (ici) le titre de l’article existant dans la table
  • $link : la chaîne de remplacement

La fonction str_replace fonctionne de la manière suivante :

  • str_replace(« profil », « chaîne de remplacement », « texte à remplacer »)
  • Cette fonction recherche la chaîne de caractères « profil » à l’intérieur de la chaîne de caractères « texte à remplacer ». Si elle trouve un résultat, elle remplace « texte à remplacer » par la « chaîne de remplacement » indiquée.

Fonctionnement :

  • La fonction SELECTionne l’id_rubrique et le titre de la table voulue.
  • Recherche le Titre ($texteorg) dans le texte ($texte) et le remplace par ce que l’on désire ($link) s’il le trouve.
function liens_auto($texte) {

$query = "SELECT id_rubrique, titre FROM spip_rubriques  WHERE statut='publie'";
$result = spip_query($query);
while($row = mysql_fetch_array($result))
     {
$link='<a href="rubrique.php3?id_rubrique='.$row["id_rubrique"].'">'.$row["titre"].'</a>';
$texteorg=$row["titre"];
$texte=str_replace($texteorg,$link,$texte);
     }

Cas particulier d’une recherche sur Titre et Chapo
Ce cas particulier peut intéresser lorsque le Titre d’un article est accompagné d’un autre élément champ, ici le Chapo (je m’en sers dans le Guide Méditerranée pour associer au Port le nom d’une marina).
La difficulté principale était d’associer Titre et Chapo dans la recherche, et de prévoir les cas avec et sans Chapo, et aussi avec ou sans tiret de séparation.

$query = "SELECT id_article, titre, chapo FROM spip_articles WHERE statut='publie' ";
$result = spip_query($query);
while($row = mysql_fetch_array($result))
	{
if ($row["chapo"]!="")
		{
$link='<a href="article.php3?id_article='.$row["id_article"].'">'.$row["titre"].' - '.$row["chapo"].'</a>';
	if ($texteorg=$row["titre"].' '.$row["chapo"])
	{$texte=str_replace($texteorg,$link,$texte);}

	elseif ($texteorg=$row["titre"].' - '.$row["chapo"])
	{$texte=str_replace($texteorg,$link,$texte);}

	elseif ($texteorg=$row["chapo"])
	{$link1='<a href="article.php3?id_article='.$row["id_article"].'">'.$row["chapo"].'</a>';}
	{$texte=str_replace($texteorg,$link1,$texte);}
		}
else
		{
$link='<a href="article.php3?id_article='.$row["id_article"].'">'.$row["titre"].'</a>';
$texteorg=$row['titre'];
$texte=str_replace($texteorg,$link,$texte);
		}
	}

return $texte;
}

Problèmes
1) lenteur d’exécution sur des tables importantes : étant donné que le select s’effectue à chaque fois sur toute la table, cela peut ralentir un peu l’affichage complet de la page.
On pourrait imaginer créer une table annexe, remplie à chaque création d’article, dans laquelle la fonction viendrait chercher les titres.
on pourrait aussi ajouter un cache extérieur pouvant accélérer la sélection/recherche.
2) problème de recherche sur des titres longs : il faut que le titre d’article du texte soit exactement le même (du point de vue espaces, etc.) que le titre de l’article enregistré.

Merci pour toutes vos critiques et suggestions d’améliorations.

Quelques références sur spip-contrib :

Discussion

Aucune discussion

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