15.4.1   语义(Schema)

可将各个字段(Field)以按照元组(tuple)的方式传入Schema对象，即可创建一个新的语义(schema)。例如，这个文章的语义(Schema)就包括三个字段(Field): group, blurb 和 body ，这个语义(Schema)的起始部分代码是:

Schema((
   StringField('group',
       vocabulary=ARTICLE_GROUPS,
       widget=SelectionWidget(),
       ),
       # 这里开始是其他的字段...
       )

多个语义(Schema)累加，是可以组装为一个新的语义(Schema)的。ArchExample也是这样做的，它累加了一个叫做 BaseSchema 的语义。

BaseSchema 包含了所有Plone内容类型都应该有的2个字段：标题和英文代号。标题用来在用户界面上显示这个内容，英文代号是用来内部命名的。这2个语义简单的累加，可构成一个更大的语义。在ArchExample中，可将你的内容语义和现有的 BaseSchema 进行累加。例如:

schema = BaseSchema +  Schema((
   StringField('group',
               vocabulary=ARTICLE_GROUPS,
               widget=SelectionWidget(),
               ),
   ...

在界面上各个输入项显示的次序，和Schema定义中字段(Field)的添加次序是一致的。 这意味着，移动Schema中各个字段(Field)在语义(Schema)中的位置，便可调整这些 元素在界面上的显示次序。正因如此，由于 BaseSchema 加到了开始处， 所以在编辑页面中，英文代号和标题在位于最上方，而不是底部。

15.4.2   字段(Field)

到现在为止，我们看到了 StringField 这个字段，它是在内容中表示字符串类型的一个常用字段。在Archetypes中，还包括很多其他的字段，详细见本节后面的表格。你可以尝试更多的字段类型，甚至定义自己的字段类型。

每个字段(Field)有一个默认使用的显示器件，你也可以专门指定一个。上面的摘要 blurb 字段中，指定了一个 TextAreaWidget (Widget在下节讲述)。所有的这些字段，可在Archetypes的public模块中导入，比如:

from Products.Archetypes.public import BooleanField

所有的字段的实例化方法是相同的：创建一个字段，并将字段名作为第一参数传入。你也可以使用关键字参数的方式，传递更多的可选参数。比如:

from Products.Archetypes.public import IntegerField
# 年龄字段
age = IntegerField('age')

每个字段都有一组可设置的属性。我们现在已经至少看到了2个： name 和 widget 属性。 name 属性是字段唯一必需的参数，而且必须唯一，并使用不包含空格和点号的小写英文字母。 name 字段将在内部使用，因此应该严格遵守这个命名规范。所有的其他属性都是可选的。下表描述了其他的所有的属性。

到现在为止，我们已经讲述了默认的字段(Field)和属性，现在开始讲述显示器件(Widget).

15.4.3   显示器件(Widget)

显示器件(Widget)包含了如何显示对象的一些信息。通常，一个字段的显示视图和这个字段的类型密切相关。但是，你可以有更多的显示选项，比如字符串可以被输入，或者从多个可选项中选择。你可从Archetypes的 public 模块中导入显示器件。例如:

from Products.Archetypes.public import BooleanWidget

所有的显示器件采用相同的方式实例化：创建一个显示器件，并传入所需的关键字参数。比如:

from Products.Archetypes.public import IntegerField
from Products.Archetypes.public import IntegerWidget
# 年龄字段
age = IntegerField('age',
       widget=IntegerWidget(label="您的年龄")
       )

显示器件能有其他的属性，这取决于显示器件的类型。大多数情况下，这些附加的属性直接和HTML属性对应。比如， StringWidget 就有一个 size 属性。相应的，这将产生使用这个size属性的HTML输入框。如果我们需要让输入框只有20个字符串宽，我们可创建如下的显示器件:

bankAccountNumber = StringField('bank',
   widget=StringWidget(
           label="银行帐号",
           size=20)
         )

下表描述了Archetypes中可用的所有显示器件。

上表中的各种显示器件，在下表中描述了所有显示器件公共的属性。你已经看过了 label 和 description 属性了，他们用于设置显示器件的标题和提示说明信息。和上面各个显示器件的附加属性在一起，我们可获得一个完整的显示器件属性清单。

在上例中，你看到的是直接在写在源代码中的中文解释说明文字， 这里只是为了说明上的简单性， 但如果你想要做成一个国际化的产品，这些文字最好是写在相应的翻译用的po文件中。

事实上Archetypes就提供了这些功能， 你可以为Widget的构造函数中的每个参数添加以"_msgid"为后缀的关键字式参数， 为它提供一个msgid，并且使用i18n_domain参数指定翻译域， 这样翻译的工作就可以分离到相应的po文件中去了，示例如下:

StringField("blurb",
             required = 1,
             searchable = 1,
             widget = TextAreaWidget(label="Article Blurb",
                                     label_msgid="label_blurb",
                                     description="Please input a short blurb for this article.",
                                     description_msgid="help_blurb",
                                     i18n_domain="archexample"),
             ),

上面的几个属性说明如下表。

要完成国际化工作，还需要产品i18n目录中，为各个语言的po文件中增加相关的msgid的翻译。 比如对于这个blurb字段，就需要在中文的翻译po文件中增加label_blurb和help_blurb这2个msgid:

msgid "label_blurb"
msgstr "文章摘要"

msgid "help_blurb"
msgstr "请为文章填写一个短的摘要"

上面这些Widget都是Archetypes所提供的，如果你安装了其它产品，则还有一些高级的Widget可以使用，

事实上是Archetypes提供了扩展Widget并注册的函数， 在这些产品中也就是使用Archetypes提供的功能加上少量的扩充定制而成， 在有必要时还可以定制自己的Widget，本章后面的定制视图一小节会讲到。

15.4.4   字段(Field)和显示器件(Widget)的组合

本节包含常用的一些组合示例。比如，制作一个你所喜爱的水果(fruit)的下拉框。 你可以定义字段的 vocabulary 属性为一个字符串的列表(list)。列表的每个值， 就是一种水果类型的字符串；因此，这个字段类型是 StringField 。由于我们采用了 SelectionWidget ，最终将显示为一个下拉列表框。代码如下:

StringField('fruit',
    vocabulary = ["苹果", "桔子", "菠萝", "香蕉"],
    widget = SelectionWidget(label = "喜爱的水果")
    )

ImageField 可用于创建和管理Plone站点中的图片。如果需要提供用户一个上传图片的字段，可使用下面的方式:

ImageField('portrait',
    widget = ImageWidget(label = "我的照片"),
    )

下面将是一个比较复杂的内容类型。大多数内容类型有一个存放数据的主字段。比如基础的页面类型，有需要输入和编辑的正文字段。这个正文字段是这个内容类型的主要文字。对这个字段，需要增加几个额外的属性。

首先，我们需要让这个字段支持全文搜索，因此需要设置 searchable 属性。其次，我们需要让这个字段能够响应FTP和WebDAV的请求，因此我们需要设置 primary 属性(后面我们会讲述Primary字段的更多信息)。你需要让多种内容类型可被上传，于是设置 allowable_content_types 属性。接下来你需要知道如何显示这个字段，这样就需要设置 default_output_type 属性。最终代码是:

TextField('body',
         searchable = 1,
         primary = 1,
         default_output_types = 'text/html',
         allowable_content_types = ('text/plain',
                                    'text/structured',
                                    'text/restructured',
                                    'text/html'),
         widget = RichWidget(label = '正文'),
         )

15.4.5   Marshall: FTP和WebDAV接口适配

Plone中的内容，每个内容都包括很多属性。但是FTP或者WebDAV只能传递单个的文件。 这样，通过FTP/WebDAV下载内容的时候，需要将内容转换单个的文件。上面的例子中， body字段被设置为内容的主字段(primary)，在FTP/WebDAV下载的时候， 会直接传递这个字段的内容，而不是整个内容。

这个方法是很有效的。但是有时候，我们还希望同时获得内容的一些属性信息。我们可采用类似邮件的存储格式那样，将内容打包后传输下来。

Archetypes将这种内容到单个文件的转换，叫做Marshall。相应的，从文件转换到内容的过程，则叫做DeMarshall。Archetypes内容的Schema定义中，可指定一个Marshaller， 来负责Marshall和DeMarshall的过程: marshall=some_marshaller() 。Archetypes默认包括2种Marshaller：

• PrimaryFieldMarshaller: 仅仅将主字段转换为文件，Plone的文件和页面，均采用这个Marshaller。
• RFC822Marshaller: 将内容采用RFC822的标准格式存储，也就是邮件的存储格式。这个格式采用 "关键字: 值" 的方式，能够传递内容的各种属性。

另外Plone 2.5包括了一个叫做Marshall的产品，如果安装了这个产品，将包括一个叫做 ControlledMarshaller 的特殊Marshaller，可手工设置满足条件内容的Marshaller方式。比如可指定网站某个部分的内容采用PrimaryFieldMarshaller，而另外一部分内容，采用RFC822FieldMarshaller。

Marshall产品还包括一个特殊的Marshall，可以将Plone的内容以XML格式导出，这样可以比较方便地和其他系统进行数据交换。

15.4.6   Validator: 输入校验器

现在内容的编辑表单已经能够很好的处理一些基本的错误，比如遗漏的输入项。 但是你可能需要更加复杂的错误处理逻辑。你可以进行一系列的校验， 以验证内容的输入是正确的。比如，你有一个整数字段，你就可能需要用户添加的数据是不是这样的。

要实现这个功能，可在字段(Field)定义中增加一个检验参数。比如，为了测试你的 IntegerField 是否真的是一个整数，你可这样完成:

from Products.Archetypes.public import IntegerField
from Products.Archetypes.public import IntegerWidget
# 一个简单的年龄字段
age = IntegerField('age',
      validators=("isInt"),
      widget=IntegerWidget(label="你的年龄")
      )

这里的 isInt 是从哪里来的？ isInt 是Archetypes校验框架中预先注册的一个校验器的名字。现在可用的校验器数量并不多，但是都非常有用，具体可见下表。

你可也注册自己的校验器(validator)。校验器是实现了 IValidator 接口的简单类。 已经有2个基础的校验器了： RegexValidator 会检验是否符合一个正则表达式， RangeValidator 则检验数据是否在一个范围内。如果要注册一个新的校验器，检查用户年龄必须在0-150岁之间，你可在字段定义前，将下面的代码添加到你的Python模块中:

from validation.validators import RangeValidator
from validation import validation

# RangeValidator 需要传入校验器的名字、起始和结束值
validAge = RangeValidator("validAge", 0, 150)
validation.register(validAge)

接下来，你可更改age字段的校验器为:

validators=("isInt", "validAge"),

首先，这段代码将检查是否是一个整数；接下来，它将检查这个整数是否在有效的年龄范围内。 如果你希望添加一个全新的校验器，而不是这种范围检查或者正则表达式检查， 你就需要添加一个新的校验系统。比如，检查日期位于某2个值之间。下面的例子介绍了一个新的 DateRangeValidator ，如果日期位于2个指定日期间，则返回布尔(boolean)值。 这样的一个检查，可确保休假位于学校的假期中。

现在，我们在 validators 模块中添加一个 DateRangeValidator 的校验器。 它允许你注册一个时间范围，来确保输入的时间位于其间。 为了完成这个，我们可使用Zope的 DateTime 对象。校验器实现起来其实很简单－它就是 有一个 name 属性的类，并且指出 __call__ 方式调用来检验日期。下面就是位于 validators 模块中的 DateRangeValidator 类:

from Products.validation.interfaces.IValidator import IValidator
from DateTime import DateTime

class DateRangeValidator:
    __implements__ = IValidator

    def __init__(self, name, min, max, title='', description=''):
        self.name = name
        self.min = min
        self.max = max
        self.title = title
        self.description = description

    def __call__(self, value, *args, **kwargs):
        if len(args) >= 1:
            min = args[0]
            if len(args) >= 2:
                max = args[1]
            else:
                max = self.max
        else:
            min, max = self.min, self.max
        if not isinstance(value, DateTime):
            value = DateTime(value)
        return min <= value < max

接下来，你可注册这个新的校验器，如下:

from validation.validators import DateRangeValidator
from validation import validation
from DateTime import DateTime

christmas = DateRangeValidator("isChristmasHolidays",
                    DateTime('12/18/2004'),
                    DateTime('01/09/2005'))
validation.register(christmas)

然后，你可在语义字段(Field)中使用校验器了:

validators=("isChristmasHolidays",)

15.4.7   数据的存储(Storage)

到现在为止，各个字段中存放的数据，都是直接作为内容对象的属性，存放在Zope的对象数据(ZODB)中的。大多数情况下，这已经可以满足要求。

前面在ZODB一章中提及，ZODB存在非Python语言无法访问、不适合存储大数据量等问题。如果我们需要和其他系统共享信息，我们可能希望将部分数据存放在关系数据库中；如果我们需要进行大量的文档、软件、流媒体的管理，我们则可能需要直接将文件存放在文件系统中。

我们可在Schema中，设置各个字段的存储方式。比如将字段的 storage 属性设置为 PostgreSQLStorage 就可将数据存放到Postgre数据库中。具体代码如下:

from Products.Archetypes.SQLStorage import PostgreSQLStorage

age = IntegerField('age',
     validators=("isInt",),
     storage = PostgreSQLStorage(),
     ),

当然，与此同时，需要在Plone的根下在ZMI界面中，添加一个数据库连接对象，并在 archetypes_tool 的 Connections 页面中选择。

如果要将文件在文件系统中保存，需要安装 ExternalStorage 或者 FileSystemStorage 这样的插件产品支持。可在 http://plone.org/products 下载后安装。关于文件系统存储的具体使用方法，可参看这些插件产品的说明文档。Archetypes默认支持的Storage清单如下表:

15.5.1   开发一个最小的内容

一旦完成Schema的定义，内容的定义就非常简单了。一个最简单的内容，可如下编写:

from Products.Archetypes.public import BaseContent, registerType
from config import PROJECTNAME

# 略去Schema 的定义，详细见上节
# schema = ....

class Article(BaseContent):
    """ 这是一个用于示例的文章 """

    schema = schema

registerType(Article, PROJECTNAME)

这里， Article 的基类是 BaseContent 。 BaseContent 是Archetypes的public模块提供的一个基础类，它提供了作为Plone内容所必须的大量特性，包括搜索、引用、编辑表单处理等。所有非文件夹类型的内容，都应该继承它。

这个类包括一个 docstring 说明：“这是一个用于示例的文章”。这个说明将自动作为内容类型的描述，在Plone界面中显示。Article类还包括了一个schema变量，这个变量直接使用前面单独定义的语义Schema。

最后 registerType 可将这个类注册到Archetypes中。后面我们会看到，可利用Archetypes的其他接口，对这个产品中注册的类自动生成代码和安装。

15.5.2   设置内容类型信息

前面在Plone的基本设置一章中，我们知道在ZMI->portal_types中管理了各种内容类型的一些基本信息，包括标题、描述、图标、显示视图、操作项(action)等。 默认情况下，Archetypes中的内容会自动生成上述内容类型信息，无需单独设置便可工作。 如果您希望对自己的内容做更加个性化的设置，则可重载这些默认的设置。

这些内容类型信息，可作为给内容类的属性来设置，比如:

class Article(BaseContent):
    """ 用于示例的文章 """

    content_icon = 'article_icon.gif'  # 图标
    portal_type = 'DemoArticle'        # 内容类型的内部注册名字
    archetype_name = 'Demo Article'    # 在界面上显示的标题

    # 内容标签页
    actions = ({ 'id': 'view',
                 'name': 'View',
                 'action': 'string:${object_url}/article_view',
                 'permissions': ('View',)
                },)

上面的例子分别设置了图标、注册名字、显示名字和内容标签页。Archetypes自动为内容生成查看(view)、编辑(edit)、属性(properties)、共享(sharing)这4个标签页面。 通过设置actions属性，可调整现有的标签页的设置，或者添加新的标签页。 Archetypes默认的查看页面是一个 base_view 的页面，显示形式比较简单，一般需要对查看页面进行定制。 上面的例子中，重新定义了查看(view)标签的action地址为 article_view ，以便更加合理的显示文章。 这个 article_view.pt 位于 ArchExample 产品的 skins/archexample 子目录中。

内容类还有一组其他的属性，详细见下表。

15.5.3   重载或者添加方法

在上面我们的类还只有一些属性定义，与普通的Python类定义相同的是，其中还可以定义方法。

一般内容类型都从BaseContent开始开发，它为内容类型提供了很多默认的构造函数和方法等， 有时需要为新的类型提供不同于默认特性的方法，或者需要为新的类型提供更多的方法， 这时可以重载现有的函数以提供不同于继承类的特性，或者添加新的方法以实现更多的功能。

因为Archetypes会默认给每一个字段都生成显示和编辑框， 但有时你想定义一个内部使用的字段不允许用户编辑而是按照规则生成字段内容， 这时可以为它定义方法：

如Poi产品(用于项目跟踪器)中为每一条新的报告生成一个新的id， 如果使用Archetypes默认的方法则会按照标题的md5值去生成一个id来保证id不重复， 但Poi产品想使用一种简单的办法保证id不会重复，就是使用数字系列从1开始往上数， 一直增加的方法，这样也能保证id不会重复， 因此在其中重载了这个_renameAfterCreation方法：

def _renameAfterCreation(self, check_auto_id=False):
    parent = self.aq_inner.aq_parent
    maxId = 0
    for id in parent.objectIds():
        try:
            intId = int(id)
            maxId = max(maxId, intId)
        except (TypeError, ValueError):
            pass
    newId = str(maxId + 1)
    # Can't rename without a subtransaction commit when using
    # portal_factory!
    transaction.savepoint(optimistic=True)
    self.setId(newId)

这一段代码就是将所有现有的id都转换成数字并找出一个最大值，并加1做为新的id。

上面这个例子是对对id字段的重载，但实际上定义语义Schema中的所有字段都是可以重载的，

还有一些是属于Plone本身的一些功能重载也很用，如搜索特性。

在前面的字段定义中可以看到很多字段定义了searchable属性， Archetypes会将设置了searchable属性为真的字段值作为字符串连接存入portal_catalog中作为搜索字符串， 如果想改变这种默认的方式，可以重载SearchableText函数，如Poi产品中对SearchableText的重载:

def SearchableText(self):
    """Include in the SearchableText the text of all responses"""
    text = BaseObject.SearchableText(self)
    responses = self.contentValues('PoiResponse')
    text += ' ' + ' '.join([r.SearchableText() for r in responses])
    return text

这个重载的方法中首先调用基类的方法获得所有需要进行索引的文本， 它还将其本身所容纳的PoiResponse子对象也纳入了索引文本内。

另外还有一些属于Zope所提供的方法重载也很有用， 如ATContentTypes中对get_size方法作了如下定义:

security.declareProtected(View, 'get_size')
def get_size(self):
    """ZMI / Plone get size method
    """
    f = self.getPrimaryField()
    if f is None:
        return 0
    return f.get_size(self) or 0

也就是从类型上读取主字段，让主字段去计算文件大小。 这个方法是用于各种方式(http,ftp)下载时或在文件夹浏览视图上查看时以正确计算出这个类型对象的大小。 如果你对这些方法有不同的需要，可以重新定义它们，也就是重载。

除了重载之外，还可以添加新的方法，也就是给自己的内容类型对象操作的新的方法， 这是Python类的特性，可以为需要的类添加任意的方法。 但需要注意不要与BaseContent基类方法命名冲突， 因为有命名冲突时可能引起的未知的错误，就是说你想定义一个方法来实现某个功能， 但这个名称的方法可能已经被Zope所内部使用，结果是你的方法在意想不到的地方被调用了， 这种情况下运行结果也是意想不到的，并且这种错误很难检查。

附录中一份常用的重载方法列表，直接在Zope的源代码中搜索也可以找到更多。

15.5.4   安全声明

上面已经看到在定义之前有一行security，这是不管重载还是定义新的方法都要进行的权限声明。

安全声明是所有Zope产品都要求的一项特性， 因为在文件系统上开发具有所有Python可用的特权， 也就是说这是在Zope的内核上增加特性， Zope在默认情况下设置了很多级的权限， 并且对于一个多级管理的多用户系统是十分安全的， 因此你需要十分注意你的产品不要成为Zope安全问题的突破点， 毕竟，安全是一个复杂的话题，在整个系统中所有产品包括内核和外围增加产品的组合中， 系统的安全性是取决于安全性最低的那一个组件。

具体在写代码的过程中，也就是要注意使用ClassSecurityInfo来声明函数的权限。

security = ClassSecurityInfo()

这一段代码是用在类的定义中，也就是实例化一个ClassSecurityInfo对象， 然后使用这个对象来初始化各个要定义的方法:

security.declareProtected(ModifyPortalContent, 'setText')
def setText(self, text=''):
    ...

这个语句是将setText方法设置为保护方法，只有有ModifyPortalContent权限的角色才能调用这个方法， 这里的ModifyPortalContent是从CMFCore.permissions上导入的权限值，它其实是一个字符串， 在 CMFCore.permissions 中定义为 'Modify portal content' 。 并且在CMFCore中已经定义了很多默认的权限值，你可以导入它，也可以使用新的权限字符串。 在这里看到Zope中的权限定义其实都是字符串，而不是其它系统中所常用的定义常量数字的形式， 使用字符串形式的权限定义不仅可读而且清晰易维护， 对于扩展人员使用也同样方便，使用一个新的字符串就好了。 它是Zope强大的用户权限管理的基础。 同样的还有:

security.declarePrivate('guessMimetypeOfText')

是注意为私有方法，私有方法只能在产品的Python代码中被调用，而不能在脚本或页面模板中调用。 在类的初始化时如果没有说明是哪一种类型则默认是私有的， 虽然能有默认值就是私有的，但在代码中还是显式地说明最好，以显得更为清晰可读。

反之，如果被说明为公有的:

security.declarePublic('guessMimetypeOfText')

则这个方法可以不受权限系统限制在任何地方被调用。

15.5.5   文件夹类型的内容

上面从BaseContent继承是注册一般内容类型， 有时需要制作可以容纳其它对象的类型，一般也称为文件夹类型， 这时可以考虑从Archetypes的文件夹基类上继承。

在Archetypes中提供了两种类型的文件夹类型可作为基类，

• BaseFolder
• BaseBTreeFolder

两种类型的不同是BaseBTreeFolder一般用于大文件夹，指的是可能有上万个子对象的情况下， 一般情况下仅使用BaseFolder就足够了。

如ATContentTypes产品中定义了一个基于BaseFolder的ATCTFolder类型，

class ATCTFolder(ATCTMixin, BaseFolder):
    ...

基于ATCTFolder继承下去可以定义更多的文件夹类型。

15.5.6   支持多种视图

可以看到在Plone内置的文件夹类型是可以选择多种视图，在【显示】下拉菜单中，可以看到多种可以选择：

图 15.3 Plone界面的多种视图显示

同样，定制的内容也可以增加多种显示视图， 这需要从CMFDynamicViewFTI的BrowserDefaultMixin继承就可以:

from Products.CMFDynamicViewFTI.browserdefault import BrowserDefaultMixin

以 BrowserDefaultMixin 作为继承的一个父类就可以定义多种视图， 因为Python的类是可以多继承的，在文件系统上的产品开发中，经常可以看到有以Mixin结尾命名的类， 这些类一般都是用于多继承，如

class CustomFolder(BrowserDefaultMixin, BaseFolder):

然后在类的定义中可以使用suppl_views来定义可用的视图:

default_view   = 'atct_topic_view'
suppl_views    = ('folder_listing', 'folder_summary_view', 'folder_tabular_view', 'atct_album_view')

在这个定义中，默认的视图是atct_topic_view，并且还有其它几种可供选择的视图。

15.6.1   产品初始化

Zope初始化一个产品的过程就是导入这个产品，然后运行其中的initialize函数，可以看到在__init__.py文件中。

from Products.Archetypes.public import process_types, listTypes
from Products.CMFCore import utils
from Products.CMFCore.DirectoryView import registerDirectory

from config import SKINS_DIR, GLOBALS, PROJECTNAME
from config import ADD_CONTENT_PERMISSION

registerDirectory(SKINS_DIR, GLOBALS)

def initialize(context):
    ##Import Types here to register them
    import Article

    content_types, constructors, ftis = process_types(
        listTypes(PROJECTNAME),
        PROJECTNAME)

    utils.ContentInit(
        PROJECTNAME + ' Content',
        content_types      = content_types,
        permission         = ADD_CONTENT_PERMISSION,
        extra_constructors = constructors,
        fti                = ftis,
        ).initialize(context)

这段代码首先是从其它模块中导入一些函数和常量，然后注册皮肤路径，它从Products.CMFCore.DirectoryView导入了registerDirectory函数用于注册文件系统目录视图， 注册之后skins中的子目录，才能被安装程序安装到portal_skins中。

重点是在initialize函数中，这个函数在Zope启动的时候，会被Zope调用执行。 Archetypes的process_types函数会对找到产品定义的内容，并进行预处理，比如动态的生成get/set方法等。 因此需要预先import相关定义内容的模块，比如import Article。 获取在产品中注册过的类型，并使用utils.ContentInit将Archetypes注册过的类型注册到Zope中，并初始化。

经过initialize的执行之后，这些内容类型就可以在ZMI上添加了(但是不推荐在ZMI界面添加)。

15.6.2   产品在Plone中的安装脚本

在Zope对产品进行初始化之后，还需要一个安装脚本来控制产品在Plone上的安装。 因为Plone对产品的安装过程控制得更为细致一些，它使用外部模块来进一步控制安装状态， 也就是说Zope产品只要放在Products文件夹中就一定会被初始化， 可添加类型在Zope初始化过程中就会加入到Zope的可添加类型列表中去了。 而Plone使用外部方法install来控制一个产品以在web界面上操作它的安装状态， 这种方式的可用性更好。它的安装过程定义在Extensions/Install.py文件中：

from Products.Archetypes.public import listTypes
from Products.Archetypes.Extensions.utils import installTypes, install_subskin
from Products.ArchExample.config import PROJECTNAME, GLOBALS

from StringIO import StringIO

def install(self):
    out = StringIO()

    installTypes(self, out, listTypes(PROJECTNAME), PROJECTNAME)

    install_subskin(self, out, GLOBALS)

    out.write("Successfully installed %s." % PROJECTNAME)
    return out.getvalue()

首先也是导入一些函数和常量， 然后在install函数中调用了installTypes安装内容类型，安装后可在ZMI中的portal_types中查看到； 同时，install_subskin可以将skins文件夹中的子文件夹作为层安装到网站所有的皮肤中。

15.6.3   扩展产品目录结构

这里的ArchExample仅仅是一个示例产品， 如果你直接到Products目录中去看许多现有的产品的话， 可以看到产品的一般结构。

一组文件是README.txt, version.txt, HISTORY.txt, refresh.txt 这些文件通常是说明性的， 在README.txt中是产品介绍，version.txt是产品的版本号，Zope在初始化一个产品时会读取到， Changelog.txt/HISTORY.txt记录了产品的更改发布历史。

refresh.txt一般是个空文件， 但它对于Zope有着特别的意义。一般情况下，修改产品的代码，需要重新启动Zope才可以让代码生效。 Zope重新启动花费的时间比较长，这导致开发效率降低。在Zope提供了一个产品刷新机制，可不必重新启动Zope服务器，就应用新的代码。 如果产品目录中存在一个refresh.txt文件，在Zope的ZMI根下，进入Control_Panels/Products区域，可找到这个产品，进入refresh标签，便可刷新产品。

另一个重要的是content目录，这里存放产品的内容定义。在ArchExample产品中因为只注册了一种类型， 所以直接放在产品根目录的Article.py文件中。 在注册类型较多的情况下可以创建一个content目录，在里面存放各种新定义的类型， 并加上一个__init__.py文件使之成为一个Python包。

还有Extensions目录用于存放产品的外部方法，一般用于需要突破Zope对脚本的安全限制时， 这时可以Extensions中定义好外部方法。 Plone安装产品也是使用固定名称的Install.py中的install函数这个外部方法。

当为产品定义了不同的显示页面时，还需要skins目录， 通常是在skins目录中再按不同的用途分为多个子文件夹存放。

为了使用产品所增加类型的功能有更为清晰的描述，通常还需要一个interfaces.py文件， 或者当类型较多时将interfaces组织为Python包，即在interfaces目录中按所注册类型分别定义各个接口，

15.6.4   一个更完整的Archetypes产品示例

有另一个Archetypes的示例产品InstanceMessage，位于 http://svn.plone.org/svn/collective/InstantMessage/trunk。这个产品提供了发布即时消息的功能。

先看它的目录结构，这是一个标准的Archetypes产品的目录结构布局:

InstantMessage
|-- Extensions
|   `-- Install.py
|-- __init__.py
|-- config.py
|-- permissions.py
|-- content
|   |-- __init__.py
|   |-- message.py
|-- skins
|   `-- instantmessage
|       `-- instantmessage_view.pt
|-- tests
|   |-- __init__.py
|   |-- base.py
|   `-- test_setup.py
|-- README.txt
|-- refresh.txt
`-- version.txt

其中每一个文件名或目录的具体含义是：

• 在Extensions中存放的是外部方法，里面的Install.py是Plone安装脚本，
• __init__.py是Zope初始化使用的文件，同时也用于构成Python包，
• config.py用于各种产品配置用的全局变量，
• permissions.py是权限定义，这个产品中为了将权限划分为更充分， 使用一个单独的文件来存放，一般如果权限定义较少也可以直接写在config.py中
• content目录中定义各种内容类型，每种类型单独使用一个Python文件来定义， 里面的__init__.py的作用是使这个目录成为一个Python包
• skins目录用于存放皮肤文件，这里的instantmessage_view.pt 是InstantMessage内容类型的查看页面
• tests目录中的文件是单元测试，单元测试是一种新的开发软件的方法， 在下一章的Zope3产品开发中将作更详细的说明。
• 最后的三个文件中，README.txt是产品说明，refresh.txt是产品可刷新文件， version.txt中声明产品的版本号。

按传统命名并不是强制要求的，但按照符合传统的命名方法能使软件的意图清晰明了。

15.7.1   最简单的方法就是定制css类型

Archetypes默认生成的编辑或查看界面的HTML代码是很有规则的， 你可以在浏览器上查看生成的页面源代码， 发现默认的界面中的每一个字段都是有id和class定义的， 从css的知识可以知道，在自己的css文件中重新定义这些id或class都可以改变显示方式。

下面以改变body字段显示方式为示例， 因为下面的以页面模板方式的定制也是为了去掉在默认的base_view页面上显示的Body字段的Body标题部分。

Archetypes为内容生成的默认页面中给每一个字段以"archetypes-fieldname-字段名"的形式为id， 以ArchetypesTextAreaWidget为编辑界面的class，以ArchetypesField-StringField为查看界面的class， 根据这些规则可以自定义某个字段的样式了。

于是可以在皮肤目录中添加新的css文件，如命名为article-custom.css:

#archetypes-fieldname-body label {
  display: none;
}

这一段css是将以archetypes-fieldname-body为id的HTML标签内的label标签设置为不显示。

针对文件系统上的css需要在安装时做注册，但不必担心，安装的过程也很简单， 需要在安装脚本Install.py中增加几行代码就可以:

cssreg = getToolByName(portal, 'portal_css', None)
cssreg.registerStylesheet("article-custom.css")

如果getToolByName没有导入时则还需要:

from Products.CMFCore.utils import getToolByName

注意此时注册的css文件会对站点上所有的内容类型都会生效， 如果想只对article类型有效，则需要在注册时增加一个expression参数:

cssreg = getToolByName(portal, 'portal_css', None)
cssreg.registerStylesheet("article-custom.css",
    expression = "python:object.portal_type == 'article'")

15.7.2   定制整个显示视图

上面的定制css的方法可以改变一些Archetypes默认显示界面的外观， 但真正要改变显示页面的结构还是需要自己制作页面模板。

因为默认的base_view显示方法会将所有可显示的字段都按照顺序显示出来， 有时你需要以不同的排列方式或结构来显示它，因此你可以写定制的显示模板。 上面的的ArchExample产品中的article_view.pt文件正是使用了这种定制方法。 一般使用 ${contenttype}_view 的方式来命名，这虽然不是强制的标准， 但为了更容易被他人所理解，应该遵守这个规范。

这个页面模板的代码也是很少的，它使用了Plone的主模板，并在其中又定义了一个main宏， 这是它的内容:

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US"
      lang="en-US"
      metal:use-macro="here/main_template/macros/master">
  <body>
    <div metal:fill-slot="main">
      <div metal:define-macro="main"
           tal:omit-tag="">
        <h1 tal:content="here/title_or_id" />

        <!-- do as you will -->
        <tal:block tal:define="field_macro field_macro|here/widgets/field/macros/view;
                   mode string:view;
                   use_label python:1">
          <div tal:repeat="field python: here.Schema().filterFields(isMetadata=0)">
            <span tal:condition="python:field.getName() not in ['body']">
              <span metal:use-macro="field_macro"/>
            </span>
          </div>
        </tal:block>
        <span tal:content="structure python: here.getBody(mimetype='text/html')"/>

      </div>
    </div>
  </body>
</html>

先是以h1标签了文件的标题或id，然后在循环中依次显示每个字段，但除了body字段。 而将body字段留到最后单独显示。 这是对显示模板的一个简单定制，而且几乎与原始的base_view差不多， 因为Archetypes的默认显示方式base_view就是依次显示各个字段。 但需要时你总是可以使用任何页面模板技术来制作定制的显示模板。 在这里不仅所有的页面模板技术是可用的，因为使用了Plone的主模板， Plone的全局变量和工具函数也都是可用的，还有Archetypes的接口函数也是可用的， 因为here变量在这里就是相应的内容类型的实例，在类中定义的所有方法也在这里可用。 这个例子中还使用了Schema, getName, getBody等属于Archetypes提供的函数。

15.7.3   定制widget，使用不同于默认的显示器件

上面的定制显示模板的方法对于整个页面都要定制的情况很有用， 但有时只需要定制某个单独的字段的显示方式，这时可以采用更为灵活的方案就是定制显示器件模板。 因为一个显示器件有查看和编辑两种模式，这里可以为两种模式分别定义不同的显示器件。

在widget定义中设置 macro_view 是显示使用的器件，macro_edit是编辑时使用的器件。 这种方式就是在定义字段时使用一个现有的器件，但指定一个不同的初始化参数， 以定制的模板来代替macro_edit或macro_view，在这个参数上指定一个模板文件名。 然后在模板文件名中定义相应的命名为edit或view宏，Archetypes会找到并使用它。 这种方式就是要写好这些宏即可， 同样，在定义这些宏时，也可以使用到所有页面模板和Plone主模板所提供的可用的技术。

如上面的Article的定制显示页面模板的例子其实只是在显示Body字段时与默认的base_view有所不同， 因此定制了整个显示模板其实有点浪费，简单的办法是在定义语义时只定制掉macro_view的部分。

可以将Article.py中的语义定义部分修改为这样，在字段中使用widget时增加macro_view参数:

TextField('body',
...
          widget=RichWidget(label='Body',
                            macro_view='widget_article_body_view'),
          ),
),

显示部分就会采用widget_article_body_view器件。因此关键部分也就变成了这个显示器件的定义。 在皮肤文件夹中增加一个widget_article_body_view.pt文件，内容很简单：

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      i18n:domain="plone">
  <body>

    <metal:view_macro define-macro="view">
      <h1>主体内容</h1>
      <tal:block replace="structure accessor" />
    </metal:view_macro>

  </body>

</html>

只是在其中定义了一个名为view的宏，使用accessor显示出原来的内容。

15.7.4   自定义Widget: 显示控件

除了Archetypes自已所提供的显示器件，还有一些产品中提供了很多的显示或编辑器件， 在Plone的站点上已经有很多的显示控件产品， 都可以在 http://plone.org/products/by-category/widgets 找到。

当所有现有的显示控件还不满足要求时，还可以自定制显示控件。

自定义显示控件一般从某个已知的Widget为基类开始继承， 或者直接从所有Widget的基类即TypesWidget开始继承，

from Products.Archetypes.Widget import TypesWidget
from Products.Archetypes.Registry import registerWidget

class EmailWidget(TypesWidget):
   _properties = TypesWidget._properties.copy()
   _properties.update({
      'macro' : "email_template",
      'size' : '30',
      'maxlength' : '255',
      })

registerWidget(EmailWidget,
   title='String',
   description='Renders a clickable email field',
   used_for=('Products.Archetypes.Field.StringField',)
)

可以看到自定义Widget也同样简单，从TypesWidget开始继承， 并修改其中需要修改的属性， 一般将其中的macro属性修改使用自定义的模板， 这里使用的email_template是定义在产品的skins目录中一个特定的页面模板。

定义好之后只需要以Archetypes提供的函数registerWidget将它注册即可， 注意注册时使用所定义的Widget类名，然后是命名参数， 分别指定title, description, 是用于在使用时显示界面上的标题和描述信息的默认值， used_for参数则指定了只能使用于何种字段中。 如果需要使用特殊的属性还可以使用registerPropertyType来注册， 如TextAreaWidget类控件有一个特殊的属性append_only是使用这个语句来注册:

registerPropertyType('append_only', 'boolean', TextAreaWidget)

事实上如果查看Archetypes中的Widget.py的源代码就可以发现， Archetypes所提供的各种显示控件也都是从TypesWidget开始继承， 并定制其中需要的属性而做到的。 定制好的Widget就可以和Archetypes提供的器件相同地使用，只需要在使用时导入它们即可， 如上面的EmailWidget是声明用于StringField，就可以在定义StringField字段时使用:

# 导入Widget
email = StringField(
  'email',
  widget = EmailWidget()
)