> Typecho的语法及函数，实在记不住，而且每次都要去百度一遍，着实是麻烦。还是自己保存下来吧，方便查阅！ > 文章内容均来自网络，并整合。 ### 模板常用函数 1、站点网址 ```php options->title() ?> ``` 2、站点网址 ```php options ->siteUrl(); ?> ``` 3、完整路径标题如分享几个 Typecho 中常用的调用函数 ```php archiveTitle(' » ', < span class="string">'', ' | '); ?>options->title(); ?> ``` 4、站点说明 ```php options->description() ?> ``` 5、模板文件夹地址 ```php options->themeUrl(); ?> ``` 6、导入模板文件夹内的 php 文件 ```php need('.php'); ?> ``` 7、文章或者页面的作者 ```php author(); ?> ``` 8、作者头像 ```php < ?php $this->author->gravatar('40') ?> 此处输出的完整的img标签，40是头像的宽和高。 ``` 9、该文作者全部文章列表链接 ```php author->permalink (); ?> ``` 10、该文作者个人主页链接 ```php author->url(); ?> ``` 11 、该文作者的邮箱地址 ```php author->mail(); ?> ``` 12、上一篇与下一篇调用代码 ```php thePrev(); ?> theNext(); ?> ``` 13、判断是否为首页，输出相关内容 ```php is('index')): ?> //首页输出内容 //不是首页输出内容 ``` 14、文章或页面，评论数目 ```php commentsNum('No Comments', '1 Comment' , '%d Comments'); ?> ``` 15、截取部份文章（首页每篇文章显示摘要），350 是字数 ```php excerpt(350, '...'); ?> ``` 16、调用自定义字段（官方文档坑爹，竟然没有，博主自己摸索出来的） ```php fields->fieldName ?> ``` 17、RSS 地址 ```php options->feedUrl(); ?> ``` 18、获取最新 post ```php widget('Widget_Contents_Post_Recent', 'pageSize=8&type=category')->parse('

'); ?> ``` 19、纯文字分类名称，不带链接 ```php category(',', false); ?> ``` 20、获取当前文章所属分类（包含链接） ```php is('post')): ?> category(' '); ?> ``` 21、获取文章分类列表 ```php

{name} ({count})

``` 22、获取某分类 post ```php

{title}

``` 23、获取最新评论列表 ```php

author(false); ?>: excerpt(50, '...'); ?>

``` 24、首页获取最新文章代码限制条数 ```php next()): ?> sequence <= 3): ?> html ``` 25、获取最新评论列表 (只显示访客评论不显示作者或者说自己发的评论) ```php widget('Widget_Comments_Recent','ignoreAuthor=true')->to($comments); ?> next()): ?>

author(false); ?>: excerpt(50, '...'); ?>

``` 26、获取文章时间归档 ```php

{date}

``` 27、获取标签集合，也就是标签云 ```php widget('Widget_Metas_Tag_Cloud', 'ignoreZeroCount=1&limit=28')->to($tags); ?> next()): ?> name(); ?> ``` 28、调用该文相关文章列表 ```php related(5)->to($relatedPosts); ?> have()): ?> //这句也可以写成 if (count($relatedPosts->stack))

title(); ?>

无相关文章

``` 29、隐藏 head 区域的程序版本和模版名称 ```php header("generator=&template="); ?> ``` 30、获取读者墙 ```php fetchAll(Typecho_Db::get() ->select('COUNT(author) AS cnt','author', 'url', 'mail') ->from('table.comments') ->where('created > ?', $period ) ->where('status = ?', 'approved') ->where('type = ?', 'comment') ->where('authorId = ?', '0') ->group('author') ->order('cnt', Typecho_Db::SORT_DESC) ->limit(25) ); $mostactive = ''; $avatar_path = 'http://www.gravatar.com/avatar/'; foreach ($counts as $count) { $avatar = $avatar_path . md5(strtolower($count['mail'])) . '.jpg'; $c_url = $count['url']; if ( !$c_url ) $c_url = Helper::options()->siteUrl; $mostactive .= "

\n"; } echo $mostactive; ?> ``` 31、登陆与未登录用户展示不同内容 ```php user->hasLogin()): ?> // 登陆可见 // 未登录和登陆均可见 ``` 32、导航页面列表调用隐藏特定的页面这个演示隐藏了 album 和 search 两个页面 ```php

is('index')): ?> class="current">主页 widget('Widget_Contents_Page_List')->to($pages); ?> next()): ?> slug != 'album') && ($pages->slug != 'search')): ?> is('page', $pages->slug)): ?> class="current">title(); ?>

