Products.SimplePortlet 1.2

关于

SimplePortlet是一个允许用户在Plone中创建自己的Portlet的产品。 它添加了三种内容类型，称为portlet、智能文件夹portlet和rssportlet。 将这些对象添加到文件夹将在左列或右列中将其显示为portlet。 在标题、说明和一些丰富的内容旁边，您还可以控制它在哪个列中 必须显示，如果它应该显示在子文件夹中，以及是否应该显示它。 智能文件夹portlet显示指定的智能文件夹和rssportlet的附加结果 允许您选择CMFSin频道（安装时）。

SimplePortlet基于原型，因此必须安装在系统上。

安装

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

用法

安装后，两个新的经典portlet被添加到plone根目录：

• 'Here/Portlet_SimplePortlet/Macros/Portlet_Left'
• 'here/portlet_simpleportlet/macros/portlet_right'

插槽中的这两个新条目是显示用户定义的portlet的实际宏。它们充当占位符 在运行时，他们将签入当前文件夹（和父文件夹以适应继承） 以查看是否有要显示的portlet。所以，从插槽定义中移除这些占位符 还将禁用自定义portlet的显示！这很重要。

当然，通过更改这些插槽属性中的顺序，可以控制顺序中的位置 将显示自定义portlet。

注意 ：具有与更高层次结构上的portlet相同id的portlet将否决它。 这使您能够关闭树中较高位置定义的portlet。 只需创建一个具有相同id的空portlet并将其设置为不显示即可。

与SimplePortlet一起出现的还有一个布局编辑器，它作为文件夹上的额外选项卡显示。 该选项卡称为"portlets"，并提供一个表单来更改portlets的显示方式 对于该文件夹和子文件夹。Portlet继承自更高的文件夹。 使用布局编辑器，您可以通过创建本地定义来否决此继承。 对于子文件夹，此定义也处于活动状态，因为它们继承portlet 就他们而言（除非你也为他们关闭了它）。

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

SimplePortlet只允许使用所谓的友好Portlet名称。 因此，不必键入"here/portlet about/macros/portlets"，只需键入"about"。 管理员可以添加或更改这些友好名称及其关联的真实路径 在ZMI的Portlet_管理器的属性选项卡中。id是友好名称和值 是完整的路径。确保将新属性作为字符串添加。

在安装期间，SimplePortlet扫描所有Folderish对象以搜索Portlet 正在使用并试图在Portlet_管理器工具中注册它们的。你可以查一下 看看SimplePortlet提出的友好名称是否是 对你来说足够了。

布局表单只接受这些友好名称，以保护用户在 错误的名称将至少中断当前文件夹。 当这种情况发生时，您必须以管理员的身份转到该文件夹 并更改该文件夹的属性（左插槽和右插槽）。

开发商

如果您的产品也有portlet，则可以在安装脚本中向portlet_管理器注册它们：

# 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将尝试删除每个文件夹左插槽和右插槽中对SimplePortlet的所有引用 portlet（请参见上面的两个portlet）。这意味着当你再次安装SimplePortlet时，你必须 恢复到具有引用的文件夹，以便再次显示自定义portlet。

CSS样式

（由osma suominen实现， osma suominen @ mbconcert fi ） 可以为自定义portlet定义css样式列表。创建/修改portlet时，可以选择样式 从名单上。其思想是在plonecustom.css中有匹配的css类定义。要启用样式选择，请写入名称 将一些css类转换成portlet管理器中名为"conf_portlet_styles"的lines属性（如果不存在则创建它）。 条目可以是表单class:visiblename的纯类名，这样就可以为用户提供"友好"的样式名。 当选择样式"mystyle"时，生成的portlet html代码将以<；div class="portlet mystyle">；开头。

主题显示（由clebaupin实现，由osma suominen移动到单独类型的主题portlet） 主题的内容可以在portlet中列出。这需要at内容类型或其他at基主题类型。你可以选择 要显示的主题和最大条目数。

作者

• 丹尼·布洛门达尔- 丹尼 blomendaal @ 同伴 nl - @