Correction des liens internes

SPIP possède des raccourcis spécifiques pour faire des liens internes au site. Par exemple pour pointer vers l’article 25, on utilise le raccourci [texte->25].

Il peut arriver que les rédacteurs et rédactices du site utilisent directement l’URL de la page publique lorsqu’ils créent des liens dans leurs articles.

Le plugin « correction des liens internes » permet de corriger automatiquement ces liens au moment de la rédaction du contenu.

Pourquoi utiliser les raccourcis de SPIP pour formater les liens internes ?

L’usage des raccourcis SPIP pour formater les liens internes permet :
-  de styler différemment les liens internes des liens externes.
-  de ne pas dépendre de l’URL du site.
-  de ne pas dépendre de l’URL des objets.
-  de permettre d’exporter facilement vers d’autres support que du Web [1].

Comment fonctionne le plugin

Le plugin s’installe comme n’importe quel plugin.

Lors de la validation d’un formulaire de rédaction d’un objet (article, rubrique etc.), le plugin vérifie les liens internes. Tout lien commençant par l’URL du site (par exemple http://www.example.com) sera analysé pour vérifier qu’il ne s’agit pas d’un objet SPIP. L’analyse se base sur la configuration du type d’URL. Autrement dit si un rédacteur copie-colle l’URL de la page publique d’un article, le plugin va le repérer.

Il va alors transformer automatiquement le lien, en mettant le raccourci SPIP correspondant :
-  [texte->xxx] s’il s’agit de l’article xxx.
-  [texte->autxxx] s’il s’agit de l’auteur xxx.
-  [texte->rubxxx] s’il s’agit de la rubrique xxx.
-  [texte->objetxxx] s’il s’agit de l’objet xxx.

Le plugin a été testé avec tous les types d’URL de SPIP, y compris les URLS arborescentes. N’hésitez pas cependant à faire part de tous cas problématiques.

Prise en compte d’autres domaines

Par défaut, le plugin reconnait toutes les urls sur le domaine où est installé le site [2].

Si votre site est accessible avec et sans www, en http et en https, si vous avez des alias (noms de domaines équivalents) [3], ces variantes d’urls ne seront pas reconnues.

Dans ce cas, vous pouvez définir avec une constante une liste de domaines supplémentaires considérés comme locaux.
Par exemple, dans config/mes_options.php :

define('CORRECTION_LIENS_INTERNES_AUTRES_DOMAINES', 'http://domaine.tld, 
https://www.domaine.tld, http://www.domaine2.tld/'); 

Plugin Multi-domaines

Si le plugin multi-domaines est activé, le plugin le reconnait automatiquement et tous les domaines déclarés dans la configuration multi-domaines sont considérés comme des domaines locaux, les liens absolus comprenant ces domaines sont transformés en raccourcis SPIP.

Notes

[1Par exemple du LaTeX pour produire un livre.

[2détection basée sur la fonction url_de_base()

[3en général, ce n’est pas une bonne idée, les variantes devraient être redirigées sur le domaine principal

Le logo est de Dmitry Mirolyubov sous Licence Creative Commons, Paternité

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