topic Customize Share Dashlet FTL in Alfresco Archive

Customize Share Dashlet FTL

jpfi — Tue, 19 Jun 2012 13:22:12 GMT

Hi,I'm trying to customize a html.ftl of an alfresco share dashlet (Alfresco 4.0.1 Ent):site-data/extensions/fme-dashlets-extensions.xml:<extension> <modules> <module> <id>FMEDashlet customizations</id> <customizations> <cust

Re: Customize Share Dashlet FTL

afaust — Tue, 19 Jun 2012 13:38:12 GMT

Hello Jan,

last I checked you needed a region / markup in the original FTL to hook into with your FTL customization in order for it to be picked up.

I.e. in the original


<div class="dashlet my-sites">
   <div class="title">${msg("header")}</div>
   <div class="toolbar flat-button">
   </div>
   <!– more HTML / FTL –>
   <@markup id="extPoint"></@markup>
</div>
‍‍‍‍‍‍‍‍‍

and in the customization


<@markup id="myExt" target="extPoint" action="after">
   <!– custom HTML / FTL –>
</@markup>
‍‍‍‍‍

Unfortunately, the base templates are not yet riddled with markups to hook into, so you usually have to either replace the entire component via sub-component URL evaluation or modify the original code a little bit.

Regards
Axel

Re: Customize Share Dashlet FTL

cleseach — Tue, 19 Jun 2012 13:49:36 GMT

Hi Jan,

You should consider this page : http://docs.alfresco.com/4.0/topic/com.alfresco.enterprise.doc/tasks/tu-share-FM-temp-customize.html
To change the FTL, you should define a new component in your extension file.

Exemple :

<components>
        <component>
          <region-id>documentlist</region-id>
          <source-id>documentlibrary</source-id>
          <scope>template</scope>
          <sub-components>
            <sub-component id="default">
              <url>/fr/amexio/documentlirary/custom-documentlist</url>
              <properties>
                <pagination>true</pagination>
              </properties>
            </sub-component>
          </sub-components>
        </component>
      </components>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Regards,
Charles Le Seac'h

Re: Customize Share Dashlet FTL

jpfi — Tue, 19 Jun 2012 14:03:22 GMT

Hi,
yub, but a component that is used as dashlet does not have a static region…it may be component-1-1, component-1-2 or component-2-1 …
There should be another solution than using the old file-replacement approach via web-extension to replace/extend another dashlet html.ftl

@Axel: yub,but adding a @markup to the original html.ftl ,copy the file to web-extension and then add a <customization> is also a little bit "dirty"

Cheers, Jan

Re: Customize Share Dashlet FTL

afaust — Tue, 19 Jun 2012 14:15:32 GMT

Hence the "unfortunately"…
At the moment, I don't know of another solution to do this and I don't think there even is one. Adding the @markup to existing components is the next major task for Alfresco to make Share more customizable - they laid the foundation with the new Surf Extensibility feature, next up should be the scaffolding.

Regards
Axel