nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

amp file

marco_altieri

Hi,

what is the best option to customize web quick start ?
All the tutorials / Wiki / code comments seem to suggest that it's necessary to change directly the core codes: templates, pages, css, etc…

With share and alfresco it's always better to use amp files. Do you suggest to do the same also for Web Quick Start?

Thanks,
Marco

Find more posts tagged with

Comments

sam1980

My understanding is that you customize Web Quick Start by putting your overrides (if you are using tomcat) in tomcat\shared\classes\alfresco\web-extension. A mechanism in Share will use the configuration made here in instead of the shipped configurations. All *-context.xml files will be loaded during the start up phase. For customizing templates, components etc you also have to do this in \tomcat\shared\classes\alfresco\web-extension.

I.E you want to customize tomcat\webapps\share\WEB-INF\classes\alfresco\site-webscripts\org\alfresco\components\documentlibrary\repo-toolbar.get.html.ftl you have to create a copy of the file in tomcat\shared\classes\alfresco\site-webscripts\org\alfresco\components\documentlibrary\repo-toolbar.get.html.ftl and modify it there. Share will thus pick up this file instead of the one Share ships with.

Disclaimer: I'm new to Alfresco - so i might misinform you on this.

marco_altieri

Hi Sam,

I think that you are right for all the customizations in alfresco and share. I have worked on other projects with share and I knew how to do it.
The problem is that I need to customize Web Quick Start. For example the templates five-block.ftl or the webscript common/page.ftl

Are you saying that I can use the same folders in shared to overwrite the WQS templates and webscripts?

Thanks,
Marco

sam1980

My understanding is that the wcmqs-webapp is only provided as an example and *could* be a starting point for build a web site utilizing Web Quick Start. In the project I'm currently involved we stripped down the wcmqs webapp to the bare minimum and built our own templates for our own needs.

marco_altieri

Hi Sam,

this is also my understanding. I just wanted to know if someone has found a better practice.

Thank you

bremmington

Although it's true that the example webapp was actually intended to be purely an example, it is built on Surf which is pretty extensible.

It's a little hard to explain why (but come back to me if you'd like to know, and I'll have a go at it), but if you want to define a new template (or override an existing one) then place its XML descriptor (such as "five-block.xml") into this folder on the classpath (below <tomcat>/shared/classes/, for instance):

surf/site/templates/
‍‍‍

Similarly, if you want to add or change a page definition, place its XML descriptor (such as "homepage.xml") into this folder on the classpath:

surf/site/pages/
‍‍‍

If you want to add a new webscript then you can add them in this location on the classpath:

surf/webscripts/
‍‍‍

And, finally, to add new templates (the actual FreeMarker template such as "five-block.ftl" - not the descriptor files) then put them on the classpath here:

surf/templates/
‍‍‍

sam1980

Found out that I had to package functionality in an amp file if i wanted to include custom class files, such as attaching behaviors to the custom content types, ref this post https://forums.alfresco.com/en/viewtopic.php?f=10&t=39109. Here is description of how to set up a maven build for the amp-file using the maven-amp-plugin: http://www.open-source-ecm.com/2010/04/maven-alfresco-creating-amp.html.