Shortcode Pro permet la création rapide et facile de shortcodes WordPress et de boutons intégrés à l’éditeur TinyMCE depuis l’interface de WordPress.

Caractéristiques principales

- Création d’un nombre illimité de shortcodes personnalisés ;
- Ajout facile de boutons TinyMCE et Quicktags ;
- Tri rapide des boutons, ajout possible de séparateurs pour créer des groupes ;
- Acceptation de variables dans les shortcodes et génération automatique de fenêtres modales ;
- Support des langages HTML ou PHP dans les shortcodes ;
- Import/export des shortcodes créés ;
- Possibilité de masquer le menu Shortcode pour une interface moins encombrée ;
- Construit sur l’API de WordPress ;
- Aide intégrée ;
- Mises à jour proposées.

Configurations requises

Serveur

PHP version 5.2+ and MySQL version 5+.

WordPress

WordPress version 3.0+ nécessaire

Téléchargement et activation

Dézippage

Après avoir téléchargé le fichier depuis le référentiel WordPress (http://wordpress.org/extend/plugins/shortcodes-pro/), décompressez-le.
Téléchargez la traduction du plugin (Voir ici).
Une fois l’archive dézippée, placez les fichiers .po et .mo dans le sous-répertoire lan du répertoire du plugin.

Mise en ligne

Uploadez le dossier « shortcodes pro » dans le dossier wp-content/plugins de votre répertoire en ligne de WordPress.

Activation

Dans WordPress, allez dans la section Extensions installées. Repérez « Shortcode Pro » et cliquez sur Activer.

Ajout d’un shortcode

Nouveau shortcode

Pour créer un nouveau shortcode, cliquez sur Ajouter un nouveau Shortcode

Nommage / Action

Chaque shortcode nécessite un nom personnalisé, un slug unique sera automatiquement généré. C’est l’identificateur d’action de votre shortcode personnalisé :

[do action="exemple"] votre contenu [/do]

Types de comportements

Deux comportements sont possibles, qui modifient la façon dont fonctionne le shortcode.
« Encadrement du contenu » vous permet d’injecter du code avant et après une sélection. Les shortcodes les plus courants et les plus simples peuvent être réalisé de cette façon.
« Insertion de code » vous donne plus de liberté et la possibilité d’accepter des valeurs d’attributs et d’utiliser différents langages de code (HTML et PHP).

Encadrement du contenu

Ce comportement est le moyen le plus simple pour créer des boutons et shortcodes courts. Il fonctionne spécialement pour les cas où vous avez besoin d’entourer une sélection avec du code personnalisé.
Utilisez les deux champs prévus à mettre le code que vous souhaitez ajouter, avant et après la sélection en cours (le cas échéant).

Exemple :

[do action="exemple"]Je suis surligné[/do]

se traduira par:

< span style= »background:#ffffce »>Je suis surligné< / span>

et ressemblera à ceci :

Je suis surligné

Insertion de code

Ce comportement offre plus de fonctionnalités pour la création de vos shortcodes.
Il active le panneau Attributs et accepte les langages HTML et PHP.



Ce comportement permet deux types de langages : HTML et PHP. Le choix du langage modifie la façon dont l’extension traite le code inséré.
HTML : Remplace le shortcode par le code inséré.
PHP : Remplace le shortcode par le résultat du code inséré.

Modèles de balises

Le comportement Insertion de code permet d’utiliser des modèles de balises.
Ceux-ci peuvent être utilisés comme des jokers et seront remplacés par du contenu dynamique.
Toutes les balises ont la même syntaxe:

%%modele-de-balise%%

Pour le langage HTML, utilisez le modèle de balise %%contenu%% pour retourner le contenu sélectionné (s’il existe).
Si vous utilisez PHP, le modèle de balise pour retourner le contenu (s’il existe) prend cette forme :

$content (String)

Attributs

Les attributs personnalisés ouvrent de nouvelles possibilités au shortcode.
Pour activer les attributs, assurez-vous que le comportement du shortcode est réglé sur Insertion de code

Que permettent les attributs ?

Comme pour les shortcodes intégrés, vous pouvez proposer l’entrée de différentes variables, proposition qui se fera grâce à demander à la génération automatique d’une fenêtre modale.

Activation des attributs

Cochez la case Attributs

Ajout d’attribut

Cliquez sur Ajouter l’attribut

Panneau nouvel attribut

Slug :
C’est un nom unique, et le modèle de balise %%slug%% sera utilisé pour récupérer cette valeur dans le Code.
Label :
C’est l’étiquette qui sera utilisée pour désigner le champ dans la fenêtre modale.
Type :
Le type de champ (Texte, Textarea, Select).
Valeur par défaut :
Cette valeur sera retournée si rien n’est entré ou sélectionné.
Desc :
Ceci est une courte description qui apparaîtra sous le champ dans la fenêtre modale.

Exemple de champ text

Exemple de champ textarea

Exemple de champ select

Utilisez la syntaxe suivante pour ajouter des options multiples :

OptionName1 | OptionValue1,
OptionName2 | OptionValue2,
[etc]

Exemple :

Petit | 12px,
Normal | 16px,
Grand | 21px

Les champs attribut ajoutés

Exemple des champs attribut appliqués à un shortcode

Accès aux attributs dans le champ code

Utilisez la syntaxe utilisée pour le modèle de balise pour accéder à une valeur d’attribut

%%slug_de_l’attribut%%

Si vous utilisez PHP, les attributs seront disponibles sur le $atts array.

$atts ( Array )

Boutons de l’éditeur

Activation

Cochez la case pour générer un bouton TinyMCE personnalisé.

Sécurité

La fonction de sécurité alerte l’utilisateur si aucune sélection n’est présente.

Quicktags

Cochez la case pour générer un bouton TinyMCE Quicktag personnalisé pour le shortcode.

Rang

TinyMCE affiche jusqu’à 4 rangées de boutons. Sélectionnez la rangée désirée dans la liste.

Bouton pour l’éditeur – Sans attributs

Voici comment se présente le panneau de boutons quand aucun attribut n’est nécessaire.

Bouton pour l’éditeur – Avec attributs

Lorsque la case attributs a été cochée pour le shortcode, de nouvelles options apparaissent, permettant de configurer la fenêtre modale.

Image du bouton

Pour l’image du bouton, utilisez le module « Image à la une ». Cela fonctionne de la même manière.

Les meilleurs résultats sont obtenus avec des images ayant pour dimension 20×20 pixels.

Arranger les boutons

Pour trier les boutons TinyMCE cliquez sur « Ordonner les boutons ».

Ecran de tri

Depuis cette page vous pouvez facilement changer l’ordre des boutons de vos shortcodes. Les changements sur cette page seront automatiquement sauvegardés.
Glissez et déposez le (séparateur) pour ajouter des espaces entre les boutons. Supprimez-les avec le double clic.

Import / Export

Shortcode Pro utilise la fonction Import / Export de WordPress pour sauvegarder et rétablir vos shortcodes personnalisés.

Exportation de vos shortcodes

Rendez-vous sur Outils > Exporter et assurez-vous que l’option Shortcode est sélectionnée dans la section « Choisissez ce que vous souhaitez exporter ».

IMPORTANT:
L’export ne comprend pas les images des boutons dans le fichier de sauvegarde, seulement les données des shortcodes.
Assurez-vous que ces images sont encore accessibles depuis leurs emplacements précédents lorsque l’importateur essaiera de les importer à partir du serveur d’origine.

Fichier exporté

Le fichier exporté est un fichier WordPress eXtended RSS.

Importer vos shortcodes

Si vous n’avez pas installé le plugin officiel d’import pour WordPress, faîtes-le.

Il suffit de choisir le fichier exporté et de cliquer sur « Envoyer le fichier et l’importer ».

Options de l’extension

Menu Shortcode Pro

Shortcode Pro dispose d’une page d’options, d’où le menu personnalisé de ce plugin peut être caché.

Cocher cette option va masquer le menu. Utile si vous voulez avoir une interface moins encombrée.

Menu Shortcode Pro masqué.

WordPress