钧言极客钧言极客

不因何事去制作
只因兴趣而创造

Typecho主题开发常用函数调用

  • 站点名称
<?php $this->options->title() ?>
  • 站点网址
<?php $this->options ->siteUrl(); ?>
  • 完整路径标题如分享几个Typecho中常用的调用函数
<?php $this->archiveTitle(' &raquo; ', < span class="string">'', ' | '); ?><?php $this ->options->title(); ?>
  • 站点说明
<?php $this->options->description() ?>
  • 模板文件夹地址
<?php $this->options->themeUrl(); ?>
  • 导入模板文件夹内的php文件
<?php $this< /span>->need('.php'); ?>
  • 文章或者页面的作者
<?php $this->author(); ?>
  • 作者头像
< ?php $this->author->gravatar('40') ?>

此处输出的完整的img标签,40是头像的宽和高。

  • 该文作者全部文章列表链接
<?php $this->author->permalink (); ?>
  • 该文作者个人主页链接
<?php $this->author->url(); ?>
  • 该文作者的邮箱地址
<?php $this->author->mail(); ?>
  • 上一篇与下一篇调用代码
上一篇
<?php $this->thePrev(); ?>
下一篇
<?php $this->theNext(); ?>
  • 判断是否为首页,输出相关内容
<?php if ($this->is('index')): ?>
//首页输出内容
<?php else: ?>
//不是首页输出内容
<?php endif; ?>
  • 文章或页面,评论数目
<?php $this->commentsNum('No Comments', '1 Comment' , '%d Comments'); ?>
  • 文章或页面,评论数目
<?php $this->commentsNum('No Comments', '1 Comment' , '%d Comments'); ?>
  • 截取部份文章(首页每篇文章显示摘要),350是字数
<?php $this->excerpt(350, '.. .'); ?>
  • 调用自定义字段
<?php $this->fields->fieldName ?>
  • RSS地址
<?php $this->options->feedUrl(); ?>
  • 获取最新post
<?php $this->widget('Widget_Contents_Post_Recent', 'pageSize=8&type=category')->parse('<li><a href="{permalink}">{title}</a></li>'); ?>
  • 纯文字分类名称,不带链接
<?php $this->category(',', false); ?>
  • 获取文章分类列表
<ul>
<?php $this->widget('Widget_Metas_Category_List')->parse('<li><a href="{permalink}">{name}</a> ({count})</li>'); ?>
</ul>
  • 获取某分类post
<ul>
<?php
$this->widget('Widget_Archive@indexyc', 'pageSize=8&type=category', 'mid=1')
->parse('<li><a href="{permalink}" title="{title}">{title}</a></li>'); ?>
</ul>
  • 获取最新评论列表
<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>
  • 首页获取 最新文章 代码限制条数
<?php while ($this->next()): ?>
<?php if ($this->sequence <= 3): ?>
// html逻辑
<?php endif; ?>
<?php endwhile; ?>
  • 获取最新评论列表第二个版本,只显示访客评论不显示博主也就是作者或者说自己发的评论
<?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; ?>
  • 获取文章时间归档
<ul>
<?php $this->widget('Widget_Contents_Post_Date', 'type=month&format=F Y')->parse('<li><a href="{permalink}">{date}</a></li>'); ?>
</ul>
  • 获取标签集合,也就是标签云
<?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, 20, 30); ?>"><?php $tags->name(); ?></a>
<?php endwhile; ?>
  • 输出随机颜色标签云
<?php $this->widget('Widget_Metas_Tag_Cloud', 'ignoreZeroCount=1&limit=30')->to($tags); ?>
<ul class="tags-list">
<?php while($tags->next()): ?>
<li><a style="color: rgb(<?php echo(rand(0, 255)); ?>, <?php echo(rand(0,255)); ?>, <?php echo(rand(0, 255)); ?>)" href="<?php $tags->permalink(); ?>" title='<?php $tags->name(); ?>'><?php $tags->name(); ?></a></li>
<?php endwhile; ?>
<?php else: ?>
<li><?php _e('没有任何标签'); ?></li>
<?php endif; ?>
</ul>
  • 调用该文相关文章列表
<?php $this->related(5)->to($relatedPosts); ?>
    <?php if ($relatedPosts->have()): ?>    //这句也可以写成 if (count($relatedPosts->stack))
    <?php while ($relatedPosts->next()): ?>
        <li><a href="<?php $relatedPosts->permalink(); ?>" title="<?php $relatedPosts->title(); ?>"><?php $relatedPosts->title(); ?></a></li>
    <?php endwhile; ?>
    <?php else : ?>
        <li>无相关文章</li>
    <?php endif; ?>
  • 隐藏head区域的程序版本和模版名称
<?php $this->header("generator=&template="); ?>
  • 获取读者墙
<?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; ?>
  • 登陆与未登录用户展示不同内容
<?php if($this->user->hasLogin()): ?>
登陆可见
<?php else: ?>
未登录和登陆均可见
<?php endif; ?>
  • 导航页面列表调用隐藏特定的页面 这个演示隐藏了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>
  • 根据页面类型显示不同内容

判断为首页则显示内容

<?php if ($this->is('post')): ?>
想要显示的内容1 
<?php endif; ?>

判断不同页面显示内容

<?php if ($this->is('index')): ?>
//首页 显示内容
<?php elseif ($this->is('post')): ?>
//文章 显示内容
<?php else: ?><
//页面 显示内容
<?php endif; ?>

这里可以利用<?php elseif ($this->is('函数')): ?>添加其他函数,继续显示不同的内容

  • 获取文章第一张缩略图
<?php $this->attachments(1)->attachment->url(); ?>

获取缩略图指当前文章第一个附件地址,确保第一附件为图片

<?php if($this->attachments(1)->attachment->isImage) $this->attachments(1)->attachment->url(); ?>

判断是否为图片,继续输出

  • 自定义首页描述description
<?php if($thisis('index')): ?>
<?php this->header('description=详细描述内容部分内容,自定义即可。'); ?>
<?php else:?>
<?php $this-> header(); ?>
<?php endif;?>
  • 登录与未登录显示不同内容
<?php if($this-user->hasLogin()): ?>
登陆可见
<?php eles: ?>
未登录和登陆均可见
<?php endif;?>
未经允许不得转载:钧言极客 » Typecho主题开发常用函数调用

评论 3

  1. 这主题在哪可以下载呀

    师兄今天想开了吗    /  (2020-04-13) 回复
    • typecho dux的主题:https://coding.net/u/Arco-X/p/DUX-for-Typecho/git

      dux修改版:
      https://github.com/hiCasper/Typecho-theme-DUX

      我这个是自己改的,还在完善暂时还没有发出来,有需求可以自己下载自己修修

      ღ钧言ღ    /  (2020-04-13) 回复
  2. 来踩踩,很有用

    久夜    /  (2020-04-15) 回复