Enhance

Sell Enhance web hosting from Blesta - accounts, subscriptions and websites created automatically, with a real self-service area for your clients.

What it does

Selling Enhance-powered web hosting normally means someone on your team creating the customer, the panel login and the subscription by hand every time an order comes in. This module removes that step: the moment an order is paid, Blesta creates the Enhance customer, the panel login and the subscription for you, and provisions the website. Your clients then get their own area to manage the hosting day to day - opening their control panel, checking resource usage, seeing their websites and resetting their panel password - without a support ticket or a second set of credentials to remember.

Key features

• Fully Automated Hosting Provisioning: A paid order creates the customer, the panel login and the subscription in Enhance and sets up the website, so hosting is live within seconds of checkout with nothing for your team to do.
• One-Click Panel Login: Clients open their hosting control panel straight from the service page without typing a password, so there is no second set of credentials for them to lose.
• Websites Tab: Clients see every website on their subscription with its domain, type, status and PHP version, and on subscription-only packages they can add new websites themselves without opening a ticket.
• Accounts Overview: A read-only Accounts tab lists each website alongside how many mailboxes, FTP users and databases it is using, so clients can see where their allowance is going.
• Self-Service Password Changes: Clients set a new hosting panel password from a Change Password tab, and when your staff change the service password the panel login is updated to match automatically.
• Resource Usage at a Glance: Disk space, transfer, websites, mailboxes, databases, FTP users, CPU, RAM, IOPS and more are shown as used against allowance for both your staff and your clients, with unlimited allowances shown as such.
• Subscription-Only and Staging Packages: Sell a plan with no domain asked for at checkout so clients add their own websites afterwards, or sell staging plans that provision on a generated hostname instead of a live domain.
• Server Group Targeting: Point a package at a specific Enhance server group or leave it on Any, so you can sell location-specific or hardware-specific plans from the same panel.

Every credential the module stores is encrypted, every API request it makes is logged for you to review, and a built-in mock mode lets you trial the entire module - every screen and every action - with bundled sample data before you connect a real Enhance panel.

Installing Enhance

Before you start

• Version 3.x requires Blesta 6.0 or later. On a Blesta 5 install, use version 2.x instead.
• If you are on the leased (subscription) licence, the Blesta Club Subscription Manager must be installed and your subscription active. The owned and owned-source licences have no such requirement.

1. Upload the files

Upload the extension folder into your Blesta installation so it lands under your Blesta directory at:

components/modules/enhance/

For example, on a typical install: /var/www/html/blesta/components/modules/enhance/

2. Install it in Blesta

1. Log in to your Blesta admin area with a staff account that has the "Modules" permission (with Install Module and Manage Module) under the Settings group in Manage Staff Groups.
2. Go to Settings > Company > Modules and click the Available tab.
3. Find Enhance in the list and click Install.

3. Configure it

1. On the Modules page, switch to the Installed tab, find Enhance and click Manage.
2. Click Add Server and fill in:
   • Name - an internal label for this server, shown only in your admin area.
   • Hostname - your Enhance control panel URL, including http:// or https://.
   • Username - your Enhance organisation ID (orgId), found in Enhance under Settings > Access Tokens.
   • Access Hash - an Enhance access token, created from that same Access Tokens page. It is stored encrypted and never shown again once saved - leave it blank when editing a server later to keep the token you already saved.
   • Enable Mock API - tick this to trial the module with built-in sample data instead of a live Enhance panel; any hostname, username and token are accepted and no connection is made. Leave it unticked for a real server.
3. Save the server.
4. Create (or edit) a package and assign it to this server on the package's Module tab, where you can also choose the Enhance plan it provisions, pick a specific server group, and mark it Staging or Subscription Only.

You're ready to go - see the usage guide for a walkthrough of day-to-day use.

Updating Enhance

Upgrading works just like installing: upload the new files over the old ones, then run the upgrade from the same page you installed it on.

1. Back up your current extension files first - good practice before any upgrade.
2. Upload the new version over the existing folder, replacing the old files.
3. Log in to your Blesta admin area and go to Settings > Company > Modules.
4. Find Enhance and click Update to run the upgrade.

Version-specific notes

