Release Notes for OpenCms 8.0.3

November 16, 2011: This is the release of OpenCms 8.0.3. With OpenCms 8.0.3, many important and useful additional features and improvements have been added to the core system and a number of issues that persisted in the 8.0.2 release have been fixed.

Important features of OpenCms 8

  • The "Advanced Direct Edit" (ADE) mode allows to create page content by drag & drop.
  • The sitemap editor allows to create new pages and re-arrange the navigation tree by drag & drop.
  • The "Content Subscription Engine" allows to inform users when subscribed documents have changed.
  • Extended support for creation of content for mobile devices with the <cms:mobile> tag.

Main new features in OpenCms 8.0.3

  • With the introduction of "Function Pages", JSP based dynamic pages can be added with simple drag and drop in the sitemap editor.
  • The sitemap editor's improved "Create Page" dialog offers a wider choice of types distinguishing "Container Pages", "Type Pages" and "Function Pages".
  • It is now also possible to select the page model when using the sitemap editor's context menu option "Create Sub-Page".
  • The available container page models can be accessed for editing directly from the "Create Page" dialog in the sitemap editor.
  • The sitemap editor executes the "Show Page" action if the page icon in the sitemap is clicked.
  • JSP function elements can now have multiple formatters to be used in different containers.
  • The element option bar displays a "Resource is currently locked" icon if an element is currently edited by another user.
  • The content galleries have been improved with a text search field to directly search for "Galleries" and "Categories".

Other new features and improvements in OpenCms 8.0.3

  • Improved Image Gallery now features a "broken image" image if this could not be rendered for any reason.
  • Improved Module Sitemap Configuration now offers localized help bubbles.
  • Improved Add Wizard now hides Resource Types if permissions are not sufficient.
  • Improved search dialog in Galleries initiating the search by pressing "Enter" in addition to the "Search Results" button.
  • Improved Image Gallery now allows selecting an image directly with double-click.
  • Improved Gallery where uploaded elements are directly visible.
  • Improved "Dynamic Functions" allow usage of function JSPs even if container does not have a width set.
  • Added support for XML content "model folders" from XSD.
  • Improved search in galleries with option to limit search to current (sub)site.
  • Improved Link selector in image gallery.
  • Improved upload process that translates filenames to avoid specials chars but preserves title property.
  • Added fall-back mechanism for non-existing formatters in container pages trying to find the appropriate formatter reading the configuration XSD.
  • Improved updater handles org.opencms.ade.config module to prevent conflicts.
  • Improved handling of not yet released/expired resources in ADE.
  • Improved cms:headincludes with attribute to close the tag supporting DOCTYPE HTML 4.01 strict.
  • Added default icon for resource types if one of the optional "small" or "big" icon is not set in the resource type configuration.
  • Moved all ADE module configuration to the common "ADE config" module.
  • Added support for the latest PostgreSQL "stable release" version.
  • Standardized ordering for core resource types, e.g group containers and dynamic functions.
  • Improved module-resource entries in manifest of org.opencms.workplace.tool.database prevents folders used by other modules of being deleted.
  • Improved Clipboard now uses localized version of Title and other properties.
  • Improved Description Mappings now provided for all Resource Types in Demo content.
  • Improved handling of XSD complex types with new content handlers that are created when unmarshalling content definitions and assigned to the new content definition objects.

