<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:05:42 CET 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>Magnolia - Issue tracker</title>
    <link>https://jira.magnolia-cms.com</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-uk</language>    <build-info>
        <version>9.4.2</version>
        <build-number>940002</build-number>
        <build-date>19-01-2023</build-date>
    </build-info>


<item>
            <title>[DOCU-77] Creating a custom control</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-77</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;Improve the Creating a custom control article. &lt;a href=&quot;http://documentation.magnolia-cms.com/cookbook/creating-a-custom-control.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://documentation.magnolia-cms.com/cookbook/creating-a-custom-control.html&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Resources:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;IntenseDebate comments on the article page&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;http://wiki.magnolia-cms.com/display/TRAINING/Custom+Control&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://wiki.magnolia-cms.com/display/TRAINING/Custom+Control&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;http://tmiyar.blogspot.com/2011/03/adding-custom-dynamic-asset-handler.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://tmiyar.blogspot.com/2011/03/adding-custom-dynamic-asset-handler.html&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</description>
                <environment></environment>
        <key id="19613">DOCU-77</key>
            <summary>Creating a custom control</summary>
                <type id="4" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10890&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/priorities/neutral.gif">Neutral</priority>
                        <status id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="1">Fixed</resolution>
                                        <assignee username="sdeprez">Suzanne Deprez</assignee>
                                    <reporter username="ahietala">Antti Hietala</reporter>
                        <labels>
                    </labels>
                <created>Mon, 13 Dec 2010 15:05:56 +0100</created>
                <updated>Mon, 29 Aug 2011 12:21:44 +0200</updated>
                            <resolved>Mon, 29 Aug 2011 12:21:40 +0200</resolved>
                                                                    <component>content</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>0</watches>
                                                                                                                <comments>
                            <comment id="36922" author="sdeprez" created="Wed, 29 Jun 2011 20:42:13 +0200"  >&lt;p&gt;Changes were activated.&lt;/p&gt;</comment>
                            <comment id="37666" author="ahietala" created="Wed, 20 Jul 2011 12:20:12 +0200"  >&lt;p&gt;Reviewed.&lt;/p&gt;





&lt;p&gt;Creating a custom control&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;Start with an introduction. Why and when do I need a custom control? List three examples of custom controls that work with Magnolia and explain what problem they solved. Motivate the reader.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;Use existing controls&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;&quot;There are two types of provided controls that can be used: module and DAM.&quot; Why such a division? DAM control is provided by the STK module so how is it different from other module controls?&lt;/li&gt;
	&lt;li&gt;&quot;Configuration &amp;gt; /modules/module_name/controls&quot; Notation rules for paths are now in &lt;a href=&quot;http://wiki.magnolia-cms.com/display/DOCU/Documentation+Style+Guide#DocumentationStyleGuide-URLsandpaths&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Documentation Style Guide&lt;/a&gt;. Please apply.&lt;/li&gt;
	&lt;li&gt;&quot;The modules that include controls...&quot; I think it&apos;s enough to mention adminInterface and standard-templating-kit as examples of modules that provide controls. Drop the Magnolia CMS version number as we would need to keep updating it.&lt;/li&gt;
	&lt;li&gt;In &quot;To create a customized control&quot;:
	&lt;ul&gt;
		&lt;li&gt;Step 2 is difficult to understand. Where should I create the content node? The screenshot does not highlight the content node. How should I name the content node?&lt;/li&gt;
		&lt;li&gt;Step 2: Are the bullets alternatives to each other? &lt;a href=&quot;http://wiki.magnolia-cms.com/display/TRAINING/Custom+Control&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Custom control&lt;/a&gt; wiki page suggests they are. Not clear here.&lt;/li&gt;
		&lt;li&gt;Step 2, bullet 2: &quot;as shown in the image above&quot; The image immediately above does not show the controls folder. Which image does the text refer to?&lt;/li&gt;
		&lt;li&gt;Step 2, bullet 2: &quot;The new control can then be used anywhere by adding a content node to a dialog for a control with a child node controlType with a value set to the name of the new control.&quot; Complicated sentence, hard to follow.&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;&quot;Custom Control Training provides additional information...&quot;. Readers don&apos;t have access to the training namespace in the wiki. Only people who paid to attend the training do. So you can&apos;t link there. The wiki page has good content and is well written, such as &quot;1. Subclass the most alike existing dialog control.&quot; That is a clear idea for the reader to follow. Replicate.&lt;/li&gt;
	&lt;li&gt;&quot;A DialogInclude customization example is also provided.&quot; What is DialogInclude? Why should I use it? What problem does it solve? Can&apos;t just link to something without explaining the benefit/relevance/difference/uniqueness...&lt;/li&gt;
	&lt;li&gt;&quot;Discussions of the following examples...&quot; Nice list. Make it clear that these are not ready-made examples or official docs. Some are just forum posts. &lt;a href=&quot;http://wiki.magnolia-cms.com/display/DOCU/Reacting+to+market+survey+2011-08-11#Reactingtomarketsurvey2011-08-11-Wiki&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Perception of bad documentation&lt;/a&gt; stems partly from not making clear the difference between official docs and community-contributed content.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;Create a new control&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;Isn&apos;t this procedure exactly the same as in &quot;Use existing module control&quot; above? If so, is the whole existing vs. new control structure moot?&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;User comments&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;What do you think the user who commented &quot;Maybe a screenshot of JCR structure should help&quot; wants to see? What detail about custom controls would a JCR view make easier to understand?&lt;/li&gt;
