Shortcodes

Pretty Links propose des codes courts que vous pouvez utiliser partout où WordPress les accepte : articles, pages, widgets, constructeurs de pages et modèles de thèmes compatibles avec do_shortcode(). Les codes courts constituent un moyen flexible d'insérer des liens dynamiques dans votre contenu.

Insérer un lien spécifique

Utiliser le [prettylink] code court permettant d'insérer n'importe quel lien « pretty » à l'aide de son ID :

[prettylink id="42"]

Cela génère un lien vers l'URL simplifiée du lien portant l'ID 42. Le texte visible du lien correspond par défaut au titre de celui-ci.

Vous pouvez trouver l'identifiant de n'importe quel lien à partir de la Pretty Links liste — elle s'affiche à côté ou en dessous du titre du lien.

Personnalisation du texte du lien

Remplacer le texte affiché par le texte attribut :

[prettylink id="42" text="Cliquez ici pour découvrir notre offre d'affiliation"]

Cela s'affiche sous la forme d'une balise d'ancrage standard, le texte que vous indiquez renvoyant vers l'URL simplifiée.

Autres attributs pris en charge : limace (à utiliser à la place de id pour effectuer une recherche par nom d'article), classe (classes CSS supplémentaires), et cible (par exemple :. target="_blank").

Ce qui est mis à l'honneur

Le [prettylink] La sortie respecte les paramètres du lien :

• Nofollow et Sponsorisé les indicateurs ajoutent le rel attributs ;
• Ouvrir dans une nouvelle fenêtre ajoute target="_blank" (avec coffre-fort rel="noopener");
• C'est l'URL « jolie » qui s'affiche, et non l'URL cible — ce qui signifie que suivi des clics, type de réorientationet caractéristiques avancées toutes ces règles s'appliquent lorsqu'un visiteur clique.

Lien vers le « Pretty Link » généré automatiquement pour l'article actuel

Si vous avez activé créer automatiquement des liens Pour un type d'article, chaque article de ce type se voit attribuer automatiquement son propre lien personnalisé. Pour intégrer ce lien personnalisé dans le contenu de l'article (ou dans un modèle), utilisez :

[post-pretty-link]

Par défaut, cela affiche le chaîne d'URL « brute » (sans formatage) (lien non cliquable). Il est couramment utilisé dans :

• Boutons « Envoyer cet article par e-mail » (“ Partager cet article : yoursite.com/abc123 ”);
• Modèles adaptés à l'impression qui nécessitent une URL courte pour s'afficher ;
• Pieds de page des thèmes qui affichent une URL courte copiable pour chaque publication.

Affichage sous forme de lien cliquable

Pour encadrer l'URL dans un <a> tag, pass lien="ancrage" (ou tout autre élément non vide texte (attribut qui implique le mode « ancrage ») :

[post-pretty-link link="anchor"]

[post-pretty-link text="Partager cet article"]

La première utilise le nom enregistré du lien comme texte d'ancrage ; la seconde utilise le texte que vous fournissez.

Si l'article en cours ne dispose pas d'un lien optimisé généré automatiquement, le shortcode n'affiche rien ; vous pouvez donc l'intégrer sans risque dans un modèle qui s'applique à tous les articles.

Où les codes courts fonctionnent-ils ?

Ces codes courts fonctionnent partout où WordPress les interprète :

• À l'intérieur Éditeur classique contenu (onglet « Visuel » ou « Texte ») ;
• À l'intérieur du Gutenberg Bloc de shortcode;
• À l'intérieur des blocs de paragraphe Gutenberg (évalués automatiquement) ;
• À l'intérieur widgets (si votre zone de widgets s'étend do_shortcode);
• À l'intérieur fichiers de thème si le développeur a encapsulé la sortie dans do_shortcode();
• À l'intérieur de la plupart des outils de création de pages (Elementor, Beaver Builder, Divi, etc.).

Si un shortcode s'affiche sous forme de texte brut sur la page au lieu d'être évalué, cela signifie que le contexte environnant ne s'exécute pas do_shortcode(). Il s'agit d'un problème lié au thème ou à la configuration du constructeur de pages, et non d'un bug de Pretty Links.

Résultat des codes courts

Ces deux codes courts génèrent un <a> balise pointant vers le URL simplifiée, et non l'URL de destination. Cela signifie que :

• Le visiteur voit votresite.com/votre-slug s'ils survolent ;
• Les clics passent par Pretty Links et sont suivis ;
• Tous les comportements liés à la redirection (masquage, barre de personnalisation, ciblage, rotation, expiration) s'appliquent ;
• La modification ultérieure de la cible du lien permet de mettre à jour la destination sans que vous ayez à modifier le contenu de l'article.

Conseils

• Enregistrer les identifiants des liens une seule fois dans un document Notes si vous réutilisez la même poignée de jolis liens dans de nombreux articles. C'est plus rapide que de les rechercher un par un ;
• Utiliser le outil d'insertion de l'éditeur de blocs dans la mesure du possible. La présentation visuelle est plus pratique pour les insertions ponctuelles ; les shortcodes sont particulièrement utiles pour le contenu basé sur des modèles (comme un lien “ s'abonner ” récurrent dans le pied de page de vos articles) ;
• Test en mode aperçu après avoir ajouté un shortcode. Si le texte brut du shortcode s'affiche sur l'interface publique, cela signifie que le contexte n'évalue pas les shortcodes ;
• Utilisez l'attribut approprié pour les slugs. id n'accepte qu'un identifiant de lien numérique. Pour effectuer une recherche par slug, utilisez la commande limace attribut dans le shortcode :

[prettylink slug="my-slug"]