Z-Blog 官方文档

文章上一篇自定义接口 ​

在 Z-BlogPHP 中读取文章对象的 Prev 属性（即上一篇）时会触发 Filter_Plugin_Post_Prev 接口，回调返回非空结果即作为上一篇使用，返回空则继续执行系统默认查询，适合实现「同分类上一篇」「同作者上一篇」等自定义逻辑。

接口信息 ​

接口参数说明
Filter_Plugin_Post_Prev$postPost 类的 Prev 接口

完整案例 ​

下例把「上一篇」改为同分类内按发布时间倒序的上一篇文章：

php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Post_Prev', 'demoAPP_Post_Prev');
}

function demoAPP_Post_Prev($post)
{
    global $zbp;

    if ($post->Type != 0) {
        return '';
    }

    $articles = $zbp->GetPostList(
        array('*'),
        array(
            array('=', 'log_Type', 0),
            array('=', 'log_Status', 0),
            array('=', 'log_CateID', $post->CateID),
            array('<', 'log_PostTime', $post->PostTime)
        ),
        array('log_PostTime' => 'DESC'),
        array(1),
        null
    );

    if (count($articles) == 1) {
        return $articles[0];
    }

    return '';
}

注意事项 ​

  • 触发时机在读取 Prev 属性时；回调返回值只要非空（!== ''）就作为上一篇，返回空字符串或 null 时系统继续按默认规则查询全站上一篇。
  • 无需设置 PLUGIN_EXITSIGNAL_RETURN 信号，本接口按「返回值是否为空」判断是否生效。
  • 返回的结果会被缓存在当前文章对象内，同一对象重复读取 Prev 不会重复触发本接口。
  • 自定义查询请保持与系统默认相似的过滤条件（已发布 log_Status = 0 等），避免把草稿、审核中的文章泄露到前台。