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 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/'); 

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

4 discussions

  • 1

    Bonjour,
    Merci pour ces travaux bien utiles et de bien vouloir tester la version 1.2 de ce plugin.
    Les corrections de liens internes ne fonctionnaient pas bien de mon côté, j’ai tenté de les améliorer :
    -  Gestion des ancres
    -  Meilleure compatibilité PHP 5 et SPIP 3
    -  Élargissement sur la reconnaissance des URLs (même anciennes si possible)
    -  Mise en log des URLs corrigées
    -  Prise en compte du raccourci historique des brèves
    -  Optimisation en cas d’absence de liens
    -  Simplification de la RegExp

    Répondre à ce message

  • Oh p*t**n ! oO

    Les gars, je vous aime ! Merci ! :-)

    Répondre à ce message

  • 4

    Bonjour,

    voilà un plugin fort utile pour ne pas dire indispensable aux rédacteurs.

    bravo et merci

    Fdg

    • attention dans les premier tmps d’install a bien vérifié que tout marche. Je n’ai fait un test qu’en local avec une dizaine d’article et une url de base du site unique. Je ne sais pas ce que cela donne si on combine avec une url de base qui varie (cas de site a plusieurs noms de domaine)

    • plungin fort utile !
      serait bien utile sur contrib...
      (si ça marche pour le forum aussi)

    • oui, ca marche pour tout édition d’objet. Mais je n’ai pas la main sur les plugins de contrib ...

    • si un des admins complets nous lit... (ce plugin fait partir de ceux que j’ai repéré comme pouvant être utile ici)

    Répondre à ce message

  • 5

    Bonjour,
    très bonne et salutaire idée.
    Je suis très attaché à la portabilité de SPIP, grâce à ses liens relatifs, et je suis toujours désolé de voir les rédacteurs copier coller leurs liens depuis le front.
    J’ai testé sur un site un peu volumineux, ça fonctionne très bien, même à travers les crayons.

    Mais sur ce site, j’ai une configuration en multidomaines, et le plugin ne reconnait pas du tout et donc ne corrige pas les liens vers d’autres domaines que celui en cours de consultation.
    Dans un article qui répond sur domaine1.tld, les rédacteurs peuvent coller des liens vers des articles de domaine2.tld

    Serait il possible de traiter une liste de domaines plutôt qu’un seul ?
    Un test rapide avec ce patch en tout début de la fonction fonctionne :

    function correction_liens_internes_correction($texte){
      $urls_sites = array(url_de_base(), 'http://domaine2.tld/', 'http://domaine3.tld');
      array_walk($urls_sites, function(&$v) { $v = preg_quote($v); });
      $url_site = join('|',$urls_sites);
      ...

    Dans mon cas, je pourrais récupérer dynamiquement la liste des domaines déclarés dans multidomaines, mais c’est un cas très particulier.
    De manière générale, une telle liste pourrait être définie en constante (ou en config ?).

    Ensuite, une fois les liens absolus transformés en texte, c’est au squelette de savoir les générer sur le bon domaine (et c’est ce qui se passe sur mes sites).

    • salut, merci pour tes remarques, et le bout de code

      Pour la question des multidomaines, je propose ceci :
      1) on récupére automatiquement dans multidomaines s’il est installé
      2) on propose une constante pour ajouter d’autres urls de base, au besoin.

      Si cela te convient, te sens tu prêt à faire le codage et à le commiter ?

    • Je peux faire cette modif, oui.
      Pour la déclaration d’une constante, c’est une liste qu’il faudrait, et php n’autorise pas d’array en define.
      Une simple liste de domaines séparés dans une chaine ?

    • arg,

      séparé par une virgule (qui je crois ne fait pas parti des urls)

      n’hésite pas à te mettre en co-auteur dans le paquet.xml

    • Commit envoyé, tu me dis.
      http://zone.spip.org/trac/spip-zone/changeset/77814

      Le code prend en compte les domaines déclarés par le plugin multidomaines (s’il est installé) et ceux déclarés par une constante, exemple :
      define(’CORRECTION_LIENS_INTERNES_AUTRES_DOMAINES’,’http://domaine1.tld domaine2.tld’) ;
      Séparateur : espace ou virgule, domaines avec ou sans http:// (tout est nettoyé)

    • hop, http://zone.spip.org/trac/spip-zone/changeset/77815. Je t’ai mis co auteur sur l’article. Tu peux compléter la doc ?

      merci encore !

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

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

Dernière modification de cette page le 2 avril 2017