分享

什么叫底层模板(Innertext),详细介绍

 yliu277 2015-05-14

底层模板(Innertext),底层模板实际上就是对于有多条记录的模板输出,用户手工去指定单个记录的样式。

   因为这个概念很虚线,那么这个地方还是通过实践去说明吧。

   大家在标签测试的地方输入:

   这是使用默认底层模板的标签:
{dede:arclist row=10}{/dede:arclist}<hr>
这是手工指定底层模板的标签:
{dede:arclist row=5}
◆ <ahref=’[field:arcurl/]’>[field:title/]</a> 点击:[field:click/]<br />
{/dede:arclist}

   有一点需注意的是,在没有指定底层模板(Innettext)的时候,系统一般调用 templets/system里的相应该文件作为底层模板。例如: {dede:arclist row=10}{/dede:arclist} 它实际由系统默认调用了templets/system/part_arclist.htm 这文件的东西作为底层模板。这文件的内容是·<a href="[field:filename/]">[field:title/]</a><br/>那么{dede:arclist row=10}{/dede:arclist}
就等同于{dede:arclist row=10}·<a href="[field:filename/]">[field:title/]</a><br/>{/dede:arclist}既能用短标记,也能直接定义样式,又不依赖数据库,这是dedecms模板和其它模板的最大区别。

   在标记之间 [field:…/] 这些就是底层模板变量,这些标记一般也是属于Dedecms 标签的模式,只是 { … } 符号改为了 [ …],因此底层模板中的标签也是具有DedeCms标签的特性的,例如,在底层模板中使用 [field:globalname=’cfg_webname’/] 同样可以表示全局变量 $cfg_webname。

具体哪些标记可以用Innertext,那些不可以用,可以在http://www./archives/templethelp/help/index.htm这页面参考。

   在此我简单介绍一下常用的 arclist 标记的底层模板字段及意义:

   arclist的底层模板字段实际上是对应相应该的主索引表的,在文档模板中则对应该主表和附加表,主表字段是一样的,我等会介绍一下,附加表的可以在模型里找。

arclist常用的字段有:

ID(同 id),
title(标题),
color,
typeid(栏目ID),
description(摘要,同 info),
writer(作者),
shorttitle(短标题),
memberid(会员ID),
pubdate(发布时间),
click,
litpic(缩图图,同 picname),
typename(栏目名称),
arcurl(网址,同 filename),
typeurl(栏目网址)

stime(pubdate 的"0000-00-00"格式,等同于[field:pubdatefunction="strftime('%y-%m-%d',@me)"/]),
textlink(等同<a href='[field:arcurl/]'>[field:title/]</a>),
typelink(等同<a href='[field:arcurl/]'>[field:title/]</a>),,
imglink(等同<a href='[field:arcurl/]'><img src='[field:picname/]'border='0'></a>),
image(等同<imgsrc='[field:picname/]'>),

   大家需注意的一个问题是:[field:标记名称/]这种写法是仅在底层模板中才用的。在文档模板中,字段是用 {dede:fieldname='title'/}这样形式表示的。不过在一 种特殊的情况下,Innertext是无效的,就是指定了runphp=’yes’ 属性,

