<!-- 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**, **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  Here you will find two sections: **Category Details, Category SEO**.  **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  **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.  To create post for your newly created category, head to **Content > Blog Posts**. Then click on the **Add New Post** button.  In add new post page you will see three sections: **Post Details, Post SEO, Related Products**.   **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  **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.  In the same way you can assign the post to products in **Display post in products** to show post in the product card  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**.  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**.  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.  ## Demo demo1.magecreation.com ## 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! ## 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.