Typecho 语法及函数集合
Typecho语法及函数集合全面整理,包括站点名称、网址、文章作者信息、评论数目、文章摘要、分类名称、标签云、相关文章等,方便查阅。
本文最后由 荒野孤灯 更新于 2023 年 11 月 23 日 09 时 20 分,已有 364 天未更新。今日被查阅 1 次,若内容或图片资源失效,请留言反馈,谢谢!
摘要由 AI 智能生成
网友 目的地-Destination 整理的 Typecho 的语法及函数,挺全面的。保存下来,方便查阅!
模板函数
1、站点名称
<?php $this->options->title() ?>
2、站点网址
<?php $this->options ->siteUrl(); ?>
3、完整路径标题
<?php $this->archiveTitle(' » ', < span class="string">'', ' | '); ?>
//或
<?php $this ->options->title(); ?>
4、站点说明
<?php $this->options->description() ?>
5、模板文件夹地址
<?php $this->options->themeUrl(); ?>
6、导入模板文件夹内的 *.php 文件
<?php $this->need('***.php'); ?>
7、文章或者页面的作者
<?php $this->author(); ?>
8、作者头像
<?php $this->author->gravatar('40') ?>
//输出的是完整的<img>标签,40是头像的宽和高。
9、文章作者全部文章列表链接
<?php $this->author->permalink (); ?>
10、文章作者个人主页链接
<?php $this->author->url(); ?>
11、文章作者的邮箱地址
<?php $this->author->mail(); ?>
12、上一篇与下一篇调用代码
<?php $this->thePrev(); ?>
<?php $this->theNext(); ?>
13、判断是否为首页,输出相关内容
<?php if ($this->is('index')): ?>
//首页输出内容
<?php else: ?>
//不是首页输出内容
<?php endif; ?>
14、文章或页面的评论数目
<?php $this->commentsNum('No Comments', '1 Comment' , '%d Comments'); ?>
15、截取部份文章(文章摘要)
<?php $this->excerpt(350, '...'); ?>
//首页每篇文章显示摘要),350 是字数
16、调用自定义字段
<?php $this->fields->fieldName; ?>
17、RSS 地址
<?php $this->options->feedUrl(); ?>
18、获取最新文章
<?php $this->widget('Widget_Contents_Post_Recent', 'pageSize=8&type=category')->parse('<li><a href="{permalink}">{title}</a></li>'); ?>
19、文章分类名称(不带链接)
<?php $this->category(',', false); ?>
20、文章分类名称(带链接)
<?php if ($this->is('post')): ?>
<span>
<?php $this->category(' '); ?>
</span>
<?php endif; ?>
21、获取文章分类列表
<ul>
<?php $this->widget('Widget_Metas_Category_List')->parse('<li><a href="{permalink}">{name}</a> ({count})</li>'); ?>
</ul>
22、获取某分类(mid=1)文章
<ul>
<?php $this->widget('Widget_Archive@indexyc', 'pageSize=8&type=category', 'mid=1')
->parse('<li><a href="{permalink}" title="{title}">{title}</a></li>'); ?>
</ul>
23、获取最新评论列表
<ul>
<?php $this->widget('Widget_Comments_Recent')->to($comments); ?>
<?php while($comments->next()): ?>
<li>
<a href="<?php $comments->permalink(); ?>"><?php $comments->author(false); ?></a>: <?php $comments->excerpt(50, '...'); ?>
</li>
<?php endwhile; ?>
</ul>
//数字50为截取评论的字数
24、获取最新文章(限制数量)
<?php while ($this->next()): ?>
<?php if ($this->sequence <= 3): ?>
//html代码,数字3为最近3篇文章
<?php endif; ?>
<?php endwhile; ?>
25、获取最新评论列表 (只显示访客评论不显示作者评论)
<? php $this->widget('Widget_Comments_Recent','ignoreAuthor=true')->to($comments); ?>
<? php while($comments->next()): ?>
<li>
<a href="<?php $comments->permalink(); ?>"><?php $comments->author(false); ?></a>: <?php $comments->excerpt(50, '...'); ?>
</li>
<?php endwhile; ?>
26、获取文章时间归档
<ul>
<?php $this->widget('Widget_Contents_Post_Date', 'type=month&format=F Y')->parse('<li><a href="{permalink}">{date}</a></li>'); ?>
</ul>
27、获取标签集合(标签云)
<?php $this->widget('Widget_Metas_Tag_Cloud', 'ignoreZeroCount=1&limit=28')->to($tags); ?>
<?php while($tags->next()): ?>
<a href="<?php $tags->permalink(); ?>" class="size-<?php $tags->split(5, 10, 15, 20); ?>"><?php $tags->name(); ?></a>
<?php endwhile; ?>
28、调用相关文章列表
<?php $this->related(5)->to($relatedPosts); ?>
<?php if ($relatedPosts->have()): ?> //这句也可以写成 if (count($relatedPosts->stack))
<ul>
<?php while ($relatedPosts->next()): ?>
<li>
<a href="<?php $relatedPosts->permalink(); ?>" title="<?php $relatedPosts->title(); ?>"><?php $relatedPosts->title(); ?></a>
</li>
<?php endwhile; ?>
</ul>
<?php else : ?>
<li>无相关文章</li>
<?php endif; ?>
29、隐藏 head 区域的程序版本和模版名称
<?php $this->header("generator=&template="); ?>
30、获取读者墙
<?php
$period = time() - 999592000; // 時段: 30 天, 單位: 秒
$counts = Typecho_Db::get()->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 .= "<a href='" . $c_url . "' title='" . $count['author'] . " (参与" . $count['cnt'] . "次互动)' target='_blank'><img src='" . $avatar . "' alt='" . $count['author'] . "的头像' class='avatar' width='32' height='32' /></a>\n";
}
echo $mostactive; ?>
31、登陆与未登录用户展示不同内容
<?php if($this->user->hasLogin()): ?>
// 登陆可见
<?php else: ?>
// 未登录和登陆均可见
<?php endif; ?>
32、导航页面列表调用隐藏特定的页面 这个演示隐藏了 album 和 search 两个页面
<ul>
<li<?php if($this->is('index')): ?> class="current"<?php endif; ?>><a href="<?php $this->options->siteUrl(); ?>">主页</a></li>
<?php $this->widget('Widget_Contents_Page_List')->to($pages); ?>
<?php while($pages->next()): ?>
<?php if (($pages->slug != 'album') && ($pages->slug != 'search')): ?>
<li<?php if($this->is('page', $pages->slug)): ?> class="current"<?php endif; ?>><a href="<?php $pages->permalink(); ?>" title="<?php $pages->title(); ?>"><?php $pages->title(); ?></a></li>
<?php endif; ?>
<?php endwhile; ?>
</ul>
//参数说明:9.0 版 typecho 支出在后台管理页面编辑时选择隐藏页面。
33、归档页面
<?php $this->widget('Widget_Contents_Post_Recent', 'pageSize=10000')->to($archives);
$year=0; $mon=0; $i=0; $j=0;
$output = '<div id="archives">';
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 .= '</ul></li>';
if ($year != $year_tmp && $year > 0) $output .= '</ul>';
if ($year != $year_tmp) {
$year = $year_tmp;
$output .= '<h3 class="al_year">'. $year .' 年</h3><ul class="al_mon_list">'; //输出年份
}
if ($mon != $mon_tmp) {
$mon = $mon_tmp;
$output .= '<li><span class="al_mon">'. $mon .' 月</span><ul class="al_post_list">'; //输出月份
}
$output .= '<li>'.date('d日: ',$archives->created).'<a href="'.$archives->permalink .'">'. $archives->title .'</a> <em>('. $archives->commentsNum.')</em></li>'; //输出文章日期和标题
endwhile;
$output .= '</ul></li></ul></div>';
echo $output;
?>
34、获取当前文章页缩略图
<?php if ($this->attachment->isImage): ?>
<?php $this->attachments(1)->attachment->url(); ?>
<?php endif; ?>
//务必注意,这里所谓缩略图指的是当前文章页第一个附件地址,请确保第一个附件类型为图片。
35、根据页面类型显示内容
//判断是文章页则显示内容
<?php if ($this->is('post')): ?>
//想要显示的内容1
<?php endif; ?>
//判断是about页面页则显示内容
<?php if ($this->is('page', 'about')): ?>
//想要显示的内容2
<?php endif; ?>
36、Title增加副标题
<?php if ($this->is('index')): ?> - 副标题<?php endif; ?>
37、按分类输出cms
<div class="row">
<?php $this->widget('Widget_Metas_Category_List')->to($categories); ?>
<?php while ($categories->next()): ?>
<?php if(count($categories->children) === 0): ?>
<?php $this->widget('Widget_Archive@category-' . $categories->mid, 'pageSize=5&type=category', 'mid=' . $categories->mid)->to($posts); ?>
<div class="col-lg-6">
<div class="panel panel-default">
<div class="panel-heading">
<i class="glyphicon glyphicon-th"></i> <a href="<?php $categories->permalink(); ?>" class="guidang" id="posts-list-<?php $categories->slug(); ?>"><?php $categories->name(); ?></a>
<a href="<?php $categories->permalink(); ?>" class="pull-right" id="posts-list-<?php $categories->slug(); ?>"><i class="glyphicon glyphicon-option-horizontal"></i></a>
</div>
<div class="panel-body">
<?php while ($posts->next()): ?>
<p class="overflow">
<a href="<?php $posts->permalink(); ?>" title="<?php $posts->title(40); ?>"><i class="glyphicon glyphicon-chevron-right"></i> <?php $posts->title(40); ?></a>
</p>
<?php endwhile; ?>
</div>
</div>
</div>
<?php else: ?>
<?php endif; ?>
<?php endwhile; ?>
</div>
未完待续……
文章标题:Typecho 语法及函数集合
分类标签:折腾,typecho,主题模板,工具代码
文章链接:https://80srz.com/posts/889.html
许可协议: 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)
分类标签:折腾,typecho,主题模板,工具代码
文章链接:https://80srz.com/posts/889.html
许可协议: 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)