dynamic/silverstripe-elemental-blog

Show recent posts from a featured blog.

Installs: 40 535

Dependents: 3

Suggesters: 0

Security: 0

Stars: 1

Watchers: 7

Forks: 10

Open Issues: 3

Type:silverstripe-vendormodule

3.0.1 2023-09-13 16:34 UTC

This package is auto-updated.

Last update: 2024-03-13 02:40:00 UTC


README

Recent Blog Posts Element for the SilverStripe Elemental module.

CI codecov

Latest Stable Version Total Downloads Latest Unstable Version License

Requirements

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

Installation

composer require dynamic/silverstripe-elemental-blog

License

See License

Usage

There are four blocks available for you to use. It is likely that you will not want all of them to be available to content authors, so it is recommended that you review what the purpose of each block is, and then add the ones you don't need to disallowed_elements.

The four blocks are:

ElementBlogPosts

A block to show a list of recent posts by a featured blog. Ideal for home pages or dashboards.

ElementBlogOverview

The purpose of this block is to replicate the output that was originally being given by the Blog module's Layout template.

Including:

  • Title (including Category/Archive/etc titles)
  • Content
  • Blog Posts
  • Pagination
  • Widgets (if the addon as been added and enabled)

Overview Block - Single

You will likely want to override the very basic default template that has been provided, you can do so by overriding the template found with the namespace Dynamic\Elements\Blog\Elements\ElementBlogOverview.ss.

Controlling pagination & widgets for this block

Pagination config:

  • pagination_field_default: 1 (pagination is enabled by default)
  • show_pagination_field: true (content authors have the ability to turn pagination on or off)

With the default configuration, when an author creates a new Overview block, they will be presented with a checkbox to "Show pagination" (which will be ticked by default). If you do not want your authors to be able to disable pagination, then you can update the show_pagination_field config to false.

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

If you would like pagination to be turned off by default, then you can update the pagination_field_default to 0.

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

Widget config:

  • widgets_field_default: 0 (widgets are disabled by default)
  • show_widgets_field: false (the "Show widgets" field is not displayed to authors by default)

Because the Widget module is an optional addon, the default settings for Widgets is for them to be disabled. You have the same control over the Widgets config as you do for Pagination.

Using this block on Page types other than Blog

Please consider: While the Overview block does support you using it on other page types, it is primarily designed to be used on Blog page types. This is because it is Blog and BlogController that provide the relevant info to this block.

Please consider whether you want this block to be available to other page types, and if you don't, you might want to add this block to disallowed_elements on your other page types. EG:

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

If you do wish this block to be available on other page types, then please review the contents on the class to see how you can dictate what data should be provided to this block.

ElementBlogPagination

You might decide that you would like Pagination to be displayed quite separately to the Overview block. This can be achieved by using ElementBlogPagination as a separate block.

Please consider: Like the Overview Block, please consider removing this block from any/all Page types that you do not want it available on. EG, if you don't want to use it at all, you can disallow it for all pages by default:

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

Overview Block Separated

ElementBlogWidgets

You might decide that you would like Blog Widgets to be displayed quite separately to the Overview. This can be achieved by using ElementBlogWidgets as a separate block.

Please consider: Like the Overview Block, please consider removing this block from any/all Page types that you do not want it available on. EG, if you don't want to use it at all, you can disallow it for all pages by default:

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

Getting more elements

See Elemental modules by Dynamic

Configuration

See SilverStripe Elemental Configuration

Maintainers

Bugtracker

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

  • Create a new issue
  • Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
  • Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.