Widget_Archive开发文档

如果需要更加原理性的讲解,请移步到《Typecho中Widget_Archive详解》,本文主要列举并介绍Widget_Archive的API用法。
Widget_Archive是用于加载皮肤文件的主要入口,包括加载index.php/search.php/page.php/category.php等。

成员属性

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

$this->options

Widget_Options的一个实例,详细手册请参考《Typecho中的Widget_Options》
Widget_Options的基本用法:

$this->options->index();//输出当前网站的index页面url
$this->options->index('/category/slug/');输出/index.php/category/slug/
$this->options->themeUrl('/img/logo.png');输出当前主题的资源地址,譬如/usr/themes/MyTheme/img/logo.png

$this->db;

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

$this->user;

Widget_User的一个实例,用于访问当前用户的信息,详细请参考《Typecho中的Widget_User手册》

$this->request;

Typecho_Request的一个实例,详细参考《Typecho中的Typezho_Request手册》

$this->request;

Typecho_Response的一个实例,详细参考《Typecho中的Typecho_Response手册》

栈属性

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

譬如,在category.php页面中:

while($this->next()){
    $this->title();
}

在post页面中,则可以直接输出title:

$this->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类型,文章的创建时间

分类信息:

其他字段:

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

成员函数

  • $this->theNext(),输出下一篇文章的链接,含标题等信息

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


版权声明:未经书面授权禁止转载、摘编、复制或建立镜像。对既成事实本站将保留所有的权利。