马春杰杰博客
致力于深度学习经验分享!

Typecho中Widget_Archive的详解

文章目录
[隐藏]

Widget_Archive的内涵

Widget_Archive是Typecho中非常重要的一个组件,基本上所有文章/页面内容的渲染都离不开这个组件。
Widget_Archive类位于/var/Widget/Archive.php里面,其继承关系如下:

Typecho中Widget_Archive的详解

所以,在实际开发过程中,需要关注的api主要有两类,1.Widget_Archive中的各种get函数,2.Typecho_Wdiget中的魔术函数。

  1. Widget_Archive中的各种get函数
    这类函数包括getArchiveSlug()/getArchiveType()/getArchiveTitle()等等,各位在制作Typecho模板的时候,可以即时参考源代码,这里就不一一赘述。
  2. Typecho_Wdiget中的魔术函数

魔术函数__get($name),获取内部变量

从贴出的代码可以看出,当我们在模板页面中调用$this->author的时候,会发生什么事情呢?首先,看看当前row中是否存在key为author的值(row里面的内容一般情况下和数据表字段一一对应),如果有则直接返回。如果没有找到,那么继续尝试找是否存在名为__author的函数,有则直接调用。如果还是没有找到,那么继续尝试从找插件中找。

魔术函数__set($name,$value),改变当前row的值

这个比较简单,就不细说了。在实战中,可以通过这个方式来临时改变row中的内容,以供其他地方调用。

魔术函数__call($name),直接输出当前row中的某个值

譬如在模板中调用$this->author(),那么会直接输出作者名到模板中。但注意看上面的代码,这个调用方式不是return回来的,而是直接echo出去的。

Widget_Archive路由

究竟从哪些url会路由到Widget_Archive呢?或者说Widget_Archive会处理哪些业务呢?从《Typecho路由速查》一文,可以查到,首页、文章、附件、归档等等请求,都会路由到Widget_Archive中。

以post页为例,简要说明

假如存在url https://www.typechodev.com/index.php/archives/9/,从上述的路由表可以看到,此url将会匹配如下路由:

PS:如果对Typecho的路由机制不熟悉,可以参考《Typecho中的路由解析》一文。

Typecho中的路由解析

文章目录[隐藏] 路由概述原理分析自定义路由 路由概述 路由的功能简单的说就是根据请求(即URL)找到对应业务代码(或者说控制器,Controller),请求来自用户端,业务由系统提供,路由器的主要任...

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

匹配之后,发生了什么事情呢?

  1. Typecho的路由系统对url进行解析以及正则匹配,最终会将Widget_Archive这个类load进来并进行初始化。
  2. Widget_Archive初始化阶段,Typecho的Widget系统会将cid=10作为参数,来初始化这个Widget_Archive控件,并执行Widget_Archiveexecute()函数。
  3. 最后,Typecho的路由系统拿到步骤2中初始化的Widget_Archive实例后,执行其render()函数,进行页面渲染。

提醒:Widget_Archive的render函数中,是通过require_once的方式来加载主题页面片的,所以在页面片中(譬如post.php),才可以直接使用$this来调用Widget_Archive实例中的函数。

Widget_Archive常见用法:

以slug方式加载某分类文章列表:

$archives = $this->widget('Widget_Archive', 'pageSize=10&type=category&page='.$page, 'slug='.$slug)

以mid方式加载某分类文章列表:

$archives = $this->widget('Widget_Archive', 'pageSize=10&type=category&page='.$page, 'mid='.$slug)

加载搜索结果列表:

$archives = $this->widget('Widget_Archive', 'pageSize=10&type=search&page='.$page, 'keywords='.$query);

如果你对这篇文章有什么疑问或建议,欢迎下面留言提出,我看到会立刻回复!

打赏
未经允许不得转载:马春杰杰 » Typecho中Widget_Archive的详解
蝴蝶PT招人啦

留个评论吧~ 抢沙发 评论前登陆可免验证码!

私密评论
  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址(选填,便于回访^_^)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

切换注册

登录

忘记密码 ?

切换登录

注册