Introduction to templating tutorial: add a note about creating your own module
------------------------------------------------------------------------------
Key: DOCU-289
URL: http://jira.magnolia-cms.com/browse/DOCU-289
Project: Documentation
Issue Type: Bug
Security Level: Public
Components: content
Reporter: Antti Hietala
Assignee: Gavan Stockdale
In
http://documentation.magnolia-cms.com/templates/introduction.html#Creatingapagedefinition
it says:
{quote}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.{quote}
The bolded sentence is somewhat misleading for beginners. A user stumbled on
this in forum thread [Need Help in creating templates in Custom
Module|http://forum.magnolia-cms.com/forum/thread.html?threadId=f6a7ae28-8b6a-49a7-85ac-2012a0ee10f5].
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.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.magnolia-cms.com/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
----------------------------------------------------------------
For list details, see: http://www.magnolia-cms.com/community/mailing-lists.html
Alternatively, use our forums: http://forum.magnolia-cms.com/
To unsubscribe, E-mail to: <[email protected]>
----------------------------------------------------------------
