Plugin bouton éditeur

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
Up bouton avec TinyMCE
UP bouton avec JCE et les autres éditeurs
Up bouton avec JCE et les autres éditeurs

Ce plugin bouton sert uniquement pour la création d'un shortcode. Les modifications sont à faire directement dans le shortcode.

Sélectionner une action

Upbtn list actions

Un clic sur le bouton, ouvre cette fenêtre popup.

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 la liste.
Cela permet de saisir les premières lettres d'une action pour la sélectionner

Action : infos et saisie des options

 

Upbtn tooltip num
  1. La sélection d'une action affiche ses informations au-dessous.
  2. Un lien permet d'ouvrir un nouvel onglet avec sa page de démo
  3. Une documentation succincte sur l'utilisation et les précautions
  4. Le webmaster du site peut également fournir des informations et conseils spécifiques à votre site
  5. 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.
  6. Si du texte est sélectionné lors du clic sur le bouton, il est considéré comme le contenu de cette action. Il est possible de forcer la fermeture du shortcode en cochant cette case.
  7. Certaines actions utilisent des séparateurs pour les différentes parties du contenu. Indiquez ici leur nombre.
  8. Vous pouvez ajouter une option "debug" pour avoir un message avec les valeurs de l'action en frontend
  9. l'option "?" affiche une aide en frontend.
  10. Et enfin, le bouton pour insérer le shortcode dans votre article ou module personnalisé.

Les types d'options

Dans l'exemple ci-dessus, nous avons les différents types d'options

  • tooltip : 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.
  • position : une liste déroulante sans possibilité de saisie
  • width : saisie d'une valeur numérique entière. Il est possible d'indiquer une valeur minimale et maximale.
    notez la présence de l'unité entre parenthèses devant la zone. Il s'agit de l'unité par défaut de l'action. Elle n'est pas reprise dans le shortcode.
  • color : saisie d'une couleur au format #rrggbb. Pour utiliser un autre format, il faudra le modifier dans le shortcode
  • icon : il s'agit d'une liste contenant les fichiers d'un dossier. Utilisé pour choisir un style parmi plusieurs fichiers .css
  • open : un classique oui/non sous la forme d'une liste
  • id : sur fond gris pour indiquer la non-nécessité de saisie.
    Comme head-css, il est précédé d'une ligne pour créer des groupes visuels.

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

Voir sa documentation