Overview

Overview

The Ultracart WordPress plugin provides a quick and easy integration of your UltraCart account with your WordPress hosted website.

...

1. Install The plugin and Activate the plugin
2. Connect your site to UltraCart via Settings → UltraCart
3. Add eCommerce components to your site

NOTE: You can Install UltraCart eCommerce - Shopping Cart via the WordPress plugin directory, or by uploading the files manually to your server.

After becoming an UltraCart merchant, use the plugin to connect your accounts and authorize your site to use UltraCart via Settings → UltraCart in the WordPress admin menu.

Installing the plugin

The UltraCart WordPress plugin is located at the following URL:

...

Q: How do I add a product thumbnail to the "mini cart" (shopping cart snapshot that pops out of the right side of page after the item is added)?

A: The shopping cart snapshot is comprised of a set of hard coded in the PHP scripts and these scripts aren't presently customizable.

Q: How do I add a direct checkout link?

...

1. Authorized Applications Logs
2. Webhooks Logs

In general, the webhook logs will have the logs for the communication initiating from UC to the server where Wordpress is hosted, while the application logs will contain the REST http requests and responses initiating from the Wordpress application to UC

Authorized Applications

To view the REST API logs for issue regarding the communication from Wordpress to UltraCart, log into UltraCart, then navigate

To view the log click the "Log" button:

...

After you have successfully installed the wordpress plugin and are working with it, if you encounter and issue with either items syncing or item assignment, you can review the wordpress webhook logs for issue related to the activity of the plugin. 

When reviewing the webhooks logs for errors, click the Request ID of the API call then inspect the Request & Response sections that are display along the right side of the page. The response will contain the error message:

...

If you encounter a problem with the plugin and are unable to resolve it after reviewing the logs for errors, please email support@ultracart.com, providing your UltraCart Merchant ID, and the URL to your Wordpress website, along with a description of the issue you are encountering. 

Updating and Reinstalling the Wordpress Plugin

If the WordPress plugin requires updating to the newest version of the plugin, or in cases where the plugin become unresponsive, you may need to revoke the active instance and delete the corresponding webhook and then reinstall the plugin. 

...

1. Within UltraCart, navigate to the REST API Logs.
   NAVIGATION: Main Menu → Advanced → Developer Tools → REST API → API Logs
2. If you have more than one instance of the "UltraCart Wordpress" and "UltraCart Wordpress Checkout (Linked to UltraCart Wordpress)", click the revoke button for each instance of each.
3. Next, navigate to the WebHook page
   NAVIGATION: Main Menu → Advanced → Developer Tools → WebHooks → Webhook Logs
   
4. Click the "delete" button for each configured webhook with application name of "UltraCart Wordpress".

Inside of Wordpress 

...

of the issue you are encountering. 

Disconnecting and Reconnecting the Wordpress Plugin to Resolve Credentials Errors Issues

If the WordPress plugin requires updating to the newest version of the plugin, or in cases where the plugin become unresponsive with credntials errors, you may need to disconnect the plugin and then reconnect it. 

Inside of Wordpress Administration

1. Log into WordPress, then click Plugins in the lefthand menu
2. Next, click Settings
3. Scroll down and click the Disconnect UltraCart button
   Image Added
   
4. Next click the Connect to UltraCart button that appears in the Ultracart  plugin settings page
   Image Added
   

Optional Clean up within UltraCart

If you are seeing multiple instances of the WordPress Plugin and corresponding WordPress webhook within the UltraCart Developer Tools, you can revoke the old, inactive instances.

1. Navigate: Main Menu → Advanced → Developer Tools
2. To remove inactive Wordpress Plugin instances from the REST APIs , click REST API's:
   Image Added
   
3. Next, click API Logs:
   Image Added
   
4. Click the revoke button for the inactive/old instances:
   Image Added
   
5. After revoking, the inactive instances will show (Disabled), you can click the delete button to remove:
   Image Added
   
6. Next, Navigate: Main Menu → Advanced → Developer Tools → Webhooks (tab) → Webhook Logs:
   Image Added
   
7. Click the Delete button to delete the disabled webhook:
   Image Added
   

Troubleshooting FAQ

Q:  I received an error on the back-end of my Wordpress site when trying to sync my items because new items weren't pulling in to Wordpress from UltraCart. I disconnected and reconnected Ultracart and now my items aren't syncing at all. I see a 403 error in the UltraCart Wordpress Webhook Logs. What could be the issue?

...