How to install WPMaven from your hosting panel
For hosting companies in the WPMaven partner program. Your customers install WordPress from the panel they already use, and WPMaven comes with it, ready to connect. Your partner code is built into the plugin, so every customer who creates their WPMaven account from that site counts for you.
It installs with WordPress from cPanel and Plesk (WP Toolkit), Softaculous and Installatron, with your partner code built in, and with WHMCS when it creates the hosting accounts.
This page is the installer step. The whole setup, from joining the partner program to your first customer, is in How to offer WPMaven on your hosting.
What you need
- Your partner code. It is on your Partner program page in the WPMaven
dashboard:
WPM-P-and six letters and digits, for exampleWPM-P-K7Q2MX. - Your plugin package. A zip named
wpmaven-wordpress-<your code>.zip: the WPMaven plugin with your code built in. On your Partner program page, under Your panel kit, choose Download the plugin package. Every panel below installs this one file.
Nothing else changes on your servers. The plugin is an ordinary plugin: your backup, migration and monitoring tools keep working on these sites.
How your code counts
- The plugin keeps your code in the site’s database the first time it runs, so the code stays when the plugin updates itself.
- When the customer opens WPMaven in their site’s admin area and chooses Build my business, Manage my site or Sign in, the link to the WPMaven dashboard carries your code. A new account created from it is yours.
- The first partner link a browser opens counts for 90 days, and an account is never moved from one partner to another. An account that existed before the customer used your link stays where it is.
- You can add your own reference for each customer, your account number for example. It shows next to that customer on your Partner program page. See Add your own customer reference.
Your panel button
Put a button where your customers start a site. There are two ways, and you can offer both:
- Install WordPress with WPMaven. The button runs your installer with the WPMaven set (the steps below). The customer then opens WPMaven in their new site’s admin, and the team builds the business on your hosting.
- Your build link.
https://dashboard.wpmaven.ai/create?ref=and your code. It asks the customer where the business will live, with your hosting first: a customer who has WordPress with you connects it, and a customer who has none yet is sent to your installer. Set the address of your panel’s WordPress installer under Your panel kit, in Where your customers install WordPress, so that step opens it.
cPanel (WP Toolkit)
In WHM:
- Open WP Toolkit, then Sets, and choose Create Set. Name it, for example “WPMaven”.
- In the set, choose Add plugins and upload your plugin package. Turn its state on, so the plugin is active as soon as WordPress is installed.
- Open Edit Packages and select a hosting package. Check the WP Toolkit option, select your set as the Autoinstall Set, then Save Changes. Repeat for every package that should include WPMaven.
Every WordPress that WP Toolkit installs for an account on those packages then includes the plugin, active, with your code built in.
Plesk (WP Toolkit)
- Go to WordPress, open the Plugins tab and choose Upload plugin. Select your plugin package. In the same window you can add it to a set, or keep None and add it in the next step.
- Open the Sets tab. To start a new set, choose Create Set, name it, then Add Plugins and select the WPMaven plugin. Choose to activate it.
- Go to Service Plans, open a hosting plan, then the Additional Services tab. In the WP Toolkit section, choose to install WordPress with a set, select your set, and save the plan.
Subscriptions created on that plan then get WordPress with the plugin installed and active on their main domain, and customers can pick the same set whenever they install WordPress from WP Toolkit.
Softaculous
- In the Softaculous Admin Panel, go to Software, then Manage WordPress Sets.
- Choose Create Sets, enter a name, for example “wpmaven”, and choose Create.
- Choose Add custom plugin/theme: name “WPMaven”, slug
wpmaven-wordpress, and upload your plugin package. Add it to the set.
Your customers then see the set when they install WordPress from Softaculous, and can select it.
To install the set with every WordPress that Softaculous installs through
WHMCS (the Softaculous WHMCS Auto Install module), add the set to the module’s
softaculous_extra.php, with _admin after its name (it marks a set made in
the admin panel), and upload that file next to softaculous.php in WHMCS’s
includes/hooks folder:
<?php$GLOBALS['softaculous_conf']['defaults']['sets_name'][] = 'wpmaven_admin';Installatron
Installatron can run your own code after it installs an application. Use the
address under Its address, always the newest version in Your panel kit
(it always serves the newest package), or put the package at a web address your
server can download, then, as root, add
the code below to /usr/local/installatron/etc/installercustomcode.php, or
paste it under Administration, Applications, Customization. If the
file already has an i_installer_customcode class, add the two lines of
init and the wpmaven_install function to it instead.
<?phpclass i_installer_customcode{ public static function init($o) { // Your plugin package, at an address your server can download. $o->registerArchive("wpmaven", "https://downloads.example-host.com/wpmaven-wordpress-WPM-P-XXXXXX.zip", "zip"); $o->registerCustomCode("wordpress", "all", "install", "last", "wpmaven_install"); }
public static function wpmaven_install($o) { $o->extract("wpmaven", "wp-content/plugins"); // Turn it on, on a new site where nothing else is on yet. $o->db_query( "UPDATE `{$o->db_prefix}options` SET `option_value`=? WHERE `option_name`='active_plugins' AND `option_value` IN ('a:0:{}', '') LIMIT 1", array(serialize(array("wpmaven-wordpress/webmaven-wordpress.php"))) ); }}Every WordPress that Installatron installs then includes the plugin. If your Installatron setup turns on other plugins during the install, WPMaven stays installed but off, and your customers turn it on under Plugins.
WHMCS
- WP Toolkit (cPanel and Plesk): nothing more to do. WHMCS creates the account on the package or plan, and WP Toolkit installs WordPress with your set, as described above.
- Softaculous: use the Softaculous WHMCS Auto Install module, with the
softaculous_extra.phpline above.
WP-CLI, or any other installer
Install your plugin package and turn it on:
wp plugin install /path/to/wpmaven-wordpress-WPM-P-XXXXXX.zip --activateOr install the plugin and give the site your code yourself, with either of:
wp option update webmaven_partner_code WPM-P-XXXXXX// In wp-config.php, above "That's all, stop editing!"define('WPMAVEN_PARTNER_CODE', 'WPM-P-XXXXXX');The wp-config.php line wins over the option, and the option wins over the
code built into the package.
Add your own customer reference
Optional. Give each site your own reference for that customer, in letters,
digits and _ . : -, up to 64 characters, after WordPress is installed:
wp option update webmaven_partner_ref acct-12345or in wp-config.php:
define('WPMAVEN_PARTNER_REF', 'acct-12345');It is sent only together with your partner code.
Check that it works
On a test account:
-
Install WordPress from your panel, as a customer would.
-
In WordPress, go to Plugins: WPMaven WordPress is there and active.
-
With WP-CLI on that site,
wp option get webmaven_partner_codeshows your code, after the first page load of the new site. -
Open WPMaven in the site’s admin menu and choose Build my business: the address of the page that opens contains
partner=and your code.
-
Create the account. It shows on your Partner program page.
Updates
The plugin updates itself, like any WordPress plugin with an update available, and keeps your code. Download the package again from Your panel kit from time to time and replace the one in your set or your installer, so new sites start on the newest version. An installer that uses the kit’s address always gets the newest version by itself.
Questions
Write to your named contact. The rest of the partner program, your links, statements and payouts, is in How to use the partner program.