Alfresco configuration has been designed to be extensible and overridable. This page gives details of how to override Alfresco Explorer configuration without modifying any of the configuration files that are deployed by the Alfresco application.
WARNING: Modifying Alfresco-maintained configuration files is not advisable, as any future alfresco releases will overwrite the changes. Use extensibility options described in this article.
Alfresco-Maintained Configuration Files
The Alfresco-maintained configuration files reside inside the alfresco web archive (alfresco.war) file in WEB-INF/classes folder. They can be viewed in the locations below once the server has started.
You can use these to review what options are available for configuration. Alternatively, refer to the Web Client Customisation Guide to see how some of the more common configuration options are applied.
Location of Extension Configuration Files
Alfresco looks for a file called web-client-config-custom.xml on the classpath in the alfresco.extension package. If you downloaded one of the bundles you will find a sample file in the location below. Simply rename it for it to take effect.
If you are using JBoss that has had a previous version of Alfresco installed ensure your <jboss>/server/default/conf/alfresco folder only contains the extension sub folder, which in turn should only contain your custom files.
Web client config files can contain configuration that either augments the standard configuration or replaces it.
Replacement is performed at the config section level by adding a replace='true' attribute to the config element, for example:
Any configuration found within a section marked this way will replace any configuration found in the Alfresco-maintained files. For example add the following to replace the list of languages shown in the login page:
If you need to add more custom files you can override the spring bean that defines the config source the web client uses. Any spring config files ending -context.xml found in the alfresco.extension package is automatically read by Alfresco. The webClientConfigSource spring bean in alfresco/web-client-application-context.xml can be overridden (examples shown below) to list the files you wish to be included.