Full stop character allowed in node names
-----------------------------------------
Key: DOCU-239
URL: http://jira.magnolia-cms.com/browse/DOCU-239
Project: Documentation
Issue Type: Task
Security Level: Public
Components: content
Reporter: Antti Hietala
Assignee: Ruth Stocks
Starting with 4.5, the full stop character (en-us "period", Unicode 002E, UTF8
2E) is allowed in node names. Root cause for this change was the need to store
binary files in the resources workspace. Theme resources (CSS, JavaScript,
images) can now be stored in the same workspace as the rest of theme
configuration. Any resource file name that has full stops is OK, e.g.
{{flowplayer-3.2.7}}. The change is not limited to resources - all workspaces
now support the full stop character in node names.
Examples (hypothetical):
* User {{john.smith}}
* Javascript {{jquery.tabtree}}
* Document {{Magnolia-Flyer-4.0.pdf}}
To do: Change documentation where disallowed characters are discussed, removing
full stop. Create a list of disallowed characters in one place and reference it
from elsewhere.
Characters are validated in
[info.magnolia.cms.core.Path|http://svn.magnolia-cms.com/view/community/magnolia/trunk/magnolia-core/src/main/java/info/magnolia/cms/core/Path.java].
See {{getValidatedLabel}} and {{isCharValid}} methods.
In principle, Magnolia allows you to use the UTF-8 character set in node names.
However, some characters are invalid.
[JCR 2.0
specification|http://www.day.com/specs/jcr/2.0/3_Repository_Model.html#3.2.4%20Naming%20Restrictions]
defines the following invalid characters in a local name:
* Space, UTF-8 20
* {{/}} Solidus (forward slash), UTF-8 2F
* {{:}} Colon, UTF-8 3A
* {{[}} Left square bracket, UTF-8 5B
* {{]}} Right square bracket, UTF-8 5D
* {{\|}} Vertical line (pipe), UTF-8 7C
* {{*}} Asterisk, UTF-8 2A
Node names can also be present in a URL. Therefore, they cannot contain
characters that are not allowed in URLs or have a special meaning in a URL.
http://www.ietf.org/rfc/rfc1738.txt
* {{;}} Semicolon, UTF-8 3B
* {{/}} Solidus (forward slash), UTF-8 2F
* {{?}} Question mark, UTF-8 3F
* {{+}} Plus sign, UTF-8 2B
* {{%}} Percent sign, UTF-8 25
* {{!}} Exclamation mark, UTF-8 21
* {{#}} Number sign (pound, hash), UTF-8 23
* {{^}} Circumflex access, UTF-8 5E
Additional invalid characters in Magnolia CMS:
* {{@}} Commercial at, UTF-8 40
* {{&}} Ampersand, UTF-8 26
* {{=}} Equals sign, UTF-8 3D
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.magnolia-cms.com/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
----------------------------------------------------------------
For list details, see: http://www.magnolia-cms.com/community/mailing-lists.html
Alternatively, use our forums: http://forum.magnolia-cms.com/
To unsubscribe, E-mail to: <[email protected]>
----------------------------------------------------------------
