Mapping multilingual Drupal to Magento store views

Creating authorizations¶

First, you must create the site, and then add authorizations for the Drupal and Magento systems. Use the Acquia Commerce Manager API to accomplish these tasks.

1. Create a site using the user keys provided by Acquia.

   API Endpoint: ${CONNECTOR_URL}/v2/config/site/create

   Request type	Request body
   POST	{ "name":"${CUSTOMER_SITE_NAME}", "description":"${CUSTOMER_SITE_NAME}", "user_id":${CUSTOMER_USER_ID} }

   This request returns a site_id, hmac_key, and hmac_secret for the site created. The site_id is used for subsequent API calls, and you will need the hmac_key and hmac_secret returned by this request for both Drupal and Magento. The returned value set will look similar to this example:

   {
      "site_id":1
      "hmac_key":"abcdef359d9vs0dxsv89ds9d0f8scd",
      "hmac_secret":"gs3dd98dlk349dkwl34kjdf"
   }
   

2. Create authorization details for the Magento systems

   API Endpoint: ${CONNECTOR_URL}/v2/config/auth_detail/create

   Request type

   Request body

   POST

   { "name":"${BACKEND_AUTH_DETAIL_NAME}", // Your detailed name for Magento "description":"BACKEND_AUTH_DETAIL_DESC", // A description for your Magento installation "client_id":"${BACKEND_CLIENT_ID}", // The client ID from Magento "client_secret":"${BACKEND_CLIENT_SECRET}", // Secret key from Magento "token":"${BACKEND_TOKEN}", // The Magento token "token_secret":"${BACKEND_TOKEN_SECRET}", // Magento token secret "site_id":${SITE_ID} // The site_id created previously }

   This request returns an auth_ID for the Magento authorization detail created. You will need this value when creating the Magento systems later.

3. Create authorization details for Drupal

   API Endpoint: ${CONNECTOR_URL}/v2/config/auth_detail/create

   Request type

   Request body

   POST

   { "name":"${FRONTEND_AUTH_DETAIL_NAME}", // Enter a name for the authorization like "Drupal auth" "description":"FRONTEND_AUTH_DETAIL_DESC", // Enter a name for the authorization like "Drupal auth" "client_id":"${FRONTEND_CLIENT_ID}", // Your client ID from Drupal allocated when you created the Drupal OAuth user "client_secret":"${FRONTEND_CLIENT_SECRET}", // Your secret from Drupal when you created the Drupal OAuth user "site_id":${SITE_ID} // The site_id from the site creation. }

   This request returns a auth_ID for the Drupal authorization detail created. You will need this value when creating the Drupal system later.

Add the systems¶

Next, you will add system definitions for Magento and Drupal.

1. Add a Magento store view as a system

   Repeat this API call for each Magento store view to be configured.

   API Endpoint: ${CONNECTOR_URL}/v2/config/system/create

   Request type

   Request body

   POST

   { "name":"${BACKEND_SYSTEM_NAME}", // Magento system name "description":"${BACKEND_SYSTEM_DESC}", \ //Magento system description "type":"${BACKEND_TYPE}", // System type, in this case "magento" "url":"${BACKEND_URL}", // Full system URL, INCLUDING a trailing slash, such as https://your-magento-host-url.com/rest/store_view_code/V1/" "uuid":"${BACKEND_UUID}", // The language used, such as en_US "site_id":${SITE_ID}, // The Magento site_id from before "auth_id":${AUTH_ID}, // The auth_id created earlier "token_url":"${BACKEND_TOKEN_URL}", "skip_ssl":${SKIP_SSL} }

   This request returns a system_id for the Magento system created. You will need the system_id and the store view when creating the mapping.

2. Add a Drupal system

   Next, you create a Drupal system for a given language. You must repeat this API call for each language you wish to add.

   API Endpoint: ${CONNECTOR_URL}/v2/config/system/create

   Request type

   Request body

   POST

   { "name":"${FRONTEND_SYSTEM_NAME}", // Drupal system name "description":"${FRONTEND_SYSTEM_DESC}", // Drupal System description "site_id":${SITE_ID}, // The site_id from previous steps "auth_id":${AUTH_ID}, // Your Drupal system auth_id "type":"${FRONTEND_TYPE}", // The system type, in this case 'drupal' "url":"${FRONTEND_URL}", // URL for your Drupal host, without a trailing slash. "uuid":"${FRONTEND_UUID}", // The ACM ID for this language "token_url":"${FRONTEND_TOKEN_URL}", "skip_ssl":${SKIP_SSL} }

This request returns a system_id for the Drupal system created. You will need the list of all returned system_id responses, and languages they correspond to, when creating the mapping.

Map the systems together¶

Finally, configure the Commerce Connector Service to map a specific Magento store view to a specific Drupal language configuration. Repeat this API call for each Drupal language to Magento store view mapping required.

API Endpoint: ${CONNECTOR_URL}/v2/config/mapping/create

{
"name":"${MAPPING_NAME}", // The name of the mapping, such as 'Drupal EN to Magento EN'
"description":"${MAPPING_DESC}", //  Description of the mapping
"backend_id":${BACKEND_SYSTEM_ID}, // The Magento system_id
"frontend_id":${FRONTEND_SYSTEM_ID}, // The Drupal system_id
"site_id":${SITE_ID} // The site_id
}