WooCommerce Helper

Note: as of WooCommerce 3.1 you can now manage your WooCommerce.com subscriptions directly within WooCommerce. Read more here.

 

Install WooCommerce Helper to help activate your WooCommerce subscription key(s). Activating your key(s) on your site will enable:

  • Easy Updates via the WordPress Updates page.
  • Support from our team.

We only provide support for sites with an activated subscription key for that product.

Installation ↑ Back to top

To install the WooCommerce Helper plugin:

  1. Download the WooCommerce Helper plugin (woothemes-updater.zip file).
  2. Go to: Plugins > Add New.
  3. Select Uploads Plugin at the top.
  4. Choose File and select the woothemes-updater .zip file.
  5. Select Install Now.
  6. Activate the plugin.

Activating Subscription Keys ↑ Back to top

On your site or store, go to: Dashboard > WooCommerce Helper.
woocommerce-helper-menu
Under the Subscriptions tab you can connect your WooCommerce.com account to activate subscription keys or manually copy and paste subscription keys for all of your WooCommerce.com purchases. Note: The Help tab has other useful resources.

WooCommerce Helper Screen

Automatically Activate Keys ↑ Back to top

  1. Click the big blue Connect your WooCommerce.com Account button.
  2. Log into the appropriate WooCommerce.com account if needed.
  3. Click Connect Account.

All subscription keys for products on that site are connected and activated for you.

Manually Add Keys ↑ Back to top

You can manually add subscription keys if you don’t want to connect your WooCommerce.com account to the WooCommerce Helper on a particular site.

Manually Add Subscription Key

  1. Go to: My Subscriptions on your WooCommerce.com account.
  2. Copy the key for the relevant product
  3. Go to your site > WooCommerce Helper > Subscriptions tab and paste the subscription key into the field for your product.
  4. Select the Connect Subscriptions button to activate the key.

Missing Plugin, Extension or Theme ↑ Back to top

Plugins, extensions or themes that are missing from the list of Subscriptions are those that need to be manually updated. It means that the version you have is older and cannot be detected by WooCommerce Helper.

All settings are saved on your site, so you can download the latest version from your aWooCommerce.com Account Downloads page and manually update the product.

It then displays in the WooCommerce Helper, and you can activate your subscription key(s).

Note: Custom CSS to a theme are protected if in a child theme; custom code in plugin files will need to be redone.

Moving keys ↑ Back to top

One subscription key entitles you to use on one live site and one testing/staging/development site as of November 2016. There’s no need for you to deactivate on one site and reactivate on another.

If you have more sites than the number you purchased, then you can move the subscription key between sites.

  • Activate the key on the site you need it most, so you’re getting support and updates on that site. The product still functions 100% without an active key; you won’t get easy updates or support for that site without it activated.

or

  • Move keys from site to site. Deactivate your key and reactivate on the other site. Go to your WooCommerce Account Dashboard > My  Subscriptions page.

Deactivate the key:

woocommerce-key-deactivate

Then reactivate the same key by on the next site by going to your respective site’s Dashboard and following instructions above in Activating Subscription Keys.

Step-by-step instructions are found at: Deactivate/Reactivate Your Subscription Key.

Updating products ↑ Back to top

Once you have activated keys for product(s), WordPress is able to update them from the Updates page.

It is important to use a child theme, or hooks and filters if you customize the core code of a product. If you do not use a child theme/hooks and filters and you update a product, you will lose your customizations.

woo-helper-updates

To update your product(s):

  1. Go toDashboard > Updates.
  2. Check the box for your product under Plugins/Themes.
  3. Select the Update Plugins/Themes button.
Updating your product through Dashboard > Updates.
Updating your product through Dashboard > Updates.

Help Tab ↑ Back to top

The Help tab contains the most common links to get started with our products.

woothemes-helper-help

WordPress Multisite ↑ Back to top

The WooCommerce Helper works with a multisite. You’ll need to network-activate the WooCommerce Helper to activate your keys and also network-activate the extensions.

