Menu Close
    Searching for an experienced Akeneo Development Company ?

    WordPress CMS Akeneo Connector

    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.

    Basic Requirements

    • This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x and 5.0.x. Download Akeneo from here
    • This module is compatible with the Akeneo community and Enterprise(Flexibility) edition.
    • If you want to use this extension on Akeneo EE Serenity mode, please contact us.
    • For the Akeneo installation, your Akeneo server should meet these system requirements.

    Video Tutorials

    Check out the following video tutorials below:

    How to get API keys?

    q6eAv2qX7ts

    How to do module configuration and export products from Akeneo to WordPress CMS?

    WullqcgNQ9U

    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.
    • WordPress CMS Akeneo Connector is compatible with latest Akeneo version 5.0.x.
    • Filter data to be Exported based on Category, family, Completeness, Time conditions, Identifier(sku), Language and Currency.

    Installation for Version 4.0.x to 5.0.x

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

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

    src-cms

    2 – Goto config/Bundles.php then add line:

    wordprsss

    in return array.

    3 – Copy the “config” folder into akeneo project root directory for routing.

    conf-cms

    – Run this command after ssh to your akeneo server by the terminal

    5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

    For Akeneo 5

    For Akeneo 4

    Docker Installation Command :

    For Akeneo 5

    alias docker_php='docker-compose run -u www-data --rm php php';
    alias docker_yarn='docker-compose run -u node --rm node yarn';
    docker_php bin/console cache:clear --env=prod;
    docker_php bin/console pim:installer:assets --symlink --clean --env=prod;
    docker_php bin/console d:s:u --force;
    docker_yarn run webpack;
    docker_yarn run update-extensions;
    docker_yarn run less;

    For Akeneo 4

    alias docker_php='docker-compose run -u www-data --rm php php';
    alias docker_yarn='docker-compose run -u node --rm node yarn';
    docker_php bin/console cache:clear --env=prod;
    docker_php bin/console pim:installer:assets --symlink --clean --env=prod;
    docker_php bin/console d:s:u --force;
    docker_yarn run webpack;
    docker_yarn run less;

    Installation for Version 2.x to 3.x

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

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

    src-cms

    2. After that goto app/AppKernel.php then add a line
    Set up in Akeneo

        new Webkul\\WordpressCmsBundle\\WordpressCmsBundle(),
    

    in function registerProjectBundles()

    3. Goto app/config/routing.yml then add these lines at top of the file.
    Set up in Akeneo

    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.

    php bin/console cache:clear --env=prod && php bin/console wk_wordpress:setup:install --env=prod
    

    5. If you are using php-fpm. Then you need to restart the php-fpm services.

    sudo service php-fpm7.2 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
        Webpack 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.

    HTTP authorization

    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.

    HTTP authorization

    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 then go to Plugins section.
    2. Search Application Passwords after that install and activate the plugin.
    3. Then, go to Users>Your Profile and find Application Passwords section.

    application passwords

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

    view credential

    Module Configuration

    Once you have installed WordPress CMS Akeneo Connector in Akeneo, login to Akeneo admin panel. Then, go to WordPress CMS Connector>Credentials after that 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.

    WordPress CMS Akeneo Connector akeneo credentials

    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.

    WordPress CMS Akeneo Connector-attribute mappingsFixed Attribute Value

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

    fixed attribute mapping value

    Featured Image

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

    featured image

    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.

    select productEnter SKU then select a family.

    select family and enter sku

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

    enter product information

    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.upload featured image

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

    other information

    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:-

    create export profile wordpress cmsThree 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.

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

    export job - contentIf 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.

    filter products - export jobCredentials

    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.

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

    export process

    WordPress Frontend

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

    exported post

    Here is the blog post page with the featured banner.

    screencapture-192-168-15-173-wc-mp-lorem-ipsum-my-blog-post-2018-03-26-20_53_57

    Support

    So, that was much about the User Guide of WordPress CMS Akeneo Connector for any queries or doubts reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.

    Please explore our Akeneo Development Services and Quality Akeneo Extensions.

    Current Product Version - 3.0.0

    Supported Framework Version - WordPress 4.x or newer | Akeneo 2.x.x & 3.x.x & 4.x.x & 5.x.x

    Blog Version - WordPress 4.x or newer | Akeneo 2.x.x & 3.x.x & 4.x.x & 5.x.x
    • Version WordPress 4.x or newer | Akeneo 2.x.x & 3.x.x & 4.x.x & 5.x.x
    • Version WordPress 4.x or newer | Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, and 3.1.x
    • Version WordPress 4.x or newer | Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x and 4.0.x
    • Version WordPress 4.x or newer | Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x and 3.2.x
    . . .
    Discuss on Helpdesk

    Leave a Comment

    Your email address will not be published. Required fields are marked*


    Be the first to comment.

    Back to Top

    Table of Content

    Hide Index