Demos Buy Now

WordPress CMS Akeneo Connector

Version
  • Version WordPress 4.x or newer | Akeneo 2.0.x, 2.1.x, 2.2.x, and 2.3.x
  • Version WordPress 4.x or newer | Akeneo 2.0.5 or newer

Introduction

WordPress CMS Akeneo Connector – With the help of this connector, you can manage your WordPress website content from Akeneo platform. Export Akeneo products as blog posts to a WordPress website. Edit your content using the rich text editor, add images, customize font styles, layout, design etc.

Please Note – WordPress CMS Akeneo Connector is compatible with Community Edition, Enterprise Edition, and Cloud (PaaS/Flexibility) Edition of Akeneo.

Basic Requirements

  • This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, and 2.3.x. Download Akeneo from here

Video Tutorials

Check out the following video tutorials below:

Features

  • Export Products from Akeneo as Posts to WordPress
  • Link multiple WordPress Stores
  • Export Categories from Akeneo as Post category in WordPress
  • Export Main image as Featured media
  • Can Use fixed value for some fields when Exporting data.
  • Filter data to be Exported based on Category, family, Completeness, Time conditions, Identifier(sku), Language and Currency.

Installation

Please follow the below steps for installing WordPress Akeneo CMS Connector in Akeneo.

1. Unzip the respective extension zip and then merge “src” folder into akeneo project root directory.

2. Goto app/AppKernel.php and add a line

    new Webkul\WordpressCmsBundle\WordpressCmsBundle(),

in function registerProjectBundles()

3. Goto app/config/routing.yml and add these lines at top of the file.

wordpresscms:
    resource: "@WordpressCmsBundle/Resources/config/routing.yml"
    prefix:   /

4. You have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.

    rm -rf ./var/cache/** && php bin/console pim:install:asset --env=prod && php bin/console assets:install web --symlink --env=prod && yarn run webpack && php bin/console d:s:u --force

5. You have to restart your web server like Apache, Nginx. Run the command for Apache web server.

sudo service apache2 restart

Common Issues After Installation

It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:

    • Webpack Installation: If you get the below error

      It means that webpack is not installed in your system. Run the following command
      npm install --save-prod webpack
      npm install
      
    • Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
    • Clear your browser cache.

Enable HTTP Authorization on WordPress

Some time HTTP authorization does not work in WordPress. You can solve it by .htaccess file modification.

WordPress creates a block that looks something like this in .htaccess file.

For it, you have to add this line to this file.

RewriteRule .* - [E=REMOTE_USER:%{HTTP:Authorization}]

After adding this line you can see the .htaccess file like this.

Creating WordPress API Credentials

Before you begin, you need to install Application Password plugin in your WordPress. After that follow the steps below:-

  1. Login to WordPress admin panel and go to Plugins section.
  2. Search Application Passwords and install and activate the plugin.
  3. Then, go to Users>Your Profile and find Application Passwords section.

  1. Enter any name for your new application password and then click Add New.
  2. Once the Add New button is clicked, your new application password will appear on the screen.

Module Configuration

Once you have installed WordPress CMS Akeneo Connector in Akeneo, login to Akeneo admin panel. Then, go to WordPress CMS Connector>Credentials and enter the following:

Credentials

Site URL – Enter your WordPress website URL here.

Username – Enter your WordPress username here.

Application Password – Enter the API password that you have just created in the previous section.

Settings

Now, you need to do the mapping between WordPress post fields and Akeneo attributes. Mapping of these attributes allows you export the information correctly from Akeneo to WordPress.

Title – Select the Akeneo attribute which will be used as the post title.

Content – Select the Akeneo attribute which will be the content.

Excerpt – Select which Akeneo attribute will be used as the excerpt for posts.

Password – Select the Akeneo attribute which will be used for mapping password for viewing a post. A will password will protect access to the content and excerpt.

Comment Status – Select the Akeneo attribute which will be used for managing comment permission on a post. Whether or not comments are open on the blog post.

Ping Status – Select the Akeneo attribute for managing ping status for blog posts. Whether or not the post can be pinged.

Format – If your WordPress theme supports post formats, you can map this information from Akeneo using attributes. Find more information here – https://en.support.wordpress.com/post-formats/

Sticky – Select the Akeneo attribute for managing sticky post information. Whether or not the post should be treated as sticky.

Fixed Attribute Value

If you want to use some fixed values for all the exported posts, you can mention in it the right column.

Featured Image

For mapping featured image of a post, the main image of a product will be used from Akeneo.

Creating Post

In WooCommerce CMS Akeneo Connector, the Akeneo products are exported as posts in WordPress blog site. So once you have configured the attributes and family for the blog posts, now to create a new product (blog post), go to Products>Create.

Select Product option.

Enter SKU and select a family.

Enter all the product information for the blog post such as title, snippet, description, etc.

Upload featured image for the blog post, make sure you have selected the correct Attribute used as the main picture in Families settings. Enter main body content in the Description text area. You can also use HTML code formatting.

Mention all the other post information required such as Sticky Post, Enable Comments, Password Protected.

Export Job

Once you have your post data ready, you can now move on to exporting process. Go to Exports>Create Export Profile. Then, enter any code, label and select a job:-

 

Three types of export jobs will be available to you:

  • Export All Job – It will export all the products including the categories.
  • Product Only Export – It will only export products to WordPress.
  • Categories Only Export – It will only export categories to WordPress.

After you have created the export profile, go to Content. From here, you can select your channel, locale, and attributes.

If you don’t want to export all the products, you can use various built-in filters of Akeneo:

  • Family – Export products belonging to a family.
  • Status – Export products which are either enabled or disabled.
  • Completeness – Export products according to their information completion.
  • Time Condition – Export products based on their date modified condition.
  • Category – Export products belonging to specific categories.
  • Identifier – Export product using SKU values separated by commas.

Credentials

In case you are managing multiple WordPress websites, you can provide different credentials for each export job. Else, you can leave the credentials fields blank.

Once you have saved your export profile information, click Export Now button and wait for the execution process to get over.

WordPress Frontend

Once the export process is completed, your exported posts will be visible on the WordPress website.

Here is the blog post page with the featured banner.

Support

Thank you for reading this documentation, in case you have any query, please send an email to support@webkul.com

Current Product Version - 1.0.0

Supported Framework Version - WordPress 4.x or newer | Akeneo 2.0.x, 2.1.x, 2.2.x, and 2.3.x

. . .

Comment

Add Your Comment

Be the first to comment.

css.php
Hire Us!
Brief us about your requirements and we'll get back to you.
Woo! Hooy!
We have just recieved your project brief and our expert will contact you shortly.
Send Again
Close

Index