This projects enables You to use Magento 1.9 as a backend platform for Vue Storefront - first Progressive Web App for e-Commerce.
Vue Storefront is a standalone PWA storefront for eCommerce. It can be conencted with any eCommerce backend (eg. Magento, Pimcore, Prestashop or Shopware) through the API.
Sign up for a demo at https://vuestorefront.io/ (Vue Storefront integrated with Magento2 or Magento1).
Vue Storefront is platform agnostic - which mean: it can be connected to virtually any eCommerce CMS. This project is a data connector for Magento 1.9.
This bridge at current stage is synchronizing the catalog part: products, categories, attributes and taxRules the missing part is users, orders and cart synchronization. If you like to have two way communication just contact us at [email protected].
Areas for improvements:
- performance (right now it's single threaded but can be easily modified to use node-cluster),
- dynamic-requests handling (user accounts, shopping carts, orders).
Magento 1.9 bridge uses it's own Magento API which is available as standard Magento module. The second part is a node.js app which is used to consume the API results.
Requirements: Magento 1.9x Community or Enterprise; Node.js >= 8; vue-storefront and vue-storefront-api installed.
First, please clone the whole repository locally:
git clone https://github.com/DivanteLtd/magento1-vsbridge.git magento1-vsbridge
cd magento1-vsbridge
cp magento1-module/app/* <MAGENTO_FOLDER>/app/
Magento module uses JWT tokens authorization method based on standard Magento admin users account system. Please create a dedicated admin account for magento1-bridge purposes only with minimal access (ACL) to the catalog part.
Then, please configure the JWT Secret in Magento configuration: System > Configuration > Services > VueStorefront Bridge.
Then please clean the Magento cache. To make sure that the module works just fine You can try to authorize the user using Postman:
As You've probably noticed in the cloned directory there is a second folder called node-app. This is a consumer application that's responsible for synchronizing the Magento1 data with the ElasticSearch instance.
This tool required ElasticSearch instance up and running. The simplest way to have one is to install vue-storefront and vue-storefront-api and run docker-compose up inside vue-storefront-api installation as the project contains Docker file for Vue Storefront.
Then you need to modify the configs:
cd node-app
cp config.example.json config.json
nano config.json
In the config file please setup the following variables:
authsection to setup Magento's user login and password and the previously set JWT secret- 'endpoint' should match your Magento 1.9 URL,
elasticsearch.indexNameshould be set to Your ElasticSearch index which then will be connected to the Vue Storefront. It can be fresh / non-existient index as well (will be created then). For example You may have:vue_storefront_magento1
Please note: current version of magento1-vsbridge requires the latest version of VS, from 'develop' branch installed. Please make sure youre using the most recent code.
By default Vue Storefront uses ES index named vue_storefront_catalog. Please apply the changes accordingly to:
vue-storefrontconfig filelocal.jsonto point to right index name,vue-storefront-apiconfig filelocal.jsonto point to right index name.
Restart vue-storefront and vue-storefront-api.
The bridge works on temporary, versioned ES indexes. You decide when the index should be published (when all data objects are properly set). All commands exec from node-app/src directory.
Create new version of index (for example: vue_storefront_magento1_1):
cd node-app/src
node index.js new
Index data:
node index.js attributes
node index.js taxrules
node index.js categories
node index.js products
node index.js cms
Please note that if you want import / update data only for cms pages / blocks / hierarchy you can use this commads:
node index.js cms --pages (import / update only cms page data)
node index.js cms --blocks (import / update only cms block data)
node index.js cms --hierarchy (import / update only cms hierarchy data)
node index.js cms (without any params import all instances at once)
Publish new version of index (creates an alias with prod. name of the index: vue_storefront_magento1_1 -> vue_storefront_magento1):
node index.js publish
Congratulations! After this step You should have got the ES index synchronized with the Magento1 instance!
Please visit Vue Storefront site to check out why it's so cool!
As you may observed, configured products do work perfectly well after imported to Vue Storefront!
Please feel free to extend Magento module or Node app and contribute Your changes to the community!
Some ideas for contributions:
- media gallery sync,
- shopping cart / order sync (please contact us for details).
magento1-vsbridge source code is completely free and released under the MIT License.