Child pages
  • Blog - Magento 2

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.



Blog extension by aheadWorks uses Disqus service to process and manage blog comments. Along with the comment management enhancements Disqus allows defining if guest customers can comment on the blog posts, open a discussion at Disqus forums, and serves as another social platform for your store advertising.


1. Create an account at Disqus;

titleClick to view details

a) Proceed to Disqus website;

b) Click button in the upper right corner of the screen to proceed to the registration form.

You can create an account with one of your social networks account or register via the email. If registering via the email address, - don't forget to check for the 'Confirm email' message from Disqus team after registration.


2. Register new application;


titleClick to view details

a) Proceed to the API Resources page and click button;

Decide on the Application Label, Description, your Organization name and Website. These are used for the Application identification purposes.

Once done, - click button. The application has been created.

b) Once again navigate to API Resourses page and copy the newly created application Secret Key;

Under Application section you can now see the newly created Application. Copy the application Secret Key and paste in into the Disqus Secret Key field of the Blog extension General Settings.

c) The Secret Key is now set and it's time to click 'Admin' link to proceed to adding a site to Disqus.


3. Add new site;


titleClick to view details


a) Proceed to Your Sites block at the top of the page and click button;

b) Decide on the Website name, copy Unique Disqus URL from below the Website Name(where you will manage the blogcomments) and choose Category (optional)

Paste the Unique Disqus URL to the Disqus Forum Code field of the Blog extension General Settings.

c) Once done, - click button.


Please note, the Website name you enter will be displayed as above the Comments section of the blog posts:


4. Configure comment policies.

titleClick to view details

a) After adding new site navigate to the Settings section;

b) Proceed to Community tab:

  • Guest Commenting - decide if you want to allow guest customers to leave comments;
  • Pre-moderation - decide if you want to manually approve all the comments;
  • Links in Comments - decide if you want to manually approve only the comments containing links;
  • Media Attachments - decide if you want to let your customers to attach images and videos to comments;
  • Flagged Comments - decide about the notifications on customer reported comments;
  • Automatic Closing - decide if you want a blog post to become unavailable for comments after set number of days;

c) You may also want to look through the other settings available. Once done, - click button at the bottom of the page.


We are not providing assistance with setting up the Disqus services.

If you have any questions or require assistance with additional settings refer to the Disqus knowledge base.





Once you are finished with installing the extension and registering Disqus application it is high time to proceed to your Magento 2 backend to finalize the Blog setup.

Before creating your first blog post we suggest running through the Blog extension settings and other options available to adjust the blog look and behavior. This will help in better understanding of how the extension functions and what can you expect your posts to look and feel like.


The fist step is to apply Disqus Forum Code and Secret Key at the General Settings section of the extension to finalize the installation.

General Settings

Stores > Configuration > aheadWorks extensions > Blog

This configuration section reflects the Blog functional aspects. These are the settings that affect the blog accessibility, content layout and other.

Here you have an access to the following configuration options:

  • Enabled - defines is the Blog is enabled on the store;

  • Route to Blog - defines the direct link to the main blog page of your store e.g.;

  • Blog Title - defines the name of the blog page; either you want to add your company name or change the title completely, - feel free adjusting this field as you feel;

  • Posts per page - defines how many posts will be displayed per blog page;

  • Display Sharing Buttons At - defines where the social network sharing buttons should be displayed at;

  • Comments enabled - defines if customers can comment blog posts;
  • Disqus Forum Code - paste here the Disqus URL from the step 3 of Disqus setup;

  • Disqus Secret Key - paste here the Disqus Secret Key from the step 2 of Disqus setup.

You have just configured the main blog page and access to it. Now we suggest proceeding to adjusting the Blog sidebar and SEO.

Stores > Configuration > aheadWorks extensions > Blog


This configuration section reflects the Blog sidebar functional aspects. These settings define the post tags look, let you add a CMS block and configure the recent posts to display.

Here you have an access to the following configuration options:

  • Number of Recent Posts to Display - defines how many most recent blog posts should be displayed in the blog sidebar;
  • Number of Most Popular Tags to Display - defines how many popular tags should be displayed in the tag cloud of the blog sidebar;
  • Highlight Popular Tags - defines if the most popular tags should be highlighted with bold or with increased font size;
  • Sidebar CMS Block - allows chosing a CMS block to be displayed in the blog sidebar.
titleClick here to see how the sidebar looks like...


