Creation of Editable Templates

In this post, we will create Editable template using the custom template type created for specific project.
Out of the structure generated out of project specific template folder creation via Configuration browser (highlighted below under /conf/training/settings/wcm), we are done with template-types(highlighted in green).
Now, the editable templates that we will create out of empty-page template type will fall under the path(highlighted in red) -  /conf/training/settings/wcm/templates


Steps for Editable template creation:

  • Navigate to Tools -> General -> Templates -> projectspecificfolder (this folder would have been created automatically when we create project specific templates folder via configuration browser. In this case, it is training folder)
  • Inside projectspecificfolder, click on "Create" -> projecspecifictemplatetype(in this case, empty-page)
  • After choosing the template-type -> click on Create -> provide suitable title and optional description for template -> click on Create -> Success message will be displayed.
  • With this, we are done with creating template from template type specific to our project.
    • Screenshots related to this are added under Screenshots A.
To be noted while creating:
  • While we hit on "Create"(bullet #2 above), all available template types would be listed to pick from to create "Editable Template" out of it. (OOB template types(2), Core WCM template types(1) along with the one that we created)
  • If we don't want OOB/core template types to be listed and show only project specific template types, then we have a property named "mergedList"  property which would have been set to true in the path /conf/training/settings/wcm/template-types/jcr:content (this would be there when we first created the templates folder for our project).
    • Set this property to false -> Only project specific template types will  be displayed. 
  • Template types and policies are inherited across all folders in the following order
    • current folder - /conf/projectspecificfolder (in this case, training)
    • parent of current folder - if added
    • /conf/global 
    • /apps 
    • /libs 
Inside Editable Template:
Click open newly created editable template, we have 3 modes available in the toolbar as shown below.
Layout mode:

  • Layout mode for template authoring is similar to layout mode for page authoring.
  • We can predefine the template layout for required range of devices.
Structure mode:
  • Components available here in this mode cannot be moved/deleted in the pages created out of this template. 
  • If we want to let authors add or remove components, we can provide parsys or responsivegrid to the template
  • In this case, we have added a node named "root" with sling:resourceType as wcm/foundation/components/responsivegrid when we created "empty-page" template type under "structure/jcr:content". Because of which, we have Layout container available as shown below.
  • We can unlock the components, the same would be available for editing in "Initial Content" mode. (Initially, Layout container would be in "locked state" as indicated below in red)


    Initial Content Mode:
    • When we switch to this mode (without making any action on responsivegrid component ), it will be blank as shown below. 
      • On hover of the content area, we could see "Layout container root" tooltip coming up, but the same is not available for editing, because the same is in locked state in Structure mode.
    • We can see the layout container with "Drop components" placeholder in this mode when the same is "unlocked" from being in Structure mode.
    • This facilitates authoring the initial content that will be copied to the pages created out of this template and because it is unlocked, the same can be available for editing in pages created out of this.
    Not to get confused/understanding around initial and structure mode:
    • We added responsivegrid component only to structure node of empty-page template type. Meaning only one responsivegrid/Layout container component being rendered in two different modes - Initial content and Structure
    • It is with unlock or lock option on Layout container, we can edit components in template editor and make them available for editing or not respectively in the pages created out of this template.
    • Eg:  Site with structure : Header + Bannerimage + maincontent(parsys/responsivegrid) + Footer
      • Header and Footer components can be in "Locked" state.
      • Layout container would definitely be in "Unlocked" state, which lets us add any (allowed components) in the pages created out of the template
      • Banner image component can be included at template level and those banner image should be in "Unlocked" state.
        • We might need to change the banner image page to page.
    With single "Layout container" in template editor now, to have all of  these components available at template editor level at first place we need to "Unlock" the same in "Structure" mode and add "Allowed components" to the container. -> which leads us to the topic "POLICIES" similar to Design mode. (Selecting allowed components by switching to design mode in page - static template) - To be covered in next post.

    Screenshots for reference:
    Screenshots A: 

    Projectspecific folder (same name as that of templates folder created via configuration browser)
     Project specific template type alone is listed by means of mergeList property set to false(as mentioned above in "steps for creating")





    Reference: Adobe helpx links on Editable Templates.

    Comments

    Post a Comment

    Popular posts from this blog

    Embedding Third party dependency/OSGi bundle in AEM application hosted in AEMasCS

    Image
    This post illustrate the ways of embedding third party dependency in AEM maven project. Steps are mentioned considering the project structure to be followed for AEMasCS while the same can be followed for classic versions too.  Before we begin, I would like to explain the scenario of including a dependency in our AEM maven project.  When we would like to make use of an API that is not already available in our project, we look for that in maven-central repository and specify the dependency in main pom.xml and desired module's pom.xml file. (Lets say, AWS S3 Java SDK V2 dependency) Upon updating the project in the IDE, we would see our class files (making use of those APIs) are compiled/build successfully without any errors.  Now, in the context of AEM/OSGi environment, when the same package and hence the bundle is deployed to AEM instance, dependencies that we added new might not be resolved/available in the OSGi as a bundle. Something like the below This indicates that the added dep
    Read more

    OSGI Factory Configuration implementation

    OSGI Factory configuration is used to have many instances of an OSGI config (represented/identified via an identifier) for the single OSGI service/PID. Most often used OOB Factory configurations for example: Logger Factory/writer configuration (for log statements) Service user Mapper service Amendment (for using service resource resolver in projects) Few sample real time use case for the need of OSGI factory config: For multi tenant projects, if we have generic service used across tenants with properties/attributes specific to tenant. For single tenant, generic service targeting all locales with properties/attributes specific to locale. (where generic service -> holds logic in the lines of calling third party service for retrieving/updating information.) Implementation: ( In terms of OSGI R6 annotations ): Create Object Class Definition(OCD) defining desired properties for the OSGI service. - OSGIFactoryConfigOCD.java OSGI Service/Factory service to retrieve
    Read more

    Creation of Template Types for Editable templates

    Image
    In this post, we will create templates types which is the base for creating editable templates. Before getting to the subject directly, have added an introduction about templates in general. Template is the base for creating pages. Starting AEM 6.2, we have categorisation for templates - Static and Editable templates. Static templates :  This has been available for several versions of AEM/CQ Created using "Create Template" option with base page component as resourceType (which is responsible for rendering the page structure).  Template ( base page component as resourceType ) -> Page This cannot be edited as such. Since it just holds a reference to base page component, any changes to the page (other than authorable components), would need a change in base page component which is ultimately a work of developer. (calls for a code change) Allowed components are configured using Design mode (list being saved to etc/designs/projectfolder/templatename/jcr:content)
    Read more