DEDECMS标签手册(7)

功能：用于获取MySQL数据库内容的标签 语法：

{dede:sql sql='' appname='default'} [field:title/] {/dede}

文件：

\\include\\taglib\\sql.lib.php

function lib_sql(&$ctag,&$refObj) 默认底层模板： 无

参数：

sql='' 需要查询的sql语句

appname='default' 这个参数在DedeCMS 5.7中有效，可以调用其他服务器或者数据库上的信息，默认为default，即当前系统所运行的数据库，可在data/tag/sql.inc.php中扩展，在DedeCMS 5.8中用户可以通过后台[模板]-[SQL标签应用管理]来配置应用。

底层字段：

所有SQL语句查询出来的字段 范例：

我们通过下列标签来调用phpwind论坛的会员信息。

{dede:sql sql='SELECT uid,username,email,memberid FROM `phpwind87`.pw_members ORDER BY uid desc' appname='phpwind'}

[field:uid/]-[field:username/]
{/dede:sql}

标签调试结果内容如下：

注：在DedeCMS 5.8中可以直接使用标签生成器来生成SQL标签。

tag TAG调用标签

（>=DedeCMS 4，DedeCMS 5） 名称：tag

功能：TAG调用 语法：

{dede:tag sort='new' getall='0'} [field:tag /] {/dede:tag}

文件：

\\include\\taglib\\tag.lib.php

function lib_tag(&$ctag,&$refObj) 默认底层模板：

tag_one.htm 参数：

row=30 调用条数

sort='new' 排序方式 month，rand，week，hot，total 底层字段：

keyword,tag,link,highlight,

type 指定栏目调用标签

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5） 名称：type

功能：获取指定栏目链接 语法：

{dede:type}

文件：

\\include\\taglib\\type.lib.php

function lib_type(&$ctag,&$refObj) 默认底层模板：

part_type_list.htm 参数：

typeid=0 指定栏目ID，如果没有指定则获取当前页面下的环境变量 底层字段：

id,typelink,typename,typedir,isdefault,ispart,defaultname,namerule2,moresite,siteurl,sitepath,listman

范例：

vote 投票标签

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5） 名称：vote

功能：用于获取一组投票表单，系统默认安装了投票插件，可在[模块]-[辅助插件]-[投票模块]中来添加或者获取投票标签 语法：

{dede:vote {/dede}

id=''

lineheight='22'

tablewidth='100%'

titlebgcolor='#EDEDE2'

titlebackground=''

tablebgcolor='#FFFFFF'/}

文件：

\\include\\taglib\\vote.lib.php

function lib_vote(&$ctag,&$refObj) 默认底层模板：

无

参数：

id=0 数字，当前投票ID lineheight=24 表格高度

tablewidth='100%' 表格宽度

titlebgcolor='#EDEDE2' 投票标题背景色 titlebackgroup='' 标题背景图

tablebg='#FFFFFF' 投票表格背景色 底层字段： 无

列表标签

list 列表数据标签

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5）

名称：list

功能：获取列表模板中的列表内容 语法：

{dede:list col='' titlelen=''

infolen='' imgwidth='' imgheight='' orderby='' pagesize=''}{/dede:list}

文件：

\\include\\arc.listview.class.php

\\include\\arc.sglistview.class.php

function GetArcList($limitstart=0,$row=10,$col=1,$titlelen=30,$infolen=250,

$imgwidth=120,$imgheight=90,$listtype=\0\默认底层模板： list_fulllist.htm 参数：

col=1 内容列数

titlelen=30 标题长度

infolen=250 内容摘要长度 imgwidth=120 缩略图宽 imgheight=90 缩略图高

orderby='default' 排序方式，有效的排序方式有 senddate、pubdate、id、click、lastpost、postnum ，默认为 sortrank

pagesize=20 分页大小 orderway='desc' 排序方式 底层字段：

ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),postnum,lastpost,shorttitle

pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename, arcurl(同 filename),typeurl,stime(pubdate 的\格式), textlink,typelink,imglink,image 范例：

{dede:list pagesize='10'}

[field:array runphp='yes']@me = (empty(@me['litpic']) ? \: \href='{@me['arcurl']}' class='preview'>\

[[field:typelink/]] [field:pubdate function=\点击：[field:click/] 好评：[field:scores/]

list标签同时也适用单表模型文档列表。

注：list标记除了支持档案表的基本模板变量外，还支持附加表的字段，你可以在模型管理中知道附加表支持列表使用的字段有哪些。

pagelist 列表分页标签

（>=DedeCMS 3，DedeCMS 4，DedeCMS 5） 名称：pagelist

功能：表示分页页码列表 语法：

{dede:pagelist listsize='3' listitem=''/} 文件：

\\include\\arc.listview.class.php \\include\\arc.sglistview.class.php

function GetPageListDM($list_len,$listitem=\function GetPageListST($list_len,$listitem=\默认底层模板： 无

参数：

listsize=3 表示 [1][2][3] 这些项的长度 x 2

listitem='index,pre,pageno,next,end,option' 表示页码样式，可以把下面的值叠加 index 首页 pre 上一页 pageno 页码 next 下一页 end 末页

option 下拉跳转框 底层字段： 无

范例：