m 1 revision imported |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:Create a template}} | {{DISPLAYTITLE:Create a template}} | ||
<div class="steps"> | <div class="steps"> | ||
| Line 5: | Line 4: | ||
To create the template, we go to the page ''Special:Create template''. On this page, we have access to the properties that we have already created. | To create the template, we go to the page ''Special:Create template''. On this page, we have access to the properties that we have already created. | ||
#Like in the previous step ([[Manual:Semantic MediaWiki/Examples/Customer data|creating properties]]), | #Like in the previous step ([[Manual:Semantic MediaWiki/Examples/Customer data|creating properties]]), find the link "Create a template" from the search field of the Special pages overview page or scroll down to the ''Page Forms'' section.[[File:Manual:Vorlage-erstellen-EN.png|alt=Create a template|center|thumb|550x550px|Create a template]] | ||
#Define the data fields that you want to use in your template. For each property that you created, you need to have a | #Define the data fields that you want to use in your template. For each property that you created, you need to have a placeholder-field (=template parameter) . <br />[[File:Manual:Vorlage-erstellen-spezialseite-EN.png|alt=Create the template|center|thumb|750x750px|Create the template]]<br /> | ||
#*'''Template name (1):''' Enter ''Customer data'' as name for the template. | #*'''Template name (1):''' Enter ''Customer data'' as name for the template. | ||
#*'''Category (2):''' Define a category which will be assigned to all customer pages that use this template. It makes sense to also call this category Customer data. | #*'''Category (2):''' Define a category which will be assigned to all customer pages that use this template. It makes sense to also call this category ''Customer data''. | ||
#*'''Field name (3):''' Create a field name for the property Has location. This field name | #*'''Field name (3):''' Create a field name for the property ''Has location''. This field name is used in the template ith the data entry form. The name should not contain spaces. | ||
#*'''Display label (4):''' This is the field label tha tis shown on the customer pages. It can contain spaces. | #*'''Display label (4):''' This is the field label tha tis shown on the customer pages. It can contain spaces. | ||
#*<nowiki/>'''S'''<nowiki/>'''emantic property''' '''(5):''' Choose the property ''Has location'' that you created in the previous step. | #*<nowiki/>'''S'''<nowiki/>'''emantic property''' '''(5):''' Choose the property ''Has location'' that you created in the previous step. | ||
#*'''A'''<nowiki/>'''dd field (6):''' Click Add field to create the fields for the properties ''Has First contact'' and ''Has contact person''. | #*'''A'''<nowiki/>'''dd field (6):''' Click Add field to create the fields for the properties ''Has First contact'' and ''Has contact person''. | ||
#C<nowiki/>lick ''Save page'' at the end of the page | #C<nowiki/>lick ''Save page'' at the end of the page. | ||
| Line 20: | Line 19: | ||
==Including the template on a page== | ==Including the template on a page== | ||
#To include the template on a customer page, you simply add it from the Visual Editor ''Insert'' menu. <br />[[File:Manual: | #To include the template on a customer page, you simply add it from the Visual Editor ''Insert'' menu. <br />[[File:Manual:Ve insert.png|alt=Insert menu of the visual editor|center|thumb|200x200px|Insert the template on a page]] | ||
#Start typing the name ''Customer data'' and select the template (1). Then, click ''Add template'' (2). <br />[[File:Manual:Vorlage-einfügen-VE2-EN.png|alt=Select template|center|thumb|350x350px|Select template]] | #Start typing the name ''Customer data'' and select the template (1). Then, click ''Add template'' (2). <br />[[File:Manual:Vorlage-einfügen-VE2-EN.png|alt=Select template|center|thumb|350x350px|Select template]] | ||
#Click ''Insert.'' | #Click ''Insert.'' Simply ignore the notice aobut missing template data, since we will create a form for the template in the next step. [[File:Manual:Manual smw templatedata notice.png|alt=Customer data template dialog box |center|thumb|500x500px|Notice about missing TemplateData]]<br /> | ||
#Save the page. The template is now included on the page. <br />[[File:Manual:Vorlage-eingebunden-EN.png|alt=Included template|center|thumb|750x750px|Included template]] | #Save the page. The template is now included on the page. <br />[[File:Manual:Vorlage-eingebunden-EN.png|alt=Included template|center|thumb|750x750px|Included template]] | ||
| Line 30: | Line 29: | ||
Next, we create a form that makes it easy for users to enter the data. | Next, we create a form that makes it easy for users to enter the data. | ||
<span class="nextstep">[[Manual:Semantic MediaWiki/Examples/Customer data/Form|Create a form]]</span> | |||
<span class="nextstep">[[Manual:Semantic MediaWiki/Examples/Customer data/Form|Create a form]]</span> | |||
{{Box Links-en|Topic1=https://www.semantic-mediawiki.org/wiki/Help:Semantic_templates Help page for semantic templates}} | {{Box Links-en|Topic1=https://www.semantic-mediawiki.org/wiki/Help:Semantic_templates Help page for semantic templates}} | ||
Revision as of 10:06, 15 July 2025
Creating the display template
To create the template, we go to the page Special:Create template. On this page, we have access to the properties that we have already created.
- Like in the previous step (creating properties), find the link "Create a template" from the search field of the Special pages overview page or scroll down to the Page Forms section.
Create a template - Define the data fields that you want to use in your template. For each property that you created, you need to have a placeholder-field (=template parameter) .
Create the template
- Template name (1): Enter Customer data as name for the template.
- Category (2): Define a category which will be assigned to all customer pages that use this template. It makes sense to also call this category Customer data.
- Field name (3): Create a field name for the property Has location. This field name is used in the template ith the data entry form. The name should not contain spaces.
- Display label (4): This is the field label tha tis shown on the customer pages. It can contain spaces.
- Semantic property (5): Choose the property Has location that you created in the previous step.
- Add field (6): Click Add field to create the fields for the properties Has First contact and Has contact person.
- Click Save page at the end of the page.
The template is now available and can be viewed in the Template namespace. You do not have to edit the template any further at this point.
Including the template on a page
- To include the template on a customer page, you simply add it from the Visual Editor Insert menu.
Insert the template on a page - Start typing the name Customer data and select the template (1). Then, click Add template (2).
Select template - Click Insert. Simply ignore the notice aobut missing template data, since we will create a form for the template in the next step.
Notice about missing TemplateData - Save the page. The template is now included on the page.
Included template
Next step
Next, we create a form that makes it easy for users to enter the data.
