博主使用 Typecho 也有个一两年了,在使用 Typecho 的过程中,我学习到了不少的 PHP 技能,我不仅可以做 TC 的模板开发及插件开发,还可以编写属于自己的简易 CMS 程序。

但是呢 Typecho 的官方文档介绍的相当不详细,程序内置了许多很有用的方法却没有编写出来。下面就给大家分享一些我所了解的一些不为人知的函数和变量,可以以此开发更多的扩展功能。这篇文章将长期不间断更新,欢迎关注~

切换 IP 来源获取

如果你的网站使用了 CloudFlare 一类的 CDN 服务使得部分插件无法正常记录用户 IP 地址的话,可以在 config.inc.php 声明这个静态变量,替换成服务商对应的用户 IP 头就可以了!CloudFlare 现在默认提供的是 HTTP_X_FORWARDED_FOR 头传送用户真实 IP 地址,所以我直接填入头的名称就可以了!

define('__TYPECHO_IP_SOURCE__', 'HTTP_X_FORWARDED_FOR');

使用自己的静态存储

如果你有自己的 CDN 或静态存储,希望 Typecho 不使用默认的站点地址来分发内容,可以在 config.inc.php 声明这个静态变量,替换成你自己的附件地址即可!REQUEST_SCHEME 是访问站点的协议,所以 HTTP、HTTPS 都可以使用。

define('__TYPECHO_UPLOAD_URL__', $_SERVER['REQUEST_SCHEME'] . '://static.paugram.com');

自定义 Gravatar 源

使用自己的 Gravatar 源,例如 V2EX 提供的源。

define('__TYPECHO_GRAVATAR_PREFIX__', 'https://cdn.v2ex.com/gravatar/');

模板开发

这两段函数在模板开发中必不可缺,否则会出现一些奇怪的 Bug!

这段是 Typecho 的头部输出内容,如缺少将导致文章评论出现异常。建议放在 header.php 里面。

$this -> header();

这段是 Typecho 的尾部输出内容,如缺少将可能导致部分需要前端支持的插件无法使用。建议放在 footer.php 里面。

$this -> footer();

输出头像

这段函数用于输出当前页面的作者头像,可以用来做作者介绍和版权提示。参数是头像尺寸,建议大于等于 64 像素。

$this -> author -> gravatar(64);

输出当前登录用户的头像地址,可以用于评论区的输出。

echo Typecho_Common::gravatarUrl($this->user->mail, 150, 'X', 'mm')

检测是否登录

用于检测用户是否登录,已登录返回 true 否则为 false,可以用来实现模板内的评论框结构变更,或是限制模板页面的内容不对外显示。

$this -> user -> hasLogin();

页面链接

输出上一页 / 下一页的链接

$this -> pageLink('上一页');
$this -> pageLink('下一页', 'next');

文章时间

获得文章创建的时间

$this -> created

获得文章上次修改的时间

$this -> modified

计算文章修改自多少天前

ceil((time() - $this -> modified) / 86400) // 当前时间减去修改时间,换算为天并取整