• v3.0.0: Requires Blesta 6.0 or later - upgrade Blesta first, then the module. Blesta 5 installs should stay on 2.x. Nothing changes in your servers, packages or services; the staff screens simply take on the Blesta 6 admin theme, and the Edit and Delete links on the server list become buttons.
• v2.0.0: Clients now get three new service tabs - Websites, Accounts and Change Password - with nothing for you to configure. A package can also target a specific Enhance plan per client using a new package_id configurable option, alongside the existing server_group_id one. Two new email tags, {service.panel_url} and {service.sso_url}, are available if you want to reference the control panel or a one-click login link in a service email.
• v1.4.0: Server rows gained an Enable Mock API option for testing and demos - leave it unticked and nothing changes for a real server. The Access Token is now stored encrypted and shown masked on screen; when editing a server, leave the Access Hash field blank to keep the token you already saved. The Access Token was also removed from the available email tags, so any email template referencing it will need updating.

This upgrade is otherwise drop-in - no data migration is needed beyond the above.

Using Enhance

For your staff

Managing servers

Go to Settings > Company > Modules, open the Installed tab, and click Manage next to Enhance. This lists every server you've added, with its name, hostname, username and a masked access hash. Click Add Server to add another, or the pencil button next to an existing one to edit it - the access token field is left blank on edit and only changes if you type a new one - and the red bin button removes a server after asking you to confirm. Each field on the server form has a small info icon you can hover for a hint, and the Back button in the form's header returns you to the server list. Enhance automatically decides which of its own nodes to provision onto, so in most cases you only need to add your main Enhance instance here as a single server.

Setting up a package

On a package's Module tab, after choosing Enhance as the module and a server, you'll see:

• Package - the Enhance plan this package provisions (pulled live from your Enhance server).
• Staging - provisions the site on a generated hostname instead of asking for a domain, for a staging-only plan. This is disabled automatically when Subscription Only is ticked, since the two are mutually exclusive.
• Subscription Only - provisions the Enhance subscription without a website, so no domain is asked for at checkout. Clients can add their own website afterwards from their Websites tab.
• Server Group - targets a specific Enhance server group, or leave it on Any. Below this dropdown you'll see the same server groups listed with their IDs, for use in configurable options.

Configurable options

Add a configurable option named server_group_id to let clients pick their own server group at checkout - use the IDs listed under the package's Server Group field. Add one named package_id to let clients (or a configurable option override) select between several Enhance plans from a single package - its value is the numeric Enhance plan ID shown in the Package dropdown.

Migrating an existing Enhance account

To bring an account that already exists in Enhance under a Blesta service instead of provisioning a new one, add the service from the client's profile and, on the Enhance Options step of the Add Service form, fill in its Website ID, Subscription ID and Customer ID along with its email, password and domain - and leave the Provision using the Enhance module box unticked, so the module records those details rather than creating a new customer, subscription and website in Enhance. On an existing service the same fields are on its Basic Options tab.

Service tabs and resource usage

Managing a client's service shows a Resource Usage tab with disk space, transfer, websites, mailboxes, databases, FTP users and other allowances used against their limits, with unlimited allowances shown as such.

Email tags

The following are available when customising module, package and service emails: module name, hostname, username; package package_id, staging; service website_id, customer_id, subscription_id, email, password, domain, panel_url, sso_url. The server's access token is deliberately left out of this list so it can never be pasted into a client-facing email. panel_url is the Enhance control panel address and sso_url is a one-click single sign-on link generated when the service is provisioned - treat it as a convenience rather than a permanent link, since it expires.

For your clients

Clients manage their hosting from their service page, which shows these tabs:

Resource Usage

Disk space, transfer, websites, mailboxes, databases, FTP users and other resources shown as used against the plan's allowance, with a progress bar for each.

Websites

Every website on the subscription, with its domain, type, status and PHP version, plus a button to open the Enhance control panel directly. On a Subscription Only package, an Add a Website form appears below the list so the client can add a new website by entering its domain, without needing to contact you.

Accounts

A read-only summary of each website's mailbox, FTP user and database counts, so clients can see where their allowance is being used.

Change Password

Lets the client set a new Enhance panel login password. Enter and confirm a new password to update it - your staff changing the service's password from the admin area also updates the panel login to match.

Login To Panel

A single sign-on link that opens the client straight into their Enhance control panel, with nothing to log in with.

Good to know

• Passwords shown on the client's service page stay hidden and only reveal on hover, and both the email and password can be copied to the clipboard in a click.
• If a service's package used a configurable option to override its server group or Enhance plan, that override is what actually provisions - the package's own Module tab settings are the default, not a guarantee.