Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

toc

Table of Contents

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

Panel

Main Menu  Advanced → Developer Tools  REST APIs → API Logs >  Authorized Applications (tab)

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. 

Panel

Main Menu  Advanced → Developer Tools  Webhooks → Webhook Logs >  "Log" button

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:

Image Removed

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. 

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 Removed
  4. Next click the Connect to UltraCart button that appears in the Ultracart  plugin settings page
    Image Removed

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.

...

" button

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:

Image Added

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. 


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
Info
UPDATE: As of 08/11/2021 when you perform the Disconnect/Reconnect steps above, UltraCart will automatically remove all stales API application instances.
Please email support@ultracart.com if plugin errors continue after performing the disconnect/reconnect with the plugin.

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?

...