topic Re: Embed custom application into share site in Alfresco Archive

Embed custom application into share site

silverhoof — Wed, 24 Oct 2012 09:03:06 GMT

When planning a business solution we found that the alfresco ecm and alfresco share application can address most of our problems regarding to document exchange and document oriented process control.But some business logic is not content oriented and is better be handled by a customized web applicati

Re: Embed custom application into share site

ddraper — Wed, 24 Oct 2012 09:42:54 GMT

Spring Surf is an extension to Spring MVC so technically Share is already fairly well set-up to use other Spring MVC technologies. It should be fairly straightforward to add new mappings to alternative view renderers so that you can render pages via an alternative Spring MVC technology but embedding content in an existing Share page (which will have been rendered by Surf) may be more challenging. The most simple solution would probably be to create a Surf Component that includes an iframe that references your new page. The alternative would be to extend Spring Surf to add processors for the technologies that you want to use so that they can be rendered as a Component.

Re: Embed custom application into share site

silverhoof — Thu, 25 Oct 2012 00:19:24 GMT

Spring Surf is an extension to Spring MVC so technically Share is already fairly well set-up to use other Spring MVC technologies. It should be fairly straightforward to add new mappings to alternative view renderers so that you can render pages via an alternative Spring MVC technology but embedding content in an existing Share page (which will have been rendered by Surf) may be more challenging. The most simple solution would probably be to create a Surf Component that includes an iframe that references your new page. The alternative would be to extend Spring Surf to add processors for the technologies that you want to use so that they can be rendered as a Component.

So, how to create another custom site component (like the existing calendar, discussion, wiki etc..)to let user add to the site using the site configuration user interface.

Re: Embed custom application into share site

ddraper — Thu, 25 Oct 2012 07:53:48 GMT

You'd need to create a new Surf Page configuration and add that to the list of pages in the configuration. If you look in the /share/WEB-INF/classes/alfresco/share-config.xml you'll find the following code:

<config evaluator="string-compare" condition="SitePages">
      <pages>
         <page id="calendar">calendar</page>
         <page id="wiki-page">wiki-page?title=Main_Page</page>
         <page id="documentlibrary">documentlibrary</page>
         <page id="discussions-topiclist">discussions-topiclist</page>
         <page id="blog-postlist">blog-postlist</page>
         <page id="links">links</page>
         <page id="data-lists">data-lists</page>
      </pages>
   </config>
‍‍‍‍‍‍‍‍‍‍‍‍

This is the list of pages available for a site. If you add a new page to this list then the page will be available when you customize a site (you'll be able to drag and drop it into the site). If you want your new page to be added by default then you'll need to override the default "site-dashboard" preset. This file can be found in /share/WEB-INF/classes/alfresco/site-data/presets/presets.xml.

The "site-dashboard" preset contains the "site/${siteid}/dashboard" page which contains a property called "sitePages" which lists the pages that are included in a site by default.

<page id="site/${siteid}/dashboard">
            <title>Collaboration Site Dashboard</title>
            <title-id>page.siteDashboard.title</title-id>
            <description>Collaboration site's dashboard page</description>
            <description-id>page.siteDashboard.description</description-id>
            <template-instance>dashboard-2-columns-wide-right</template-instance>
            <authentication>user</authentication>
            <properties>
               <sitePages>[{"pageId":"documentlibrary"}]</sitePages>
            </properties>
         </page>
‍‍‍‍‍‍‍‍‍‍‍‍

Regards,
Dave