内容插件

内容插件可以与当前内容项配合使用。

“分析数据”插件

• 此插件用于写入适合于活动站点分析的信息。
• 例如：[Plugin:AnalyticsData property="title" css-class="asa.wcm.content_item.title"]

“复制文本”插件

• 此插件用于一次或多次写入文本。
• 此插件的语法为 [Plugin:CopyText text="" count="" separator="" format="trim | tolower | toupper" escape="xml | json | none"]。

If List Index 插件

• 此插件用于编写基于计数的附带主体标记，在此标记中，当前项位于菜单、导航器、搜索、个性化或分类法组件的呈示中。如果当前计数介于指定的数字之间并且受值“by”限制，那么此插件将呈示主体。列表中第一项具有计数 1。如果不需要下限或上限，那么可以忽略“from”和“to”值。
• 例如：
  • [Plugin:ifListIndex is='2'] 呈示第二项的主体。
  • [Plugin:ifListIndex from='2'] 呈示从第二项开始的所有项的主体。
  • [Plugin:ifListIndex to='3'] 呈示直到第三项为止的所有项的主体。
  • [Plugin:ifListIndex from='2' to='8'] 呈示从第二项到第八项的主体。
  • [Plugin:ifListIndex from='1' by='2'] 或 [Plugin:ifListIndex by='odd'] 呈示所有奇数项的主体。
  • [Plugin:ifListIndex from='2' by='2'] 或 [Plugin:ifListIndex by='even'] 呈示所有偶数项的主体。

If Count Index 插件

• 此插件类似于 ifListIndex 插件。此插件用于编写基于计数的附带主体标记，在此标记中，当前项位于呈示 IfCountIndex 插件的菜单、导航器、搜索、个性化或分类法组件的呈示中，但仅对菜单、导航器、搜索、个性化或分类法组件中可见的项进行计数。如果当前计数介于指定的数字之间并且受值“by”限制，那么此插件将呈示主体。列表中第一项具有计数 1。如果不需要下限或上限，那么可以忽略“from”和“to”值。
• 例如：
  • [Plugin:ifCountIndex is='2'] 呈示第二个计数项的主体。
  • [Plugin:ifCountIndex from='2'] 呈示从第二个内容项开始的所有计数项的主体。
  • [Plugin:ifCountIndex to='3'] 呈示直到第三个计数项为止的所有计数项的主体。
  • [Plugin:ifCountIndex from='2' to='8'] 呈示从第二个计数项到第八个计数项的主体。
  • [Plugin:ifCountIndex from='1' by='2'] 或 [Plugin:ifCountIndex by='odd'] 呈示所有奇数计数项的主体。
  • [Plugin:ifCountIndex from='2' by='2'] 或 [Plugin:ifCountIndex by='even'] 呈示所有偶数计数项的主体。

表 1.

项	列表中呈示的 IfCountIndex 标记	If List Index 插件使用的计数方法	If Content Index 插件使用的计数方法
项 1	否	1	无
项 2	是	2	1
项 3	是	3	2
项 4	否	4	2

“JavaScript 和 XML 编码”插件

• 此插件用于对 JavaScript 或 XML 进行编码。
• 例如：[Plugin:jsencode enc="js|xml|jsxml" value="myValue"]

“评级”插件

• 此插件用于对内容项的评级选项提供支持。
• [Plugin:ratings]

“远程操作”插件

• 用于为远程编写操作创建 URL。
• 例如：[Plugin:RemoteAction action="edit" useCurrentContext="true" dialog="true"]

“标记”插件

• 此插件用于提供对内容项的标记支持。
• [Plugin:tags]

“文本提供程序”插件

• 用于写入来自文本提供程序的值。
• 插件的语法为 [Plugin:TextProvider provider="" key="" defaultValue="" param.0="" param.1="" param.X=""]，其中“provider”参数必须设置为文本提供程序的名称，并且“key”参数必须设置为应检索的关键字。
• 如果未设置任何提供程序，那么将使用为当前内容的标题设置的文本提供程序。
• 可选参数“defaultValue”可用于在文本提供程序未返回结果的情况下设置写入的值。否则，此插件不会写入任何内容。
• 文本中的占位符会替换为插件标记中指定的所有可选参数的值。
• 从 CF09 开始，您也可以使用此标记的标记别名“Localized”。如果此标记仅用来呈现本地化文本，那么这种方式更为合适。例如：[Plugin:Localized provider="translated" key="title"]。
• 
  如果打算在组件设计或演示模板设计中多次使用 TextProvider 插件标记，您可以用一个标记指定缺省文本提供程序名称路径：

  [Plugin:TextProvider defaultProvider="library/sitearea/contentitem"]

  然后，可以忽略紧跟在缺省提供程序标记后的标记中的提供程序参数：

  [Plugin:TextProvider defaultProvider="library/sitearea/contentitem"]
  [Plugin:TextProvider key="key1"]
  [Plugin:TextProvider key="key2"]
  [Plugin:TextProvider key="key3"]

  在所有演示模板设计和组件设计（包括通过使用标记（如组件标记）包含的组件设计）中应用缺省提供程序。

  要除去缺省提供程序，请使用：

  [Plugin:TextProvider defaultProvider=""]