README

旨在增强您的statamic博客，目前此插件添加了

• 存档内容的路由（具有日期的内容）
• 标签，用于生成集合中所有可能的存档日期列表
• 一个查询作用域，用于在存档路由上过滤您的集合。

安装

通过composer安装

composer require withcandour/statamic-blog-helpers

然后发布服务提供商的可发布内容

php artisan vendor:publish --provider="WithCandour\StatamicBlogHelpers\ServiceProvider"

标签

此插件提供了一个标签，用于为特定的Statamic集合生成存档日期。

默认情况下，生成的日期如下

• 对于当前年份内的任何日期，将提取有记录的每个月份
• 具有早于当前年份开始日期的条目将按其年份分组

此示例将为每个存档日期生成一个选择选项。

{{ blog-helpers-archive:dates collection_name="blog_posts" }}
    <option value="{{ value }}" {{ if selected }}selected{{ /if }}>{{ nice }}</option>
{{ /blog-helpers-archive:dates }}

存档和路由

默认情况下，存档路由遵循以下模式：/{uri}/archive/{year}/{?month}

安装后，将创建一个config/statamic/blog-helpers.php文件。在此文件中，您可以注册您的存档，然后插件将生成路由并处理页面的渲染。

在此示例中，将为/blog页面创建一个存档（例如blog/archive/2021/01）。它将使用blog.archive模板视图和layout布局视图。此页面的标题也将是“来自”，后面跟存档日期。

'archives' => [
    [
        'uri' => '/blog',
        'view' => 'blog.archive',
        'layout' => 'layout',
        'title_prefix' => 'Posts from'
    ],
]

过滤

此插件添加了“blog_helpers_archive_scope”查询作用域，您可以使用它来过滤您的集合，只需提供archive_year和archive_month，它将自动过滤由您的集合标签返回的条目。

在此示例中，将提取2019年3月的blog_posts

{{ collection:blog_posts query_scope="blog_helpers_archive_scope" archive_year="2019" archive_month="03" }}
    <!-- Content -->
{{ /collection:blog_posts }}

year和month变量将被传递到为存档页面渲染的模板，因此您可以简单地使用

{{ collection:blog_posts query_scope="blog_helpers_archive_scope" :archive_year="year" :archive_month="month" }}
    <!-- Content -->
{{ /collection:blog_posts }}