&lt;/ul&gt;
</comment>
                            <comment id="37879" author="sdeprez" created="Thu, 28 Jul 2011 23:10:00 +0200"  >&lt;p&gt;Was not able to find auto complete search control in wiki.  Added other known controls to the introduction.&lt;/p&gt;

&lt;p&gt;My intent was to differentiate because there are differences in how to customize a dam control vs. other controls.  I&apos;ve reworked that section to hopefully improve.&lt;/p&gt;

&lt;p&gt;I&apos;ve reworked the &quot;To create a customized control&quot; procedure.  The bullets actually were alternatives in showing how to specify a customized control class in AdminCentral.  &lt;/p&gt;

&lt;p&gt;I think the JCR comment is basically asking for some AdminCentral screenshots showing where/how controls are set.  I think the added screenshots will help.&lt;/p&gt;

&lt;p&gt;Activated changes.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                            <customfield id="customfield_14166" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Acceptance criteria</customfieldname>
                        <customfieldvalues>
                            
        <checklist>
        <![CDATA[
                            




                
                                    <div class="o-completion" style="display: flex; flex-shrink: 0;"><span  class="aui-lozenge aui-lozenge-complete" style="font-size: 12px; font-weight: normal; display: flex; flex-direction: row; align-items: center;" ><span style="padding-right: 4px; vertical-align: middle;"><svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" fill="white"><path clip-rule="evenodd" d="m10.41037,3.42544l-7.86501,0c-0.72395,0 -1.31084,0.58688 -1.31084,1.31084l0,7.86508c0,0.7239 0.58689,1.3108 1.31084,1.3108l7.86501,0c0.724,0 1.3109,-0.5869 1.3109,-1.3108l0,-7.86508c0,-0.72396 -0.5869,-1.31084 -1.3109,-1.31084zm-7.86501,-0.65542c-1.08593,0 -1.96626,0.88032 -1.96626,1.96626l0,7.86508c0,1.0859 0.88033,1.9662 1.96626,1.9662l7.86501,0c1.086,0 1.9663,-0.8803 1.9663,-1.9662l0,-7.86508c0,-1.08594 -0.8803,-1.96626 -1.9663,-1.96626l-7.86501,0z" fill-rule="evenodd"/><path d="m5.09049,10.18526l-1.82767,-1.82766l-0.78479,0.78479l2.61246,2.61246l5.38758,-5.38754l-0.78483,-0.78479l-4.60275,4.60274z"/></svg></span><span>Empty</span></span></div>
                        ]]>
    </checklist>


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10111" key="com.atlassian.jira.toolkit:reporterdomain">
                        <customfieldname>Company</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>magnolia-cms.com</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10031" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 29 Jun 2011 20:42:13 +0200</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_12730" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_14151" key="com.atlassian.jira.toolkit:message">
                        <customfieldname>Docu info</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10061" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comm is not jira-dev</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10071" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last participant</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>mmuehlebach</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            12 years, 30 weeks, 3 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>ahietala</customfieldvalue>
            <customfieldvalue>sdeprez</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|i0420f:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10244" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>23768</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_14145" key="com.intenso.jira.issue-templates:issue-templates-customfield">
                        <customfieldname>Template</customfieldname>
                        <customfieldvalues>
                            


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_15131" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Time in Discovery</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10032" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        </customfields>
    </item>
</channel>
</rss>