Wiki source code of 05 Zertifikate

Last modified by Carina Enke on 23.07.2024

version	line-number	content
895.1	1	[[image:attach:medal.png\|\|data-xwiki-image-style="img-icon"]] In addition to the [[Performance results>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Bewertung.Performance Results.WebHome\|\|shape="rect"]], certificate files can be generated for a course or individual course elements. The user can download these files as a PDF via a link in the performance results section of the course and print them out.
894.3	2
895.1	3	You can use various configuration options to influence the design of the certificate and limit the view or print.
787.1	4
879.1	5	{{info}}
895.1	6	A certificate is issued for a passed course or course element. Instructions on how to configure the passing status can be found on the [[Assessment>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Bewertung.WebHome\|\|shape="rect"]] help page.
879.1	7
895.1	8	A certificate is only visible if performance results have been configured for the course. Instructions on how to configure performance results for a course can be found on the [[Performance Results>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Bewertung.Performance Results.WebHome]] help page.
879.1	9	{{/info}}
	10
884.1	11	(% class="box infomessage" %)
	12	(((
895.1	13	A [[supplementary Video>>doc:LMS.Benutzerhandbuch OPAL.Erste Schritte.Ergaenzungsvideos.WebHome]] is available for this function.
787.1	14	)))
869.1	15
894.3	16
895.1	17	== Offer certificates ==
787.1	18
884.1	19
895.1	20	To generate a certificate automatically and display it to the learner, proceed as follows:
787.1	21
895.1	22	1. Open the course editor and navigate to the desired course element. To receive a certificate for the entire course, go to the top course node.
	23	1. In the selected element, switch to the Assessment tab.
	24	1. Activate the Use certificates option.
	25	\\//[[image:attach:Kurseditor-Zertifikate verwenden_en.png\|\|data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]//
884.1	26
895.1	27	1. Choose the desired certificate template from the Template for certificates selection list. Apart from the example template, you can also use individually created templates. The latter will appear at the top of the selection list.(% style="color:#0000ff" %)
	28	1. If you activate the Display certificates only for tutors option, the PDF files of the certificates will only be accessible by tutors via the assessment tool. A simple user does not have access to this area and can thus not view, print, or download their certificate.
884.1	29
787.1	30
895.1	31	{{info}}
	32	Please note that the template set in step 4 will be used for the first time for certificates that have been newly acquired after the publication of this change. However, users will also receive a new certificate if they improve on their original result. The template does not affect existing certificates. This also applies to replacing the template. A new template will only be used for a new certificate.
787.1	33	{{/info}}
	34
884.1	35
895.1	36	== Use individual certificate templates ==
884.1	37
787.1	38
895.1	39	Individual course templates must be saved to the storage folder of the course and linked to the relevant course element. First open the course and switch to the course editor. Then select the Storage folder entry from the Editor tools menu. Choose one of the following options according to your certificate template:
787.1	40
895.1	41	* One or more certificate files with any name:
787.1	42
895.1	43	1. First create a new folder with the exact title //certificate_templates //in the course storage folder.
	44	1. Copy all HTML templates as well as all images and CSS files referenced in these templates to the //certificate_templates //folder.
	45	1. (((
	46	Close the storage folder.
879.1	47
895.1	48	{{info title="Tip"}}
	49	Use the following example template file to test the function: (% style="color: rgb(0,0,255);" %)[[attach:certificate_templates.zip]].
	50
	51	(% style="color: rgb(51,51,51);" %)Upload this file to the storage folder in the course editor and unzip it. Take a look at the examples included in the //certificate_templates// folder and edit them if necessary. All included certificate templates will then be available under the Use certificates section in the Assessment tab of the course or course element.
879.1	52	{{/info}}
787.1	53	)))
869.1	54
895.1	55	* A single template with the mandatory file name //certificatetemplate.html //(all letters in lowercase):
787.1	56
895.1	57	1. Upload the HTML file with this specific file name to the course storage folder or the assigned resource folder of the course.
	58	1. All images and CSS files referenced in the template must also be copied to the course storage folder / resource folder.
	59	1. Close the storage folder.
