README

为 eZ Publish 提供正则表达式数据类型，用于在服务器端验证编辑器内容的编辑。

eZ Publish 的数据类型扩展

许可: GPL

为 eZ publish 提供正则表达式数据类型。

这是什么？

对于最终用户来说，它看起来就像 eZ publish 一起提供的标准 "文本行" 数据类型。

最大的区别是输入将根据正则表达式进行验证。这可以确保输入满足某些标准。

它可以通过允许所有输入（正则表达式：/.*/）来像普通的 "文本行" 数据类型一样工作。

特性

方括号中的数字表示引入该特性的版本号。

如果没有指示，则该特性包含在版本 1.0 中。

• 检查用户输入是否与正则表达式（Perl 兼容）匹配
• 能够指定多个正则表达式 [2.0]
• 使用正则表达式子模式，能够在对象名称模式中使用输入的一部分 [2.0]
• 能够自定义将用于对象名称模式的文本 [1.1]
• 能够为用户提供帮助文本 [2.0]
• 与较新版本的 eZ publish 兼容的必需检查（草稿忽略必需字段） [2.0]
• 支持信息收集 [2.0]
• 支持属性过滤 [2.0]
• 能够在 ini 文件中定义预置的正则表达式 [2.0]
• 能够选择多个预置 [2.0]
• 能够为每个正则表达式/预置指定错误消息 [2.0]
• 能够将数据类型显示为单行文本或文本区域（对象编辑） [2.0]
• 能够否定正则表达式和预置 [2.1]
• 支持模板中的 has_content [2.1]
• 去除标签，并且可以通过 ini 文件禁用去除 [2.2]
• 控制内容/编辑中文本行和文本区域的尺寸 [2.2]
• 在类验证失败时显示错误消息 [2.3]
• 内容类导入和导出
• 支持多语言 [i18n]
• PHP5 支持 eZ Publish 4.x [3.0]

信息

在编辑内容类时，您将能够定义如何验证 regexpline 属性的内容。

您可以选择两条路径

1. 直接在类中输入正则表达式。
2. 选择一个或多个已定义在 INI 文件中的预置。

路径 1 非常直接。界面将告诉您可以做什么。您输入的每个正则表达式都可以有一个错误消息，说明如何满足标准。如果您指定了多个正则表达式，则输入必须与所有三个表达式匹配。

路径 2 从 INI 文件读取设置。您可以根据需要定义尽可能多的正则表达式，前提是每个正则表达式都有一个唯一的标识符。使用相同的标识符，您还可以构建错误消息的数组。这样，您就可以实现与路径 1 相同的功能（每个正则表达式自定义消息）。

Path 2的特殊之处在于，如果之后对正则表达式进行了否定（输入必须不匹配该表达式）。此时，数据类型将根据正则表达式的唯一标识符和'_negate'拼接后寻找错误消息标识符。当然，如果您选择Path 1（对于该属性，正则表达式始终会被否定，错误消息也可以构造来反映这一点），则不需要这样做。

所选属性的正则表达式中的任何子模式都将可用于对象名称模式。数据类型允许您构建这些子模式的自定义字符串。如果您将内容类构造为这样做，则该自定义字符串将用于实际的对象名称模式。

计划功能

这些功能目前尚未提供，但即将推出。

撰写时没有计划的功能

要求

• 合适的eZ publish版本：4.0。
• 了解与Perl兼容的正则表达式语法（https://php.ac.cn/manual/en/ref.pcre.php）

安装

您可以在http://pubsvn.ez.no/community/trunk/extension/regexpline找到此扩展的最新版本。

如果您不能使用SVN，您也可以从贡献部分下载最近发布的版本http://ez.no/community/contribs。

• 将regexpline扩展解压或检出至eZ publish的'extension'文件夹。

• 通过管理界面或通过添加以下内容激活扩展：

  ActiveExtensions[]=regexpline

  到 site.ini.append(.php) 中的 [ExtensionSettings]

• 清除模板覆盖缓存以确保eZ publish获取扩展中的模板。

错误？评论？愿望？

• 错误：如果您报告一个错误，请确保您有一个最小测试用例，这样我就可以重现问题。如果我不能重现它，我就无法修复它。

• 评论：这里没有特别之处 :)

• 愿望：请提供清晰的描述。

请将所有（fan|bug|wish）邮件发送至：hans melis gmail com

请注意，此数据类型是在我的业余时间开发的，并按原样提供。我对任何数据丢失或故障不承担责任。YMMV！

技巧与窍门

1. 如果您想在对象名称模式中引用匹配正则表达式的完整文本，可以使用 <0> 作为标签。

版权

eZ publish 4.x的正则表达式数据类型

版权（C）2005 - 2008 Hans Melis

此程序是自由软件；您可以在自由软件基金会发布的GNU通用公共许可证版本2的条款下重新分发和/或修改它。

此程序是免费提供的，旨在供公众使用，但没有任何保证；甚至没有任何暗示保证其可销售性或适用于特定用途。有关详细信息，请参阅GNU通用公共许可证。

您应该已收到随此程序一起提供的GNU通用公共许可证副本；如果没有，请写信给自由软件基金会，Inc.，51 Franklin St，第五层，波士顿，MA 02110-1301 USA。