Subversion Repositories regexpline_backup

[/] [stable/] [2.2/] [docs/] [readme.txt] - Blame information for rev 3

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 3 xrow
Datatype extension for eZ publish 3.6+ (License: GPL)
2
-----------------------------------------------------
3
 
4
Provides a regular expression datatype for eZ publish.
5
 
6
 
7
What is it?
8
-----------
9
For end users it will look like the standard "Text line" datatype that ships with eZ publish.
10
 
11
The biggest difference is that the input will be validated against a regular expression. This enables you to make sure the input meets certain criteria.
12
 
13
It can act like a regular "Text line" datatype by allowing all input (regexp: /.*/).
14
 
15
 
16
Features
17
--------
18
A number between square brackets denotes the version number where said feature has been introduced.
19
If no indication is present, version 1.0 contains the feature.
20
 
21
- Check user input against a regular expression (Perl-compatible)
22
- Ability to specify multiple regular expression [2.0]
23
- Use regular expression subpatterns to be able to use parts of the input in the object name pattern
24
- Ability to customise the text that will be used in the object name pattern [1.1]
25
- Ability to supply a help text for users
26
- Required checks compatible with newer eZ publish versions (drafts ignore required fields)
27
- Information collection support
28
- Attribute filtering support
29
- Ability to define preset regular expressions in an ini file
30
- Ability to select multiple presets [2.0]
31
- Ability to specify an error message per regular expression / preset [2.0]
32
- Ability to display the datatype as a single text line or as a textarea (object edit) [2.0]
33
- Ability to negate regular expressions and presets [2.1]
34
- Support for has_content in templates [2.1]
35
- Stripping of tags with possibility to disable the stripping via the ini file [2.2]
36
- Control the size of both a text line and a text area in content/edit [2.2]
37
- Contentclass import & export
38
- i18n support
39
 
40
 
41
Information
42
-----------
43
While editing a contentclass, you will be able to define how the content of a regexpline attribute will be validated.
44
 
45
You can choose two paths:
46
  1. Enter regular expressions directly in the class.
47
  2. Select one or more presets which have been defined in an INI file.
48
 
49
Path 1 is pretty straightforward. The interface will tell you what you can do. Each regular expression you enter can
50
have an error message that describes what should be done to meet the criteria. If you specify multiple regular expressions,
51
the input must match all three expressions.
52
 
53
Path 2 reads the settings from an INI file. You can define as many regular expressions provided you give each of them a
54
unique identifier. With that very same identifier, you can build and array of error messages too. This way, you can accomplish
55
the same thing as in Path 1 (custom messages per regular expression).
56
 
57
Something specific for Path 2 is if the regular expression is negated afterwards (input must NOT match the expression). The datatype
58
will then look for the error message identifier by the regular expression's unique identifier concatenated with '_negate'. This is of
59
course not needed if you take Path 1 (the regular expression will always be negated for that attribute and the error message can be
60
constructed to reflect that).
61
 
62
Any subpatterns in the regular expressions chosen for an attribute will be available for use in the object name pattern. The datatype
63
allows you to construct a custom string of these subpatterns. The custom string will then be used in real object name pattern if you
64
construct the contentclass to do so.
65
 
66
 
67
Planned Features
68
----------------
69
These features are NOT available yet, but they're coming.
70
 
71
No planned features at the time of writing
72
 
73
 
74
Requirements
75
------------
76
- A suitable eZ publish version: 3.6.x; 3.7.x has also been used during development.
77
- Knowledge of Perl Compatible Regular Expression syntax (http://www.php.net/manual/en/ref.pcre.php)
78
 
79
 
80
Installation
81
------------
82
You can always find the latest version of this extension @
83
http://pubsvn.ez.no/community/trunk/extension/regexpline
84
 
85
If you can't use SVN, you can also download the most recently released version from the Contributions section @
86
http://ez.no/community/contribs
87
 
88
- Extract or checkout the regexpline extension into the eZ publish 'extension' folder
89
- Activate the extension by means of the admin interface or by adding
90
 
91
  ActiveExtensions[]=regexpline
92
 
93
  to [ExtensionSettings] in site.ini.append(.php)
94
- Clear the template override cache to make sure eZ publish picks up the templates in the extension.
95
 
96
 
97
Bugs? Comments? Wishes?
98
-----------------------
99
- Bugs: If you report a bug, please make sure you have a minimal testcase so I can reproduce the problem.
100
  If I can't reproduce it, I can't fix it.
101
 
102
- Comments: Nothing special here :)
103
 
104
- Wishes: Please provide a clear description.
105
 
106
Direct all (fan|bug|wish)mail at: hans <dotty> melis <atty> gmail <dotty> com
107
 
108
Please note that this datatype has been developed in my spare time, and is supplied as is. I'm not responsible for any data loss or failures. YMMV!
109
 
110
 
111
Tips & Tricks
112
-------------
113
1. If you want to refer to the complete text that matched the regular expression in the object name pattern, you can use <0> as tag.
114
 
115
 
116
Copyright
117
---------
118
 
119
Regular Expression datatype for eZ publish 3.6+
120
Copyright (C) 2005-2006  Hans Melis
121
 
122
This program is free software; you can redistribute it and/or modify
123
it under the terms of the GNU General Public License as published by
124
the Free Software Foundation; either version 2 of the License, or
125
(at your option) any later version.
126
 
127
This program is distributed in the hope that it will be useful,
128
but WITHOUT ANY WARRANTY; without even the implied warranty of
129
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
130
GNU General Public License for more details.
131
 
132
You should have received a copy of the GNU General Public License
133
along with this program; if not, write to the Free Software
134
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA