博主使用 Typecho 也有个一两年了,在使用 Typecho 的过程中,我学习到了不少的 PHP 技能,我不仅可以做 TC 的模板开发及插件开发,还可以编写属于自己的简易 CMS 程序。但是 Typecho 的官方文档介绍的相当不详细,很多内置了的方法却没有写出来被众人所了解。下面就给大家分享一些我所了解的一些不为人知的函数和变量,可以以此开发更多的扩展功能。这篇文章将长期不间断更新,欢迎关注~

日用技巧

如果你的网站使用了 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 源,例如 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);

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

$this -> user -> hasLogin();

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

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

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

$this -> pageLink('Previous');
$this -> pageLink('Next', 'next');