collective.plonefinder 1.3.1

基本用法

此产品提供了一个用于zope3表单（zope.app.form）的参考小部件。

可以使用这个小部件在序列字段中存储对象引用。

在名为target_contents的元组字段中用作部件的示例

from collective.plonefinder.widgets.referencewidget import FinderSelectWidget

target_contents = schema.Tuple(title=u"Browse for contents",
                               description=(u"Choose contents to display "
                                            u"with a plone finder window."),
                               default=()
                               )

form_fields['target_contents'].custom_widget = FinderSelectWidget

调整一些属性

您可以使用FinderSelectWidget，并在您的AddForm或EditForm中使用update方法设置一些属性。以下是一个用于部件AddForm的示例

class AddForm(base.AddForm):
    """Portlet add form.
    """
    form_fields = form.Fields(IReferencesPortlet)
    form_fields['targets'].custom_widget = FinderSelectWidget
    label = u"Add References Portlet"

    def update(self):
        super(AddForm, self).update()
        self.widgets['targets'].typeview = 'image'
        self.widgets['targets'].forcecloseoninsert = 1

    def create(self, data):
        return Assignment(**data)

如果您愿意，您还可以传递一个上下文作为小部件的基，以便在查找器中打开当前或父文件夹。以下是一个使用update方法的示例

assignment = aq_parent(aq_inner(self.context))
self.widgets['targets'].base = aq_parent(aq_inner(assignment))

还有两个针对文件和图片的定制小部件。查看代码以创建您自己的特定小部件。

支持文件上传的文件引用示例代码

from collective.plonefinder.widgets.referencewidget import FinderSelectFileWidget

target_files = schema.Tuple(title=u"Browse for images",
                            description=(u"Choose files to display "
                                         u"with a plone finder window. "
                                         u"You can upload new files."),
                            default=()
                            )

form_fields['target_files'].custom_widget = FinderSelectFileWidget

支持图片上传的图片引用示例代码

from collective.plonefinder.widgets.referencewidget import FinderSelectImageWidget

target_images = schema.Tuple (title=u"Browse for images",
                              description=(u"Choose images to display "
                                           u"with a plone finder window. "
                                           u"You can select different image sizes. "
                                           u"You can upload new images."),
                              default= ()
                              )

form_fields['target_images'].custom_widget = FinderSelectImageWidget

注意，在最后一种情况下，数据存储图像uid和图像缩略图大小如下

'%s/%s' % (image.UID(), thumb_size_extension)

thumb_size_extension可以是'image_thumb'或'image_preview'…

因此，使用以下内容显示引用的图片

uid, variant = data.split('/')
'<img src="%s/resolveuid/%s/%s" />' % (portal_url, uid, variant)

自定义属性完整列表

如何在 WYSIWYG 编辑器中使用它

更简单的方法是创建一个特定的视图，因为您通常需要覆盖选择对象的 JavaScript 方法，因为每个编辑器都与浏览器有特定的协商。

请参阅 collective.ckeditor 包作为示例。

在自定义文件夹类型中上传

如果您希望让 plone 查找器用户在您的自定义或第三方文件夹类型中上传文件，您需要使用 IFinderUploadCapable 标记接口标记这些类型。如下面的自述 ZCML 示例所示

<class class="my.content.folderish.MyFolderish">
  <implements
     interface="collective.plonefinder.browser.interfaces.IFinderUploadCapable" />
</class>

默认情况下，collective.plonefinder 允许在 Plone 站点本身以及 ATFolder 和 ATBTreeFolder 中上传。

1.3.1 (2018-03-26)

• 修复缩略图大小选择：现在正确设置了完整大小图像。[bsuttor]

1.3.0 (2017-10-02)

• 使用 plone.api 而不是 IDirectoryFactory 创建文件夹，这防止了 dexterity 创建文件夹错误。新增依赖：plone.api。[bsuttor]

1.2.3 (2017-01-10)

• FinderImageWidget：启用快速上传。[gotcha]

1.2.2 (2016-08-15)

• FinderImageWidget：存储选择器而不是绝对 URL。[gotcha]

1.2.1 (2016-07-25)

• 添加缺失的分号以避免在 prod 模式下 portal_javascript 时出现 JS 问题。[gotcha]

• 添加检查值是否为 None（当添加图像后删除图像时）。[spereverde]

• 对 FinderImageWidget 中的 HTML 进行了一些重构以使其更清晰。[gotcha]

1.2.0 (2016-07-08)

• 添加 formlib FinderImageWidget；使用

  # in interface class
  picture = schema.TextLine(title=_(u'Picture'),
                             description=_(u'Optional picture'),
                             required=False)
  # in form class
  form_fields['picture'].custom_widget = FinderImageWidget

  [gotcha]

1.1.4 (2016-03-30)

• 修复在 finder 的查询表单序列化中带有特殊字符的 bug。[pgrunewald]

1.1.3 (2016-03-24)

• 添加 openuploadwidgetdefault 选项，以便能够指定是否希望在默认情况下打开上传小部件，而无需单击“文件快速上传”按钮。[gbastien]

1.1.2 (2016-03-15)

• 添加 showsearchbox 选项，以便能够轻松显示/隐藏搜索框。[gbastien]

1.1.1 (2016-02-23)

• 重新应用 1.0.2 中的修复，这些修复可能在迁移到 github 中丢失。[gotcha]

