Simple Blog - Magento 2 module documentation

Author: Marek Milewski

Simple Blog Module

Module overview

Tell stories, that convert your visitors into customers. Simple Blog module lets you build your own blog base that increases greatly the chances of engagement by your visitors, after all, product page is less attractive than interesting post with a catchy headline. New content for your website may also improve your site SEO; someone my find your posts interesting enough to link them on their site. Also keeping regular blog signals visitors that your site is being updated. Separate your blogs into categories, to make it easier to look through.

Module compatibility

This module is compatibile with Magento Community versions: 2.2, 2.3, 2.4.

How it works

After installing the module, head to Admin Panel to add first Blog Category. Go to Content > Blog Category. Click on Add New Category button to add category

Image 4

Here you will find two sections: Category Details, Category SEO.

Image 1

Name – assign name to your categories
Url – assign custom Url to your categories
Store View – a store/store view that this category should be visible in
Enable category - turns on or off visibility of your category
Sort – keep your Blog organised by sorting categories

Image 6

Meta Title – create a custom meta title
Meta Description – create a custom meta description
Meta Keywords - create a custom keywords element

Added category will be shown in Content > Blog Category grid.

Image 9

To create post for your newly created category, head to Content > Blog Posts. Then click on the Add New Post button.

Image 5

In add new post page you will see three sections: Post Details, Post SEO, Related Products.

Image 10

Image 8

Enable post– turns on or off visibility of your post
Title - type in your custom title
Url – assign custom Url to your posts
Main Image – add image to the post (optional)
Short Description – write a description to your post, you can either use html editor or WSWIG
Content – create content for your post, you can either use html editor or WSWIG
Category – assign a post to a category or categories, it will be shown under those categories

Image 16

Meta Title – create a custom meta title
Meta Description – create a custom meta description
Meta Keywords - create a custom keywords element

Assign products in post section lets you assign products that will be shown under your post.

Image 12

In the same way you can assign the post to products in Display post in products to show post in the product card

Image 17

Added posts should be seen in the Content > Blog Posts grid.

To make your blog more flexible we added option to limit Items amount in default and specific category. Go to Stores > Configuration > Simpleblog > Blog configuration.

Image 2

Simple Blog module content is located under homepage/blog location. You can access its adres from any page of your store that contains the sidebar.

Image 7

Blog page contains categories listed on the left and main content in the middle. Clicking on the post title or Read Post redirects you to the post page, when you can see whole post content.

Image 19

Demo

Installation

Composer

  1. Add repo to composer.json:
"repositories": [
    ...
    {
        "type": "vcs",
        "url": "it@git.auroracreation.com:aurora-modules/simple-blog.git"
    }
    ...
],
  1. Add package to composer.json:
"require": {
    ...
    "aurora/simpleblog": "*"
    ...
},
  1. In Magento root folder run commands:
composer update aurora/simpleblog
php bin/magento module:enable Aurora_Simpleblog
php bin/magento setup:upgrade

Manual

  1. Unzip archive.
  2. Upload extension files on your server to:
{Magento root}
└── app/
    └── code
  1. In Magento root folder run commands:
php bin/magento module:enable Aurora_Simpleblog
php bin/magento setup:upgrade

Thank you for your interest in our products!

Changelog

v2.1.0

- Add widget post list

v2.0.11

- Add routing to all posts pager.

v2.0.10

- Change default way to sorting posts.

v2.0.9

- ???

v2.0.8

- Fix typed properties.

v2.0.7

- Refactore code for PHP7.4 standart.

v2.0.6

- Add Images in Last Posts widget.

v2.0.5

- Handle possiblity while ID in AssignedPost block will does not exists.

v2.0.4

- Fix category pagination.

v2.0.3

- Change requirements to magento/framework@103.0.*.

v2.0.2

- Fix counstructor types.
- Add API ACL.

v2.0.1

- Fix title on post view.

v2.0.0

- Added API for Models.
- Refactor for PSR.

v1.5.2

- Check if data to unserialize is not null(Block/Post/Post).

v1.5.1

- Add file uploader.

v1.5.0

- Add block AllPosts.
- Add block CategoryTitle.

v1.4.10

- ???

v1.4.9

- Fix pagination.
- Fix limiter.
- Add config.xml with default config values.

v1.4.8

- Fix .xml files for PSR.

v1.4.7

- Update README.md.

v1.4.6

- Fix unit tests.
- Fix noncacheable elements.

v1.4.5

- Update Post Collection, to retrive table name via magento.

v1.4.4

- Fix DataProviders.
- Remove using SuperGlobals variables.
- Fix uploading images.

v1.4.3

- Fix typo while building post URL.

v1.4.2

- Add assigned post template in product page view.

v1.4.1

- Add possibility to assign post to prodcuts.
- Add possibility to insert `Main Image` for post.
- Reorganizing the appearance of the form post.

v1.3.5

- Fix frontend view with all categories.

v1.3.4

- Add helper class to get core configuration values.

v1.3.3

- Fix action Post/Save in PA.

v1.3.2

- ???

v1.3.1

- Update dependencies to match magento2.3.

v1.3.0

- Render metatags on frontend views.

v1.2.0

- Add possibility to bind products with posts.