Outils pour utilisateurs

Outils du site


mod:pdcertificate:technique:placeholders

Ceci est une ancienne révision du document !


Intégration des données dans les modèles

Module Attestation de formation

Introduction

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.

Balises HTML

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

Les emplacements de variables

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 :

Données de l'utilisateur

  • {{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

Données liée aux champs de profil personnalisés

  • {{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>

Données locales de l'instance d'activité

  • {{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_credit_hours_text}} : Crédit d'heure renseigné (crédit d'heure : X h)
  • {{info:certificate_code}} : Code unique de certificat
  • {{info:certificate_certifier}} : Identité de l'autorité attestante
  • {{info:certificate_teachers}} : Liste des enseignants

Données du cours

  • {{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é

Données du site ou de contexte général

  • {{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.

Données d'achèvement et d'inscription

  • {{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:module_completion_date_<cmid>}} : Date d'achèvement d'un module de cours spécifique donné par ID. :!: nouveau

Données spéciales (nécessite la disponibilité de plugins complémentaires)

Données spéciales liées au groupe

  • {{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).

Données spéciales du cours

Données liée à version PRO : Gestion des absences

  • 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:user_credit_hours}}

Explication de la règle de gestion :

Les notions de temps et d’état verrou ont été dissociées pour rester orthogonales et ne pas mélanger les fonctionnalités.

  • temps surchargé dans la gestion des certificats :
  • si champs vide = on reprend le credit hours
  • si champs non vide afficher la valeur choisie
  • Etat du certificat si verrou : attestation bloqué

Exemple :

Dans le corps de l'attestation, utilisation du shortcode {{info:certificate_user_credit_hours}}

L'usager a été inscrit sur une formation de {{info:certificate_credit_hours}} heures et a réalisé {{info:user_credit_hours}} heures.

Nota :Les boites de surcharge n'apparaissent que quand le certificat est activé et les conditions d'obtention emplies

Crédits

  • 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

mod/pdcertificate/technique/placeholders.1645205086.txt.gz · Dernière modification: 2024/04/04 15:52 (modification externe)