Products.SimplePortlet 1.2

关于

SimplePortlet是一个让用户在Plone中创建自己的组件的产品。它添加了三种内容类型，即组件、智能文件夹组件和RSS组件。将这些对象添加到文件夹中，它将显示为左侧或右侧的组件。除了标题、描述和一些丰富内容外，您还可以控制它在哪个列中显示，是否应在子文件夹中显示，以及是否应显示。智能文件夹组件显示指定智能文件夹的附加结果，RSS组件允许您选择CMFSin频道（如果已安装）。

SimplePortlet基于archetypes，因此必须在您的系统上安装。

安装

有关安装说明，请参阅docs/INSTALL.txt。

使用方法

安装后，已在plone-root中添加了两个新的经典组件

• ‘here/portlet_simpleportlet/macros/portlet_left’

• ‘here/portlet_simpleportlet/macros/portlet_right’

这两个新条目在插槽中是实际宏，用于显示用户定义的组件。它们作为占位符，在运行时将在当前文件夹（以及父文件夹以适应继承）中检查是否有组件要显示。因此，从插槽定义中删除这些占位符也将禁用自定义组件的显示！这很重要。

当然，通过更改这些插槽属性中的顺序，您可以控制自定义组件的显示顺序。

注意：具有与层次结构中较高位置的组件相同ID的组件将覆盖它。这使您能够关闭在树中定义较高的组件。只需创建一个具有相同ID的空组件，并将其设置为不显示即可。

与SimplePortlet一起，还有一个布局编辑器，它作为文件夹上的一个额外标签页呈现。这个标签页称为“端口”，它提供了一个表单来更改该文件夹及其子文件夹中端口显示的方式。端口是从上级文件夹继承的。使用布局编辑器，您可以通过创建本地定义来覆盖这种继承。此定义也适用于子文件夹，因为它们在其部分也继承端口（除非您还将其关闭）。

因此，每个列都有自己的选项集，并允许您创建一个新的顺序或定义哪些端口应该显示。只需在任一文本区域中键入可用的端口之一即可。每行一个端口！不要忘记包括用户定义的端口。

SimplePortlet只允许使用所谓的友好端口名称。因此，您不必输入“here/portlet_about/macros/portlet”，只需输入“about”即可。管理员可以在ZMI的portlet_manager属性标签页中添加或更改这些友好名称及其关联的真实路径。id是友好名称，值是完整路径。确保您以字符串的形式添加新属性。

在安装过程中，SimplePortlet会扫描所有文件夹对象，以寻找正在使用的端口，并尝试在portlet_manager工具中注册它们。您可以亲自检查SimplePortlet提出的友好名称是否适合您。

布局表单仅接受这些友好名称以保护用户免输入错误名称，这至少会破坏当前文件夹。当发生这种情况时，您将不得不作为管理员在ZMI中转到该文件夹并更改该文件夹的属性（left_slots和right_slots）。

开发者

如果您有一个也有端口的产品的产品，您可以在安装脚本中将它们注册到您的portlet_manager中

# register our portlets to SimpePortlet's portlet manager if it exists
try:
    pm = self.portlet_manager
except:
    pm = None
if not pm==None:
    pm.registerPortlet('<friendlyName>', '<path like here/myportlets/macros/portlet>')

在您卸载脚本中

#unregister portlets
try:
    pm = self.portlet_manager
except:
    pm = None
if not pm==None:
    pm.unRegisterPortlet('<friendlyName>')

我希望您会喜欢这个产品，但请自行承担风险！请先备份！

注意

在卸载时，SimplePortlet将尝试删除每个文件夹的left_slots和right_slots中的所有对SimplePortlet端口的引用（见上面的两个端口）。这意味着当您再次安装SimplePortlet时，您将不得不转到具有引用的文件夹并恢复它们，以便自定义端口再次显示。

CSS样式

（由Osma Suominen实现，osma.suominen@mbconcert.fi）可以为自定义端口定义一组CSS样式。在创建/修改端口时，可以从列表中选择样式。想法是在例如ploneCustom.css中具有匹配的CSS类定义。要启用样式选择，将一些CSS类的名称写入portlet_manager（如果不存在则创建）中名为‘conf_portlet_styles’的行属性。条目可以是具有以下形式的class:visiblename的纯类名，以便您可以拥有用户“友好”的样式名称。当选择样式“mystyle”时，结果端口HTML代码将开始于<div class="portlet mystyle">。

主题显示（由clebeaupin实现，由Osma Suominen移至单独的类型主题端口）主题的内容可以列出在端口中。这需要AT内容类型或某些其他基于AT的主题类型。您可以选择一个主题和要显示的最大条目数。

作者

• Danny Bloemendaal - danny.bloemendaal@companion.nl - _ender_@#plone.irc