[DOCU-289] Introduction to templating tutorial: add a note about creating your own module Created: 02/Jul/12  Updated: 05/Jul/12  Resolved: 04/Jul/12

Status: Closed
Project: Documentation
Component/s: content
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Neutral
Reporter: Antti Hietala Assignee: Gavan Stockdale
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Template:
Acceptance criteria:
Empty
Bug DoR:
[ ]* Steps to reproduce, expected, and actual results filled
[ ]* Affected version filled
Date of First Response:

 Description   

In http://documentation.magnolia-cms.com/templates/introduction.html#Creatingapagedefinition it says:

In this tutorial you will create place the page definition in the Templating module. You can find it in Configuration > /modules/templating. This is the same module that provides the basic templating functionality. Your definitions don't have to reside in this module. In fact, the best practice is to create your own module and bootstrap templates from that module during installation.

The bolded sentence is somewhat misleading for beginners. A user stumbled on this in forum thread Need Help in creating templates in Custom Module. He created the myModule folder by hand rather than through the module bootstrap mechanism. This is why the system did not detect the page definition and the template was not visible in the dropdown.

Take the text that starts with "Your definitions don't have to reside..." and move it to an info box below the procedure. Explain in the box that in order to place the configuration into your own module you need to develop a complete module with a module descriptor that registers the module and a task that bootstraps configuration such as page definitions.


Generated at Mon Feb 12 01:07:43 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.