Reading list Switch to dark mode

    Joomla CMS Akeneo Connector


    Joomla CMS Akeneo Connector allows you to export and publishes your content through the Akeneo platform. With this integration, you’ll be able to create blog articles using Akeneo product data. Joomla CMS Akeneo Connector will export categories, articles (including tags, links, images, meta information, key reference, author, content rights, status, access, and much more).

    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 5.0.x, 6.0.x and 7.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.


    • Export Categories from Akeneo in Joomla CMS.
    • Send Products from Akeneo to Articles in Joomla CMS.
    • Export Product Images as Article Images.
    • Joomla CMS Akeneo Connector is compatible with the latest Akeneo version 7.0.x
    • Export article tags, images, links, publish start date, and publish end date, with article data.
    • Use the fixed value for some fields when exporting data.
    • Filter Data to be exported based on category, family, completeness, and identifier (SKU).
    • Connect multiple Joomla instances by providing credentials in export jobs.
    • Better mapping UI with select attributes instead of filling code.


    Two types of module installation processes are available for the module.

    1- Composer Installation

    2- Manual Installation

    Installation using Composer Installation

     1: GET the ACCESS KEYS [Raise a support ticket]

    Searching for an experienced
    Akeneo Company ?
    Read More

     2: In Akeneo Composer.json, add our repository and installation script.

    Akeneo 6 and 7:

      "scripts": {
            "post-update-cmd": [
               "vendor/webkul/joomlacmsbundle/src/Webkul/JoomlaCmsBundle/install/ COMPOSER=true NO_DOCKER=true"
            "post-install-cmd": [
               "vendor/webkul/joomlacmsbundle/src/Webkul/JoomlaCmsBundle/install/ COMPOSER=true NO_DOCKER=true"
            "post-create-project-cmd": [
              "vendor/webkul/joomlacmsbundle/src/Webkul/JoomlaCmsBundle/install/ COMPOSER=true NO_DOCKER=true"
      "repositories": [{
        "type": "composer",
        "url": ""

    For Akeneo 5

      "scripts": {
            "post-update-cmd": [
            "post-install-cmd": [
            "post-create-project-cmd": [
      "repositories": [{
        "type": "composer",
        "url": ""

    3: Use composure to install the extension.

        composer require webkul/joomlacmsbundle

    4: Fill in the authentication form.

    5: Send a Success Message.

    6: Clear your browser’s cache.

    Manual Installation For Version 6.0.x and 7.0.x

    • After Unsiping the respective extension zip, merge the “src” folder into the akeneo project root directory.
    • From the PIM directory, run the following command over the NO-DOCKER Instance.
        ./src/Webkul/JoomlaCmsBundle/install/ COMPOSER=false NO_DOCKER=false
    • After that, run the below command over the PIM directory’s DOCKER instance.
        ./src/Webkul/JoomlaCmsBundle/install/ COMPOSER=false NO_DOCKER=false

    Manual Installation For Version 5.0.x

    Please follow these steps for installing the Joomla CMS Akeneo Connector module in your Akeneo PIM platform.

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


    2 – Goto app/AppKernel.php then add the line.

    Webkul\JoomlaCmsBundle\JoomlaCmsBundle::class => ['all' => true],

    in the return array.

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


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

    php bin/console cache:clear--env=prod;php bin/console joomlaCms:setup:install && yarn run webpack

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

    For Akeneo 5

    sudo service php-fpm7.4 restart

    For Akeneo 4

    sudo service php-fpm7.3 restart
    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;

    Module Installation For Version 2.x to 3.x

    1 – Once you have unzipped the download zip then merge the “src” folder into akeneo project root directory.

    upload the src folder

    2 – Goto app/AppKernel.php after that  add the following line.
    AppKernel.php file

    new Webkul\\JoomlaCmsBundle\\JoomlaCmsBundle(),

    in function registerProjectBundles()

    3 – After that, goto app/config/routing.yml then add these lines at top of the file.
    Routing.yml file

        resource: "@JoomlaCmsBundle/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 joomlaCms:setup:install && yarn run webpack

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

    sudo service php-fpm7.2 restart

    Joomla Module Installation

    Once you have extracted the downloaded zip file, you will find two module folders. “JoomlaCmsBundle” for Akeneo and “” for Joomla.


    1 – Login to the Joomla admin panel then go to Extensions>Manage>Install.


    2 – Browse the “” file and upload it. After successful installation, you will see a message
    Installation of the component was successful.


    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.

    Uninstall Module: For Akeneo 6 and 7

    • Run the below command over the NO-DOCKER Instance from the PIM directory
    ./src/Webkul/JoomlaCmsBundle/uninstall/ COMPOSER=false NO_DOCKER=true
    • Run the below command over the DOCKER Instance from the PIM directory
    ./src/Webkul/JoomlaCmsBundle/uninstall/ COMPOSER=false NO_DOCKER=false

    Joomla API Credentials

    Once you have installed the module in Joomla, you need to generate an API key that will be used in the Akeneo Connector module configuration.

    First, log in to the admin panel  then go to Components>JoomApi>API Key>New.

    webkul-joomla-akeneo-connector-api-createSelect a user and then click Save & Close. The newly created API key token will be visible to you.


    Copy the API Key, it will be used in the next step of Joomla CMS Akeneo Connector module configuration.

    Api keys

    Module Configuration

    Login to your Akeneo admin panel and then go to Joomla CMS Akeneo Connector menu. Here, you need to go to the Credentials section and enter Joomla website URL and the API Key created in the previous step.

    Screenshot-2023-02-13T185751.181Attribute Mapping

    In the Attribute Mapping section, you need to match the Akeneo product attributes with Joomla fields. This process is important because it will ensure that the correct information is exported to Joomla from Akeneo.

    Please NoteBefore doing attribute mapping, make sure you have already created and set up the required attributes in your Akeneo.


    When you export to Joomla, you can send detailed information about your blog articles. Following Joomla fields are supported:

    • Article Title
    • Article Alias
    • Content
    • Status (0 -> unpublish, 1 -> publish, -2 -> trashed )
    • Featured
    • Access
    • Tags (Use the Tags separated by commas Only)
    • Intro Image with Alt, Caption
    • FullText Image with Alt, Caption
    • Link A, B, C
    • Link Text A, B, C
    • Start Publishing Date
    • Finish Publishing Date
    • Created By Alias
    • Meta Description, Meta Keywords
    • Key Reference
    • Author
    • Content Rights
    • External Reference

    To do an attribute mapping, go to Use Value of this Attribute column and select an Akeneo attribute which resembles the Field in Joomla CMS column.


    Use this Fixed Value – In case you want to use some fixed value for all export products, you can mention that value here.


    Akeneo Product Information

    Once you have created and mapped all the relevant attributes for the Joomla platform, you can go to the Products section and manage product information. You can set the article title, upload feature image, the article image, add links, reference, alias (URL), publishing information, etc.


    Write and format your content using the rich text editor of Akeneo. The connector will send all the text formatting details on Joomla such as bold, italics, underlined, paragraphs, bullet points, including the HTML code.


    Export Profile

    After you have managed the product information, you can move on to the export process. Go to Exports>Create Export Profile and enter a code and set a label. There are three profiles available in this connector:

    • Joomla CMS Article Export – This export job profile will send all the articles to Joomla. You can use various filters for products.
    • Joomla CMS Category Export – This export job profile will create/update all the Akeneo categories in Joomla.
    • Joomla CMS All Export – This export job profile will export/update all the articles and categories from Akeneo to the Joomla website.

    export-credentialsFilter the Data – Once the export job profile is created, you can then decide what product will be exported to Joomla. You can select a channel, locales, and attributes.

    export-profileFilter the Product – You can then decide, which products will be selected and filtered for the export jobs. You can filter the products based on family, status, completeness, time condition, categories, or identifier.


    Job Credentials – In case you are managing multiple Joomla websites and want to export content to some other website for this job profile, you can mention the credentials. Please note these credentials must be separate from the Module Configuration.


    Now save your profile and click the Export Now button. You can see the progress on the screen showing the count of products and categories that are read and written.


    Joomla Backend

    As you can see that the article has been exported to Joomla successfully. You can edit the article and check the information.


    All the mapped attribute information will appear in the article with proper text formatting.


    Images and links are also imported to Joomla.

    joomla-mapping-images-linkCheck out the publishing information imported from Akeneo. Start publishing, end publishing, created date, created by alias, meta description, meta keywords, key reference, etc.publisingg

    Joomla Frontend

    You can see the article showing various details such as title, author, tags, featured image, and some content.


    Here’s the article view page showing image, tags, and content.



    For further queries or customization requirements, 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 - Akeneo 2 t 5 || 2.0.0, Akeneo 6 || 3.0.0 and Akeneo 7 || 4.0.0

    Supported Framework Version - Joomla 3.x | 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, 5.0.x, 6.0.x and 7.0.x

    Blog Version - Joomla 3.x | 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, 5.0.x, 6.0.x and 7.0.x
    • Version Joomla 3.x | 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, 5.0.x, 6.0.x and 7.0.x
    • Version Joomla 3.x | 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
    • Version Joomla 3.x | 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
    . . .
    Add a comment

    Leave a Comment

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

    Be the first to comment.

    Back to Top
    Very good service from Webkul. Bought an extension from Webkul. The support team explained everything in detail. Thank you Webkul.
    Juan Alberto Garcia Paredes
    Talk to Sales


    Live Chat

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home

    Table of Content