Common and frequent mistakes, NPEs

(Difference between revisions)
Jump to: navigation, search
m (adopt heading format)
Line 13: Line 13:
 
OpenCms modules are normally named in java package syntax with the version as suffix.  
 
OpenCms modules are normally named in java package syntax with the version as suffix.  
 
  org.opencms.workplace_7.0.4.zip
 
  org.opencms.workplace_7.0.4.zip
 +
 +
==HowTo use correct content encoding==
 +
 +
Quite often people are facing problems with displaying special characters (e.g. german umlauts). Do it like this, and it works:
 +
 +
as OpenCms uses java.util.Properties under the hood ISO-8859-1 will be used by OpenCms to decode the .properties files. So if you use an external editor to edit these files you have to ensure that this editor uses the iso encoding. If you use the internal OpenCms (wysiwyg) editor you should set the encoding property for the property files to ISO-8859-1 (as long as you don't use it as [[Changing_the_default_request_encoding|defaultcontentencoding]] which is UTF-8 by default). (taken from the OpenCms mailinglist - answer from Felix Noz)

Revision as of 13:20, 2 June 2008

Error message "Manifest file missing in module"

When importing an OpenCms module sometimes you get the error message

Error uploading the module [MODULENAME].zip.
Manifest file missing in module [PATH_TO_MODULE][MODULENAME].zip.

In most of the cases the problem is, that the zip file you try to import is not the module.zip, but another zip file which includes the real module.zip

(Example from the mailing list: http://www.nabble.com/Workflow-in-v7.0.4-to17319767.html)

HowTo recognise a OpenCms module by its name

OpenCms modules are normally named in java package syntax with the version as suffix.

org.opencms.workplace_7.0.4.zip

HowTo use correct content encoding

Quite often people are facing problems with displaying special characters (e.g. german umlauts). Do it like this, and it works:

as OpenCms uses java.util.Properties under the hood ISO-8859-1 will be used by OpenCms to decode the .properties files. So if you use an external editor to edit these files you have to ensure that this editor uses the iso encoding. If you use the internal OpenCms (wysiwyg) editor you should set the encoding property for the property files to ISO-8859-1 (as long as you don't use it as defaultcontentencoding which is UTF-8 by default). (taken from the OpenCms mailinglist - answer from Felix Noz)

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox