Passer au contenu principal

Utiliser les shortcodes

Les shortcodes SportsPress vous permettent d'intégrer des calendriers, des tableaux, des statistiques de joueurs et d'autres contenus sportifs dans n'importe quel article, page ou widget texte WordPress.

Mis à jour aujourd’hui

Utiliser les shortcodes

Les shortcodes SportsPress vous permettent d'intégrer des calendriers, des tableaux, des statistiques de joueurs et d'autres contenus sportifs dans n'importe quel article, page ou widget texte WordPress.

Le bouton « S » dans l'éditeur classique

Lors de la modification d'un article ou d'une page avec l'éditeur Classique (TinyMCE), SportsPress ajoute un bouton « S » dans la barre d'outils. Un clic dessus ouvre un menu des shortcodes disponibles regroupés par type (Événement, Joueur, etc.). En sélectionnant l'un d'eux, la balise shortcode est insérée à la position du curseur avec un attribut id de remplacement que vous remplacez par l'ID de publication correct.

Le panneau Shortcodes sur les écrans de modification

Sur l'écran de modification d'une publication Calendrier, Tableau de ligue, Liste de joueurs, Annuaire du staff, Tournoi ou Événement, SportsPress affiche une méta-boîte Shortcodes dans la barre latérale droite. Ce panneau génère automatiquement le shortcode correct pour la publication en cours — y compris l'ID de publication déjà renseigné — afin que vous puissiez le copier et le coller directement dans n'importe quelle page ou publication sans avoir à rechercher l'ID manuellement.

Le paramètre id

Chaque shortcode qui affiche des données d'une publication SportsPress spécifique (calendrier, tableau de ligue, liste de joueurs, etc.) accepte un paramètre id dont la valeur est l'ID de publication WordPress de cet enregistrement.

Dans la boucle (sur une page d'événement, de joueur ou d'équipe unique), vous pouvez omettre id — le modèle utilise automatiquement get_the_ID() comme valeur de repli.

Hors de la boucle (sur une page autonome, un widget texte, ou toute page qui n'est pas la publication unique de l'élément que vous souhaitez afficher), le paramètre id est obligatoire. Sans lui, le shortcode n'a aucune publication depuis laquelle extraire des données et n'affichera rien ou utilisera un ID de publication aléatoire.

Exemple — omettre id dans la boucle fonctionne :

[league_table]

Exemple — id est obligatoire lors de l'intégration sur une page différente :

[league_table id="42"]

Vous pouvez également passer l'ID de publication comme premier argument positionnel (sans nom de clé) :

[league_table 42]

Les deux formes sont équivalentes.

Trouver un ID de publication

La façon la plus rapide de trouver un ID de publication est de survoler le titre de la publication dans la vue liste de l'administration WordPress — l'URL dans la barre d'état contient post=123, où 123 est l'ID. Vous pouvez également ouvrir la publication et regarder l'URL dans la barre d'adresse du navigateur.

Coller des shortcodes dans des pages et articles

  1. Copiez la chaîne de shortcode (par exemple [event_list id="99"]).

  2. Ouvrez la page ou l'article où vous souhaitez que le contenu apparaisse.

  3. Dans l'éditeur Classique, collez dans l'onglet Texte ou utilisez le bouton « S ». Dans l'éditeur de blocs, utilisez un bloc Shortcode et collez la chaîne à l'intérieur.

  4. Enregistrez et prévisualisez la page.

Remarque : SportsPress nécessite que les permaliens WordPress soient définis sur au moins « Jour et nom » (autre chose que « Simple »). Avec les permaliens simples, les événements programmés et la navigation dans les calendriers ne fonctionnent pas correctement.

Avez-vous trouvé la réponse à votre question ?