``` > 参数说明：9.0 版 typecho 支出在后台管理页面编辑时选择隐藏页面。 33、Typecho 归档页面 ```php widget('Widget_Contents_Post_Recent', 'pageSize=10000')->to($archives); $year=0; $mon=0; $i=0; $j=0; $output = '

'; while($archives->next()): $year_tmp = date('Y',$archives->created); $mon_tmp = date('m',$archives->created); $y=$year; $m=$mon; if ($mon != $mon_tmp && $mon > 0) $output .= ''; if ($year != $year_tmp && $year > 0) $output .= ''; if ($year != $year_tmp) { $year = $year_tmp; $output .= '

'. $year .' 年

'. $mon .' 月
- '.date('d日: ',$archives->created).''. $archives->title .' ('. $archives->commentsNum.')

'; echo $output; ?> ``` 34、获取当前文章页缩略图 ```php attachments(1)->attachment->url(); ?> ``` > 务必注意，这里所谓缩略图指的是当前文章页第一个附件地址，请确保第一个附件类型为图片。 35、根据页面类型显示内容判断是文章页则显示内容 ```php is('post')): ?> 想要显示的内容1 ``` 判断是页面则显示内容 ```php is('page', 'about')): ?> 想要显示的内容2 ``` 36、Title增加副标题 ``` is('index')): ?> - 副标题 ``` 37、按分类输出cms ```

widget('Widget_Metas_Category_List')->to($categories); ?> next()): ?> children) === 0): ?> widget('Widget_Archive@category-' . $categories->mid, 'pageSize=5&type=category', 'mid=' . $categories->mid)->to($posts); ?>

name(); ?>

next()): ?>

title(40); ?>

``` 38、相关文章 ``` related(5)->to($relatedPosts); ?>

title(); ?>

``` 39、侧边栏热门标签 ``` ``` 40、侧边栏输出所有标签 ``` ``` 41、当前文章的标签 *说明：(',', true, 'none') 第一个单引号间的逗号代表标签与标签的间隔用逗号隔开，true 是标签以超链接形式输出 false 则只输出文字，none 为该文章没有标签时显示的提示信息可为空。* ``` tags(',', true, 'none'); ?> ``` 引申用法：如果想给每个标签套上 div 或者 span 什么的就需要这要做 ```

tags('

', true, 'none'); ?>

``` 判断当前标签并自定义内容 ``` tags) ): ?> 文章含有abc标签就会显示这里 ``` 判断文章是否存在标签，如果存在输出标签，如果不存在输出该文章分类 ``` tags) == 0 ): ?> //此处的count也可改为size category(',', true, 'none'); ?> //文章分类 tags(',', true, 'none'); ?> //文章标签 ``` ## 代码片段 > 以下为代码片段及对应的调用方式；代码片段请放置于function.php中 1、输出文章缩略图 ```php /** 输出文章缩略图 */ function showThumbnail($widget) { // 当文章无图片时的默认缩略图 $rand = rand(1,5); // 随机 1-5 张缩略图 $random = $widget->widget('Widget_Options')->themeUrl . '/img/sj/' . $rand . '.jpg'; // 随机缩略图路径 // $random = $widget->widget('Widget_Options')->themeUrl . '/img/mr.jpg'; // 若只想要一张默认缩略图请删除本行开头的"//" $attach = $widget->attachments(1)->attachment; $pattern = '/\]*>/i'; if (preg_match_all($pattern, $widget->content, $thumbUrl)) { echo $thumbUrl[1][0]; } else if ($attach->isImage) { echo $attach->url; } else { echo $random; } } ``` 调用方法： ```php ``` 2、获取文章第一张图片做缩略图 ```php function showThumbnail($widget) { 　　$attach = $widget->attachments(1)->attachment; 　　$pattern = '/\]*>/i'; 　　if (preg_match_all($pattern, $widget->content, $thumbUrl)) { 　　　　echo $thumbUrl[1][0]; 　　 else if ($attach->isImage) { 　　　　echo $attach->url; 　　} else { 　　　　echo $random; 　　} } ``` 调用方法： ```php

