Table of contents
What the extension does
Training Videos for MainWP installs the Training Videos plugin on the child sites you choose, activates each one against your license, and keeps its video selection in step with what you set on the Dashboard. Your license key stays on the Dashboard: child sites never receive it, only a key locked to their own address.
Sites deployed this way get the neutral build of the plugin. It lists itself under the name you choose, and your clients see your business name and support link, never ours. Not using MainWP? The single-site guide covers installing the plugin by hand.
You need:
- MainWP Dashboard 5.4 or newer, on WordPress 5.8+ and PHP 7.4+.
- Client sites connected to that Dashboard through the MainWP Child plugin.
- Your license key (it starts with
wptl_). If you have lost it, regenerate it in your agency account.
Install the extension
Sign in to your agency account with the email address you bought the license with, and click Download the MainWP extension.
On the WordPress site that runs your MainWP Dashboard, go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP, click Install Now, then Activate Plugin. No MainWP.com API key is involved: the extension is unlocked by your WP Tutoring license key.
Open Training Videos for MainWPfrom MainWP’s extensions (Add-ons). It opens on the Status tab, next to Library, My videos, Sites and Settings. Only administrators can use it.
Add your license key
On the Status tab, paste your key into the Licence key box and click Save & verify. You should see Licence verified.and your account and plan. The key is checked before it is saved, and it is kept in MainWP’s encrypted key store on the Dashboard.
The Status tab also shows how many of your plan’s slots are in use, the video catalogue, where your sites stand, and recent activity.
Your name on client sites
On the Settings tab, fill in Your details before you deploy. It is what your clients see:
- Your business name: the name of the training library on every client site.
- Your support URL and Your support message: where a client is sent for help. They contact you, never us.
- On the Plugins screen: the plugin name, description, author and links each client site shows. Leave a field empty to use your business name and support URL.
Leave Install the client plugin from on WP Tutoring (licensed download). Under Catalogue updates, choose whether a course we publish is held for your review (the default) or added to your client sites automatically. Click Save Settings: sites already deployed are queued for the change.
Choose the default videos
The Library tab holds the Default selection for new sites: the lessons every newly deployed site gets, and any site set to use your defaults. Choose Who can watch (the lowest role on a client site that can open the library; the default is Contributors and up), then click Save defaults. Sites that follow the defaults pick up the change on the hourly sync.
When a new course is waiting for your review, the Library tab says so. Click Add these to my sites to release it to your clients, or leave it hidden. Nothing appears on a client site while a course is held.
Deploy to your sites
On the Sites tab, tick the sites (or Select all, or filter by group). Only sites MainWP can currently reach are listed.
Click Deploy selected. For each site the extension installs and activates the plugin, registers the site against your license, and sends its configuration. Sites run one at a time, and progress shows as Deploying… (n / total).
A site’s first deploy uses one slot on your plan. Deploying it again reuses the same slot, so re-running a deploy is safe. Push selected only sends the configuration to sites that already have the plugin, and never installs anything.
On a deployed site, the plugin’s settings page says the training videos are managed by your business, with a Get support button to your support URL. There is nothing for the client to configure.
Choose what each client sees
On the Sites tab, click Configure on a site. Under Show, pick Use my default selection, Choose for this client or Nothing (keep the plugin, hide everything), and set Who can watch. Every lesson is shown by default: uncheck what this client shouldn’t see. Your own videos are the opposite, off until you tick them.
Click Save. The site shows Out of date until the change reaches it: click Push (or Deploy) to apply it now, or let the hourly sync carry it.
Add your own videos
On the My videos tab, paste a Video URL (YouTube, Vimeo, Wistia, Loom, or a direct link to a video file), give it a Title your clients will see, and click Add video. You can add up to 200. They appear alongside the lessons, in their own section, on the sites where you tick them under Configure. Removing a video takes it off every site.
Release a slot
To take the library off a site and give its slot back to your plan, click Remove on the site’s row in the Sites tab and confirm. The client loses access, the slot is released, and the plugin stays installed but does nothing. You can also release any site from your agency account: click Release next to it.
| If you… | Is the slot released? |
|---|---|
| Click Remove on the Sites tab | Yes |
| Click Release in your agency account | Yes. The Dashboard notices within the hour and marks the site Released from your account. |
| Delete the site from MainWP first | No. The site keeps its slot and is listed under Slots in use by sites you no longer manage on the Status tab: release it from your agency account. |
| Deactivate or delete the plugin on the client site | No. The next sync reports that the plugin is not active. |
| Delete the extension, or click Forget key | No. Remove your sites first if you want their slots back. |
| Change a site’s address | No. The next deploy registers the new address, which uses a slot, and the old address appears under Slots in use by sites you no longer manage. |
If you regenerate your key
Regenerate in your agency account stops the old key working immediately. On the Status tab, clear the saved key, paste the new one and click Save & verify. The extension checks it, then re-sends the configuration to the sites that need it, the rest within the hour. Child sites never held the key, so there is nothing to change on them.
Updates
The extension updates from the Dashboard site’s Plugins screen, like any other plugin, as long as your license key is saved. When we publish a new version of the client plugin, the Sites tab adds a Sites to update filter: select those sites and click Deploy selected to install it. Push and the hourly sync never upgrade the plugin. Deploy is also how sites still on version 2.x move to 3.x.
Troubleshooting
A site’s status and its last error show on the Sites tab (hover the status) and in the site’s own Training Videos tab in MainWP.
| What you see | What to do |
|---|---|
| Add your licence key first. | Add it on the Status tab (see add your license key). |
| Invalid or inactive license key, or Your licence key was rejected. | The key was regenerated, or the license is not active. Save your current key, and check the license status in your agency account. |
| Domain limit reached for the … plan | Every slot is in use. Release sites you no longer manage, or move up a plan, then deploy again. |
| Too many download requests, or Too many requests to WP Tutoring | Wait a minute and try again. A license can install the plugin on about 120 sites an hour, so deploy a very large fleet in batches. |
| MainWP could not reach this site. | Fix the site’s connection in MainWP (Sync or Reconnect), then deploy. |
| The Training Videos plugin is not active on this site. | Click Deploy: it re-activates or reinstalls the plugin and keeps the site’s slot. |
| This site runs an older Training Videos plugin. | Click Deploy to install the current version. |
| This site runs a newer Training Videos plugin. Update this extension. | Update the extension from the Dashboard’s Plugins screen. |
| Out of date | The site hasn’t received your latest changes yet. Click Push. |
| Released from your account | The site was released from your agency account. Deploy it again (which uses a slot), or Remove it. |
| Licence paused | Your license is not active, so the library is paused on the client’s site. Check your plan in your agency account. |
| A cURL or connection error when saving the key or deploying | The Dashboard’s server must be able to make HTTPS requests to app.wp-tutoring.com. Ask the host to allow it. |
Still stuck? Email service@wp-tutoring.com with the site’s address and the message you see.