Customizing core component dialogs

[#1]

https://docs.adobe.com/content/help/en/experience-manager-core-components/using/developing/customizi...

As per the 'Customizing Dialogs' section of the link above, when trying to customize core component dialogs, the dialog should be copied over to the proxy component (up to tab node) but should be hidden using Sling resource merger. A duplicate dialog should be created where the actual changes should be made. 

What is the rationale behind this? As per documentation, it is to 'To be fully compatible with any changes made to a dialog on its current version' but I'm not fully clear on this.

Could anyone clarify this?

[jakej40603950 · Accepted solution]

Each dialog has a consistent node structure. It is recommended that this structure is replicated in an inheriting component so that Sling Resource Merger and Hide Conditions can be used to hide, replace, or reorder sections of the original dialog. The structure to replicate/copy as it is from core components is defined as anything up to the tab item node level.

To be fully compatible with any changes made to a dialog on its current version, it is very important that structures below the tab item level not be touched (hidden, added to, replaced, reordered, etc.).

If you don't want any tab, tab can be hidden via the sling:hideResource property (see Sling Resource Merger Properties ),

New tab items added/modified in the proxy components that contain the configuration fields. 

Reordering can be done using sling:orderBefore 

https://helpx.adobe.com/experience-manager/6-3/sites/developing/using/sling-resource-merger.html

[jakej40603950 · Accepted solution]

Thanks Arun for taking time to answer this.

But it's still not clear to me as to why I should copy over the original dialog tab but not change it and in its place create a duplicate and make changes to that. The reason given is of compatibility.. considering we want to make changes to the dialog tab anyway..what kind of compatibility are we trying to preserve here?

[Arun_Patidar · Accepted solution]

you don't need to copy complete dialog while changing. you should copy the node till where you want to make changes. If you have many new fields to add go for new tab and create items. But it is also fine to make changes in existing tab inside proxy component. Never make any changes in original component dialog/htl.

[jakej40603950 · Accepted solution]

Thanks again for the reply. "But it is also fine to make changes in existing tab inside proxy component." - I share this view but the document I think says otherwise and I was confused as to the reasoning for the same. Probably I'm misreading the document... 🙂

[Arun_Patidar · Accepted solution]

This is absolutely fine to make changes in existing tabs inside proxy components. Never make changes directly in core components dialogs.