Version: current

Getting started

Getting Started#

info

Falcon magento module should be installed over preinstalled magento instance. In case you don't have magento installed yet please checkout Magento install guide.

Using our example project, demo-v1 you will have Magento 2 support without having to do any custom dev.

1. Configure composer repository#

caution

To install falcon magento module you will need a repository-url and token. You should get this data from our team after signing up.

Run the following command in your magento instance:

composer config --global --auth http-basic.deity.repo.packagist.com token `token`

Afterwards update you composer.json file with following data

"repositories": [
{"type": "composer", "url": "repository-url"}
]

2. Install falcon magento module#

Run the following composer command

composer require deity/falcon-magento ^5.3.8

After package installed, install falcon module into your magento with

bin/magento setup:upgrade

and flush magento cache

bin/magento cache:flush

3. Create an integration within Magento.#

From the admin (system->integrations) you can create a new integration.

Magento admin

From here you will get the following credentials to use later:

Integration details
  • CONSUMER_KEY
  • CONSUMER_SECRET
  • ACCESS_TOKEN
  • ACCESS_TOKEN_SECRET

4. Create your Falcon App.#

Install Falcon Platform using the demo-v1 example and create-falcon-app

5. Configure your Magento connection#

Add your Magento 2 details to your server/config/ files. Below is an example of the config variables you'll need to add. If you're using demo-v1 this will be set up to use our demo Magento 2 instance and should work out of the box.

{
"endpoints": {
"magento": {
"config": {
"host": "MAGENTO_HOST"
}
}
},
"apis": {
"magento2": {
"config": {
"host": "MAGENTO_HOST",
"defaultLocale": "MAGENTO_DEFAULT_LOCALE",
"auth": {
"consumerKey": "MAGENTO_CONSUMER_KEY",
"consumerSecret": "MAGENTO_CONSUMER_SECRET",
"accessToken": "MAGENTO_ACCESS_TOKEN",
"accessTokenSecret": "MAGENTO_ACCESS_TOKEN_SECRET"
}
}
}
}
}

Deity Cloud Environment Variables#

  • MAGENTO_HOST: Your Magento site URL (without protocol) e.g. magento.deity.io
  • MAGENTO_CONSUMER_KEY: your consumer key
  • MAGENTO_CONSUMER_SECRET: your consumer secret
  • MAGENTO_ACCESS_TOKEN: your access token
  • MAGENTO_ACCESS_TOKEN_SECRET: your access token secret
  • MAGENTO_DEFAULT_LOCALE: default locale for your Magento store. e.g. en_GB

6. Update magento configuration#

When your falcon instance is up and running its important to update magento with falcon instance data Go to Magento admin Stores->Configuration On Configuration page open Services->Falcon

Magento admin

Enter your falcon domain to Falcon frontend url, and cache webhook url to Url to flush cache on Falcon Server.

7. Configure Deity Payment Gateway#

To configure Deity Payment Gateway go to Magento admin Stores->Configuration and select Sales -> Payment Methods section

Magento admin

If your shop does not support offline payments (like Cash on Delivery) you can disable Deity Offline Payments on this page.

8. Disable your Magento frontend#

Disable your Magento 2 frontend. We have a Magento module you can use.

9. Complete#

Complete, you should now have a fully working Magento 2 / Falcon Platform site

Ask the community. #help

If you can't find what you're looking for, the answer might be on our community slack channel. Our team keep a close eye on this and will usually get back to you within a few hours, if not straight away. If you haven't created an account yet please sign up here slack.deity.io.

Stay up to date

Do you want to be informed when we release new features or fixes? Sign up to our newsletter to stay in the loop.