Products.PloneFilesZip 1.2.0b1

可选产品

• ATContentTypes 0.2+，在Plone 2.0.x上

• AttachmentField 1.3+和基于AttachmentField的内容类型，如PloneExFile

• LinguaPlone 0.7+。如果检测到LinguaPlone，则用户将从首选语言的内容中下载文件。

警告

FileSystemStorage用户必须升级到2005/10/20之后的版本。

自定义字段

您可以创建并注册自己的检索器来自定义字段。查看 retrivers.py 了解我们如何处理 FileFields、ImageFields 和 AttachmentFields。

基本上，您只需要提供一个实现‘IFileRetriever’的类，并按如下方式注册：

try:
    from Products.PloneZipFiles import HAS_PLONE_FILES_ZIP
except ImportError, e:
    HAS_PLONE_FILES_ZIP = False
...
if HAS_PLONE_FILES_ZIP:
    from Products.PloneZipFiles.interfaces import IFieldRetriever
    from Products.PloneZipFiles.registry import GlobalRegistry

    class MyFieldRetriever:

        __implements__ = Products.IFieldRetriever

        field_type = 'my_field'

        def __init__(self, field, content):
            ...

        def fileName(self):
            ...

        def mimeType(self):
            ...

        def fileBody(self):
            ...

    GlobalRegistry.register(MyFieldRetriever)

查看‘interfaces.py’获取有关方法签名和文档的详细信息。

自定义类型

大多数基于 AT 的内容不需要为 PloneFilesZip 提供特定的支持。无论如何，如果您的内容类型不支持标准 AT 架构接口（这意味着‘your_content.Schema().fields()’不提供所有字段），则您的代码必须包括并注册一个自定义类型检索器，如下所示：

try:
    from Products.PloneZipFiles import HAS_PLONE_FILES_ZIP
except ImportError, e:
    HAS_PLONE_FILES_ZIP = False
...
if HAS_PLONE_FILES_ZIP:
    from Products.PloneZipFiles.interfaces import ITypeRetriever
    from Products.PloneZipFiles.registry import GlobalRegistry

    class MyTypeRetriever:

        __implements__ = Products.ITypeRetriever

        meta_type = 'my_type'

      def __init__(self, content):
          ...

      def getFieldRetrievers(self):
          ...

    GlobalRegistry.register(MyFieldRetriever)

查看‘interfaces.py’获取有关方法签名和文档的详细信息。

您可以在最新的 PloneArticle 产品中找到类型检索器的示例。

自定义内部结构策略

您可以自定义文件在 zip 存档中组织的方式。

您必须实现并注册一个实现 getZipFilePath 方法的 ZipStructurePolicy 类，该方法从文档容器路径、文件名和字段路径构建内部文件路径

container_path 是存储文件的 plone 文档的绝对路径 field_path 是文件字段在文档对象中的相对路径

您将在您的产品中包含一个类似于以下内容的 plone zip 策略模块

from Products.PloneFilesZip.interfaces import IZipStructurePolicy
from Products.PloneFilesZip.policies import AbstractZipStructurePolicy, PolicyRegistry

class MyZipStructurePolicy(AbstractZipStructurePolicy):
    '''
        The inner structure of the zip file
        corresponds to the inner structure of the objects.
    '''

    __implements__ = (IZipStructurePolicy,)

    id = 'my_policy_id'
    label = "Policy title"
    label_msgid = 'my_policy_title_i18n_msgid'
    help = "Policy help text"
    help_msgid = "my_policy_help_i18n_msgid"


    def getZipFilePath(self,
                    container_path=None,
                    file_name=None,
                    field_path=None,):
        ...

PolicyRegistry.registerPolicy(MyZipStructurePolicy)

查看‘interfaces.py’获取有关方法签名和文档的详细信息。

主干

• Eggification [glenfant]

• Plone 3 支持 [glenfant]

1.1.0RC2 - 2007/02/02

• 修复文件检索中的错误。在创建 BaseUnit 时附加 arg (full=True)，以确保我们获取整个文件而不是块文件（clebeaupin）

• 修复 DeepZipStructurePolicy:getZipFilePath 中的错误（在方法上添加 **kwargs）(clebeaupin)

1.1.0RC1 - 2007/02/01

• 添加策略 ContentZipStructurePolicy

• 关于新策略，如果文件在同一个内部存档目录中重复，则将重命名文件

• 添加策略来管理 zip 结构。策略可以在配置中配置

1.0.0 - 2006/10/16

• 添加了配置

1.0.0RC1 - 2006/09/24

• 首次公开发布