:A、function 扩展;B、在Innertext中直接编程。

    一、那么首先说A、function 扩展:

   在标记中,可以使用 {dede:标记名称 function=”函数名(@me,其它参数)” /}这样模式对标记的值进行处理,其中@me 就是表示标记当前的值,最终获得的结果是这个函数返回的值。

   大家不妨测试一下下面这个标签:{dede:globalfunction="file_get_contents('http://www.baidu.com')" /}

   下面再举个实用的例子(测试一下):
{dede:arclist row=5}
◆ <ahref='[field:arcurl/]'>[field:title/]</a>
[field:pubdate function="strftime('%y-%m-%d%H:%M',@me);"/]<br />
{/dede:arclist}

   从实例中大家可以注意到,{dede:xx/}和[field:xxx/}都支持function扩展。实际上 [field:xxx/]这种模式也是dede标签解析器解析的,所以作用一样,它 只是把 dede 换成 field { 换成[

   在这里,function 属性的 function不仅是用PHP自带的,用自己定义的也行。不过要注意function的格式,自定义的function不 能用echo这样的输出,而是返回一个字符串,这样就行了。

    写好的函数放入include/inc_channel_unit_functions.php文件,因为dede核心都会调用这个文件。

   这里举个简单的函数:
function testMyFunc($str){
return $str." 增加了我的东西哦!";
}

   在标签中使用:
{dede:global name='cfg_webname'function='testMyFunc(@me)'/}

   用function扩展的好处是既可以增强系统的功能,又保持标记的简洁。

   二、下面介绍的是另一种扩展 B、在Innertext中直接编程


   这种方式和function编程的不同之处是,你可以把PHP代码直接写入到标签的底层模板代码的地方,不过需要注意的是,在这里的PHP代码并非完全意义上的PHP代码,它必须符合Dede限定的格式,即是最终返回值返回到 @me 变量中,同样的是用 @me表示标记的最初的值。

    使用格式:{dede:标记名称 runphp=yes} PHP代码{/dede:标记名称}

   大家测试一下这个代码:
{dede:global name='cfg_webname' runphp='yes'}
$baidu = file_get_contents("http://www.baidu.com");
preg_match_all("/<title>(.*)<\/title>/isU",$baidu,$baidus);
@me = $baidus[1][0];
{/dede:global}

    这里的cfg_webname 不再显示当前站点名了,因为 @me = $baidus[1][0]; 改变了它的值。

   在使用标记内编程或function扩展时,很多情况都可能会调用数据库。在V5版本中,DedeCms的数据库进行了改进,无论你新建多少个类的对像,最终打开的链接是只有一个的,并且会生成一个 $dsql 的全局数据库类的变量。

   以往有些懂dedecms数据库类的人在调用function扩展的时候,一般的做法是用 $dsql = newDedeSql(false); 这样新建一个类。实际上在V5中是不需要这样的。直接用global $dsql;声明一下就能使用,并且在函数体中不要自行关闭(即执行$dsql->Close())否则可能出错。

   那么在这里举个简单的例子(测试代码):

{dede:global runphp='yes'}
global $dsql;
$restr = '';
$dsql->SetQuery("Select * From dede_feedback whereischeck=1 order by ID desc limit 5");
$dsql->Execute('feedback');
while($row = $dsql->GetArray('feedback')){
$restr .= "<a target='_blank'href='/plus/feedback.php?arcID={$row['aid']}&urlindex={$row['urlindex']}'>{$row['arctitle']}</a>-- ".cn_substr($row['msg'],200)."<hr/>";
}
@me = $restr;
{/dede:global}

   这代码是调用最新评论的。dede本身没有提供直接调用评论的标签,一般懂的人用loop标签调用,不过在本版中,新增的SQL标签会更简单。

    在DedeCms V5 中有一个标签{dede:sql sql="SQL语句 limit记录"}底层模板{/dede:sql}

   我现在改一下刚才调用评论的地方(测试代码):

{dede:sql sql="Select * From dede_feedback whereischeck=1 order by ID desc limit 5"}
<a target='_blank'href='/plus/feedback.php?arcID=[field:aid/]&urlindex=[field:urlindex/]'>[field:arctitle/]</a>-- [field:msg/]<hr />
{/dede:sql}

   这结果应该和上面的代码是一样的。

   为了补允调用全站数据的不足,V5中新增了 arcfulllist 标记,它的作用与 arclist 标记有点类同,不示不同的是arcfulllist 里的文件名有时候可能是动态的,这因为它是使用搜索时用的那个简单索引表。在专题文章、相关文章中默认都是使用arcfulllist 调用指定的 id 的文档的。

   由于这标记可能造成文件名不同步,我们系统后面增加了文档名批量修正功能,但为了防止忘记操作,建议建立栏目就设定好文档命名规则,以后不要经常更改。

一就是常用的模型,二是新出的模块,三是插件。

   大家进到Dede管理后台“频道管理->内容模型管理”的地方可以看到:

分类信息
专题
普通文章
图片集
软件
Flash
产品

   这些都是内置的模型。大家也可以自己新建一个模型,有不少人问:Dedecms的文存储在哪里呀?下面我一步一步的教大家建立一个用文本存储的文章模型。

   首先“增加一个新模型”,建立好后“添加字段”,然后转向栏目管理的地方。建立好后转到栏目管理的地方新建一个顶级栏目,内容模型选刚才建好的那个。建立好栏目后,随意在那个栏目增加一篇文章。预览文章,会发生新增的模型显示的文档。现在再回到频道模型管理的地方,在新建的频道点击“模板”。

   对于类同的模型,最好是把类同的模板作为当前模型的模板。如刚才建立的模型,实际上模板和普通文章模板是一样的。

   关于字段的问题,在文档模板中字段是用{dede:field name='字段名'/}表示。例如在软件模型中

文件类型 filetype 单行文本(varchar) 固化表单 [修改]
语言 language 单行文本(varchar) 固化表单 [修改]
软件类型 softtype 单行文本(varchar) 固化表单 [修改]
授权方式 accredit 单行文本(varchar) 固化表单 [修改]
操作系统 os 单行文本(varchar) 固化表单 [修改]
软件等级 softrank 整数类型 固化表单 [修改]
官方网址 officialurl 单行文本(varchar) 固化表单 [修改]

   语言这字段就可以用 {dede:field name='language'/} 表示,此外,title ,keywords,description 这些实际上主索引表的东西,刚才说模板时已经介绍过它的含义了。

   有用户提过一个问题,就是关于自定义模型如何在表布表单中调整字段的顺序。Dedecms目前没有这选项,需要改的必须用phpmyadmin 进入 it_channeltype 这个表。编辑 fieldset这里的XML,调一下位置就行了。

   此外大家要区别一下自动模型和系统模型的区别,系统模型是固化了的,要调整必须自己修改程序,对于普通人是无法改的。不过这版本允许自行增加一些字段在里面。

   因为这次讲座是个中级讲座,模型这块我就不太深入的讲解了,最后介绍一下插件和模块。

插件和模块

   DEDE增加新模型,必须一步到位,如果不用phpmyadmin,输入错误什么的,在后台修改不了。

   插件在Dedecms中是就是一些小的实际的程序的集合,它可以简单的安装和删除,不过安装和删除仅去去掉数据库的索引记录,并非进行真正的安装。

   官方网前自带的插件有:

文件管理器
站内新闻发布
友情链接模块
留言簿模块
投票模块
论坛扩展
广告管理
正则规则测试器
随机模板防采集
木马扫描检测
数据转换与导入

   实际上很多情况下单用插件是满足不了系统的需求的,实际上很多情况下单用插件是满足不了系统的需求的。因此DedecmsV5提出了模块的概念。

   模块是对系统模型的一个补充,因为Dedecms的模板解析机制相对复杂,如果所有东西都依赖模型,就结果只有一个:速度越来越慢。而使用模块就补充了这方面的不足。在 Dedecms V5 的菜单中“扩展模块”里放的就是Dedecms的模块。

   模块文件是一个标准化的xml文件,它即包含了模块安装删除的数据,也偶包含了图片等二进制文件。有些人问我,为什么在DedeCmsV5的安装包里没发现ask、group等目录?因为这些东西都封装起来了,如果你不安装它,是不会看到这些文件的,这样就能尽大限度满足一些站长想要功能多,一些想要功能实用的需求。

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多