The following extensions SHOULD NOT be network activated and must be updated manually*

  • PayPal Express
  • Western Union
  • Catalog Restrictions
  • Software Add On
  • WooCommerce Recommendation Engine
  • WooCommerce Compare Products Pro
  • WooCommerce US Export
  • WooCommerce Review for Discount
  • WooCommerce Follow Up Emails
  • WooCommerce Cart Notices
  • WooCommerce Advanced Notifications
  • WooCommerce Amazon S3 Storage
  • Royal Mail Shipping Module for WooCommerce
  • Table Rate Shipping

*These extensions create database tables and/or new pages and are not set up to do this on a multisite network.

Key Exceeded Activation ↑ Back to top

If you receive the following message: “This has exceeded the number of times it can be activated.”

  1. Go to: WooCommerce Account Dashboard > My Subscriptions tab
  2. Deactivate your key for the URL that is no longer in use.
  3. Reactivate on your WordPress site via Dashboard > WooCommerce Helper.

Tip: The above steps apply if you change your WordPress URL at any time. This includes adding or removing ‘www’ from the URL under Settings > General, or changing from ‘http’ to ‘https.’

How key activations work ↑ Back to top

When transferring your website — even from a staging server on a platform such as WPEngine — the keys remain “active” on your website’s database, but are not actually active on our servers.

Keys are active for specific URLs. Therefore, when moving from a staging server or other URL, the URL changes and makes the key inactive.

Troubleshooting ↑ Back to top

Common issues with the WooCommerce Helper may include:

WooCommerce Helper isn’t updating. ↑ Back to top

Your server may be blocking connections to WooCommerce.com via a firewall. The best solution is to check with your web host.

My key says it’s been activated already. ↑ Back to top

Follow the step-by-step instructions: Deactivate/Reactivate your key. This typically fixes the issue.

My updates aren’t showing. ↑ Back to top

Either you haven’t activated a key, or the server is blocking the connection. If the latter, check with your web host.

Everything looks to be activated, yet no updates are coming through. ↑ Back to top

Either:
a) there are no updates or
b) you activated the key, changed the site URL or changed from http to https, and now it is not picking up the updates.

This has been resolved in the latest version of the Helper, the key is automatically deactivated if the URL doesn’t match correctly, but your WordPress installation may think the key is still active so deactivate and reactivate it in your WordPress admin.

‘No keys were specified for activation.’ ↑ Back to top

If you receive this error, go to WooCommerce > System Status Report to check if SUHOSIN is activated on your site.

suhosin

If SUHOSIN is activated this means your hosting provider is likely setting a suhosin.post.max_name_length variable in the config which causes inputs with long names, like the license key inputs, to be discarded when you click ‘Activate’ as it is longer then the limit in the config.

If activated, contact your hosting provider about removing the suhosin.post.max_name_length limit or increasing it to 200 so key activations can work.

FAQ ↑ Back to top

Why do I need a key? ↑ Back to top

A key gives you:

  • Two-click updates of the product.
  • Support for the product through our Help Desk.

Note that we only provide support on tickets for websites that have authenticated keys.

Will my product work without the key activated? ↑ Back to top

Yes!

Why is my theme not showing up in the WooCommerce Helper? ↑ Back to top

If you have an older version downloaded before 26th November 2013, you need to manually update your theme, as there is a new theme_info.txt file inside your theme zip file which is needed.

What happens to my translation (.mo/.po/.pot) files on automatic update? ↑ Back to top

If a language file is contained within the plugin itself, and is not a part of the original plugin package (e.g., You added it yourself), this language file will be overwritten in the same way it would be overwritten in a theme.

For language files, we recommend creating a wp-content/languages folder, to store your translations when upgrading a theme or plugin.

Why can’t I see my products in the Dashboard > Updates page? ↑ Back to top

If you can’t see your products, you might need to tell WordPress to force check by clicking the Check Again button at the top of Dashboard > Updates screen. It may take a few times to work.

I’m missing keys for plugins/themes on My Subscriptions account page. Where are they? ↑ Back to top

If you have purchased products and are missing keys, submit a ticket at our Help Desk with the order number for products you are missing.

Do you have more info on keys? ↑ Back to top

Yes we have an extensive section in our WooThemes FAQ with the most common questions asked about keys and subscriptions.

Questions ↑ Back to top

Already searched this page and still need assistance? Get in touch with a Ninja via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top