编辑“CMSware内容调用CMS CONTENT”

<span style="border:1px solid #000; float:right; text-align:center; padding:6px;"><strong>导航：</strong>[[CMSware模板制作指南#模板调用|返回上一页]]</span>
<div style="clear:both;"></div>
该调用标签可实现对已发布的特定文章内容的调用.

本标签对应的系统调用函数为CMS_CONTENT()。
{|border="1"
!属性
!必需
!默认值
!描述
|-
|colspan="4"|
<CMS action="CONTENT" return="Var" IndexID="" LoopMode="" Tpl="" Cache="" returnKey="" />
|-
|IndexID    
|是
| -
|
* IndexID="180"调用一篇文章，返回一维数组;后续参数指定 LoopMode="1"时返回2维数组
* IndexID="1,2,18,16"调用多篇文章，返回2维数组
|-
|LoopMode 	 	 	
|否
| -
|
便于将返回值统一为2维数组
* LoopMode="1"： 在只有一条返回值时也生成二维数组；IndexID为变量时必须加上该参数
|-
|Tpl
|否
| -
|
指定调用的子模版
* Tpl="list_style_1.html"： 调用子模版“list_style_1.html”
|-
|Cache
|否
| - 
|
模版中的CMS调用通过使用Cache,可以大幅提升批量更新的效率. 该标签只有门户版可用
* Cache="1"：设置是否使用缓存，“1”为使用。 特别注意,只有模版公共调用的部分使用Cache才有效果,比如内容页头部的导航NODELIST调用,或者top10之类的调用,结点首页的page-10分页调用最好不要用Cache, 因为不会提升任何效率.
|-
|returnKey
|否
| -
|
可以定义内容列表记录返回那些字段，一般列表只需要获得Title即可，而无需返回Content 等字段，使用此属性，可以一定程度上提高更新效能。 该标签只有门户版可用
* returnKey="Title,Keywords"：返回标题和关键词字段

|}

'''例子 1:调用一篇文章'''

调用代码:
<pre>
<CMS action="CONTENT" return="var" IndexID="68" />
<!--调用文章 IndexID为68的记录-->
标题： [$var.Title]
简介： [$var.Intro]
内容： [$var.Content]
链接： [$var.URL] 
</pre>

'''例子 2:调用多篇文章'''

调用代码:
<pre>
<CMS action="CONTENT" return="List" IndexID="1,2,18,16" />
<!--调用文章IndexID为 1,2,18,16 的记录-->
<loop name="List" var="var" key="key" >
标题： [$var.Title]
简介： [$var.Intro]
内容： [$var.Content]
链接： [$var.URL]
</loop>
</pre>
 
'''例子 3:调用多篇其它结点内容'''

调用代码:
<pre>
<CMS action="CONTENT" return="List" IndexID="{$OtherNodeContent}" LoopMode="1" />
<!--调用文章IndexID来自$OtherNodeContent这个变量，例如$OtherNodeContent="1,2,18,16"，此时必须使用LoopMode="1"以免返回值只有一条时出错-->
<loop name="List" var="var" key="key" >
标题： [$var.Title]
简介： [$var.Intro]
内容： [$var.Content]
链接： [$var.URL]
</loop>
</pre>
 
'''例子 4:调用自定义相关文章'''

调用代码:
<pre>
<ul>
<!--如果存在自定义相关文章，则调用之-->
<if test="!empty($CustomLinks)">
<CMS action="CONTENT" return="List" IndexID="{$CustomLinks}" LoopMode="1" />
<!--调用自定义相关文章，此时必须使用LoopMode="1"以免返回值只有一条时出错-->
<else>
<!--自定义相关文章为空，则使用SEARCH调用根据文章设置的关键字自动获取相关文章列表-->
<CMS action="SEARCH" return="List" NodeID="{$NodeID}" Field="Keywords" Keywords="{$Keywords}" Num="10" Separator="," IgnoreContentID="{$ContentID}" />
</if>

<!--开始显示相关文章-->
<loop name="List" var="var" key="key" >
<!--为了便于排版，下面“if”部分指定自定义相关文章的条数：如果不到10条，有多少条就显示多少条；如果多于10条的，就只显示10条-->
<if test="key<10" >
[$var.Title]
</if>
<li>
·<a href="[$var.URL]" title="[$var.Title]">
[@CsubStr($var.Title,0,25)]
</a>
</li>
</LOOP>
</ul>
</pre>





==参考来源==
*[http://www.lonmo.com/cmsware/manual/ 参考来源]


[[category:CMSware]]