787.1	60
895.1	61	When configuring the course element in the Assessment tab, select exactly this template from the Template for certificates list.
787.1	62
884.1	63
895.1	64	=== Placeholder ===
884.1	65
787.1	66
895.1	67	When creating the certificate template, you can use different placeholders in the HTML file, depending on the configuration of the learning platform. These are then filled in the certificate of the respective user with the corresponding data of the course or user.
884.1	68
895.1	69	You can create and design such a certificate template with the integrated HTML editor e. g. directly in the course storage folder. If you create and upload a certificate template with an external editor, the system will warn you of possible information loss when trying to edit the template with the integrated editor.
787.1	70
895.1	71	{{note title="Course element ID"}}
	72	For some of the placeholders, you will need the individual course element ID. The IDs can be found in the course editor of the respective course element on the Title and description tab in the form of a number combination in the bottom right corner (e. g. ID: 94862470524389). Just replace the signs indicated in the table (~#~##) with the desired number combination (e.g. %%MARK:94862470524457%%).
879.1	73	{{/note}}
787.1	74
895.1	75	(% class="wrapped" %)
	76	\|=(((
	77	Placeholder
	78	)))\|=(((
	79	Value
	80	)))
	81	\|(((
879.1	82	%%COURSE_TITLE%%
	83	)))\|(((
895.1	84	Title of the course for which the certificate is issued.
879.1	85	)))
895.1	86	\|(((
	87	(% style="color:#172b4d" %)%%COURSENODE_TITLE%%
879.1	88	)))\|(((
895.1	89	Title of the course element for which the certificate is issued.
879.1	90	)))
895.1	91	\|(((
849.1	92	%%CERTIFICATE_DATE%%
895.1	93
	94
	95
841.1	96	)))\|(((
879.1	97	(% class="content-wrapper" %)
	98	(((
895.1	99	The date on which the performance results were achieved. The formatting of the placeholder depends on the language selected by the user. It can be adjusted with the following options:
879.1	100
892.2	101
895.1	102	\|=Form\|=Placeholder\|=Example
893.2	103	\|Standard\|%%CERTIFICATE_DATE%%\|(((
	104	Standard (Systemsprache Deutsch): 23.07.2024,
	105
	106	Standard (Systemsprache Englisch): Jul 23, 2024
	107	)))
	108	\|LONG DE\|%%CERTIFICATE_DATE_LONG:LANG=de%%\|23. Juli 2024
	109	\|SHORT DE\|%%CERTIFICATE_DATE_SHORT:LANG=de%%\|23.07.24
	110	\|MEDIUM DE\|%%CERTIFICATE_DATE_MEDIUM:LANG=de%%\|23.07.2024
	111	\|FULL DE\|%%CERTIFICATE_DATE_FULL:LANG=de%%\|Dienstag, 23. Juli 2024
	112	\|LONG EN\|%%CERTIFICATE_DATE_LONG:LANG=en%%\|July 23, 2024
	113	\|SHORT EN\|%%CERTIFICATE_DATE_SHORT:LANG=en%%\|07/23/24
	114	\|MEDIUM EN\|%%CERTIFICATE_DATE_MEDIUM:LANG=en%%\|Jul 23, 2024
	115	\|FULL EN\|%%CERTIFICATE_DATE_FULL:LANG=en%%\|Tuesday, July 23, 2024
787.1	116	)))
879.1	117	)))
895.1	118	\|(((
	119	(% style="color:#172b4d" %)%%GRADE%%
869.1	120	)))\|(((
895.1	121	Display of grades as text
869.1	122	)))
895.1	123	\|(((
879.1	124	%%GRADE:~#~##:LANG=de%%
849.1	125	)))\|(((
895.1	126	Display of the German grade for the specified course element
849.1	127	)))
895.1	128	\|(((
879.1	129	%%GRADE:~#~##:LANG=en%%
	130	)))\|(((
895.1	131	Display of the English grade for the specified course element
879.1	132	)))
895.1	133	\|(((
787.1	134	%%MARK%%
849.1	135	)))\|(((
895.1	136	Mark for the entire course
787.1	137	)))
895.1	138	\|(((
787.1	139	%%MARK:~#~##%%
	140	)))\|(((
895.1	141	Mark for the course element with the ID ~#~## (the course element must be assessable)
787.1	142	)))
895.1	143	\|(((
787.1	144	%%ROOT_NODE_SHORT_TITLE%%
879.1	145	)))\|(((
895.1	146	Short title from the course root node
787.1	147	)))
895.1	148	\|(((
787.1	149	%%ROOT_NODE_TITLE%%
879.1	150	)))\|(((
895.1	151	Title from the course root node
787.1	152	)))
895.1	153	\|(((
787.1	154	%%METADATA:moduleduration%%
	155	)))\|(((
895.1	156	(% class="TableParagraph" %)
	157	Course metadata: Duration of the module
787.1	158	)))
895.1	159	\|(((
787.1	160	%%METADATA:moduleects%%
	161	)))\|(((
895.1	162	Course metadata: ECTS
787.1	163	)))
895.1	164	\|(((
787.1	165	%%METADATA:moduleexam%%
	166	)))\|(((
895.1	167	Course metadata: Exams
787.1	168	)))
895.1	169	\|(((
787.1	170	%%METADATA:modulelevel%%
	171	)))\|(((
895.1	172	Course metadata: Level
787.1	173	)))
895.1	174	\|(((
787.1	175	%%METADATA:modulelink%%
	176	)))\|(((
895.1	177	Course metadata: Link to the module
787.1	178	)))
895.1	179	\|(((
787.1	180	%%METADATA:modulemethods%%
	181	)))\|(((
895.1	182	Course metadata: Teaching and learning methods
787.1	183	)))
895.1	184	\|(((
787.1	185	%%METADATA:modulename%%
	186	)))\|(((
895.1	187	Course metadata: Name of the module
787.1	188	)))
895.1	189	\|(((
787.1	190	%%METADATA:modulenumber%%
	191	)))\|(((
895.1	192	Course metadata: Module number
787.1	193	)))
895.1	194	\|(((
787.1	195	%%METADATA:moduleresponsible%%
	196	)))\|(((
895.1	197	Course metadata: Person responsible for further education
787.1	198	)))
895.1	199	\|(((
787.1	200	%%METADATA:moduleversion%%
	201	)))\|(((
895.1	202	Course metadata: Version
787.1	203	)))
895.1	204	\|(((
787.1	205	%%METADATA:moduleworkloadpresence%%
	206	)))\|(((
895.1	207	Course metadata: Attendance time
787.1	208	)))
895.1	209	\|(((
787.1	210	%%METADATA:moduleworkloadprivate%%
	211	)))\|(((
895.1	212	Course metadata: Private study time
787.1	213	)))
895.1	214	\|(((
787.1	215	%%METADATA:moduleworkloadtotal%%
	216	)))\|(((
895.1	217	Course metadata: Total workload
787.1	218	)))
895.1	219	\|(((
787.1	220	%%PASSED%%
	221	)))\|(((
895.1	222	Displays "Passed" in the certificate, depending on the configured user language at the time of passing.
787.1	223	)))
895.1	224	\|(((
787.1	225	%%PROPERTY:birthDay%%
879.1	226	)))\|(((
	227	(% class="content-wrapper" %)
787.1	228	(((
895.1	229	(% class="TableParagraph" %)
	230	Date of birth with the following options:
879.1	231
895.1	232	* Selecting a display style for the date
879.1	233	* (((
895.1	234	Defining the language format
879.1	235
895.1	236	{{expand title="Display all available format options ..."}}
879.1	237	{{{Standard: %%PROPERTY:birthDay%%
	238	LONG DE: %%PROPERTY:birthDay_LONG:LANG=de%%
	239	SHORT DE: %%PROPERTY:birthDay_SHORT:LANG=de%%
	240	MEDIUM DE: %%PROPERTY:birthDay_MEDIUM:LANG=de%%
	241	FULL DE: %%PROPERTY:birthDay_FULL:LANG=de%%
	242	LONG EN: %%PROPERTY:birthDay_LONG:LANG=en%%
	243	SHORT EN: %%PROPERTY:birthDay_SHORT:LANG=en%%
	244	MEDIUM EN: %%PROPERTY:birthDay_MEDIUM:LANG=en%%
	245	FULL EN: %%PROPERTY:birthDay_FULL:LANG=en%%}}}
	246	{{/expand}}
787.1	247	)))
879.1	248	)))
	249	)))
895.1	250	\|(((
787.1	251	%%PROPERTY:email%%
	252	)))\|(((
895.1	253	Email address
787.1	254	)))
895.1	255	\|(((
787.1	256	%%PROPERTY:firstName%%
	257	)))\|(((
895.1	258	First name
787.1	259	)))
895.1	260	\|(((
787.1	261	%%PROPERTY:institutionalName%%
	262	)))\|(((
	263	Institution
	264	)))
895.1	265	\|(((
879.1	266	%%PROPERTY:institutionalUserIdentifier%%
	267	)))\|(((
895.1	268	Matriculation number (system-dependent metadata)
879.1	269	)))
895.1	270	\|(((
787.1	271	%%PROPERTY:lastName%%
	272	)))\|(((
895.1	273	Last name
787.1	274	)))
895.1	275	\|(((
787.1	276	%%PROPERTY:orgUnit%%
	277	)))\|(((
895.1	278	Organisation unit
787.1	279	)))
895.1	280	\|(((
879.1	281	%%SALUTATION:LANG=de%%
	282	)))\|(((
895.1	283	Salutation (German)
879.1	284	)))
895.1	285	\|(((
879.1	286	%%SALUTATION:LANG=en%%
	287	)))\|(((
895.1	288	Salutation (English)
879.1	289	)))
895.1	290	\|(((
787.1	291	%%SCORE%%
	292	)))\|(((
895.1	293	Score for the entire course
787.1	294	)))
895.1	295	\|(((
787.1	296	%%SCORE:~#~##%%
	297	)))\|(((
895.1	298	Score for the course element with the ID ~#~## (the course must be assessable)
787.1	299	)))
895.1	300	\|(((
	301	(% style="color:#172b4d" %)%%OUTCOME:[variable name]:~#~##%%
879.1	302	)))\|(((
	303	(% class="content-wrapper" %)
	304	(((
895.1	305	Output value of an ONYX test
879.1	306
895.1	307	{{expand title="Learn more about how to use this placeholder ..."}}
	308	This placeholder can be used for all variables displayed in a test course element on the Test configuration tab>"Output variables of this resource" such as MAXSCORE, PASS_SCORE, SCORE, PASS, as well as for individual test and section variables of the type text or numerical.
879.1	309
895.1	310	[[image:attach:Kurseditor - Ausgabevariablen_en.png]]
879.1	311
895.1	312	If the certificate should contain output values from another course element, the course element ID must be specified in the placeholder. For example, this is the case if the certificate is created for a structure course element and output values are to be retrieved from a test course element. If the certificate is created directly for the test course element for which the user values should be displayed, %%OUTCOME:[variable name]%% will be sufficient as specification.
879.1	313	{{/expand}}
	314	)))
	315	)))
895.1	316	\|(((
	317	(% style="letter-spacing:0.0px" %)%%SEMESTER%%
787.1	318	)))\|(((
	319	Semester
	320	)))
895.1	321	\|(((
787.1	322	%%USERNAME%%
	323	)))\|(((
895.1	324	First and last name of the person receiving the certificate for their performance results.
787.1	325	)))
	326
895.1	327	=== Examples ===
787.1	328
879.1	329	{{panel bgColor="#dddddd"}}
895.1	330	{{expand title="Display HTML example ..."}}
879.1	331	{{code language="xml"}}
787.1	332	<body>
	333	<div id="center">
	334	<!-- header-logo -->
	335	<div id="header">
	336	<div id="logo"></div>
	337	</div>
	338
	339	<!-- content-part-->
	340	<div id="content">
	341	<h1>Zertifikat</h1>
	342	<h2>%%USERNAME%%</h2>
	343	<div>hat am</div>
	344	<h3>%%CERTIFICATE_DATE%%</h3>
	345	<div>den Kurs</div>
	346	<h2>%%COURSE_TITLE%%</h2>
	347	<div>erfolgreich absolviert.</div>
	348	</div>
	349
	350	<!-- signature line -->
	351	<div id="signature">
	352	<h3>Dieses Zertifikat wurde automatisch von der Lernplattform erstellt.</h3>
	353	</div>
	354	<div class="clearfloat"></div>
	355
	356	<!-- footer-logo -->
	357	<div id="footer">
	358	</div>
	359
	360	</div>
	361	</body>
	362
	363	{{/code}}
879.1	364	{{/expand}}
	365	{{/panel}}
787.1	366
879.1	367	{{panel bgColor="#dddddd"}}
895.1	368	{{expand title="Display CSS example ..."}}
879.1	369	{{code language="css"}}
787.1	370	body {font-family: Verdana,Helvetica,Arial,sans-serif; margin: 0; padding: 0;}
	371	h1 {color: #888; font-size: 4em; margin-bottom: 80px;}
	372	h2 {font-size: 2em; padding-bottom: 0px; margin-top: 40px; margin-bottom: 40px;}
	373	h3 {font-size: 1.6em;}
	374	.floaterright {float: right;}
	375	.clearfloat {clear: both;}
	376	#center {margin: 0 auto; width: 900px;}
	377	#header {height: 152px;background: url(certificate_header.png) no-repeat #eee; box-shadow: 0 4px 4px -2px #AAAAAA;}
	378	#content {height: 900px; margin-top: 100px;}
	379	#content div, #signature span {font-size: 1.6em;}
	380	#content div, #content h1, #content h2, #content h3 {text-align: center;}
	381	#signature {text-align: left; margin-left: 20px;}
	382	#signature h3 {font-weight: normal; font-size: 1.3em; margin-bottom: 5px; margin-top: 5px;}
	383	#signature span {font-size: 1em;}
	384	#footer {margin-top: 35px; height: 50px; background: url(certificate_footer.png) no-repeat #eee;}
	385	{{/code}}
879.1	386	{{/expand}}
	387	{{/panel}}

Wiki source code of 05 Zertifikate

Search

OPALGlobal

OPALMenü

Recently Visited