Wiki source code of Templates

Last modified by XWikiGuest on 2026/06/21 23:01

Show last authors
1 {{include reference="Help.Code.VelocityMacros" /}}
2
3 {{velocity output="false"}}
4 #set ($featuresPrefix = 'https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features')
5 #set ($exoPrefix = 'https://extensions.xwiki.org/xwiki/bin/view/Extension')
6 #set ($actionCards = [{
7 'title': $services.localization.render('help.templates.useTemplates.title'),
8 'description': $services.localization.render('help.templates.useTemplates.description'),
9 'tip': $services.localization.render('help.templates.useTemplates.tip',
10 ["<a href='$featuresPrefix/DocumentLifecycle#HCreate' class='wikiexternallink'>",'</a>"])
11 ,
12 'thumbnail': 'Template',
13 'actions': [{
14 'label': $services.localization.render('help.try.label'),
15 'type': 'success',
16 'url': $xwiki.getURL('Sandbox.WebHome', 'create', $escapetool.url({
17 'title': "New Page $datetool.get('dd MMM yyyy, HH:mm')"
18 }))
19 }]
20 }, {
21 'title': $services.localization.render('help.templates.create.title'),
22 'description': $services.localization.render('help.templates.create.description'),
23 'tip': $services.localization.render('help.templates.create.tip',
24 ["<a href='$exoPrefix/Administration+Application#HCreatetheTemplateProvider' class='wikiexternallink'>",'</a>"])
25 ,
26 'thumbnail': 'Administration',
27 'actions': [{
28 'label': $services.localization.render('help.more.label'),
29 'url': "$exoPrefix/Administration+Application#HCreatetheTemplateProvider"
30 }]
31 }])
32
33 #if ($hasAdmin)
34 #set ($discard = $actionCards[1].actions.add(0, {
35 'label': $services.localization.render('help.browse.label'),
36 'url': $xwiki.getURL('XWiki.XWikiPreferences', 'admin', 'editor=globaladmin&section=Templates')
37 }))
38 #end
39
40 #macro (getTemplateExample $inputCard $outputCard)
41 #set ($templateReference = $services.model.resolveDocument($inputCard.templateReference))
42 #if ($xwiki.getDocument($templateReference).isNew())
43 #set ($outputCard = {
44 'title': $inputCard.title,
45 'description': $inputCard.description,
46 'documentation': "$exoPrefix/Templates+Application/",
47 'thumbnail': $inputCard.thumbnail
48 })
49 #else
50 #set ($outputCard = {
51 'title': $inputCard.title,
52 'description': $inputCard.description,
53 'examples': $inputCard.templateReference,
54 'thumbnail': $inputCard.thumbnail
55 })
56 #end
57 #end
58
59
60 #set ($exampleCards = [{
61 'title': $services.localization.render('help.templates.article.title'),
62 'description':$services.localization.render('help.templates.article.description'),
63 'templateReference': 'Templates.Article.Template.WebHome',
64 'thumbnail': 'Help.Templates.WebHome@article.png'
65 }, {
66 'title': $services.localization.render('help.templates.encyclopedia.title'),
67 'description': $services.localization.render('help.templates.encyclopedia.description'),
68 'templateReference': 'Templates.Encyclopedia.Template.WebHome',
69 'thumbnail': 'Help.Templates.WebHome@encyclopedia.png'
70 }, {
71 'title': $services.localization.render('help.templates.meeting.title'),
72 'description': $services.localization.render('help.templates.meeting.description'),
73 'templateReference': 'Templates.Meeting.Template.WebHome',
74 'thumbnail': 'Help.Templates.WebHome@meeting.png'
75 }, {
76 'title': $services.localization.render('help.templates.simple.title'),
77 'description': $services.localization.render('help.templates.simple.description'),
78 'templateReference': 'Templates.SimplePage.Template.WebHome',
79 'thumbnail': 'Help.Templates.WebHome@simple.png'
80 }])
81 {{/velocity}}
82
83 {{velocity}}
84 {{html clean="false"}}
85 <ul class="card-list two-cols">
86 #foreach ($card in $actionCards)
87 <li class="card">
88 #helpActionCard($card)
89 </li>
90 #end
91 </ul>
92 <h3 id="HExamples">$services.localization.render('help.templates.examples.title')</h3>
93 <p>$services.localization.render('help.templates.examples.description')</p>
94 <ul class="card-list">
95 #foreach ($card in $exampleCards)
96 <li class="card">
97 #set ($outputCard = {})
98 #getTemplateExample($card $outputCard)
99 #helpExampleCard($outputCard)
100 </li>
101 #end
102 </ul>
103 <p><a href="$exoPrefix/Templates+Application/" class="wikiexternallink">$services.localization.render('help.templates.more')</a></p>
104 {{/html}}
105 {{/velocity}}