Pour faciliter l'écriture des shortcodes, un plugin éditeur (editors-xtd) est disponible depuis la version 2.1 de UP.
Il doit être téléchargé et installé comme tous les plugins.
Il ajoute un bouton dans tous les éditeurs de Joomla!
UP bouton avec TinyMCE
Joomla 4 et 5
UP bouton avec JCE
et les autres éditeurs
Joomla 4 et 5
UP bouton avec TinyMCE
Joomla 3.10
UP bouton avec JCE
et les autres éditeurs
Joomla 3.10
Ce plugin bouton sert uniquement pour la création d'un shortcode. Les modifications sont à faire directement dans le shortcode.
Sélectionner une action
Un clic sur le bouton, ouvre cette fenêtre popup.
- La zone de recherche sur le nom et la desription des actions.
- la liste des actions
La présentation standard (ci-contre) affiche la liste des options avec les options fréquemment utilisées au début.
Selon les choix du webmaster du site, les actions "top10" et le regroupement peuvent varier.
A l'ouverture, la zone active est le champ de recherche.
Cela permet de saisir les premières lettres du terme recherché pour réduire la liste
Action : infos et saisie des options
- zone de recherche des actions
- Liste des actions sélectionnées à la première étape
- Un lien permet d'ouvrir un nouvel onglet avec sa page de démo
- Une documentation succincte générée à partir de l'entête du script
- Le webmaster du site peut également fournir des informations et conseils spécifiques à votre site (fichier custom/help.txt)
- les prefsets définis par le webmaster du site
- La liste des options proposées par l'action.
Sa présentation dépend de son type.
Le survol de son libellé affiche une bulle avec des informations sur l'option.
Le survol de la valeur affiche la valeur par défaut. Quand cela est possible, cette valeur est affichée en grisé dans le champ. - Ajoute un shortcode fermant pour définir le contenu
Le texte sélectionné, lors du clic sur le bouton, est utilisé comme contenu de cette action. - Certaines actions utilisent des séparateurs pour les différentes parties du contenu. Indiquez ici leur nombre.
- Ajoute une option "debug" pour avoir un message en frontend avec les valeurs de l'action
- L'option "?" affiche une aide en frontend.
- Le bouton pour insérer le shortcode dans votre article ou module personnalisé.
- Ce bouton ajoute un shortcode fermant sans avoir à cocher la case du point 8.
Le nombre de séparateurs doit être indiqué
Les types d'options
Dans l'exemple ci-dessus, nous avons les différents types d'options
- div : l'option principale de l'action permet de saisir du texte, mais également de choisir un jeu d'options si votre webmaster en propose.
Une liste avec saisie (combo) se reconnait grâce au petit triangle à droite.
Cette option est sur fond jaune pour montrer son importance et la nécessité de fournir un argument. - id : pour personnaliser l'ID de l'action. Par défaut, l'id est composé du mot up, de l'id de larticle et sa position dans la page. Pour un module, le mot up suivi d'un nombre aléatoire.
- class, style :peut contenir des styles et des classes séparés par des points-virgules
- head-css : une ou des règles CSS qui seront ajoutées au head de la page
- xxx : certaines actions permettent des options libres. Celles-ci sont à saisir directement dans le shortcode
Note : un champ sur fond rouge pâle attire votre attention sur une particularité.
upbtn_makefile : action compagnon
Pour créer et mettre à jour les fichiers utilisés par le plugin upbtn, on utilise l'action upbtn_makefile
Son usage est indispensable si :
- vous créer des jeux d'options
- vous ajouter des modèles CSS
- vous transmettez des conseils avec les fichiers custom/help.txt
- vous modifiez la présentation de la liste d'action dans le plugin editor
- vous créer des actions
Si le plugin ne fonctionne pas correctement, vérifiez qu'une extension de sécurité (Admin Tools de Akeeba) ne bloque pas les fichiers.
Dans ce cas, il faut ajouter une exception pour le dossier contenant le fichier upbtn.js (\plugins/content/up/upbtn)