README

BaunCMS的分类插件

安装说明

使用Composer

在命令行使用Composer安装

composer require maccath/baun-categories

或在composer.json中

"require": {
    "maccath/baun-categories": "1.*",
},

配置

将以下行添加到您的config/plugins.php文件中

'BaunPlugin\Categories\Categories',

在您的项目目录中运行以下命令

php baun publish:config maccath/baun-categories

这将创建位于config/plugins/maccath/baun-categories目录中的配置文件，您可以根据需要编辑。

以下是一些可用的配置选项

title：用于分类列表页面和导航中的标题
category_url：访问您博客分类的路径，无需前面的斜杠
exclude_from_nav：（布尔值）是否从导航中排除分类页面

使用说明

将分类添加到文章

要将分类添加到您的文章中，只需将categories: categoryOne, categoryTwo添加到您的博客文章文件顶部。例如，以下文件将创建一个包含分类'volutpat'和'consectetur'的文章

title: Post 1
categories: consectetur, volutpat
----
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque ut vehicula erat. Morbi volutpat posuere auctor. 
Vivamus condimentum, purus nec tempus euismod, enim massa blandit est, vel elementum lacus nulla ut sem. Integer 
orci libero, rutrum id nisl et, euismod auctor augue.

查看特定分类的所有文章

默认情况下，分类文章将出现在以下路径：/categories/categoryName。用于显示分类的路径可以在位于config/plugins/maccath/baun-categories/categories.php的配置文件中进行配置

编辑分类页面模板

在您的主题目录内（通常是public/themes/themeName/），创建categories.html。此文件可以根据您的喜好自定义显示分类列表。以下示例是默认文件内容，它简单地显示了一个无序列表分类

{% extends "layout.html" %}

{% block content %}
<h1>{{ categories_title }}</h1>
<ul>
    {% for category in categories %}
    <li><a href="{{ category.link }}">{{ category.name }}</a></li>
    {% endfor %}
</ul>
{% endblock %}

maccath / baun-categories

维护者

详细信息