Below the Sidebar configuration block you can find SEO configuration with a single filed Blog Meta Description. At this field you are suggested to type in few words for SEO identification of your Blog.

Related Products

Stores > Configuration > aheadWorks extensions > Blog

Starting from 2.0 version of Blog extension, store administrator can add related product blocks to the blog post pages. In addition, Blog tab is added to the product pages. Under the 'Blog' tab customers can find blog articles where this particular product has been mentioned as related.

This configuration section defines how the related product blocks that can be assigned to the blog posts should behave:

  • Display Blog Posts Tab on Product Page - defines if the 'Blog' tab should be displayed at product pages;
  • Display Related Products Block on Post Page - defines if and where the related products block should be displayed at the blog post page;
  • Related Products Block Layout - defines the related product block's layout;
  • Display "Add to Cart" Button - defines if 'Add to Cart' button should be displayed on the products featured in the related product blocks at blog post pages.

Once done with the settings click button.

Before continuing to creating your first blog post there is one other thing to consider - blog categories.

Wordpress Import

Stores > Configuration > aheadWorks extensions > Blog

Starting from 2.2.0 version of Blog extension, store administrator can import blog posts from wordpress blog.

The process behind migration is the following:

  1. Navigate to Tools > Export in the Wordpress administrator area;
  2. Choose 'Posts' option and click 'Download export file' button. An XML file contatining containing all blog posts should be downloaded;
  3. Navigate to your Magento backend Stores > Configuration > aheadWorks extensions > Blog;
  4. In the 'Wordpress Import' section of the Blog settings upload XML file via 'Import file';
  5. Set 'Override existing posts with the same URL' if you want the existing Magento 2 posts with the same URL overridden;
  6. Click 'Import Posts' button to begin post import;
  7. If imported successfully copy contents from Wordpress folder:
    directly to Magento folder:
    If this directory doesn't exist - create it manually. Make sure the file permissions are set properly.

Post migration is now complete.

Blog Categories

Content > Blog by aheadWorks > Categories

Blog Categories represent another navigation tool your customers may find helpful. Along with providing a navigation tool, categories ease the post management and let you highlight the post's theme.

Click button to add the first blog category to your store. Once at the New Category page decide on the following:

The configuration is pretty much straightforward with the options names speaking for themselves.

Now, when we are done with configuring the extension it is time to create your first blog post.



This is it. To create your first post navigate to Content > Blog by aheadWorks > New Post this will land you directly at the New Post form.

The New Post form is quite huge that is why for further convenience we will split it in three steps:

Step 1: title, URL key, schedule


At this step you are suggested to:

  • Type in the blog post title that will be visible at the top of it;
  • Decide on the post's URL key;
  • Schedule the to post the draft automatically at a time set.

Scheduling a post can prove useful in different situations:

  • Start of the sale;
  • New product/service release;
  • Holiday greeting;
  • etc.

With the scheduling functionality you can chose on what date, hour and event second you want the draft to be published.

Whenever you tick Schedule Post box appears at the top of the page. Once you are done with the post click it and the post is scheduled.

titleClick to see how the scheduler looks like...

Step 2: short content, categories, tags


At step 2 you are suggested to decide if your post should have a Short Content, set the post to particular category and decide on tags.

Short Content can prove usefull if your post is content heavy and takes a couple of pages. What it does is instead of displaying whole post on a Blog page it allows displaying only the contents of the Short Content field, thus saving blog page space and making it look neat.

titleClick to see how the post looks like with and without short content...

Without Short Content field enabled:

With Short Content field enabled:


Tags are one of the navigations tools provided by Blog extension. Every post is suggested to be tagged with relevant words or phrases to simplify further customer search for relevant information. All the tags are gathered in a tag cloud displayed at the blog Sidebar.

titleClick to see how the tags work...

The more particular tags you have the more highlighted they become. At an image above we have five tags: post, lorem ipsum, first, Grand opening, test store.

The 'post' tag has been used in three posts in our blog, all the other tags were used only once. As you can see from the tag cloud 'post' tag ourshines the others.


Step 3: content, comments, meta description


At the final step you are suggested to type in the blog contents, meta description and decide if you want your customers to comment on the post.

Content field column comes with native Magento WYSIWYG editor allowing text editing, inserting images, widgets, variables etc.


That's it. Providing you are done with all three steps you can now click button and your first blog post is ready.