README

为 SilverStripe Elemental 模块提供的最近博客帖子元素。

要求

silverstripe/blog: ^4.0
dnadesign/silverstripe-elemental: ^5.0

安装

composer require dynamic/silverstripe-elemental-blog

许可证

查看许可证

使用方法

有四个块可供您使用。您可能不希望所有这些块都可供内容作者使用，因此建议您查看每个块的用途，然后添加您不需要的块到 disallowed_elements。

这四个块是

ElementBlogPosts
ElementBlogOverview
ElementBlogPagination
ElementBlogWidgets

ElementBlogPosts

显示特色博客近期帖子的列表块。非常适合主页或仪表板。

ElementBlogOverview

此块的目的在于复制博客模块原始的 Layout 模板的输出。

包括

标题（包括分类/存档等标题）
内容
博客帖子
分页
小部件（如果已添加并启用小部件插件）

您可能希望覆盖提供的基本默认模板，可以通过覆盖以下命名空间中找到的模板来实现：Dynamic\Elements\Blog\Elements\ElementBlogOverview.ss。

控制此块的分页和组件

分页配置

pagination_field_default: 1（默认启用分页）
show_pagination_field: true（内容作者可以启用或禁用分页）

默认配置下，当作者创建新的概览块时，会显示一个复选框“显示分页”（默认选中）。如果您不希望作者禁用分页，则可以将 show_pagination_field 配置更新为 false。

Dynamic\Elements\Blog\Elements\ElementBlogOverview:
  show_pagination_field: false

如果您希望默认关闭分页，则可以将 pagination_field_default 更新为 0。

Dynamic\Elements\Blog\Elements\ElementBlogOverview:
  pagination_field_default: 0

组件配置

widgets_field_default: 0（默认禁用组件）
show_widgets_field: false（默认不向作者显示“显示组件”字段）

由于组件模块是一个可选插件，组件的默认设置是禁用。您对组件配置的控制与对分页的控制相同。

在其他页面类型上使用此块

请考虑：虽然概览块支持您在其他页面类型上使用，但它主要是为博客页面类型设计的。这是因为它是 Blog 和 BlogController 为此块提供相关信息。

请考虑是否希望此块可供其他页面类型使用，如果您不希望使用，您可能希望将此块添加到您其他页面类型的 disallowed_elements 中。例如

App\Model\Page\MyPage:
  disallowed_elements:
    - Dynamic\Elements\Blog\Elements\ElementBlogOverview

如果您希望此块在其他页面类型上可用，请查看类的内容，了解如何指定应提供到该块的数据。

ElementBlogPagination

您可能决定希望分页显示与概览块完全分开。这可以通过使用ElementBlogPagination作为一个单独的块来实现。

请考虑以下内容：与概览块类似，请考虑从您不希望其可用的所有/任何页面类型中移除此块。例如，如果您根本不想使用它，您可以默认禁止所有页面的使用。

Page:
  disallowed_elements:
    - Dynamic\Elements\Blog\Elements\ElementBlogPagination

ElementBlogWidgets

您可能决定希望博客小部件显示与概览完全分开。这可以通过使用ElementBlogWidgets作为一个单独的块来实现。

Page:
  disallowed_elements:
    - Dynamic\Elements\Blog\Elements\ElementBlogWidgets

获取更多元素

查看Dynamic的Elemental模块

配置

查看SilverStripe Elemental配置

维护者

Dynamic (dev@dynamicagency.com)

问题追踪器

问题在该存储库的问题部分进行跟踪。在提交问题之前，请先阅读现有问题，以确保您的问题具有独特性。

如果问题看起来像是新的错误

创建一个新的问题
描述重现您问题的步骤以及预期的结果。单元测试、截图和屏幕录制在这里可能会有所帮助。
尽可能详细地描述您的环境：SilverStripe版本、浏览器、PHP版本、操作系统、安装的任何SilverStripe模块。

请直接向模块维护者报告安全问题。请不要在问题追踪器中提交安全问题。

开发和贡献

如果您想为此模块做出贡献，请确保提出一个拉取请求，并与模块维护者进行讨论。

dynamic / silverstripe-elemental-blog

维护者

详细信息