Typecho中Widget_Archive的API用法

Typecho中Widget_Archive的详解

Widget_Archive的内涵 Widget_Archive是Typecho中非常重要的一个组件，基本上所有文章/页面内容的渲染都离不开这个组件。 Widget_Archive类位于/var/Wi...

时间:2021/4/7 分类:建站教程 人气:654 评论:0

成员属性

包括Widget_Archive本身的成员变量或者从父类继承的成员变量。

$this->options

Widget_Options的一个实例，详细手册请参考《Typecho中的Widget_Options》

Typecho中的Widget_Options用法

通过Typecho的Widget_Options，可以方便地获取Typecho的系统信息，或者方便地获取相关配置、资源路径等。这里列出常用的Widget_Options函数和用法，方便各位筒子方便查阅...

时间:2021/4/7 分类:建站教程 人气:922 评论:1

$this->db;

Typecho_DB的一个实例，用于访问当前的DB资源，详细请参考《Typecho中的数据库API》

Typecho数据库常用API

表创建和删除 在Typecho插件开发过程中，往往需要创建自己的表。上文提到Typecho_Db类中的query函数，可用于执行所有sql语句，因此我们使用query()来进行表的创建、修改或者删除。...

时间:2021/4/7 分类:建站教程 人气:517 评论:0

$this->user;

Widget_User的一个实例，用于访问当前用户的信息

$this->request;

Typecho_Request的一个实例

$this->request;

Typecho_Response的一个实例

栈属性

如果在列表页面中，譬如index.php或者category.php，则通过$this->next()函数来迭代，如果在文章页面譬如post.php中，则可以直接访问。

譬如，在category.php页面中：

在post页面中，则可以直接输出title：

常用字段：

• allowComment,String类型,1或者0
• allowFeed,String类型,1或者0
• allowPing,String类型,1或者0
• category,String类型,文章所在分类的slug值，譬如default
• cid,String类型，文章的ID
• commentsNum,String类型，该文章的评论数
• permalink,String类型，文章的有效链接
• slug,String类型，文章的slug
• text,String类型,文章的内容
• title,String类型，文章的标题
• type,String类型，文章的类型，譬如post/page等
• authorId,String类型,作者ID

时间类字段:

• created,String类型，该文章的创建时间，时间戳形式，譬如1431954420
• modified,String类型，文章的修改时间，时间戳形式
• day,String类型，文章创建的日期，譬如’25’
• month,String类型，文章的创建月份，譬如05
• year，String，文章创建时间的年份信息，譬如2015
• date,Typecho_Date类型，文章的创建时间

分类信息：

• categories,Array类型，每个数组元素均是一个分类信息，譬如：array (size=14)
  ‘mid’ => string ‘1’ (length=1)
  ‘name’ => string ‘默认分类’ (length=12)
  ‘slug’ => string ‘default’ (length=7)
  ‘type’ => string ‘category’ (length=8)
  ‘description’ => string ‘只是一个默认分类’ (length=24)
  ‘count’ => string ‘2’ (length=1)
  ‘order’ => string ‘1’ (length=1)
  ‘parent’ => string ‘0’ (length=1)
  ‘cid’ => string ‘3’ (length=1)
  ‘directory’ =>
  array (size=1)
  …
  ‘permalink’ => string ‘https://www.typechodev.com/index.php/category/default/‘ (length=45)
  ‘feedUrl’ => string ‘https://www.typechodev.com/index.php/feed/category/default/‘ (length=50)
  ‘feedRssUrl’ => string ‘https://www.typechodev.com/index.php/feed/rss/category/default/‘ (length=54)
  ‘feedAtomUrl’ => string ‘https://www.typechodev.com/index.php/feed/atom/category/default/‘ (length=55)
• directory,Array类型，表示文章所在的分类结构，譬如：array (size=3)
  0 => string ‘default’ (length=7)
  1 => string ‘dev’ (length=3)
  2 => string ‘debug’ (length=5)

其他字段：

• feedAtomUrl,String类型，譬如：’https://www.typechodev.com/index.php/feed/atom/archives/3/‘
• feedRssUrl,String类型，譬如：’https://www.typechodev.com/index.php/feed/rss/archives/3/‘
• feedUrl,String类型，譬如：’https://www.typechodev.com/index.php/feed/archives/3/‘
• hidden，Boolean类型，文章是否隐藏
• isMarkdown,Boolean类型，文章是否Markdown格式
• order,String类型，文章的序号
• parent,String类型，此条记录的所属。譬如在附件中，parent会记录此附件的所属文章
• password,String类型，文章的查看密码
• pathinfo,String类型，譬如’/archives/3/’
• status,String类型，文章的状态，譬如publish
• template,String类型，文章的模板，譬如在page中可以指定自定义模板

注意：以上属性，类型是String的，均使用如下规则：
$this->title，表示获取值，譬如$title = $this->title;echo $title;
$this->title(),表示直接输出，等效于上面的语句。

成员函数

• $this->theNext()，输出下一篇文章的链接，含标题等信息
• $this->thePrev()，输出上一篇文章的链接，含标题
  //TODO，其他待补充。