The Woocommerce Magento plugin provides the ability to pull all Woocommerce Magento products into Checkout Champ. The Woocommerce plugin will not pull product variation information into the CRM though it can easily be created in the Product Variant Section in the CRM. Please click this link to be taken to Product Variations article for more informationOnce the steps are enabled your Magento store can redirect to CheckoutChamp to complete the checkout process.
Table of Contents | ||
---|---|---|
|
...
Once the plugin is configured and products are synced in, please view the article below:
...
...
Step 1 -
...
When logged into the Admin site, click on “Woocommerce” then click “Settings” then click the “Advanced” tab to expose the “REST API” option. Click “REST API” to create your Woocommerce API Keys.
...
2. Click “Add Key” to create your Woocommerce API Key.
...
3. In the “Key Details” Screen make sure to enter a Description, choose a user, and ensure you select “Read/Write” for the permissions selection. Then click “Generate API Key” to finish the API key creation process.
...
4. Woocommerce will display the API keys upon successful API Key creation. Please save these as they are required for the plugin setup in the CRM..
These API Keys become inaccessible as soon as you leave this page.
...
Step 2 - Setup the Plugin
Install the app on your Magento store
1. Download the app here
View file | ||
---|---|---|
|
2. Unzip the file into the app > code folder on your Magento store
...
3. Open a command prompt. Navigate to the project root directory in the app > store folder.
4. Run php bin/magento setup:upgrade
5. Run php bin/magento setup:di:compile
6. Run php bin/magento setup:static:static-content:deploy -f
7. Run php bin/magento cache:flush
Step 2 - Configure Magento Security
Login to Magento
Go to Stores > Configuration > Services > Magento Web API > Web API Security
Set Allow Anonymous Guest Access to Yes
Save
...
Step 3 - Setup the CheckoutChamp Plugin
Login to the CheckoutChamp page builder. Navigate to your funnel and drag the WooCommerce Magento page type to the Funnel Visualizer funnel canvas if you have not done so already.
...
Next, click Click on the WooCommerce page and then click Magento page
Click the settings gear icon to open the plugin settings.
...
storeURL = your Woocommerce Magento store url (minus the https://)ConsumerKey
userName = your Woocommerce Consumer Key (required)ConsumerSecret= your Woocommerce Consumer Secret (required)Magento store user name
password = your Magento store password
campaignId = optional. Use this to assign your Woocommerce Magento products to a specific campaign. If blank, a new campaign will be is created when the products are pulled from WoocommerceMagento . If grayed out, then all products will load into the funnel/campaign that the plugin was added to.
billerId gatewayId= optional. The billerId gatewayId to assign to the CRM campaign products that will be created from the Woocommerce Magento products. Entering a value here will save the effort of manually editing the campaign products to assign a merchant account. billerId gatewayId can be found on the MID List on the CRM side of your account under Merchants → MID Gateway List.
...
Press Create Plugin to save.
Step
...
4 - Synchronize Products
This process will pull your Woocommerce Magento products into your Checkout Champ account.
From the Funnel Visualizer, open the WooCommerce plugin, verify the information entered, and press the blue “Sync Products” button located at the very bottom of the plugin.
...
Login to CheckoutChamp and navigate to the Magento funnel
Click on the Magento page
Click the Settings gear icon to open the plugin details
Press the blue Sync Products button
...
The product sync will take a few minutes (or longer depending on the number of products in your Magento store). When the sync is finished, open the Funnel’s settings go to the funnel Settings and open Offers or Upsells section to view/edit the imported products.
Variant detail information will not be synced from Woocommerce but you can easily add variants to any product synced from Woocommerce. To do so, navigate to the CRM side of your account and then go to CRM → Products to edit the product and add variant options.
...
Specify a Variant Name for example, you can use Size. Then for the variant options you will specify your Size options (Small, Medium, Large).
Fill out all the relevant variant information for your products, then hit the green “Create” button to create all the variant options. Magento. For more information about Product Variations please view this article .
Step
...
It has been discovered that most Wordpress servers are configured differently which could cause issue when syncing products. The most common error one might face when using this plugin is "sorry you cannot list resource". To troubleshoot this issue please follow the steps below.
Confirm API credentials are correct.
Confirm pretty permalinks are enabled in your WP settings. If not please follow this guide to ensure you’re permalinks are configured correctly.
If updating your credentials and/or updating your store’s permalinks did not resolve this issue then it is safe to say that this issue might be caused by the way your Wordpress server is configured more specifically your server is not passing authorization headers to Wordpress.
Make sure your server is passing the authorization headers to wordpress.
Test by passing in key and secret via url rather than headers to confirm the issue
eg:
https://your-store-url.com/wp-json/wc/v3/products?consumer_key=XXXX&consumer_secret=XXXX
If pasting this URL into your browsers yields a proper result then it confirms that there is an issue with your wordpress server configuration.
Before Adjusting your Server Configuration please ensure you take proper back-ups of your server configuration so you can easily roll back changes if they are no longer needed.
Apache Server
...
Code Block |
---|
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress |
supporting links
https://wordpress.org/support/topic/woocommerce-rest-api-error-401/
https://github.com/woocommerce/woocommerce/issues/19649
Before Adjusting your Server Configuration please ensure you take proper back-ups of your server configuration so you can easily roll back changes if they are no longer needed.
Nginx Server
...
Navigate to your Nginx conf file and make the necessary changes.
Code Block |
---|
server {
server_name localhost;
listen 80;
root /var/www;
location /wpbop {
index index.php;
access_log /var/log/nginx/blog.access.log;
error_log /var/log/nginx/blog.error.log;
try_files $uri $uri/ /index.php$is_args$args;
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
location ~ \.php$ {
try_files $uri =404;
fastcgi_index index.php;
fastcgi_pass 127.0.0.1:7000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi_params;
}
} |
}
if that does not work, navigate to /etc/nginx/sites-available/YOUR_DOMAIN on your Nginx server and add the following route.
Code Block |
---|
location / {
#try_files $uri $uri/ =404;
try_files $uri $uri/ /index.php$is_args$args;
} |
...
5 - Configure Magento Redirect
Login to Magento
Go to Stores > Configuration > CheckoutChamp
Enable the redirect
Set Checkout URL to the full URL of the CheckoutChamp checkout page
Save
...
Troubleshooting Product Sync Errors
Disable the redirect on your Magento store
Login to Magento
Go to Stores > Configuration > CheckoutChamp
Set Enable = No
Save
Disable the app on your Magento store
Go to the project root directory in the app > code folder
Run php bin/magento module:disable CheckoutChamp_Meta
Uninstall the app on your Magento store
On your Magento store go to Admin > Stores > Attributes > Products
Click on Additional Data Id
Click on Delete Attribute
Remove the module CheckoutChamp_Meta from app/etc/config.php
Remove the module CheckoutChamp_Meta from table setup_module
remove the folder app/code/CheckoutChamp