Les widgets d'édition

Les widgets permettent d'enrichir les champs classiques d'un formulaire, afin de fournir une aide à la saisie.

 

Voici ci-dessous la liste des widgets supportés pour l'édition des métadonnées d'un contenu en fonction du type.

  1. Champ de type "string"
  2. Champ de type "binary"
  3. Champ de type "file"
  4. Champ de type "rich-text"
  5. Champ de type "user"
  6. Champ de type "long"
  7. Champ de type "double"
  8. Champ de type "date"
  9. Champ de type "datetime"
  10. Champ de type "geocode"

 

Notez que certains plugins apportent leurs propres widgets qui ne sont pas énumérés ici.
Par exemple Le plugin Newsletter fournit un widget pour sélectionner une catégorie de lettre d'information.

Champ de type "string"

 

Id du widgetDescriptionRendu
AucunTexte simple sur une seule ligne.
Widget par défaut.
textareaTexte sur plusieurs ligne.
sitemap

Permet de choisir une ou plusieurs pages dans le plan du site en choisissant le site et la langue.
La valeur du champ est l'identifiant de(s) page(s) sélectionnée(s) 

current-sitemapIdentique au widget "sitemap" mais restreint aux pages du plan du site courant et la langue courante uniquement.
 
tagsPermet de choisir une ou plusieurs étiquettes de contenus ou de page.
La valeur du champ est l'identifiant de(s) étiquettes(s) sélectionnée(s)

content-tags Identique au widget "tags" mais restreint aux étiquettes de contenus 
page-tags Identique au widget "tags" mais restreint aux étiquettes de pages.
tag-categories Permet de choisir une ou plusieurs catégories d'étiquettes.
La valeur du champ est l'identifiant de(s) catégorie(s) sélectionnée(s) 

content-tag-categories Permet de choisir une ou plusieurs catégories d'étiquettes de contenus.
La valeur du champ est l'identifiant de(s) catégorie(s) sélectionnée(s)
page-tag-categories Permet de choisir une ou plusieurs catégories d'étiquettes de pages.
La valeur du champ est l'identifiant de(s) catégorie(s) sélectionnée(s)
pick-contentPermet de sélectionner un contenu
explorer-folderPermet de sélectionner un répertoire de l'explorateur de ressources

Aucun

Widget utilisé par défaut pour les champs énumérés.

Se présente sous forme d'une liste déroulante.

sorted-enumerationListe déroulante pour les champs énumérés, avec tri alphabétique des entrées.
multiselectPermet de sélectionner plusieurs entrées d'un champ énuméré.
Les valeurs possibles sont affichées dans une liste déroulante avec multi-sélection.
sorted-multiselectIdentique au widget "multiselect" mais les entrées sont triées par ordre alphabétique.
resource-filePermet de sélectionner un fichier de l'explorateur de ressources

grouped-enumerationListe énumérée à deux niveaux. Seuls les sous éléments peuvent être sélectionnés.
multiple-grouped-enumerationPermet de sélectionner plusieurs entrées.
resource-imageIdentique au widget "resource-file" mais restreint aux images.

Champ de type "binary"

Id du widgetDescriptionRendu
external-file

Permet de télécharger n'importe quel type de fichier local.
Le widget affiche le nom, la taille et la vignette du fichier et permet de téléchargé le fichier uploadé.

Widget utilisé par défaut pour les champs de type "binary"

external-imageIdentique au widget "external-file" mais restreint aux images (.png, .jpg, .jpep, .gif)
external-mutlimediaIdentique au widget "external-file" mais restreint aux fichiers multimédia (.swf, .flv)
external-soundIdentique au widget "external-file" mais restreint aux fichiers  audio (.mp3)

Champ de type "file"

Id du widgetDescriptionRendu
external-or-resource-filePermet de télécharger n'importe quel type de fichier local ou de sélectionner un fichier de l'explorateur de ressources.
Le widget affiche le nom, la taille et la vignette du fichier et permet de téléchargé le fichier choisit.

external-or-resource-imageIdentique au widget "external-or-resource-file" mais restreint aux images (.png, .jpg, .jpep, .gif)
external-or-resource-mutlimediaIdentique au widget "external-or-resource-file" mais restreint aux fichiers multimédia (.swf, .flv)
external-or-resource-soundIdentique au widget "external-or-resource-file" mais restreint aux fichiers  audio (.mp3)

Champ de type "rich-text"

WidgetDescriptionRendu
small-richtextUtilisez ce widget lorsque vous voulez un champ de texte riche plus petit en hauteur que celui par défaut
html-richtext

Utilisez ce widget lorsque vous voulez un éditeur de texte enrichi sans validation du code HTML.
Le widget par défaut pour les champs riche ne transmet que balises et attributs valides, tandis que ce dernier transmet le code HTML tel quel sans vérification.

Par exemple, le code HTML suivant provenant d'un copier-coller dans l'éditeur <p class="unknownclass">Texte<unknowntag/></p> sera sauvegardé tel quel.
En utilisant le widget par défaut, seul <p>Texte</p> aurait été sauvegardé.

L'utilisation de ce widget est dangereux, il ne peut être utilisé lorsque le contenu est stocké directement en HTML.
Il ne doit pas être utilisé sur un contenu stocké au format docbook.

 

Champ de type "user"

Id du widgetDescriptionRendu
userPermet de sélectionner une personne dans la base des utilisateurs.

Champ de type "long"

Id du widgetDescriptionRendu
Aucun

Champ texte simple n'autorisant que les chiffres à la saisie.

Widget utilisé par défaut pour les champs de type "long"

Champ de type "double"

Id du widgetDescriptionRendu
Aucun

 Champ texte simple n'autorisant que les entiers ou décimal à la saisie.

Widget utilisé par défaut pour les champs de type "double"

 

Champ de type "date"

Id du widgetDescriptionRendu
Aucun

 Sélection d'une date dans un calendrier.

Widget utilisé par défaut pour les champs de type "date"

 

Champ de type "datetime"

Id du widgetDescriptionRendu
Aucun

Sélection d'une date dans un calendrier et de l'heure dans une liste déroulante éditable.

Widget utilisé par défaut pour les champs de type "datetime"

 

Champ de type "geocode"

Id du widgetDescriptionRendu
AucunSélection de coordonnée numérique (latitude, longitude) à l'aide d'une carte et d'un champ de recherche Google Map
Widget utilisé par défaut pour les champs de type "geocode