使用插件标记来引用呈示插件。请从预安装的呈示插件中进行选择,或者选择您自己的定制插件。
关于此任务
插件标记的格式为:
[plugin:pluginname paramKey="paramVal" compute=" " htmlencode=" " start=" " end=" "]
Tag Body Content
[/plugin:pluginname]
要创建插件标记:
过程
- 从演示模板、组件或元素设计字段中单击插入标记。将打开标记助手对话框。
- 选择插件组件作为标记类型。
- 选择插件类型。
- 选择要引用的插件。将显示有关该插件的信息和有效参数。
- 选择是否包含开始和结束部分。您可以在标记和诸如组件或元素标记之类的其他 Web 内容标记的开始和结束部分之间输入其他文本。
- 单击确定以将标记添加到您的导航器设计中。
- 然后可以将定制参数添加到标记设计。 将标记添加到设计中之后,您还可以向标记添加下列参数:
表 1. 其他标记参数. 该表列出了可以手动添加到此标记的其他参数。| 标记参数 |
详细信息 |
| compute=" " |
如果未指定,那么缺省设置为“always”,意味着每次标记呈现在列表(如菜单或导航器组件)中时,都将对插件标记进行求值。使用 compute="once" 以仅对标记求值一次。 |
| htmlencode=" " |
如果 htmlencode="true",那么保留的 HTML 字符将转换为字符实体。例如,“<”将转换为“<”。
如果要防止用户添加恶意代码或使用 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]