创建插件标记

使用插件标记来引用呈示插件。请从预安装的呈示插件中进行选择,或者选择您自己的定制插件。

关于此任务

插件标记的格式为:

[plugin:pluginname paramKey="paramVal" compute=" " htmlencode=" " start=" " end=" "]
Tag Body Content
[/plugin:pluginname]

要创建插件标记:

过程

  1. 从演示模板、组件或元素设计字段中单击插入标记。将打开标记助手对话框。
  2. 选择插件组件作为标记类型。
  3. 选择插件类型。
  4. 选择要引用的插件。将显示有关该插件的信息和有效参数。
  5. 选择是否包含开始和结束部分。您可以在标记和诸如组件或元素标记之类的其他 Web 内容标记的开始和结束部分之间输入其他文本。
  6. 单击确定以将标记添加到您的导航器设计中。
  7. 然后可以将定制参数添加到标记设计。 将标记添加到设计中之后,您还可以向标记添加下列参数:
    表 1. 其他标记参数. 该表列出了可以手动添加到此标记的其他参数。
    标记参数 详细信息
    compute=" " 如果未指定,那么缺省设置为“always”,意味着每次标记呈现在列表(如菜单或导航器组件)中时,都将对插件标记进行求值。使用 compute="once" 以仅对标记求值一次。
    htmlencode=" " 如果 htmlencode="true",那么保留的 HTML 字符将转换为字符实体。例如,“<”将转换为“&lt;”。 如果要防止用户添加恶意代码或使用 HTML 更改其文本设计,那么此参数非常有用。

    如果未指定,那么将使用 WCM WCMConfigService 服务中的 cmpnt.htmlEncodeDefault 属性指定的缺省设置。缺省情况下,此属性设置为 true。

    start=" "

    end=" "

    start 和 end 属性用于将标记返回的数据打包到 HTML 等其他标记中。这些属性不是必需的。
    简单标记
    要无需指定任何参数或标记主体内容即可引用插件,请执行以下操作:
    [plugin:pluginname]
    简短标记

    您可以将插件标记简化为:[pluginname]

    缩短的插件标记无法替换现有 Web 内容标记。 例如,如果您创建一个名为“Property”的插件,那么必须使用完整标记:[Plugin:Property]。将标记 [Property] 视为属性标记,而非插件标记。

    带有参数的简单标记
    要引用带有参数但不带有标记主体内容的插件,请执行以下操作:
    [plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2"]
    以 Web 内容标记作为参数的插件标记
    [plugin:pluginname paramKey1="[IDCmpnt context='current' type='sitearea' field='id']"]
    注: 必须在用作参数值的 Web 内容标记内使用单引号。
    带有主体内容的插件标记
    要引用带有参数和内容(包括对组件的引用)的插件,请执行以下操作:
    [plugin:pluginname paramKey1="paramVal" paramKey2="paramVal" paramKey2="paramVal2"]
    This is the tag body content.
    <br>
    [component name="test"]
    <br>
    More content.
    [/plugin:pluginname]

更多信息

这些状态包含不同插件的相关信息。