NewThe WP Tutoring WordPress training platform is live — on demand video courses and interactive WordPress lessons. Free lessons included.Start free
TutorialsManual (PDF)Courses & PricingAbout
Helping site owners learn WordPress since 2012 · (844) WP-TUTOR
WP TutoringLEARN · BUILD · GROW
(844) WP-TUTORGet Help Now

Training Videos setup guide

Everything you need to put the video library in a client’s dashboard: install the plugin, activate the site with your license key, choose what the client sees, and move a slot to another site when a client leaves.

Table of contents
Managing your sites from MainWP?The Training Videos for MainWP extension installs and activates the plugin on every child site from your Dashboard, so you can skip most of this page. Follow the MainWP setup guide instead.

Before you start

  • Your license key. It starts with wptl_ and was emailed to you once, when you bought your plan. We never store the full key, so if you have lost it, sign in to your agency account and click Regenerate to issue a new one (see if you regenerate your key).
  • The plugin. It is not on WordPress.org. Sign in to your agency account with the email address you bought the license with, and click Download the plugin.
  • An administrator loginon the client’s site, which needs WordPress 5.8 or newer and PHP 7.4 or newer.

Each site you activate uses one slot on your plan: Starter has 10, Studio 25, Agency 50, Agency+ 100 and Network 300. A site is its domain, plus the folder when WordPress lives in one: clientsite.com and clientsite.com/intranet are two sites. Your agency account lists every site that holds a slot.

Install the plugin

Upload the ZIP

In the client’s WordPress dashboard, go to Plugins → Add New Plugin, click Upload Plugin, choose the ZIP you downloaded and click Install Now. Don’t unzip it first.

Activate it

Click Activate Plugin. A Training Videos menu appears in the dashboard, with a Settings page underneath for administrators.

The download from your account lists itself on the Plugins screen as Training Videos by WP Tutoring. Sites you deploy from a MainWP Dashboard get the neutral build instead, which shows your business name and never names us.

Multisite networksActivate the plugin on each site that should have the videos, not across the network: network activation is refused, because every site in a network uses its own slot.
Upgrading a site from version 2.xVersion 3.0.0 moved the plugin to a new folder, so older copies can’t update themselves into it. Install 3.0.0 as above: it switches off and removes the old copy, and keeps the license, settings and video choices. If the old folder can’t be removed automatically you’ll see a notice, and deleting it from the Plugins screen is safe.

Activate the site

Open the settings

Go to Training Videos → Settings.

Paste your license key

Paste the whole key, starting wptl_, into License key and click Save & activate.

Check it worked

You should see Your license is active and the catalog has been refreshed. and a badge showing your plan. The site now holds a slot and appears under Activated sites in your agency account.

The key is stored encrypted on the site. Clients can’t see it, and only administrators can change the settings.

Choose what each client sees

Everything below is on Training Videos → Settings, and each site keeps its own choices.

  • Who can watch. Pick the lowest role that sees the Training Videos menu, from Everyone who can log in (Subscribers and up) to Administrators only. The default is Contributors and up (can write posts). Administrators always have access.
  • Available videos. Every course and lesson is shown by default. Uncheck a course, or single lessons inside it, to hide them, then click Save availability. New lessons we publish appear automatically unless you hide them.
  • Additional Videos. Add your own videos by URL (YouTube, Vimeo, Loom, or a direct link to an .mp4, .webm or .mov file). They appear in their own section after the courses, up to 50 per site.

The library plays only inside the dashboard, for logged-in users. It is never shown on the public site.

Release a slot

When a client leaves, or a site moves, release its slot so you can use it elsewhere. The slot is free straight away, and the training videos on that site stop playing. There are two ways:

  • From your agency account: find the site under Activated sites, click Release and confirm. This works even if you no longer have access to the site.
  • On the site: in Training Videos → Settings, click Remove this key. The videos disappear from the site and its slot goes back to your plan.
Deactivating the plugin does not release the slotNeither does deleting it. The site keeps its slot until you release it from your account or click Remove this key first.

If a site changes address (a new domain, or gaining or losing www.), the settings page says so. Click Re-activate & refresh catalog to register the new address, which uses a slot, then release the old address from your account.

If you regenerate your key

Regenerate in your agency account shows a new key once and stops the old one working immediately. The sites stay registered, but each site that was activated with the old key needs the new one: open Training Videos → Settings, replace the key in License key and save. Sites managed from MainWP never hold the key; update it once in the extension instead (see the MainWP guide).

Updates

New versions appear on the site’s Plugins and Dashboard → Updates screens like any other plugin, and automatic updates work too. They come from us rather than WordPress.org, so the site must be activated with your key to receive them. The video library itself updates on its own: new lessons show up within the hour, or straight away if you click Re-activate & refresh catalog.

Troubleshooting

The messages below are shown on Training Videos → Settings unless noted.

What you seeWhat to do
That doesn’t look like a license key.Paste the whole key, starting wptl_, with nothing missing.
Invalid or inactive license key, or Your license key was rejected.The key was regenerated, or the license is not active. Paste your current key, and check the license status in your agency account.
Your license has no room for this site, or Domain limit reached for the … planEvery slot is in use. Release a site you no longer need (see release a slot) or move up a plan, then paste the key again and click Save & activate.
This site was activated as … but its address is now …Click Re-activate & refresh catalog, then release the old address from your account.
The stored license key can no longer be readThe site’s WordPress security keys (salts) changed. Paste the license key again.
Could not reach the WP Tutoring service (or “the video service”)The site’s server can’t make an HTTPS request to app.wp-tutoring.com. Ask the host to allow it through the firewall or proxy.
In the library: This lesson could not be opened.Reload the page and try again. If it persists, check that the browser can reach app.wp-tutoring.com and iframe.mediadelivery.net, and that a privacy or ad blocker isn’t stopping the player.
A new lesson isn’t in the library yetThe list refreshes hourly. Click Re-activate & refresh catalog to fetch it now.
On the Updates screen: This site has no licence to download updates with.Activate the site with your key first.

Getting help

Email service@wp-tutoring.comwith the site’s address and what you see on screen, and we’ll get it running. Your agency account has your license, plan and every activated site.