Unlockable Packages

Keep your best packages hidden until a client has earned them, then unlock them automatically the moment they qualify.

What it does

Some of your best packages should not be available to just anyone - a premium tier, a loyalty perk, an upgrade you only want to offer to clients who already hold a qualifying service. Blesta already lets you restrict a package so nobody can order it directly, but by itself that restriction never lifts for anybody. Unlockable Packages watches your clients' services and automatically opens up those restricted packages the moment a client owns the right one, then locks them straight back up if that qualifying service is canceled or stops counting. You define the rules once; the plugin keeps every client's access in sync from then on, with no manual grants and no manual revokes.

Key features

• Rules That Unlock Restricted Packages: Pick the main packages a client must own and the restricted packages those should open up, and the hidden packages appear in that client's order form as soon as they qualify.
• Any or All Matching: Decide per rule whether owning any one of the main packages is enough, or the client has to hold all of them before anything unlocks.
• Decide Which Service Statuses Count: A qualifying service counts when it is Active by default, and you can widen a rule to also accept Suspended or Pending services.
• Automatic Re-Locking: When the qualifying service is canceled, suspended or otherwise stops counting, the packages it unlocked go back behind the gate without anyone touching them.
• Markup When the Qualifier Goes Away: Optionally add a percentage or fixed-amount markup to the renewal price of an unlocked service once the client no longer holds the package that earned it, so loyalty pricing ends with the loyalty.
• Enforced, Not Just Hidden: Access is written into Blesta's own restricted-package list, so a client who has not qualified is refused the package even if they try to order it directly.
• Sync All Clients on Demand: One button recomputes access and pricing for every client immediately, so a rule you just changed takes effect without waiting for anything.
• Filterable Rule List: Find a rule by name, enabled state, match mode, markup type or markup amount, with the main and unlocked packages listed on every row.

Enhance your package management with Unlockable Packages by Blesta.Club.

Installing Unlockable Packages

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.
• Unlockable Packages unlocks packages that are already set to Restricted status. Set the status of any package you want a rule to unlock (Packages > edit the package > Status) before you create your first rule - restricted packages are the only ones the rule form lets you choose as the packages to unlock.

1. Upload the files

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

plugins/unlockable_packages/

For example, on a typical install: /var/www/html/blesta/plugins/unlockable_packages/

2. Install it in Blesta

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

3. Configure it

There are no credentials to enter - Unlockable Packages works entirely with your existing packages and services.

1. Installing registers a Unlockable Packages permission section (List/Add/Edit/Delete rules, Sync All Clients) under Settings > System > Staff > Groups. Blesta grants it to your own staff group automatically; grant it to any other staff group that should manage rules.
2. A daily reconcile task is registered automatically on Blesta's cron - it runs at 03:00 to catch up any client whose access should have changed but who has not triggered a service event in the meantime. No setup is needed for it.
3. Open Tools > Unlockable Packages and add your first rule - see the usage guide for a walkthrough of the rule form.

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

Updating Unlockable Packages

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 > Plugins.
4. Find Unlockable Packages and click Update to run the upgrade.

Version-specific notes

• v1.1.0: Adds a staff permission for the Unlockable Packages page. Blesta registers new permissions unchecked, so immediately after the update the page will be hidden and staff will see "You are not authorized to access that resource" until you grant it: go to Settings > System > Staff > Groups, edit each staff group that should manage unlockable packages, and under the Plugins section tick Unlockable Packages (and the individual list/add/edit/delete permissions you want that group to have). This is a one-time step; rules already configured keep working throughout.
• v3.0.0: Requires Blesta 6.0 or later - upgrade Blesta first, then the plugin. Blesta 5 installs should stay on 2.x. Nothing changes in your rules, client access, markups, permissions or the daily reconcile task; the staff pages simply take on the Blesta 6 admin theme, including dark mode: the Edit / Delete links on the list become pencil and trash buttons, and the rule form is split into Rule, Packages and Markup sections.
• v2.0.0: Adds a Sync All Clients button on the Unlockable Packages page and a daily reconcile cron task, plus per-rule Match Mode and Qualifying Service Statuses options. Blesta registers the new Sync All Clients staff permission unchecked, so grant it the same way (Settings > System > Staff > Groups > edit the group > Plugins section > tick Sync All Clients) before staff will see the button. Your existing rules are upgraded automatically and keep their current behavior (Match Mode = any master package, Qualifying Service Statuses = active only); the reconcile cron task is registered and enabled automatically, with no further action required.

Using Unlockable Packages

For your staff

The Unlockable Packages list (Tools menu)

Open Tools in the admin sidebar and click Unlockable Packages to see every rule you've created, with its Enabled state, Name, Master Packages, Unlockable Packages, Match Mode and Markup Type/Amount all listed on the row. Click a column heading to sort by it, and use the funnel button above the list to filter by name, enabled state, match mode, markup type or markup amount. Click the pencil button on a row to change that rule, or the trash button to delete it after confirming. A rule whose unlock packages are no longer set to Restricted carries a red warning under its Unlockable Packages, because it no longer gates them.

Creating or editing a rule

Click the + button (or the pencil button on an existing rule) to open the rule form. It has three sections - Rule, Packages and Markup - and the blue info icons next to the Match Mode, Qualifying Service Statuses and Markup fields explain each option when you hover them:

• Enabled: Untick to keep a rule saved but inactive - it grants nothing and applies no markup until you re-enable it.
• Name: A label to identify the rule in the list; it is not shown to clients.
• Match Mode: Choose Any master package to unlock as soon as the client owns one of the master packages, or All master packages to require every one of them.
• Qualifying Service Statuses: Pick which service statuses count as "owning" a master package - Active is selected by default; add Suspended and/or Pending if you want those to qualify too.
• Main Packages / Unlock Packages: Select one or more packages in the left list as the qualifying (master) packages, and one or more packages in the right list as the ones to unlock (hold Ctrl, or Cmd on a Mac, to select several). Only packages already set to Restricted status appear in the Unlock Packages list.
• Markup Type / Markup Amount: Optionally add a Percentage or fixed Amount markup to the renewal price of an unlocked service once the client no longer qualifies for it. Leave the amount at 0 to disable the markup.

Click Submit to save, or Cancel to go back to the list without saving. Saving a rule does not recompute anyone's access by itself: a new or changed rule reaches a client the next time one of their services is added, changed, suspended, unsuspended or canceled, at the daily reconcile run, or straight away for everyone when you click Sync All Clients.

Sync All Clients

Click Sync All Clients above the list to recompute restricted-package access and pricing for every client right away, rather than waiting for a client's next service change or the nightly cron. Confirm the prompt, and a message reports how many clients were recomputed. Use it after adding or changing a rule when you want the change to apply at once.

Good to know

• Access is enforced on Blesta's own restricted-package list, so a client who has not qualified is refused the package even if they try to order it directly, not just when it happens to be hidden from the order form.
• A package must already be set to Restricted status before it can be chosen as something a rule unlocks; changing its status back to Active makes it orderable by anyone regardless of any rule.
• Markup is applied to the unlocked service's renewal price, not its first-term price, and only while that service is still active and the qualifying package is gone.
• Addon-group packages, and items already sitting in a client's cart before a rule changes, are not re-checked against the current rules - treat restriction as a strong gate on ordinary package groups, not an absolute one everywhere.