destoon各个模块数据的调用说明

    发布时间:2018-03-04

    1153

    阅读量


    供应:
    最新供应信息:


    1.<!–{tag(“moduleid=5&condition=status=3&length=34&condition=status=3&pagesize=5&order=addtime desc&template=list-trade”)}–>
    2.<!–{php $tags=tag(“moduleid=5&condition=status=3&length=34&condition=status=3&pagesize=5&order=addtime desc&template=null”);}–>
    {loop $tags $k $t}
    <li><span class=”f_r”>[{area_pos($t[areaid], ’/', 1)}]</span><a href=”{$t[linkurl]}” target=”_blank” title=”{$t[alt]}”>{$t[title]}</a></li>
    {/loop}


    签调用理论上需要网站管理人员有一定的HTML+CSS知识,并对PHP+MySQL有初步的了解。
    调用过程实际是按照调用条件从数据表读取调用数量条数据,并依排序方式排序,最终通过标签模板的布局输出数据。
    函数原型 tag($parameter, $expires = 0) $parameter 表示传递给tag函数的字符串,系统自动将其转换为多个 变量 例如传递 table=Destoon&pagesize=10,系统相当于得 到$table = ‘destoon’;$pagesize = 10;
    两个变量 $expires 表示缓存过期时间 >0 缓存$expires秒;0 – 系统默认时间;-1 – 不缓存;-2 – 缓存SQL;一般情况保持默认即可。
    变量 $tags 以数组类型保存标签调用的数据,可通过loop语法遍历显示。
    $pages 保存数据分页代码,仅在调用了分页时有效。

    $path 模块路径。 常用字段 title 标题; linkurl 链接; catid 分类ID; introduce 简介; addtime 添加时间;

    常用函数 dsubstr($string, $length, $suffix = ”) 将字符串$string截取为$length长,尾部追加$suffix(例如..)
    set_style($string, $style = ”, $tag = ‘span’) 将字符串$string置于$tagHTML标签中并设 置style为$style linkurl($linkurl, $absurl = 0) 将相对路径$linkurl修补为绝对路径(防止链接错 误)
    date($format, $timestamp) 将时间戳$timestamp转化为$format(例如Y-m-d)格式
    标签模板 模板保存于./template/default/tag/目录; 建议不要删除或者修改自带的模板,推荐在自带模板基础上新建模板并应用。
    Category:Destoon标签调用
    Comments (0)
    destoon显示地区Posted byjinpeng998on 星期一, 12 07月, 2010

    显示地区:

    需要的函数是 include/module.func.php/get_mainarea($areaid, $area);
    php页面:$AREA=cache_read(‘area.php’); //读取缓存文件
    静态页面调用: <table width=”100%” cellpadding=”3″>
    {php $mainarea = get_mainarea(0, $AREA)}
    {loop $mainarea $k $v}
    {if $k%2==0}<tr>{/if}
    <td><a href=”{$MOD[linkurl]}{rewrite(‘search.php?areaid=’.$v['areaid'].’&typeid=’.$typeid)}”>{$v[areaname]}</a></td>
    {if $k%2==1}</tr>{/if}
    {/loop}
    </table>
    还有一种方法就是 直接标签调用,,不错的,直接从destoon数据库里取出信息
    Category:Destoondestoon显示地区
    Comments (0)
    destoon 学习标签调用Posted byjinpeng998on 星期日, 11 07月, 2010
    链接:$t[linkurl]
    供应模块 更多:$MODULE[---模块ID---][linkurl] 模块ID把 鼠标放在其下链接上 出现 moduleid=? 就能看到
    图片路径:$t
    ;
    资讯模块 更多:{$MOD[linkurl]}{$c[linkurl]}
    查看 名称是属于哪个字段?--选中–右键-看name值 eg name=post[brand] 即为brand字段
    每个模块的首页 都是其 template/文件夹下的 index.htm
    pagesize=”.$MOD[pagesize].” 可写成 pagesize=4;记住不要加 单引号 or 双引号

    调用分页:

    分页标签:

    <!–{tag(“moduleid=$moduleid&c=3
    $dtype&catid=$catid&pagesize=4&page=$page&showpage=1&datetype=5&order=”.$MOD[order].”&template=list-sell”)}–>
    分页:{if $showpage && $pages}<div class=”pages”>{$pages}</div>{/if}

    调用分类:

    主要方法
    $maincat = get_maincat(0, $CATEGORY);
    get_maincat(0, $CATEGORY)--在include/global_func.php 中
    $childcat = get_maincat(0, $CATEGORY, 1);- 调用超级栏目下的1级目录
    0 代表 最最根目录 1代表 level为1的目录 level 手动设置 默认都为1
    如果0改为3 则为 catid 为3 的目录
    小注意:$CATEGORY = cache_read(‘category-’.$moduleid.’.php’);此文件在模块页的common.inc.php页面中
    调用
    {loop $maincat $k $v}
    {if $k%$DT[page_subcat]==0}<tr>{/if}
    <td>
    <a href=”{$MOD[linkurl]}{$v[linkurl]}”>{set_style($v[catname],$v[style])}</a> <span>({$ITEMS[$v[catid]})</span>
    </td>
    {if $k%$DT[page_subcat]==($DT[page_subcat]-1)}</tr>{/if}
    {/loop}
    注意:
    在其模块 module 文件夹下的 php页面里必须有 $maincat
    $MOD[linkurl] 是模块也首页地址 $v[linkurl]其下列表页 加 catid
    Category:Destoon标签调用
    Comments (0)
    非常好的Destoon B2B标签调用手册Posted byjinpeng998on 星期日, 11 07月, 2010
    Destoon B2B标签调用手册什么是标签调用?
    标签调用是根据调用条件(condition)从数据表(table)读取调用数量(pagesize)条数据,并按排序方式(order)排序,最终通过标签模板的布局输出数据。
    可以看出,标签的工作分两个部分,一是读取数据,二是显示数据。
    标签函数原型
    标签函数保存于 include/tag.func.php
    tag($parameter, $expires = 0)
    $parameter 表示传递给tag函数的字符串,系统自动将其转换为多个变量
    例如传递 table=destoon&pagesize=10&hello=world
    系统相当于得到
    $table = ‘destoon’;
    $pagesize = 10;
    $hello = ‘world’;
    三个变量
    $expires 表示标签缓存过期时间
    >0 缓存$expires秒;0 – 系统默认标签缓存时间;-1 – 不缓存;-2 – 缓存SQL结果;
    一般情况保持默认不需要传递。
    数据读取过程
    例如以下标签:
    <!–{tag(“table=sell&c=3&order=addtime desc&pagesize=10″)}–>
    会被转换为如下的SQL语句:
    SELECt *
    FROM destoon_sell
    WHERe status=3
    ORDER BY addtime DESC
    LIMIT 0,10
    读出的数据会保存在 $tags 数组里
    数据显示过程
    1、通过标签模板显示
    传递&template=abc给标签函数,例如:
    <!–{tag(“table=…&template=abc”)}–>
    默认的标签模板保存在模板目录/tag/目录里,例如&template=abc将调用模板目录/tag/abc.htm模板来显示数据
    如果标签模板放于其他目录,例如def,则传递&dir=def&template=abc,系统将调用模板目录/def/abc.htm模板
    2、直接在模板里循环数据
    <!–{php $tags=tag(“table=…&template=null”);}–>
    此写法传递标签模板为null,并且直接返回数据给$tags数组,此时可以直接在模板里循环了
    以下为一个完整的示例:
    <!–{php $tags=tag(“table=…&template=null”);}–>
    {loop $tags $t}

    {/loop>
    第一种写法一般用于多次调用的数据,第二种写法一般用于只调用一次的数据。
    常用参数及含义
    moduleid
    moduleid指模块ID,可在后台模块管理里查询。对于直接调用模块的数据,设置正确的模块ID后,将不需要传递table参数,系统会自动获取。
    例如传递moduleid=5,系统将识别为调用供应信息,自动设置table参数为sell
    table
    table指表名,可在后台数据库维护里查询。对于Destoon系统表,不需要加表的前缀;对于非Destoon系统表,需要填写完整的表名,且传递prefix参数
    例如对于Destoon系统表,传递table=sell,如果表前缀为destoon_,系统将识别表名为 destoon_sell
    对于非Destoon系统表,传递table=tb_abc&prefix=或者table=abc&prefix=tb_,系统将识别表名为 tb_abc
    fields
    fields指查询的字段,默认为星号。可以传递例如 fields=title,addtime,但是一般情况下无需传递,Destoon独有的标签缓存机制会自动缓存查询结果,不必担心效率问题。
    order
    order指数据的排序方法(此项需了解SQL语法)。
    例如order=addtime desc表示按添加时间降序排列、order=itemid desc表示按itemid降序排列、order=rand()表示随机数据等。
    pagesize
    pagesize指调用数据的数量,如果不传递,默认为10。
    template
    template指指定的标签模板,如果不传递,默认为list,位于模板目录/tag/list.htm,如果传递为null,表示不应用标签模板。参见上述数据显示过程。
    其他常见用法举例
    控制标题长度
    在标签里传递length参数,例如&length=20表示20个字符长度(GBK一个汉字占2个字符,UTF-8一个汉字占3个字符),一般情况建议用css隐藏多余字符(定义height和overflow:hidden)
    传递length参数,系统仅对title字段自动截取,如果需要截取其他字段,可用dsubstr函数
    例如 {dsubstr($t[company], 20, ‘…’)} 表示截取company字段为20个字符,截取后,结尾追加…
    设置日期显示格式
    可以在标签里传递datetype参数

    destoon模版开发

    1 表示 年;
    2 表示 月-日;
    3 表示 年-月-日;
    4 表示 月-日 时:分;
    5 表示 年-月-日 时:分;
    6 表示 年-月-日 时:分:秒
    也可以在模板里直接使用date函数,例如{date(‘Y-m-d’, $t[addtime])} 表示将时间转换为 年-月-日 格式
    调用某一分类的信息
    在标签里传递catid参数,例如&catid=5表示调用分类ID为5的所有信息。
    如果调用多个分类,用逗号分隔分类ID,例如 &catid=5,6,7表示调用分类ID为5、6、7的所有信息。
    分类调用默认包含子分类的信息,如果不需要包含子分类,可设置&child=0参数。
    例如&catid=5&child=0表示只调用分类ID为5的信息,不包括子分类的信息。
    调用某一地区的信息
    调用地区信息和上述调用分类信息的方法完全相同,将其中的catid换为areaid即可。
    显示信息所在分类
    <a href=”{$MODULE[$moduleid][linkurl]}{$CATEGORY[$t[catid][linkurl]}”>{$CATEGORY[$t[catid][catname]}</a>
    控制列数
    此项常用于图片的布局,可使用cols参数。
    例如调用12张图片,一行显示4个,共3行,则传递&pagesize=12&cols=4
    支持cols参数的标签模板限thumb-table.htm和list-table.htm
    其中,thumb-table.htm显示图片列表,list-table.htm显示文字列表
    如果新建支持cols的标签模板或直接循环$tags,可参考以上两个模板的写法
    上述效果可以也可以通过CSS实现,无需使用表格,请自行书写
    显示文章的简介
    使用{$t[introduce]}变量,如果要截取字数,例如80字符,可使用{dsubstr($t[introduce], 80, ‘…’)}
    小结
    标签看似复杂难懂,实际上在理解各个参数的含义和调用流程后,您会了解到标签实际简单自由、灵活易用、功能强大。
    默认模板里已提供了大量的调用范例和标签模板,可以在学习中参阅和调试。
    标签调用是制作模板必备的知识,希望您能早日掌握。