Important
EOL notice! Drupal 8 reached end-of-life on November 2, 2021. For more information, see Frequently Asked Questions.
Acquia Commerce Manager uses a specialized set of Drupal modules to connect Drupal to your commerce solution, through the use of the Commerce Connector Service. PHP 7.1 or later is required.
Note
By default, if your website has only one language selected, Acquia Commerce Manager will not install Language or Content translation Drupal core modules.
After you have obtained the Acquia Commerce Manager Drupal modules, you must enable them for use with your website. To do this, complete the following steps:
http://[your site]/admin/extend
).Next, you will must configure the modules for your use.
To configure the modules you have enabled to allow you to connect to your commerce solution, complete the following steps:
Open a command prompt window, and then execute the following commands to generate a pair of RSA keys to encrypt your tokens:
openssl genrsa -out private.key 2048 openssl rsa -in private.key -pubout > public.key
For security reasons, store the keys outside of your docroot directory.
In your website, as an administrator, go to Configuration > People >
Simple OAuth
(http://[your site]/admin/config/people/simple_oauth
).
Set the following values:
300
(default)1209600
(default)Click Save configuration.
Click the Clients tab, and then click Add Client
(http://[your site]/admin/config/people/simple_oauth/oauth2_client/add
).
Enter the following values to create a new OAuth client:
In the Scopes section, select the check box for ACM.
Click Save.
Copy the values from the following fields to use when you set up the Commerce Connector Service connection:
Using the details from the OAuth client, with other details from your account, you can configure the Commerce Connector Service.
Go to Commerce > Configuration > Conductor Settings, and enter the required information in the following fields:
50
Click Save Configuration
Go to Commerce > Configuration > Store Settings, and enter the required information in the following fields:
Store id: A unique ID used to identify the mapping of an ecommerce
store to this Drupal website or language. Commerce Connector Service
will map data from the Magento store with same setting.
Refer to Configuring Acquia Commerce, and note that the ID entered
here should be entered as the frontend.uuid
of the quick-setup JSON
POST object. Acquia recommends you set the Store id to be the same as
the corresponding Magento store ID. (Required)
Currency: Select the currency of the prices in the ecommerce store mapping to this Drupal website.
Price range format: The format string to use for generating price
ranges in the admin SKU table. Use the @min
and @max
as
placeholder values in the string, such as From @min to @max
. This
value is not displayed on the front end.
For front-end product price formatting, see the Twig template files for
example, such as
docroot/modules/contrib/acm/modules/acm_sku/templates/acm-sku-price--configurable.html.twig
.
Click Save Configuration.
If you want to protect these pages with Basic Authentication, download the Shield module, and then apply this patch.
Your Drupal website should now be ready to connect to the Commerce Connector Service.