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.
Aucune discussion
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 : |