Fixed issues in OpenCms 8.0.3

  • Fixed issue #1883 that category widget did not work correctly when the category title contains apostrophes.
  • Fixed issue #1981 that static export after publish did not work correctly for template resources with parameters.
  • Fixed issue #1991 that link relations are not displayed correctly in the workplace when first opened in explorer mode.
  • Fixed issue #2002 that the category widget logs errors when editing elements created through a collector list.
  • Fixed issue #2013 that the Toolbar Direct Edit Provider does not preserve request parameters.
  • Fixed issue with Tomcat 7 tag pooling.
  • Fixed Image Gallery now enables setting the alt / Title text in the settings tab in the XML page editor.
  • Fixed issue that if you create a new folder in the shared folder, the folder list in the explorer view (left frame) duplicates all entries.
  • Fixed issue in ADE Editor displaying scrollbars or not depending on the style of the web page, which might lead to flickering.
  • Fixed issue that dragging a new Dynamic Function Element onto the container page threw an exception.
  • Fixed issue in XML Editor submitting the form on "Enter" in a non-multi line field instead of advancing cursor to next field.
  • Fixed issue that user last login information was not updated anymore when working with OCEE cache.
  • Fixed issue in the movedResource method when moving a folder containing a sub-tree marked as deleted.
  • Fixed issue with timeout in Send-to-user function in a multi-user scenario.
  • Fixed issue that links to other sites were saved wrong in the editor.
  • Fixed issue that title property of uploaded image was set to source path when using IE7.
  • Fixed issue in creation of Sub-Sitemap as "common" user in the workplace throwing exception.
  • Fixed issue that missing "en" locale in sitemap configuration makes resource types vanish.
  • Fixed issue that GWT Upload did not work with Firefox 7 and Mac OS.
  • Fixed issue in property dialog in ADE that deleting once set values was not possible.
  • Fixed issue that Sitemap operations (insert new page, moving existing pages) generated negative NavPos property values.
  • Fixed issue that restricting search results in ADE does not work when reopening ADE galleries.
  • Fixed encoding issue in image galleries that images with special characters in the title are shown with broken characters in ISO-8859-1 environments.
  • Fixed issue in image gallery when reopening the gallery after selecting an image, that first 20 images are not shown.
  • Fixed issue that scrollbars in Explorer view did not work in Chrome.
  • Fixed issue that documents of the latest MS Office editions ending with .docx, .xlsx were not displayed in the galleries at all.
  • Fixed issue that headinclude of CSS does not produce valid XHTML.
  • Fixed issue that headincludes of elements in element groups were not considered.
  • Fixed issue within the link substitution if the "en" locale is missing in a module's .config file.
  • Fixed issue that CmsVfsDriver.readResourcesWithProperty behaved differently for shared and individual properties.
  • Fixed issue that the updater did not add the correct XML in opencms-search.xml when adding the new field-mapping of the "gallery_fields".
  • Fixed issue with the FCKEditor Image Gallery loading different images than selected when using IE7.
  • Fixed issue that repeated resizing of images added white bars at top and bottom of the image.
  • Fixed issue with the updater inserting an invalid node in the configuration when updating an OpenCms 7.0.5 installation with no node in the opencms-workplace.xml.
  • Fixed issue in the gallery search, where it occasionally happened that new resources were not added to the search index.
  • Fixed issue that when readDefaultFile method returned NULL the Sitemap Editor did not work.
  • Fixed caching issue, that new element settings in a modified XSD were not visible after OpenCms restart.

Other features of OpenCms

  • "Direct Edit" allows creation and modification of content directly from a web page.
  • Structured contents can be defined using a simple XML schema.
  • Includes editors with WYSIWYG and syntax highlighting functionality.
  • Easy to use "Online / Offline" workflow, changes must be approved before they become visible.
  • Link management for all internal resources with broken link detection.
  • Support for WebDAV access to all resources in the OpenCms repository.
  • Integrated image scaling and cropping.
  • Full featured internal user management that supports the concept of "Organizational Units" (OUs).
  • Allows management of multiple websites within one installation.
  • Contents can be served dynamically or exported to static HTML files.
  • Extensions can be added through a flexible module system.
  • Full text search for web pages, but also in PDF, MS Office documents etc.
  • The "time warp" feature allows to view resources which are expired or not yet released.
  • JSP integration for dynamic functionality in templates, dynamic forms etc.
  • Distribution includes a complete demo website "Wonderful World of Flowers".
  • ... and many more

Backward compatibility

We recommend everyone who uses OpenCms to update to the 8.0.3 release.

OpenCms 8.0.3 is fully backward compatible to all prior 7.x versions. Templates and other OpenCms developed code from version 7.0 or 7.5 should work "out of the box" with version 8.0.3.

Notice for users of Alkacon OCEE: OpenCms version 8.0.3 requires Alkacon OCEE version 3.0.3 or later. In case you want to update your OpenCms installation to 8.0.3, please make sure you update Alkacon OCEE to 3.0.3 or later first!

Compatibility with Java versions, Servlet containers and Databases

OpenCms 8.0.3 has been written and tested using Java 5 / 6. We have tested only with ORACLEs version of the JDK. However, OpenCms has no dependencies to sun.* packages so it should in theory run with all compliant JVMs.

We have tested this release on the Tomcat servlet engine. OpenCms works "out of the box" with Tomcat 6.0, which we recommend. Others have reported deploying OpenCms successfully on other servlet containers like JBoss, BEA, Websphere, Glassfish and Resin Professional. We appreciate any feedback regarding other servlet containers.

On the database side, we have tested with MySQL 5.x, Oracle 9.x and Oracle 10.x, as well as PostgreSQL 8.2.x and 7.4.x, MS SQL Server 2000 / 2003, DB2 9.1 and HSQLDB 1.8.0. The automatic update wizard for OpenCms 8 supports MySQL, Oracle and PostgreSQL.

Regarding version numbers and build tags

In case you want to check out OpenCms from Git, please keep the following in mind: The tag numbers for all OpenCms 8.0 final releases are "build_8_0_x", so the 8.0.3 release is tagged "build_8_0_3".

The main OpenCms Git repository is available on Github at

How you can help

Contributions to the OpenCms core development are most welcome. Please contact the core development team on the opencms-dev mailing list in case you are interested in supporting the development of OpenCms.

Please use our Bugzilla to report bugs in this release:


Thank you for using OpenCms and have fun with OpenCms 8 :-)