Integrating OpenCms with Maven

OpenCms Solution Provider Comundus has created an integration of OpenCms and Maven. The project is available on SourceForge. Goal of the project is to optimize the OpenCms build process, not only for the OpenCms core but also for OpenCms project development. The project was initially presented to the OpenCms community at OpenCms Days 2008.

In order to use this Maven integration, currently a non-standard OpenCms distribution that contains several patches to the original OpenCms core has to be used. This non-standard OpenCms distribution is based on OpenCms 7.0.3.

In this Sprint, we checked how to modify the code of the OpenCms core and the Maven plugin so that in the future, the Maven plugin can be used with the standard OpenCms core distribution.


  • Some of the changes to the OpenCms core by Comundus are just bug fixes; these have been given to Alkacon during the Sprint as a patch relative to 7.0.5 code (patch available here: bugfixes.patch.txt). These fixes will be integrated in future OpenCms release versions.
  • A requirement with the checking of existing OUs not existing yet when doing a Maven build on group creation has been fixed with a patch to the OpenCms core doing the checks only when the OpenCms runlevel is "servlet mode" (patch available here: ou.maven.patch.txt).
  • One problem with configurable LinkRelations is that the type "defined in content" can't be set via configuration; some API in that area must be extended in the core (patch available here: relationtype.defincontent.patch.txt).
  • The class implementing the OpenCms synchronization method must be made pluggable, since the Maven plugin requires different functionality for this. It was agreed that this should be configured in opencms-importexport.xml with a new "synchronizationhandler". For this handler a simple interface needs to be defined.
  • Code for use by the Maven VFS Plugin will go into a separate JAR file for a beginning; might be integrated to the core later on
  • If there is a way to eliminate the need for the special "CmOpenCmsShell" class of the Maven plugin, it should be done.
  • Besides it would be helpful to include a possibility to actually configure and use custom CommandObject classes with the CmsShell. This functionality should already be available in the core but either it does not work as expected or it has not been used correctly in the Maven Plugin. This needs further investigation.
  • Currently the Maven VFS Plugin code copies quite some code from original OpenCms; this code should go into one or more extra classes that are used by OpenCms core as well as Maven VFS Plugin code; thus eliminating duplicated code; and changes to that code done by Alcacon get integrated into the function of the Maven VFS Plugin automatically.

Latest News

  • OpenCms 10.5 Beta available

    Sep 26, 2016 - OpenCms 10.5 Beta provides a feature complete look at OpenCms 10.5. This will be the only pre-release version before OpenCms 10.5.0 is published, which is expected by the end of November. Only minor GUI updates, as well as improvements to the demo template, will be made for the final release.

  • OpenCms 10.5 Beta Release Notes

    Sep 26, 2016 - The OpenCms 10.5 Beta release notes contain detailed information about the new features and fixes in this beta version.

  • OpenCms 10.0.1 available

    Jun 14, 2016 - Being the greatest OpenCms update for years, version 10 brings a vastly improved user experience that combines the intuitive "Direct Edit" approach of OpenCms with a new, well integrated Lauchpad app center. OpenCms 10.0.1 is a maintenance update for 10.0.0 installations. It fixes several issues that persisted in previous releases. This version focuses on performance and stability.

  • OpenCms 10.0.1 Release Notes

    Jun 14, 2016 - The OpenCms 10.0.1 release notes contain detailed information about the updates and fixes in this version.