$this
以下是 Typecho 模板中 $this
常用方法和属性的归纳表格,涵盖主要使用场景和功能:
代码示例 | 用途/说明 | 上下文/备注 |
---|---|---|
$this->options->title | 输出博客标题 | 站点信息,从后台“基本设置”中获取 |
$this->options->description | 输出博客描述(副标题) | 同上 |
$this->options->themeUrl | 获取当前主题目录的URL路径 | 常用于引用主题资源文件(CSS/JS) |
$this->request->get('page') | 获取URL中的参数(例如当前页码 ?page=2 ) | 处理请求参数,需搭配 intval() 使用防止注入 |
$this->user->name | 输出当前登录用户的用户名 | 用户未登录时可能为空 |
$this->user->mail | 输出当前登录用户的邮箱 | 需用户登录 |
$this->header() | 输出网页头部(包括 <head> 内容,由主题的 header.php 控制) | 通常在模板开头调用 |
$this->footer() | 输出网页底部(由主题的 footer.php 控制) | 通常在模板结尾调用 |
$this->content() | 输出当前文章/页面的完整内容(含格式) | 在文章/页面模板(post.php/page.php)中使用 |
$this->excerpt($length=100) | 输出文章摘要,可指定截取长度(默认按分割符或自动截断) | 在首页/列表页中显示摘要时使用 |
$this->title() | 输出当前页面的标题(如文章标题、分类名称等) | 自动根据上下文显示对应标题 |
$this->permalink | 输出当前文章的永久链接 | 在循环中或文章页内使用 |
$this->date('Y-m-d') | 输出文章的发布日期,格式由参数指定 | 支持PHP日期格式,如 Y年m月d日 |
$this->category() | 输出文章所属分类的名称(默认以逗号分隔多分类) | 可搭配 ->split() 遍历多个分类 |
$this->tags() | 输出文章的标签(默认以逗号分隔) | 类似分类处理方式 |
$this->author->name | 输出文章作者的名称 | 在文章模板中替代 $this->user->name |
$this->commentsNum() | 输出文章的评论数量(如“3 条评论”或“暂无评论”) | 自动根据数量显示不同文案 |
$this->comments()->render() | 输出评论列表 | 需在 comments.php 模板中使用 |
$this->pageNav('旧文', '新文') | 输出分页导航(上一页/下一页链接,参数为链接文字) | 在列表页(如分类页)中使用 |
$this->need('sidebar.php') | 嵌入指定模板文件(如侧边栏) | 类似PHP的 include ,但路径基于主题目录 |
$this->is('index') | 判断当前页面是否是博客首页 | 返回布尔值,常用于条件判断 |
$this->is('post') | 判断当前页面是否是文章详情页 | 同上 |
$this->widget('Widget_Archive@index') | 调用其他Widget(如最新文章列表) | 需根据Widget类型传递正确参数 |
https://api.dicebear.com/7.x/bottts/svg?seed=<?php echo $user->mail;?>