cancel
Showing results for 
Search instead for 
Did you mean: 

Understanding where files should be customized

uskerine
Champ in-the-making
Champ in-the-making
Hi all,

I started few days ago with Alfresco and I am trying to fully understand how Alfresco files are organized. I am using Alfresco 4.2.e with Tomcat 7.0.47.

I want to customize login page, and I have understood that this can be done by modifying the FreeMarker file named "login.get.html.ftl".


<strong>"login.get.html.ftl" can be found at two locations:</strong>

<strong>[1]</strong> D:\Program Files\apache-tomcat-7.0.47<strong>\webapps\share\WEB-INF\classes\alfresco\site-webscripts\org\alfresco\components\guest</strong>

<strong>[2]</strong> And it can be also found in the "<strong>share.war</strong>" container located at Tomcat webapps folder.

To get permanent changes into this file, <strong>which one should be modified?</strong> the one located in the file system, the one stored in share.war or both? Should these changes be done with tomcat stopped?


<strong>Same question for favicon.ico</strong>; you can find it at the following locations:

<strong>[1]</strong> D:\Program Files\apache-tomcat-7.0.47\webapps\alfresco\favicon.ico

<strong>[2]</strong> D:\Program Files\apache-tomcat-7.0.47\webapps\share\favicon.ico

<strong>[3]</strong> And it is also present in both share.war and alfresco.war.

Should the favicons be modified from the .war files or directly from the filesystem?

Thanks in advance,



5 REPLIES 5

arnoldschrijve1
Champ on-the-rise
Champ on-the-rise
Well, the methods you suggest are both considered to be 'quick 'n dirty' ways of customizing Share Smiley Happy Of the 2 it's best to modify the WAR-file. This contains the packaged application, that is unpacked in the \webapps\share directory.
If you want to be more thorough in your customization you could use the Alfresco Maven SDK and develop your own modular extension for Share (and maybe using Eclipse as your IDE). This will produce either an AMP file (that you install into Share.war) or a Java JAR (that you install in webapps\share\WEB-INF\lib either in the .war or in the dir. directly).
When you modify the war-file, you could delete the directory. When restarting Tomcat the war is automatically unpacked and the directory recreated.

Probably you'll need to change the favicon in the share.war.

NOTE: If you really want to do some more extensive customizations of Alfresco, be prepared to go through quite a big learning curve.

Thanks a lot Arnold,

This really helps. I will also try to learn about how to develop modular extensions.

Thanks also for the advice regarding on what I will face: I will do my best to not underestimate the complexity when planning for required time and effort to learn.

If you don't require a lot of customizations, things can also be easy still 😉 For people that don't develop their own modular extension Alfresco offers two directories where you can override existing files or add your own code. These are 'extension' for extending the Repository tier and 'web-extension' for extending the Share (UI) tier. You can place these in <tomcat-dir>/shared/classes/alfresco or in the respective webapps (search in the alfresco wiki or docs for more info).

If you want to start with the Maven SDK this is your url: https://wiki.alfresco.com/wiki/Maven_Alfresco_SDK. Once you get past the learning curve Alfresco offers a really open architecture with lots of extensibility points so you can create powerful customization.

Good luck!!

arnoldschrijve1
Champ on-the-rise
Champ on-the-rise
If you don't require a lot of customizations, things can also be easy still 😉 For people that don't develop their own modular extension Alfresco offers two directories where you can override existing files or add your own code. These are 'extension' for extending the Repository tier and 'web-extension' for extending the Share (UI) tier. You can place these in <tomcat-dir>/shared/classes/alfresco or in the respective webapps (search in the alfresco wiki or docs for more info).

If you want to start with the Maven SDK this is your url: https://wiki.alfresco.com/wiki/Maven_Alfresco_SDK. Once you get past the learning curve Alfresco offers a really open architecture with lots of extensibility points so you can create powerful customization.

Good luck!!

Ooops, didn't want to repeat myself. Posted from a very ssslloooww internet connection while in the train. Sorry.