You are here

Share configuration files

Share can be configured through configuration files. This topic looks at the key configuration files available.
The main Share configuration file is share-config.xml. This can be found in a default installation at tomcat/webapps/share/WEB-INF/classes/alfresco/share-config.xml. While it is possible to change configuration through direct changes to this file this is not recommended as any customizations will be lost if the Share WAR is re-exploded, or you install a new version of Alfresco. To get around this issue it is advisable to make configuration changes to a file outside of the Share WAR. This can be done through the file share-config-custom.xml, which can be found at tomcat/shared/classes/alfresco/web-extension/share-config-custom.xml in the default Alfresco installation. Any changes made here will be applied, and can be saved between reinstalls and the Share WAR exploding.
Note: If you are overriding a configuration section, you must apply the replace="true" attribute to replace the existing Alfresco configuration.

It should also be noted that it is possible to package a share-config-custom.xml file in a JAR or AMP. In this way you can have multiple share-config-custom.xml files packaged in JARs or AMPs if necessary. JARs will be loaded from the classpath, for example ./tomcat/shared/lib. AMPs will be applied to the Share WAR file.

The order in which multiple share-config-custom.xml files are applied is not guaranteed in the case where multiple files override the same section of configuration.

Another key Share configuration file is slingshot-application-context.xml which can be found at tomcat/webapps/share/WEB-INF/classes/alfresco/slingshot-application-context.xml in the default Alfresco installation. This loads a number of other configuration files:

    <!-- Spring Web Scripts -->
    <!-- Spring Surf -->
    <!-- Surf Autowire Support -->

    <!-- Common form config -->
    <!-- Share default config -->
    <!-- Share help url config -->
    <!-- Share form config -->
    <!-- Share Document Library config -->

    <!-- Share Data List form config -->

    <!-- Share workflow form config -->
    <!-- Share CMIS config -->

    <!-- Share Security config -->

    <!-- Share custom config -->

Note that the custom configuration files are loaded last, so that they can override existing configuration.