ZBlogPHP如何设置文章置顶？

ZBlogPHP是一款开源的博客程序，为了实现文章置顶功能，你需要修改配置文件config.inc.php，在配置文件中找到'sticky_post'设置项并将其值设置为true，这样，文章就可以在发布后自动置顶，吸引读者关注，你还需要创建一个专门的置顶文章页面模板文件，并在文章的meta关键字中添加“sticky”标识符，这样，在首页和自定义文章列表页面中，带有"sticky"标识符的文章会显示在前面。

在ZBlogPHP框架中，实现文章置顶功能是一个相对简单的过程，置顶文章不仅可以提高文章的曝光率，还能吸引更多读者的关注,本文将详细介绍如何在ZBlogPHP中设置文章置顶。

了解ZBlogPHP的文章模型

在开始设置之前，首先需要了解ZBlogPHP的文章模型，ZBlogPHP使用MVC（Model-View-Controller）架构模式，其中文章数据存储在数据库中，并通过控制器和视图进行展示和管理，在ZBlogPHP中，文章通常分为两类：普通文章和置顶文章。

普通文章：这些文章按照发布时间排序显示在文章列表中。

置顶文章：这些文章会被特殊标记,以便它们始终显示在文章列表的顶部。

在数据库中创建置顶文章字段

要实现文章置顶功能，首先需要在数据库中为文章表添加一个字段来标记文章是否被置顶,可以在ZBlogPHP的数据库迁移文件或直接在数据库中执行以下SQL语句：

ALTER TABLE `'zblog`.`posts` ADD `'is_sticky'` BOOLEAN NOT NULL DEFAULT 0;

这个字段名为is_sticky，表示文章是否被置顶，默认值为0，表示文章不是置顶状态；当值为1时,表示文章被置顶。

编写置顶逻辑

需要在ZBlogPHP的控制器或插件中编写置顶逻辑,这里以控制器为例：

class PostController extends \Z Blog\Controller {}
public function stickyPostAction()
{
    // 获取文章ID
    $postId = $this->request->param('id');
    // 检查文章是否存在
    $post = \ZBlog\Model\Post::find($postId);
    if (!$post) {
        \Z\Ext\Debug::error("文章不存在", __FUNCTION__, 404);
    }
    // 判断文章是否已经置顶
    if ($post->is_sticky == 1) {
        \Z\Ext\Debug::info("文章已置顶，无需重复置顶", __FUNCTION__, 300);
        return;
    }
    // 将文章置顶
    $post->is_sticky = 1;
    $post->save();
    // 重定向到文章详情页或其他页面
    $this->forward('post_detail', ['postId' => $postId]);
}

在这个控制器方法中，我们首先获取文章ID，然后检查文章是否存在，我们判断文章是否已经置顶，如果没有，则将is_sticky字段设置为1，并保存文章,重定向到文章详情页或其他页面。

配置URL路由

为了让用户可以通过点击一个链接来置顶文章,需要在ZBlogPHP的配置文件中添加相应的URL路由：

// application/config/routes.php
$router->add(['uri' => '/post/sticky/:id', 'action' => 'PostController/stickyPost']);

这个路由表示，当用户访问/post/sticky/:id这样的URL时，将会调用StickyPostController类的stickyPostAction方法。

前端展示置顶文章

在ZBlogPHP的前端模板中，可以通过判断文章的is_sticky字段来决定文章是正常显示还是置顶显示,这里以一个简单的列表渲染为例：

<!-- application/view/post/list.htm -->
{if $posts}
  <ul>
    {foreach $posts as $post}
      <li {$post.post_url} {$post.title}>
        {'若文章已置顶'} <span class="sticky标记">●</span> {'若文章未置顶'}
      </li>
    {/foreach}
  </ul>
{/if}

通过这样的方式,我们可以清晰地看到哪些文章被置顶。