1.1.0 (2016-02-16)

• 使用获取图像的新方法。调用 /@@images/image/preview 而不是 /image_preview。[bsuttor]

• 通过 IFinderUploadCapable 添加 plone.app.contenttypes.content.Folder 的实现。[bsuttor]

• 为 plone.app.contenttypes 图像提供基本支持。[kiorky]

1.0.7 (2014-09-15)

• 修复：使用 ckeditor 时，新闻条目的链接不再链接到其图像。1.0.4 中的修复在 1.0.5 中丢失。[gotcha]

1.0.6 (2014-03-05)

• 修复错误的引号测试。[bsuttor]

1.0.5 (2014-03-05)

• 修复创建对象时的作用域容器。容器是第一个非 portal_factory 对象。[bsuttor]

• 大量代码简化（尚未完成，grep for “FIXME:”）。[glenfant]

• 在 README 中添加更多文档（解释所有相关用法）。[glenfant]

• 所有可能的文件中的 SVN 标记。[glenfant]

• 大量优化（尚未完成，grep for “FIXME:”）。[glenfant]

• 在代码中注释了晦涩的功能。[glenfant]

• 修复 image 字段为 reference 类型的场景。[toutpt]

1.0.4 (2013-09-09)

• 修复：使用 ckeditor 时，新闻条目的链接不再链接到其图像。[gotcha]

1.0.3 (2013-06-12)

• 与 Plone 4.3 的兼容性。[toutpt]

1.0.2 (2011-08-19)

• 始终在导航列中显示完整站点结构。[spereverde, yulka, gotcha]

• 在面包屑导航中，避免链接到用户没有查看权限的文件夹。[spereverde, yulka, gotcha]

1.0.1

• CSS IE7 修复 macadames - 2010/09/22

• finder.pt：模板修复缺少 doctype macadames - 2010/09/22

• finder.pt：从 html 标签中删除 lang 属性 - 我们不需要它，并且在 Plone3 / Plone4 之间难以维护 macadames - 2010/09/26

1.0.0

• 使用 Plone 快速上传作为上传工具 - 新增依赖 collective.quickupload macadames - 2010/09

1.0.0-b2

• 修复在使用 FinderSelectWidget 编辑表单时发生的未授权错误，当用户没有权限访问某些引用内容时。在这种情况下，对象不会被从列表中删除，而是显示对象标题的消息：“%s : %s” % (_(u“您没有权限访问此对象”))，uid)

• 添加：当 self.multiselect = False 或 self.forcecloseonsinsert = False 时关闭窗口

• 修复当标题中有引号时的 selectItem

• 添加了用于打开文件夹的引用小部件的 base 属性。

• 在参考小部件中使用Unicode字符表示上下箭头。

• 允许通过请求和参考小部件更改图像类型。

• 为Plone3内容类型图标添加了生成的CSS。

• 在浏览器中添加了新属性self.filestypes。

• 在查找器中为文件类型添加了MIME类型图标。

• FinderSelectWidget：当找不到对象时不再引发错误，而是用消息替换标题（UID不存在的对象）。

• 修复了allowupload的回归问题（从未允许）macadames - 2010/07/21

• 修复了使用请求或self.browse = False启用/禁用浏览的问题 macadames - 2010/07/22

• 当浏览被禁用时，不要在另一个路径上搜索 macadames - 2010/07/22

• 使用jQuery.uploadify添加了多个上传的标题字段 macadames - 2010/07/24

• 当可能时，使用cookie进行闪存上传的认证（与collective.uploadify相同的方法），否则使用票据（PloneFlashUpload方法）macadames - 2010/07/28

• 使用标准archetypes方法“invokeFactory”，通过上传的文件创建新对象，以遵守完整的Plone createObject过程。macadames - 2010/07/28

• 在请求中添加了新的mediaupload键，用于设置上传的内容类型（与jQuery.uploadify非常实用）macadames - 2010/07/28

• 改进了jQuery.uploadify的过程，增加了错误处理macadames - 2010/07/29

• 添加了新的CSS类required，用于在Plone4上显示图标（icons-on）macadames - 2010/07/31

• 修复了Plone4上的上传按钮样式 macadames - 2010/07/31

• 修复了Plone3或Plone4 +经典主题的一些CSS样式 macadames - 2010/07/31

• 设计改进 macadames - 2010/07/31

• 法语翻译正在进行中 macadames - 2010/07/31

• 使用InavigationRoot作为查找器根，不再使用IPloneSiteRot macadames - 2010/08/01

• 设计改进，蓝色是新的颜色 macadames - 2010/08/01

• 添加了新的视图属性root和rootpath，用于更改浏览器根 macadames - 2010/08/02

• 添加了真正的左侧导航树 macadames - 2010/08/02

• 将属性视图中的持久化对象替换为数据字典，即self.data['root']而不是self.root macadames - 2010/08/04

• 当作用域是主题时，使用topic queryCatalog macadames - 2010/08/04

• 添加了对z3c.autoinclude的支持 macadames - 2010/08/20

1.0.0-b

• 在查找器中显示的图像大小来自门户属性图像属性，如果存在的话

• 选择图像大小：添加了上下文菜单

• 许多IE修复和外观更改

• Plone4图标样式也在Plone3下使用

• 为zope3表单添加了参考对象小部件（可用于部件中）

1.0.0-a

• 初始发布