安装产品后，如何在门户根目录添加经典 portlet？

Question

最简单的方法是什么？我将其添加到profiles/default 中的portlets.xml 文件中。现在，当我转到 @@manage-portlets 时，它可以在“添加 portlet”下拉列表中找到。但我需要它自动创建。

是否可以在我的配置文件/默认值的左右列中明确指定我想要的 portlet 集？

Answer 1

portlets.xml 文件执行一些不同的操作，注册可添加的 portlet 与实际添加 portlet 之间存在差异，这两者都可以在 portlets.xml 中完成。您需要使用“赋值”元素来添加 portlet：

<assignment
   manager="plone.rightcolumn"
   category="context"
   key="/plone"
   type="plone.portlet.static.Static"
   name="foo-portlet">
  <property name="header">Foo Portlet Title</property>
  <property name="text">Foo portlet contents...</property>
</assignment>

Answer 2

您可以通过 portlets.Classic portlet 注册您的经典 portlet，并使用 portlets.xml 文件中的 assignment 元素配置模板和宏名称：

<assignment
    manager="plone.rightcolumn"
    category="context"
    key="/"
    type="portlets.Classic"
    name="my-classic-portlet"
    visible="1">
  <property name="template">templatename</property>
  <property name="macro">macroname-found-in-template</property>
</assignment>

请参阅Plone.org 上 GenericSetup 手册的 Portlet 部分 或 原始 PLIP 了解有关 Portlet 分配和 GenericSetup 的详细信息。

这些属性与 portlet dataprovider 接口相匹配，请参阅 经典 Portlet 源代码，用于经典 Portlet 的接口定义。

Answer 3

对于没有经验的产品开发人员（甚至其他人）来说，实现这种自动化的最简单方法是：

1. 手动配置 o
   像任何其他常见的任务一样
   克隆用户/管理员，进入
   门户的根目录并添加
   您想要的 portlet。
2. 进入zmi->门户_设置->出口
   选项卡
3. 选择 portlet 步骤并
4. 使用 tar.gz 中的 portlets.xml 导出它
   得到。

这个 xml 包含您需要的所有内容：注册和分配...实际上，甚至还有更多的内容，因此清理其中不需要的内容可能是一件好事。