Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCU-289

Introduction to templating tutorial: add a note about creating your own module

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • Neutral
    • None
    • None
    • content
    • None

    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.

      Checklists

        Acceptance criteria

        Attachments

          Activity

            People

              gstockdale Gavan Stockdale
              ahietala Antti Hietala
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Checklists

                  Bug DoR