collective.uploadify 1.2

Plone集成

上传文件夹选项卡操作默认安装。您可以通过portal_quickinstaller或通过控制面板中的插件部分进行安装。

配置

以下设置可以在site_properties中完成。（请只使用字符串属性！）

• ul_auto_upload – true/false（默认：false）

  设置为true，如果您希望在文件被选中时上传文件。

• ul_allow_multi – true/false（默认：true）

  设置为true，如果您希望允许多个文件上传。

• ul_sim_upload_limit – 数字 1-n（默认：4）

  您希望允许的同时上传文件数量的限制。

• ul_queue_size_limit – 数字 1-n（默认：999）

  一次上传可以选择的文件数量的限制。

• ul_size_limit – 字节数（默认：空）

  代表每次上传字节数限制的数字。

• ul_file_description – 文本（默认：空）

  将在浏览对话框底部出现的文本。

• ul_file_extensions – 扩展名列表（默认：*.*;）

  您希望允许上传的文件扩展名列表。格式如*.ext1;*.ext2;*.ext3。使用此选项时需要FileDesc。

• ul_button_text – 文本（默认：BROWSE）

  您希望在默认按钮上出现的文本。

• ul_button_image – 图片路径（默认：空）

  浏览按钮将使用的图片路径。注意：如果您使用的是**不同大小的按钮图片*，您必须设置 ul_height 和 ul_width，否则 ul_button_image 将被拉伸到默认值（110x30）

• ul_hide_button – true/false（默认：false）

  如果想要隐藏按钮图片，请设置为 true。

• ul_script_access – always/sameDomain（默认：sameDomain）

  Flash 文件中脚本的访问模式。如果您正在本地测试，请设置为 `always`。

• ul_width – 数字（默认：110）

  使用不同大小的 ul_button_image 时应设置的 ul_width 值

• ul_height – 数字（默认：30）

  使用不同大小的 ul_button_image 时应设置的 ul_height 值

• ul_scale_image_size – x,y

  这两个值定义了图像的最大 x,y 尺寸（像素）。将图像按比例缩小到最多 ul_scale_image_size 大小，同时保持宽高比。例如：800,600 设置最大尺寸为 800x600 像素

• ul_content_field – Contenttype.field

  上传的文件将包含到特定的字段中，特定于 Contenttype。例如：File.file 上传到字段 file，内容类型为 File

添加自定义文件突变工具

如果您想在文件在门户中创建之前进行一些特殊处理，可以简单地注册一个新的提供 IFileMutator 接口的新工具。

在内容将在门户中创建之前，您的工具将使用 file_name, file_data, content_type 被调用。

<!-- An Utility to give images an "photo-" prefix -->
<utility component=".utility.prefix_image_filename"
         name="prefix-image-filename"/>

from zope import interface

def prefix_image_filename(file_name, file_data, content_type):
    """ Prefix all images with 'photo-<filename>'
    """
    # we only handle image files
    if not content_type.startswith("image"):
        return (file_name, file_data, content_type)

    if not file_name.startswith("photo"):
        file_name = "-".join(["photo", file_name])
    return (file_name, file_data, content_type)


interface.directlyProvides(prefix_image_filename,
                           IFileMutator)

针对特定 BrowserLayer 的定制

如果您安装了自己的基于其自身的 BrowserLayer（默认为 IThemeSpecific）的皮肤，并想定制 collective.uploadify 的外观和感觉，可以覆盖上传视图和/或上传初始化回调视图

• 自定义视图模板

  <configure
      xmlns="http://namespaces.zope.org/zope"
      xmlns:browser="http://namespaces.zope.org/browser">
  
      ...
  
      <!-- Customize collective.uploadify upload template -->
      <browser:page
          for="collective.uploadify.browser.interfaces.IUploadingCapable"
          name="upload"
          template="templates/upload.pt"
          permission="cmf.AddPortalContent"
          layer=".interfaces.IThemeSpecific"
          />
  
  </configure>

• 自定义初始化模板

  from zope.i18n import translate
  from zope.component import getMultiAdapter
  from collective.uploadify.browser.upload import UploadInitalize
  from my.product import MyMessageFactory as _
  
  
  class MyCustomUploadInitalize(UploadInitalize):
      """ Initialize uploadify js
      """
  
      def upload_settings(self):
  
          portal_state = getMultiAdapter(
              (self.context, self.request), name="plone_portal_state")
  
          settings = super(MyCustomUploadInitalize, self).upload_settings()
          settings.update(dict(
              ul_height = 26,
              ul_width = 105,
              ul_button_text = translate(_('Choose images'), target_language= \
                                         self.request.get('LANGUAGE', 'de')),
              ul_button_image = portal_state.navigation_root_url() + \
                  '/button_upload.png',
          ))
  
          return settings

  不要忘记使用以下方式为您的 themespecific browserlayer 注册新的上传初始化视图

  <configure
       xmlns="http://namespaces.zope.org/zope"
       xmlns:browser="http://namespaces.zope.org/browser">
  
     ...
  
      <browser:page
          for="*"
          name="upload_initialize"
          class=".uploadify.MyCustomUploadInitalize"
          permission="cmf.AddPortalContent"
          layer=".interfaces.IThemeSpecific"
          />
  
  </configure>

collective.uploadify 安装

要安装 collective.uploadify 到全局 Python 环境（或工作环境），使用传统的 Zope 2 实例，您可以这样做

• 当您阅读此内容时，您可能已经运行了 easy_install collective.uploadify。有关如何安装 setuptools（和 EasyInstall）的信息，请参阅：http://peak.telecommunity.com/DevCenter/EasyInstall

• 如果您正在使用 Zope 2.9（不是 2.10），请获取 pythonproducts 并通过以下方式安装它

  python setup.py install --home /path/to/instance

到您的 Zope 实例中。

• 在 /path/to/instance/etc/package-includes 目录中创建一个名为 collective.uploadify-configure.zcml 的文件。该文件应仅包含以下内容

  <include package="collective.uploadify" />

或者，如果您正在使用 zc.buildout 和 plone.recipe.zope2instance 脚本管理您的项目，您可以这样做

• 将 collective.uploadify 添加到要安装的 eggs 和 zcml 的列表中，例如

  [buildout]
  ...
  eggs =
      ...
      collective.uploadify
  
  zcml =
      ...
      collective.uploadify

• 重新运行 buildout，例如使用

  $ ./bin/buildout

更改日志

贡献者

Ramon Bartl，作者

Stefan Eletzhofer，InQuant GmbH

Harald Friessnegger，Webmeisterei GmbH

Daniel Widerin，Kombinat Media Gestalter GmbH

Nejc Zupan，NiteoWeb Ltd.

Jan Van Hees，K.U.Leuven

Kim Paulissen，K.U.Leuven

Rok Garbas，http://www.garbas.si

Philip Bauer，bauer@starzel.de