Versions Compared

Old Version 47

changes.mady.by.user Hunter Schaeffer

Saved on

compared with

New Version Current

changes.mady.by.user Hunter Schaeffer

Saved on

Key

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

Table of Contents

...

  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?

...

Q: What are the tracking scripts associated with the WordPress plugin integration?

A: There two potential tracking scripts, here's how to access them:

The analytics script requires jQuery to be included on the page, and it also requires specific attributes.
For example:


Code Block
<script async defer src="'. $src .'" data-mid="'. $mid .'" data-channel="'. $host_name .'"></script>


Inspecting and the Log 

If you are having an issue with the plugin, there are two areas in which to inspect the plugin API logs.

  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:

...

The Wordpress logged events will appear like this:

Webhook Log

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:

...

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 credentials errors, you may need to revoke the active instance and delete the corresponding webhook and then reinstall the plugindisconnect the plugin and then reconnect it. 

Inside

...

  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 Wordpress Administration

  1. Log into WordPress, then click Plugins in the left-hand 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 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?

A: If you have multiple WordPRess WordPress plugins installed, it could be caused by another plugin. In this case the merchant did end up identifying a SPAM plugin as the culprit. So, if you have multiple plugins installed in addition to the UltraCart Wordpress plugin, try temporarily disabling the other installed plugins to see if that resolves the issue.

...