Le module Attestation de formation permet une mise en page libre du texte du document au dessus d'un fond image calé pour la circonstance.

Le texte doit être écrit en HTML simple, en utilisant un jeu de balises réduit. La technologie sous jacente est la fonction writeHTMLCell de la librairie TCPDF qui permet une certaine mise en forme limitée d'un contenu texte formaté en HTML dans le document PDF.

Parmi les balises reconnues (les plus courantes) :

• Titres : <H1> à <H3> (le rendu de H4, H5 et H6 n'est pas garanti)
• Paragraphes : <P>
• Les espaceurs : <BR>
• Listes simples : <UL>, <OL>, <LI>
• Les sections <CENTER> ou <RIGHT> sont reconnus
• L'attribut COLOR est reconnu

• {{pagebreak}} pour un saut de page

Les emplacements sont remplacés au moment de la production du document par les données issues des sources correspondantes. Les 3 zones de texte, en-tête, contenu et pied de page sont traités par la fonction de remplacement.

Le remplacement des balises ne peut traiter aucun contenu contenant des images embarquées dans le HTML, du à la non reconnaissance de la balise IMG par le générateur TCPDF sous-jacent. La superposition d'éléments graphiques (images) ne peut être obtenue que par programmation. Le module permet déjà une intégration d'un logo, d'une signature et d'un QRcode de vérification.

Le module apporte des variables qui peuvent être insérées dans le texte par des balises :

• {{info:user_fullname}} : Nom complet de l'utilisateur
• {{info:user_firstname}} : Prénom
• {{info:user_lastname}} : Nom
• {{info:user_idnumber}} : Numéro identifiant externe
• {{info:user_country}} : Code pays
• {{info:user_city}} : Ville
• {{info:user_institution}} : Institution
• {{info:user_department}} : Département

• {{info:user_<nom court choisi dans le formulaire de configuration du champ personnalisé>}} nouveau

Exemple : {{info:user_birthday}} Exemple : {{user:gender}} (champs personnalisé)

Note : En général, les données utilisateurs pourront aussi être récupérées sous la forme :

 <nowiki>{{user:<nomchamp>}}</nowiki>

• {{info:certificate_date}} : Date d'émission du certificat
• {{info:certificate_outcome}} : Objectif du certificat
• {{info:certificate_credit_hours}} : Crédit d'heure renseigné pour le certificat
• {{info:certificate_user_credit_hours}} : Crédit d'heure renseigné pour un utilisateur (surcharge)
• {{info:certificate_user_credit_hours_text}} : Crédit d'heure renseigné (surcharge de crédit d'heure : X h)
• {{info:certificate_credit_days}} : Crédit de jours renseigné pour le certificat
• {{info:certificate_user_credit_days}} : Crédit de jours renseigné pour un utilisateur (surcharge)
• {{info:certificate_user_credit_days_text}} : Crédit de jours renseigné (surcharge de crédit de jours : X j)
• {{info:certificate_code}} : Code unique de certificat
• {{info:certificate_certifier}} : Identité de l'autorité attestante
• {{info:certificate_teachers}} : Liste des enseignants

• {{info:course_shortname}} : Nom court du cours
• {{info:course_fullname}} : Nom complet du cours * <nowiki>{{info:course_summary}} : Résumé du cours
• {{info:course_category}} : Catégorie du cours
• {{info:course_idnumber}} : Identifiant externe du cours
• {{info:course_grade}} : Note obtenue du cours
• {{info:module_grade_<cmid>}} : Note obtenue sur l'id de module indiqué (PRO uniquement)

• {{info:site_fullname}} : Nom complet du site
• {{info:site_shortname}} : Nom court du site
• {{info:site_city}} : Ville du site, pris comme la “ville par défaut” des réglages globaux.
• {{info:site_country}} : Pays du site, pris comme le “code pays par défaut” des réglages globaux.

• {{info:user_enrolment_date}} : (Dernière) Date d'inscription dans le cours
• {{info:user_enrolment_end_date}} : Date de fin d'inscription au cours
• {{info:completion_date}} : Date d'achèvement du cours. nouveau
• {{info:legalstartdate}} : Date de départ administrative de la formation. (PRO uniquement) nouveau
• {{info:legalenddate}} : Date de fin administrative de la formation. (PRO uniquement) nouveau
• {{info:module_completion_date_<cmid>}} : Date d'achèvement d'un module de cours spécifique donné par ID. (PRO Uniquement)

• {{info:uqm_exam_grade_A}}: Utilisation du plateau de révision - Note première série de note
• {{info:uqm_exam_grade_C}}: Utilisation du plateau de révision - Note seconde série de note

• {{info:group_specific}} : Texte spécifique au groupe. Est obtenu d'une instance du bloc Bloc HTML par groupe trouvée dans le cours (la première).

• {{info:course_total_time}} : Temps total passé dans le cours, selon les calculs du bloc Bloc Use_Stats / Mesure d'activité

Il est désormais possible, pour les plugins qui ont développé l'API d'interrogation de données du PDCertificate, d'aller puiser dans un plugin des données exposées pour les certificats. La nature des données dépend de chaque plugin dont les développeurs déterminent la sémantique des données exportées et les clefs correspondantes.

La forme générale d'une balise de récupération de données d'un plugin quelconque est :

 {{plugin:<pluginname>:<datakey>:<contextinfo>}}

• pluginname est le nom moodle du plugin (par exemple local_onboarding)
• datakey est une clef de données, généralement formée par un token simple. Il est possible, lorque le plugin le propose d'aller chercher une donnée 'membre“ d'une structure avec une syntaxe à point (par ex. session.idnumber ou institution.name).
• contextinfo En général l'API invoquée dans le plugin demande une instance et un userid. Le PDcertificate fournit sa propre identité, et le userid du document certificat en cours de réalisation. Si cela ne suffit pas, il sera possible d'ajouter une information de contexte statique lors de l'appel à l'API du plugin.

La définition des récupérées dans le plugin est documentée dans le plugin.

Plugins compatibles :

• Plugin d'enregistrement d'inscriptions locales (Onboarding)

• Verrouillage individuel des attestations, dans le cas d'une absence.
• Temps passé par apprenant partiellement absent à une formation qui sera appelée par le champs dynamique {{info:certificate_user_credit_hours}}. Cette information de temps réellement accordée au stagiaire peut être saisie dans les paramètres de l'attestation de chaque stagiaire.

(Une information en “jours” peut également être donnée, avec les champs {{info:certificate_credit_days}} et {{info:certificate_user_credit_days}}, lorsque la comptabilité se fait en jour. Les deux informations peuvent être combinées dans les cas les plus exigeants)

• Valéry Frémaux (Valery@activeproLearn.com) : Développement & tests
• Florence Labord (Florence@activeproLearn.com) : Revue fonctionnelle, Documentation

Retour à l'index du guide technique - Revenir à l'index du composant- Revenir à l'index des plugins - Revenir au catalogue