编辑“Siteserver-stl:sites获取站点列表”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[Siteserver二次开发指南|上一页]]</span>
<div style="clear:both;"></div>

'''stl:sites 获取站点列表'''

*获取站点列表并显示在页面上。

'''属性列表'''

下表显示所有属于此元素的属性列表。

{| border="1" cellpadding="0" cellspacing="0"
|-
! 属性
! width="18%" | 可能的取值
! width="18%" | 默认值
! 简介
|-
| <nobr>siteName</nobr>
| &nbsp;
| &nbsp;
| 站点名称
|-
| directory
| &nbsp;
| &nbsp;
| 站点文件夹
|-
| totalNum
| &nbsp;
| &nbsp;
| 设置列表一共显示多少个站点，不设置将显示所有站点。
|-
| startNum
| &nbsp;
| 1
| 从第几个站点开始显示，默认从第一个站点开始显示。
|-
| scope
| &nbsp;
| &nbsp;
| 站点显示范围。此属性只可属于以下可能的取值的一种。
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Children
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 显示下级站点的列表
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Descendant
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 显示下级及下下级站点的列表
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | All
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 显示所有站点的列表
|-
| order
| &nbsp;
| &nbsp;
| 站点列表排序方式。
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Default
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 默认排序，显示与CMS后台站点相同的排序
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Contents
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 按站点中内容数进行排序
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Hits
| bgcolor="#ffffcc" |√ 
| bgcolor="#ffffcc" | 按站点中页面的点击量进行排序
|-
| since
| &nbsp;
| &nbsp;
|时间段，<span>格式为&ldquo;数字+日期符号&rdquo;，日期符号有&quot;y&quot;、&quot;m</span><span>&quot;、&quot;d&quot;及&quot;h&quot;，分别代表年、月、天及小时</span></span><span>。</span>
|-
| where
| &nbsp;
| &nbsp;
| <span>获取站点列表的条件判断</span>
|-
| columns
| &nbsp;
| 1
| <span>列数，默认显示一列</span>
|-
| direction
| &nbsp;
| &nbsp;
| <span>方向</span>
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Vertical
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 垂直
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Horizontal
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 水平
|-
| layout
| &nbsp;
| &nbsp;
| <span>重复布局</span>
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Table
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 表格布局
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Flow
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | SPAN标签布局
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | None
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 无，常用于Div+Css形式页面
|-
| itemHeight
| &nbsp;
| &nbsp;
| 列表中每一项的高度
|-
| itemWidth
| &nbsp;
| &nbsp;
| 列表中每一项的宽度
|-
| itemAlign
| &nbsp;
| &nbsp;
| 列表中每一项的水平对齐方式
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Center
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 居中对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Left
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 居左对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Right
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 居右对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Justify
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 向页面的左右边缘对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | NotSet
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 不设置
|-
| itemVerticalAlign
| &nbsp;
| &nbsp;
| 列表中每一项的垂直对齐方式
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Top
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 顶端对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Middle
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 居中对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Bottom
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 底端对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | NotSet
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 不设置
|-
| itemClass
| &nbsp;
| &nbsp;
| 项CSS类
|-
| isDisplayIfEmpty
| &nbsp;
| &nbsp;
| 当项为零是是否显示。
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | true
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 列表项不存在时仍然显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | false
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 列表项不存在时不显示
|-
| class
| &nbsp;
| &nbsp;
| 整体CSS类
|-
| target
| &nbsp;
| &nbsp;
| <span>控制链接打开窗口的目标</span>
|-
| height
| &nbsp;
| &nbsp;
| <span>列表的整体高度</span>
|-
| width
| &nbsp;
| &nbsp;
| 列表的整体宽度
|-
| align
| &nbsp;
| &nbsp;
| 列表的整体对齐方式
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Center
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 居中对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Left
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 居左对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Right
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 居右对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | Justify
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 向页面的左右边缘对齐
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | NotSet
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 不设置
|-
| cellpadding
| &nbsp;
| &nbsp;
| 填充像素值
|-
| cellspacing
| &nbsp;
| &nbsp;
| 间距像素值
|-
| isDynamic
| &nbsp;
| &nbsp;
| 是否动态显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | true
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | 动态显示
|-
| bgcolor="#ffffcc" | &nbsp;
| bgcolor="#ffffcc" | false
| bgcolor="#ffffcc" | √ 
| bgcolor="#ffffcc" | 静态显示
|}

'''注意'''

*元素 <stl:sites> 用于显示网站群中的站点，如果定义siteName或directory属性，系统将从对应站点的子站点中选择，否则系统将从所有站点中选择。
*<stl:sites> 必须包含子元素，否则将不起作用，系统将找到对应的站点并在对应站点下解析子元素。子元素可以是任意STL元素或HTML元素。
*属性 order 用于站点列表排序：
**order 不设置或设置为"Default"，站点列表将与CMS后台中站点的显示排序一致。
**order 设置为"Contents"，站点将根据内容数的多少进行排序，如果同时设置since属性，系统将根据对应时间段内添加的内容数量进行排序。
**order 设置为"Hits"，站点将根据页面点击量的多少进行排序，如果同时设置since属性，系统将根据对应时间段内页面浏览量的数量进行排序。
*属性 since 用于指定时间段，列表将只显示这段时间内添加的站点。since 属性格式为“数字+日期符号”，如"1y"、"3m"、"10d"或"16h"，分别代表一年、三个月、十天及十六个小时。

'''stl:sites 示例'''

*示例一：显示系统中所有站点的名称以及最新添加的两条内容。
<pre>
<stl: sites>  
 <a href="{ Stl.SiteUrl}" target="_blank"><stl: value type="SiteName"></stl: value></a>  
    <br/>  
   <ul>  
   <stl: contents totalNum="2" order="AddDate" scope="All">  
      <li><stl: a target="_blank"></stl: a></li>  
   </stl: contents>  
    </ul>  
  </stl: sites>  
</pre>

*示例二：显示系统中所有站点及站点的内容数，并按内容数量进行排序.
<pre>
 <stl: sites order="Contents">  
  <a href="{ Stl.SiteUrl}" target="_blank">  
         <stl: value type="SiteName"></stl: value>  
   </a>  
     (内容数：<stl: count type="Contents" scope="All"></stl: count>)  
 </stl: sites>  
</pre>

*示例三：显示系统中所有站点，并按最近3个月的页面浏览量进行排序，同时显示对应站点的内容数、栏目数及浏览量。
<pre>
 <stl: sites order="Hits" since="3m">  
 <a href="{ Stl.SiteUrl}" target="_blank"><stl: value type="SiteName"></stl: value></a>  
  (新增内容数：<stl: count type="Contents" scope="All" since="3m"></stl: count>  
 栏目数：<stl: count type="Channels" scope="All"></stl: count>  
  访问量：<stl: analysis type="PageView" scope="Site" since="3m"></stl: analysis>)  
 </stl: sites>
</pre>

==参考资料==
*[http://help.siteserver.cn SiteServer官方]

[[category:SiteServer|S]]