collective.examples.userdata 2.1

创建架构

我们以与其他架构相同的方式创建字段的架构

class IEnhancedUserDataSchema(model.Schema):
    country = schema.TextLine(
        title=_(u'label_country', default=u'Country'),
        description=_(u'help_country',
                      default=u"Fill in the country you live in."),
        required=False,
        )

扩展用户数据表单

要将此架构添加到表单中，我们需要为 UserDataPanel 定义一个表单扩展器，这允许我们注册任何我们想要的新字段

class UserDataPanelExtender(extensible.FormExtender):
    adapts(Interface, IDefaultBrowserLayer, UserDataPanel)
    def update(self):
        fields = field.Fields(IEnhancedUserDataSchema)
        fields = fields.omit('accept') # Users have already accepted.
        self.add(fields)

并在 configure.zcml 中进行注册

<adapter
  factory=".userdataschema.UserDataPanelExtender"
  provides="plone.z3cform.fieldsets.interfaces.IFormExtender" />

存储/检索自定义字段

为了将值与默认字段一起存储，我们需要向 profiles/default/memberdata_properties.xml 中添加字段。例如

<?xml version="1.0"?>
<object name="portal_memberdata" meta_type="Plone Memberdata Tool">
  <property name="country" type="string"></property>
</object>

我们在这里不定义“接受”字段，因为那只是用于注册。用户必须接受才能在系统中拥有用户。

在值可以通过表单读取和写入之前，需要一个数据管理器来检索值。默认管理器将读取/写入架构中定义的任何字段，因此大部分工作已经为您完成

from plone.app.users.browser.account import AccountPanelSchemaAdapter

class EnhancedUserDataSchemaAdapter(AccountPanelSchemaAdapter):
    schema = IEnhancedUserDataSchema

如果您想做些不同的事情，为该字段添加一个属性以覆盖默认行为。源代码显示了 birthdate 字段的示例。

最后，在 ZCML 中注册数据管理器

<adapter
  provides=".userdataschema.IEnhancedUserDataSchema"
  for="plone.app.layout.navigation.interfaces.INavigationRoot"
  factory=".adapter.EnhancedUserDataSchemaAdapter"
  />

定义注册字段表单扩展器

为 BaseRegistrationForm 注册扩展器将允许我们在任何位置向注册表单添加字段。这是以前的方式

class RegistrationPanelExtender(extensible.FormExtender):
    adapts(Interface, IDefaultBrowserLayer, BaseRegistrationForm)
    def update(self):
        fields = field.Fields(IEnhancedUserDataSchema)
        #NB: Not omitting the accept field this time, we want people to check it
        self.add(fields)

并在 configure.zcml 中进行注册

<adapter
  factory=".userdataschema.RegistrationPanelExtender"
  provides="plone.z3cform.fieldsets.interfaces.IFormExtender" />

数据管理器附加到架构，因此将与用户数据表单共享。如果我们使用了不同的架构，那么我们还需要定义另一个数据管理器。

“接受条款”字段

特殊情况是 accept 字段。这是一个布尔字段，对于注册是必需的。我们通过向架构添加一个 constraint 来实现它

def validateAccept(value):
    if not value == True:
        return False
    return True

class IEnhancedUserDataSchema(IUserDataSchema):
    # ...
    accept = schema.Bool(
        title=_(u'label_accept', default=u'Accept terms of use'),
        description=_(u'help_accept',
                      default=u"Tick this box to indicate that you have found,"
                      " read and accepted the terms of use for this site. "),
        required=True,
        constraint=validateAccept,
        )

因为这个字段在注册完成后可以忽略，所以我们没有将其添加到成员数据属性中。我们还将其从用户数据表单中隐藏。