aem-code-templates's Introduction

Code Templates

Goal

Boost AEM components development

Touch UI templates demo

What is it and how to use it

Code templates are list of reusable and parameterized code snippets. The feature is well-known for all developers. You use it every time when you create loops/conditions in Java classes.

Template types

Touch UI templates

Provide templates for Touch UI dialogs and widgets which could be used inside the dialog.

Component Files templates

Provide basic definition of the AEM component files like: .content.xml, _cq_template.xml, _cq_editConfig.xml.

HTL templates

Provide templates for HTML Template Language (HTL)

How to install

IntelliJ

Automatic Import
Download the liveTemplates.jar file
Open your IDE
Go to File > Import Settings
Choose the file downloaded in the fist step and click OK
Manual Import
Go to the following directory where code templates are stored on you computer

* Windows: `<your home directory>\.<product name><version number>\config\templates`

* Linux: `~/.<product name><version number>/config/templates`

* OS: `~/Library/Preferences/<product name><version number>/templates`

Download the *.xml containing templates definition file from the repository
Put the downloaded file to the directory from the first point
Restart your IDE if it is running

Eclipse

Download the *.xml containing templates definition file from the repository
Open your IDE
Go to Window > Preferences > XML > XML Files > Editor > Templates
Click Import button and select the downloaded file

Change log

Version 2.0.0 Date 16.01.2017

HTL templates provided

Version: 1.0.0 Date: 29.09.2016

Touch UI and Component Files templates provided

aem-code-templates's People

Contributors

Stargazers

Watchers

aem-code-templates's Issues

Add support for hidden fields in Touch UI dialog templates

Hidden fields are quite useful in AEM dialogs as they can provide useful hints and additional parameters to the Sling POST Servlet.

Please add support for generating a basic hidden field to the Touch UI templates.

Touch UI Image Template missing a property

When used, the aem_image Touch UI template generates the following code (example with properties already filled in):

<nodeName
    jcr:primaryType="nt:unstructured"
    sling:resourceType="granite/ui/components/foundation/form/fileupload"
    autoStart="{Boolean}false"
    class="cq-droptarget"
    fieldLabel="Field Label"
    fileNameParameter="./nodeName/fileName"
    mimeTypes="[image]"
    multiple="{Boolean}false"
    name="./nodeName/file"
    title="Field Label"
    useHTML5="{Boolean}true" />

When uploaded to AEM, such a field is greyed out by default and it cannot be used.

Adding an uploadUrl property seems to enable the input, as seen in the screenshot below:

Perhaps the field should be added to the template? I'm not sure what the value should be. I had a look at foundation/components/image for reference and it uses ${suffix.path}... which I assume is HTL code that's somehow executed later?

Consider not generating fieldDescription by default

Hi,

I've been using the IntelliJ templates for Touch UI dialogs for a while and I find myself removing the fieldDescription attribute from automatically generated fields more often than not.

Perhaps we could drop this bit by default?

Recommend Projects

wttech / aem-code-templates Goto Github PK