If you’ve ever logged in to WHM as a root-level user, you’ve assuredly seen a box with a notification of a new or improved feature. This dialogue box is known as the “Feature Showcase,” and has allowed us at cPanel to present information about changes to cPanel & WHM. Since its creation, the Feature Showcase was only available for use by cPanel. However, we’ve made some changes to the functionality of the Feature Showcase which change that.
Starting in v74, the Feature Showcase system now uses individual JSON files for each Showcase item. The update allows cPanel more control over how it appears and how configuration changes to the system are triggered.
Now hosting providers and plugin developers can create notifications!
The greatest benefit the new functionality of the Feature Showcase provides is opening the feature to third-parties. Hosting providers, plugin developers, and server owners can create their own Feature Showcase boxes in an officially supported way for the first time! This means that parties such as plugin developers can create new Feature Showcase popups upon the launch of a new feature in their plugin, or announce a change to an existing feature! This allows developers to create messaging that appears directly to WHM end-users in a way that doesn’t break the normal WHM workflow!
So what comprises the Feature Showcase?
The Showcase is split into three different sections:
- Showcased Items Top of the list, reserved for big or very important changes
- Recommended Items Recommended items. cPanel & WHM usually enables these items by default, but not always.
- New Items Everything else advertised in this release
Within those sections, there are four types of items that the Feature Showcase supports:
- Announcements Announce a new feature. Announcement features cannot be enabled or disabled by a user, nor can a user configure any settings of the announced feature.
- Background These features do not appear in the Feature Showcase interface, and background features are enabled by default for new system installations
- Activation Announces a new feature where users are allowed to enable or disable the feature. Activation items do not allow a user to configure a setting.
- Configuration Announces a new feature where users can configure a setting of the feature.
There are a few different actions you can request of a user who views the Feature Showcase item.
- enable or disable a feature (
enableordisable) - enable or disable as the default value (
set_default) - manage a user submitted form field (
handle_showcase_submission).
Using the ability to craft Feature Showcase messaging to your end users allows a bit of flexibility in enabling, disabling, or configuring any new features you wish to spotlight. Depending on the type of action the user does, the Feature Showcase can return a different value:
enableand disableactions return a value of 1 for success and 0 for failure.set_defaultactions return a value of 0 for backward compatibility with Version 1.handle_showcase_submissionactions return the form response.
To remove a Feature Showcase item from display simply remove the appropriate drivers.json file from the /user/local/cpanel/Cpanel/Config/ConfigObj/Driver directory.
Test Time!
Once you have created your new feature showcase item, you will definitely want to test it before you push it to end users. To test a Feature Showcase listing, follow these steps:
- Log in to WHM as the
rootuser. - Navigate to https://hostname:2087//scripts3/feature_showcase (make sure to replace ‘hostname’ with your server’s hostname)
- You should see something that resembles the following screen capture, with your new feature showcase item!
WHM Feature Showcase update
As of my last update in September 2021, the Web Host Manager (WHM) periodically rolls out new features, enhancements, and updates to improve its functionality and address the evolving needs of hosting providers and users.
The “Feature Showcase” in WHM is a helpful section that highlights and introduces users to the newest features or significant changes added in recent updates. After a cPanel & WHM update, upon first login, the system might present administrators with the Feature Showcase interface. This allows admins to see, at a glance, what’s new or changed and make immediate decisions about enabling or disabling those features.
To get the most recent and specific details about the “Feature Showcase” or any other WHM updates, you would typically:
- Log into WHM: When you log in after an update, any new or notable features will often be presented in the Feature Showcase section.
- Check cPanel’s Official Documentation: cPanel maintains extensive documentation on their website, including release notes and feature spotlights.
- cPanel & WHM Version History: This is a detailed log of changes, including new features, tweaks, and bug fixes for each version.
- cPanel Forums & News: The community forums are a good place to learn about recent changes, get insights from other users, and provide feedback.
If you’re seeking information on a very recent update or feature after September 2021, I’d recommend visiting cPanel’s official website or community forums, or logging into your WHM to see these updates firsthand.
