Siteserver-stl:sites获取站点列表

stl:sites 获取站点列表

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

属性列表

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

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

注意

元素 <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 示例

示例一：显示系统中所有站点的名称以及最新添加的两条内容。

<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>

示例二：显示系统中所有站点及站点的内容数，并按内容数量进行排序.

 <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>

示例三：显示系统中所有站点，并按最近3个月的页面浏览量进行排序，同时显示对应站点的内容数、栏目数及浏览量。

 <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>

参考资料

SiteServer官方