``` 3、评论自动排第一 ```php function Autofirst(){ $db = Typecho_Db::get(); $query = $db->select()->from('table.comments')->where('authorId = ?','0')->order('coid',Typecho_Db::SORT_DESC)->limit(100); $result = $db->fetchAll($query); $arrUrl = array(); $arrAuthor = array(); foreach ($result as $value) { if($value["url"]!==null){ array_push($arrUrl,$value["url"]); array_push($arrAuthor,$value["author"]); } } $su=array_filter(array_merge(array_unique($arrUrl))); $sa=array_filter(array_merge(array_unique($arrAuthor))); $num=0; for($i=0;$iselect()->from('table.comments')->where('url = ?',$su[$i])->order('coid',Typecho_Db::SORT_DESC)->limit(100); $result1 = $db1->fetchAll($query1); $arrAuthor1 = array(); foreach ($result1 as $value) { array_push($arrAuthor1,$value["author"]); } echo '

'.$arrAuthor1[0].'

'; } } } ``` 调用方法： ```php ``` 4、随机文章 ``` function getRandomPosts($limit = 10){ $db = Typecho_Db::get(); $result = $db->fetchAll($db->select()->from('table.contents') ->where('status = ?','publish') ->where('type = ?', 'post') ->where('created <= unix_timestamp(now())', 'post') ->limit($limit) ->order('RAND()') ); if($result){ $i=1; foreach($result as $val){ if($i<=3){ $var = ' class="red"'; }else{ $var = ''; } $val = Typecho_Widget::widget('Widget_Abstract_Contents')->push($val); $post_title = htmlspecialchars($val['title']); $permalink = $val['permalink']; echo '

'.$i.''.$post_title.'

'; $i++; } } } ``` 调用方法： ``` ``` 5、热门文章 ``` function getHotComments($limit = 10){ $db = Typecho_Db::get(); $result = $db->fetchAll($db->select()->from('table.contents') ->where('status = ?','publish') ->where('type = ?', 'post') ->where('created <= unix_timestamp(now())', 'post') //添加这一句避免未达到时间的文章提前曝光 ->limit($limit) ->order('commentsNum', Typecho_Db::SORT_DESC) ); if($result){ foreach($result as $val){ $val = Typecho_Widget::widget('Widget_Abstract_Contents')->push($val); $post_title = htmlspecialchars($val['title']); $permalink = $val['permalink']; echo '

'.$post_title.'

'; } } } ``` 调用方法： ``` ``` 6、文章阅读量统计 ``` function get_post_view($archive) { $cid = $archive->cid; $db = Typecho_Db::get(); $prefix = $db->getPrefix(); if (!array_key_exists('views', $db->fetchRow($db->select()->from('table.contents')))) { $db->query('ALTER TABLE `' . $prefix . 'contents` ADD `views` INT(10) DEFAULT 0;'); echo 0; return; } $row = $db->fetchRow($db->select('views')->from('table.contents')->where('cid = ?', $cid)); if ($archive->is('single')) { $db->query($db->update('table.contents')->rows(array('views' => (int) $row['views'] + 1))->where('cid = ?', $cid)); } echo $row['views']; } ``` 调用方法： ``` ```

Typecho语法大全/Typech常用函数/Typecho调用方法