local:tabbedquickform:userguide

This is an old revision of the document!


User guide

The TabbedQuickform plugin transforms radically moodle by:

  • Displaying more compact screens for forms, avoiding scrolls and long forms when deployed.
  • Allowing cleaning all forms from unused or unexploited options.

For the non admin users

Using this plugin is almost transparent for those users. Users will be proposed the forms in a similar view/controller model as before. Forms are just more compact and have tab switchable panels.

If users are allowed to, users might have an additional “switch” button on top of each form allowing to globally switch between “simplified” or “complete” mode.

For an administrator

Administrators will have more implication in the process as they will drive the simplification effort of Moodle. Administrators can run across the whole platform and choose to mask and setup some relevant defaults for most of the form items. This cleanup should in any case:

  • Be performed by admins unilaterally before the users come in.
  • Be performed bilaterally with users representants after users started to use the platform.
  • Eventually follow a survey that will examine what users really will not use.
  • Or eventually following a data inquiry to check tracks of disinterest.

Switching on forms configuration mode

  1. Form configuration mode switch button
  2. Form mode switch button

Masquage/Démasquage des champs

Le masquage démasquage des champs doit être réalisé avec précaution. Certains champs peuvent être liés à d'autres entrées et leur indisponibilité pourrait provoquer des situations non solubles pour l'utilisateur destinataire.

En général, il est conseillé de bien étudier une fonctionnalité et de repérer l'ensemble des paramètres qui s'y réfèrent afin de les masquer tous. Attention que certains paramètres peuvent également être liés à des fonctions qui transparaissent dans d'autres composants et donc d'autres formulaires.

Les hypothèses de simplification doivent donc être étudiées avec soin, faire l'objet d'expérimentation sur les effets produits et d'une validation.

  1. Bouton de retour au mode normal
  2. Commutateurs de masques

Peut on utiliser le mode configuration pour changer les valeurs par défaut des paramètres masqués ?

Actuellement non. Les valeurs que vous modifiez dans un formulaire que vous configurez ont la même valeur que celles que vous rentreriez dans le mode d'usage normal. Elles valent pour l'action que vous êtes en train de faire (créer un cours, créer une activité, une cohorte etc.)

Comment je reconnais un formulaire qui peut être traité ?

En mode administrateur de site, par la présence du bouton “Configurer le formulaire” en haut à droite du formulaire.

Pourquoi certains écrans avec des entrées de formulaires ne peuvent-ils pas être configurés ?

Parce que le développeur n'a pas utilisé la technologie QuickForm préconisée par Moodle pour les formulaires. Seuls les formulaires QuickForm peuvent être optimisés.

Si je vois deux boutons de configuration sur une page ?

C'est qu'il y a deux formulaires indépendants posés sur la page. Les deux peuvent être dans la plupart des cas optimisés. Dans certains cas rares, des champs pourraient avoir le même nom dans la même page et une collision de clef pourrait se produire. Les deux champs se verraient alors maqués en même temps.

Si les boutons d'action du formulaire n'apparaissent que sur le dernier onglet ?

Il s'agit d'une construction particulière du formulaire par son développeur que nous n'avons pas encore examinée. Reportez nous si possible le signalement sur Github.

Utiliser le fichier de configuration pour précaractériser une simplification

Le système de filtrage étant intégré comme un plufin, les décisions de masquage prises par les administrateurs ont été implémentées comme des clefs de configuration du plugin local_tabbedquickform. De ce fait la règle qui permet une configuration forcée par le fichier de configuration config.php à la racine de Moodle s'applique.

Il suffit alors de connaître la matrice qui génère les clefs de configuration lorsqu'un champ est masqué pour pouvoir écrire un ensemble de pré-configurations du type :

  $CFG->forced_plugin_settings = array('local_tabbedquickform'  => array('<maskid>' => '1',
                           '<secondmaskid>' => '1'),

La clef de masque est composée comme suit :

  • Le préfixe 'mask_'
  • L'ID de page Moodle transformé (ex : site_login_index pour le type site-login-index)
  • Un séparateur '_'
  • L'identifiant d'élément ou groupe d'élément de formulaire (tel qu'il peut être relevé sur un élément “fitem” dans le HTML d'une page).

Exemple :

mask_page_course_edit_id_idnumber

Revenir au sommaire du composant

local/tabbedquickform/userguide.1483442155.txt.gz · Last modified: 2024/04/04 15:50 (external edit)