<!-- TITLE: Simple Blog - Magento 2 module documentation--> <!-- SUBTITLE: 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** and **2.3**. ## 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](/uploads/simple-blog/image-4.png "Image 4") Here you will find two sections: **Category Details, Category SEO**. ![Image 1](/uploads/simple-blog/image-1.png "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](/uploads/simple-blog/image-6.png "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](/uploads/simple-blog/image-9.png "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](/uploads/simple-blog/image-5.png "Image 5") In add new post page you will see three sections: **Post Details, Post SEO, Related Products**. ![Image 10](/uploads/simple-blog/image-10.png "Image 10") ![Image 8](/uploads/simple-blog/image-8.png "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](/uploads/simple-blog/image-16.png "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](/uploads/simple-blog/image-12.png "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](/uploads/simple-blog/image-17.png "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](/uploads/simple-blog/image-2.png "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](/uploads/simple-blog/image-7.png "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](/uploads/simple-blog/image-19.png "Image 19") ## Installation ### Composer 1. Add repo to composer.json: ```text "repositories": [ ... { "type": "vcs", "url": "it@git.auroracreation.com:aurora-modules/simple-blog.git" } ... ], ``` 2. Add package to composer.json: ```text "require": { ... "aurora/simpleblog": "*" ... }, ``` 3. In Magento root folder run commands: ```text 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: ```text {Magento root} └── app/ └── code ``` 3. In Magento root folder run commands: ```text php bin/magento module:enable Aurora_Simpleblog php bin/magento setup:upgrade ``` ### Thank you for your interest in our products!