编辑“CMSware结点调用CMS NODE”

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

本标签对应的系统调用函数为CMS_NODE()。
{|border="1"
!属性
!必需
!默认值
!描述
|-
|colspan="4"|
<CMS action="NODE"  return="NodeVar" NodeID="" NodeGUID="" Tpl="" Cache="" returnKey="" />
|-
|NodeID
|是
| -
|
调用结点ID号
* NodeID=""：自动获取NodeID，包括内容页属于的父结点NodeID，或者结点首页归属的结点NodeID
* NodeID="self"：同上NodeID=""
* NodeID="parent"：自动获取NodeID的父结点NodeID
* NodeID="8"：获取NodeID为8的结点信息 
|-
|NodeGUID
|否
|""
|
调用结点唯一标识符
* NodeGUID="com.cmsware.news.global"：调用结点唯一标识符为 “com.cmsware.news.global"的结点 
注意：NodeGUID不能和NodeID同时使用，结点唯一标识符建议使用”域名.结点名“的形式以保证唯一性。(对于对外发布共享的结点更需要注意这点)
|-
|Tpl
|否
| -
|
指定调用的子模版
* Tpl="list_style_1.html"： 调用子模版“list_style_1.html”
|-
|Cache
|否
| -
|
模版中的CMS调用通过使用Cache,可以大幅提升批量更新的效率. 该标签只有门户版可用
* Cache="1"： 特别注意,只有模版公共调用的部分使用Cache 才有效果,比如内容页头部的导航NODELIST调用,或者top10之类的调用,结点首页的page-10分页调用最好不要用Cache, 因为不会提升任何效率.
|-
|returnKey
|否
| -
|
可以定义内容列表记录返回那些字段，一般列表只需要获得Title即可，而无需返回Content 等字段，使用此属性，可以一定程度上提高更新效能。 该标签只有门户版可用
* returnKey="Title,Keywords"：返回标题和关键词字段
|}
<br />
{|border="1"
!键名
!类型
!描述
|-
|colspan="3"|
返回1维数组($NodeVar)
|-
|NodeID
|int
|结点ID
|-
|TableID
|int
|结点归属的内容模型ID
|-
|NodeName(Name)
|string
|结点名称
|-
|NodeURL(URL)
|string
|结点首页URL地址
|-
|SubNodeID
|string
|所有子结点的ID串，比如'1%2%8%9%10%11%'
|-
|parentNodeID
|int
|父结点ID
|-
|Navigation
|array
|
结点当前位置的2维数组，你可以遍历这个数组生成结点的当前位置。
例如：
<pre>
[Navigation] => Array
(
  [1] => Array
            (
                        [NodeID] => 1
                        [Name] => 首页
                        [URL] => http://www.cmsware.net/index.html
            )
[2] => Array
            (
                        [NodeID] => 1
                        [Name] => 新闻
                        [URL] => http://www.cmsware.net/news.html
            )

)
</pre>
|}

'''例子 1:当前位置'''

效果图:
<div>
[[Image:cmsware160.gif]]
</div>
调用代码:
<pre>
<!--自动获取结点id，用于生成内容页的当前位置-->
当前位置：
<CMS action="NODE" return="NodeVar" />
<loop name="NodeVar.Navigation" key="key" var="var" >
<if test="$key == 0">
<a href="[$var.URL]"> [$var.Name] </a>
<else>
→ <a href="[$var.URL]"> [$var.Name] </a>
</if>
</loop>
</pre>
 
'''例子 2:当前结点信息'''

调用代码:
<pre>
<!--自动获取结点id，显示结点信息 -->
<CMS action="NODE" return="NodeVar" />
结点名称： [$NodeVar.NodeName]
结点首页地址： [$NodeVar.NodeURL]
</pre>
 
'''例子 3:特定结点信息'''

调用代码:
<pre>
<!--自动获取结点id，显示结点信息 -->
<CMS action="NODE" return="NodeVar" NodeID="8" />
结点名称： [$NodeVar.NodeName]
结点首页地址： [$NodeVar.NodeURL]
</pre>

'''例子 4:返回上一级'''

调用代码:
<pre>
<!--自动获取当前结点的父结点 id-->
<CMS action="NODE" return="NodeVar" NodeID="parent" />
<a href="[$NodeVar.NodeURL]"> 返回上一级</a>
</pre>




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


[[category:CMSware]]