Getting Started
Welcome to the documentation of Blog MX for Magento 2 extension.
Whether you are a new or an advanced user, you can find some useful information here.
First of all we recommend you check the following link:
How to install the extension
Prepare for installation
-
Back up your store's database and web directory.
-
Log in to the SSH console of your server and navigate to the root directory of the Magento 2 store.
- Copy the installation instructions from the page My Downloadable Products to the SSH console and press ENTER.
Install the extension via composer
- Run command to enable the extension
php -f bin/magento module:enable Mirasvit_Core Mirasvit_BlogMx
- Run command to install the extension
php -f bin/magento setup:upgrade
- Run command to clean the Magento cache
php -f bin/magento cache:clean
-
Deploy static view files
rm -rf pub/static/*; rm -rf var/view_preprocessed/*;
php -f bin/magento setup:static-content:deploy
Install the extension for Hyva
- Run the command to obtain the Blog MX Hyva component
composer require mirasvit/module-blog-mx-hyva:*
- Enable installed Hyva component:
bin/magento module:enable Hyva_MirasvitBlogMx
- Update Magento database schema and data with the command:
bin/magento setup:upgrade
- Compile the code to generate the contents of Magento var/di folder:
bin/magento setup:di:compile
- Run the command below to clean the cache:
bin/magento cache:flush
Blog MX settings
The settings of Blog Mx are located at Content ▸ Blog MX ▸ Settings and are grouped into the following sections:
- Appearence - basic configuration of the blog appearence in the frontend.
- Display - additional configurations related to the blog appearence in the frontend.
- Search Engine Optimization - SEO settings of the module
- Comments - settings for comments in posts.
- Sharing - configurations for sharing blog posts via social networks, email, etc.
- Layout Settings - configurations related to the way pages of the blog will be displayed on the frontend.
Appearence
Display
- Visible Navigation Menu - if enabled, the link to the blog will be added to the main menu of the website.
- Enable excerpts on list page - When enabled, excerpts will be inserted as follows; if there is a
tag in the post's content, the excerpt will go until that tag,
next if the post has an excerpt that gets used,
lastly, the first n characters of the post (as set below) will be displayed.
- Default Excerpt Character size - set the limit for the number of symbols of the post content to be displayed on the posts list pages.
Search Engine Optimization
- Base URL - the URL key for the blog (will be visible in the URLs for all blog pages).
- Base Meta Title - the part of the page meta title that will be added to all blog pages.
- Base Meta Description - the part of the meta description that will be added to all blog pages.
- URL Suffix for Posts - the suffix of the URLs for all blog post pages.
- URL Suffix for Categories - the suffix of the URLs for all blog category pages.
- Provider - choose the provider for comments or disable them. Currently our extension only supports Facebook comments.
Sharing
- Enable AddThis Sharing Buttons - enable/disable AddThis buttons.
Layout Settings
- Post Layout - choose the template for blog post pages.
- Post List Layout - choose the layout for all post list pages (the main page of the blog, category, author, and tag pages).
- Post List View Mode - select one of the provided view modes for post list pages - List or Grid.
- Sort posts by - choose the sorting for posts in all post list pages.
- Posts per Page - set options for post per page appearence (options for pager toolbar). Comma sepparated values. The default value is
10,20,50
.
Posts
Create a new blog post
Go to Content ▸ Blog MX ▸ All Posts. There you'll see all blog posts

To create a new blog post, click on the Add New Post button and you'll be redirected to the post creation form.

Blog post score checker
Blog post score checker tool analyses the content of the post.
Click "Check content" of the blog post you're looking to analyze to identify possible content issues.

The score checker tool offers full-text analysis for SEO compliance.

Note
Please note that the score checker analysis is based on the fields of the blog posts in the admin.
Categories
Go to Content ▸ Blog MX ▸ Categories. There, you'll see the blog categories organized hierarchically

To create a new category, click on the Add new button and you'll be redirected to the category creation form.
The form is split into 2 tabs:
- General Information - main settings of the blog category.
- Search Engine Optimization - SEO configurations.

Authors
Go to Content ▸ Blog MX ▸ Authors. There, you'll see all authors of the blog posts

To create a new author, click on the Add New Author button and you'll be redirected to the author creation form.

Tags
Go to Content ▸ Blog MX ▸ Tags. There, you'll see all tags of the blog

To create a new blog tag, click on the Add New Tag button and you'll be redirected to the tag creation form.

Widgets
The extension provides you with 2 types of widgets: Vertical and Horizontal.
To add a blog widget, go to Content ▸ Widgets and click on the Add Widget button.
You'll be redirected to the widget creation form.
Choose one of the blog widgets, pick your design theme and press the Continue button.
After that, widget configurations will be available (depending on the selected widget type).
You can see an example of the horizontal widget configurations here:

You can see an example of the vertical widget configurations here:

Vertical widget provides you with the ability to choose the template type of the widget, depending on where you are planning to place it: Full Content or Sidebar.
For the Full content template type, you can also configure the Display Mode of the widget and Excerpts Character Size.
How to upgrade extension
To upgrade the extension, follow these steps:
- Backup your store's database and web directory.
- Login to your server's SSH console and navigate to the root directory of the Magento 2 store.
-
Run command composer require mirasvit/module-blog-mx:* --update-with-dependencies
to update current extension with all dependencies.
Note
There are some cases when the command above is not applicable; it is not possible when updating the current module; neither will it be applicable when upgrading all the Mirasvit modules in a bundle. In this case, the command above will be of no effect.
Run instead composer update mirasvit/*
command. It will update all Mirasvit modules installed in your store.
- Run command
php -f bin/magento module:enable Mirasvit_Core Mirasvit_BlogMx
to enable the extension.
- Run command
php -f bin/magento setup:upgrade
to install updates.
- Run command
php -f bin/magento cache:clean
to clean the cache.
-
Deploy static view files
rm -rf pub/static/*; rm -rf var/view_preprocessed/*; php -f bin/magento setup:static-content:deploy
Note
If you have the Hyva installed, run:
composer require mirasvit/module-blog-mx:* mirasvit/module-blog-mx-hyva:* --update-with-dependencies
Disabling the Extension
Temporarily Disable
To temporarily disable the extension please follow these steps:
- Login to your server's SSH console and navigate to the root directory of the Magento 2 store.
- Run command
php -f bin/magento module:disable Mirasvit_BlogMx
to disable the extension.
- Log in to the Magento backend and refresh the store cache (if enabled).
Note
If you have Hyva installed, run:
php -f bin/magento module:disable Mirasvit_BlogMx Hyva_MirasvitBlogMx
Removing the Extension
To uninstall the extension, please follow these steps:
- Login to your server's SSH console and navigate to the root directory of the Magento 2 store.
- Run the command
composer remove mirasvit/module-blog-mx
to remove the extension.
- Log in to the Magento backend and refresh the store's cache (if enabled).
Note
If you have Hyva installed, run:
composer remove mirasvit/module-blog-mx:* mirasvit/module-blog-mx-hyva:*
1.2.21
(2023-01-26)
Improvements
- Increased maximum content size to 16MB
- Added support of Magento 2.4.6
Fixed
- Assign post to Root Category by default
1.2.20
(2022-12-26)
Fixed
- Translation "About author"
- Displaying a disabled category
1.2.19
(2022-12-22)
Improvements
Fixed
- Mass action Change status
1.2.18
(2022-12-09)
Fixed
- Filter by store in sitemap
1.2.17
(2022-12-08)
Features
- Add posts and categories to sitemap
1.2.16
(2022-11-24)
Fixed
- Issue with blank preview page when reopening.
- Page not found for Post/Category in first level if option Use subcategories is enabled.
- Pagination
- Double slash in url
1.2.15
(2022-10-24)
Features
1.2.14
(2022-09-30)
Fixed
- Category is not visible in any store where this post is visible
1.2.13
(2022-09-22)
Fixed
- Compatibility with php8.1
1.2.12
(2022-09-19)
Fixed
- Compatibility with Page Builder
1.2.11
(2022-09-08)
Fixed
1.2.10
(2022-08-04)
Fixed
- Category links in breadcrumbs
1.2.9
(2022-07-27)
Improvements
- Ability to use different base urls for different store views
1.2.8
(2022-07-05)
Fixed
- Disabled the ability to change the position of an element in Related Posts and Related Products on the post edit page.
1.2.7
(2022-07-04)
Fixed
- "Table or view not found" error on update.
1.2.6
(2022-06-29)
Fixed
- Preventing the creation of unused tables during installation
1.2.5
(2022-06-23)
Improvements
- Ability to disable Related Posts on Product page
1.2.4
(2022-06-20)
Improvements
- remove db_schema_whitelist.json
1.2.3
(2022-06-14)
Fixed
- Fixed the issue with categories and posts not migrated from eav tables
1.2.2
(2022-06-01)
Fixed
- Public access to the draft is forbidden
1.2.1
(2022-05-25)
Fixed
- Issue with Add Related Products if more than one Inventory Source is configured
1.2.0
(2022-05-23)
Improvements
- migrate to declarative schema
1.1.28
(2022-05-12)
Fixed
1.1.27
(2022-05-10)
Fixed
- Issue on Post page when using cache
1.1.26
(2022-05-09)
Fixed
- Issue with Related Products block style
- Compatibility with Magento 2.3.3. and below
1.1.25
(2022-04-08)
Fixed
1.1.24
(2022-04-05)
Improvements
1.1.23
(2022-02-14)
1.1.22
(2022-02-14)
Fixed
- Issue after delete category
1.1.21
(2022-02-04)
Fixed
1.1.20
(2022-01-27)
Improvements
1.1.19
(2022-01-27)
Fixed
- Issue with content checking
1.1.18
(2022-01-21)
Features
- Sorting posts by update date
- Views counter
Improvements
1.1.17
(2022-01-18)
Features
Improvements
Fixed
1.1.16
(2021-12-17)
Improvements
1.1.15
(2021-12-15)
Fixed
- Issue with editing post tags
1.1.14
(2021-12-08)
Fixed
- Issue with post save if Single-Store Mode is enabled
1.1.13
(2021-10-20)
Fixed
- Compatibility with Magento Page Builder
1.1.12
(2021-09-29)
Improvements
- compatibility with third party Page Builder
1.1.11
(2021-09-20)
Fixed
- Issue when changing status via massaction for Magento 2.3
1.1.10
(2021-09-14)
Fixed
1.1.9
(2021-09-14)
Fixed
- Issue when changing status via massaction
1.1.8
(2021-09-07)
Fixed
- Issue with Page Buider for Magento 2.4.3
1.1.7
(2021-06-30)
Fixed
- Issue after delete author,post,category
- Issue after save author,post,category
1.1.6
(2021-06-15)
Fixed
- Clean cache on post/category/author save/delete
1.1.5
(2021-06-09)
Fixed
- Fixed the issue with upgrading extension from free Blog extension
1.1.4
(2021-06-04)
Improvements
- Added id and sort order columns on categories page
Fixed
- Issue with display post if featured image not set
1.1.3
(2021-05-25)
Improvements
- Ability to enable/disable link in the footer
1.1.2
(2021-05-14)
Fixed
- Fixed the issue with not displayed selected store in tag form if 'All Store Views' selected
1.1.1
(2021-04-29)
Fixed
- Magento EE PageBuilder compatibility
1.1.0
(2021-04-27)
Features
- Ability to manage Authors
- Ability to manage Tags
- Full multistore support (Posts, Categories, Authors, Tags)
- Different display modes for post and post list pages
- New widgets (2 types, old widgets will be removed)
- Ability to duplicate posts
- Open Graph meta tags for posts (generated automatically)
1.0.6
(2021-02-15)
Fixed
- rss
- save post without date
1.0.5
(2021-01-19)
Fixed
1.0.4
(2021-01-16)
Fixed
1.0.3
(2020-12-31)
Fixed
- Stored "Store View" does not show in the form (m2.4.1)
1.0.2
(2020-12-30)
Fixed
- Error "Type Error occurred when creating object: Mirasvit\BlogMx\Block\Catalog\RelatedPosts ..."
- Error "TypeError: Return value of Mirasvit\BlogMx\Model\ConfigProvider::getCommentProvider() ..."
1.0.1
(2020-12-18)
Fixed
1.0.0
(2020-12-11)
Features