{"id":50705,"date":"2018-10-11T10:00:00","date_gmt":"2018-10-11T15:00:00","guid":{"rendered":"https:\/\/blog.cpanel.com\/?p=50705"},"modified":"2018-10-11T10:00:00","modified_gmt":"2018-10-11T15:00:00","slug":"whm-feature-showcase-update","status":"publish","type":"post","link":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/","title":{"rendered":"WHM Feature Showcase update"},"content":{"rendered":"<p>If you&#8217;ve ever logged in to WHM as a root-level user, you&#8217;ve assuredly seen a box with a notification of a new or improved feature. This dialogue box is known as the &#8220;<a href=\"https:\/\/documentation.cpanel.net\/display\/CKB\/Feature+Showcase\">Feature Showcase<\/a>,&#8221; and has allowed us at cPanel to present information about changes to cPanel &amp; WHM. Since its creation, the Feature Showcase was only available for use by cPanel. However, we&#8217;ve made some changes to the functionality of the Feature Showcase which change that.<\/p>\n<p>Starting in v74, the Feature Showcase system now uses\u00a0<a href=\"https:\/\/documentation.cpanel.net\/display\/CKB\/Feature+Showcase#FeatureShowcase-TheCpanel\/Config\/ConfigObj\/Driver\/drivers.jsonfiles\">individual JSON files<\/a>\u00a0for each Showcase item. The update allows cPanel more control over how it appears and how configuration changes to the system are triggered.<\/p>\n<h3><a href=\"https:\/\/blog.cpanel.com\/wp-content\/uploads\/2018\/10\/Screen-Shot-2018-10-09-at-2.29.19-PM.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter\" src=\"https:\/\/blog.cpanel.com\/wp-content\/uploads\/2018\/10\/Screen-Shot-2018-10-09-at-2.29.19-PM.png\" width=\"621\" height=\"268\" \/><\/a><\/h3>\n<h2>Now hosting providers and plugin developers can create notifications!<\/h2>\n<p>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!\u00a0 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&#8217;t break the normal WHM workflow!<\/p>\n<h2>So what comprises the Feature Showcase?<\/h2>\n<p>The Showcase is split into\u00a0<a href=\"https:\/\/documentation.cpanel.net\/display\/CKB\/Feature+Showcase#FeatureShowcase-Overview\">three different sections<\/a>:<\/p>\n<ul>\n<li><u><strong>Showcased Items<\/strong><\/u>\u00a0Top of the list, reserved for big or very important changes<\/li>\n<li><span class=\"inline-comment-marker\" data-ref=\"1b19fa77-3ad2-441b-bd91-2293d3176168\"><u><strong>Recommended Items<\/strong><\/u><\/span><span class=\"inline-comment-marker\" data-ref=\"1b19fa77-3ad2-441b-bd91-2293d3176168\">\u00a0Recommended items. cPanel &amp; WHM usually enables these items by default, but not always.<\/span><\/li>\n<li><span class=\"inline-comment-marker\" data-ref=\"1b19fa77-3ad2-441b-bd91-2293d3176168\"><u><strong>New Items<\/strong><\/u><\/span><span class=\"inline-comment-marker\" data-ref=\"1b19fa77-3ad2-441b-bd91-2293d3176168\">\u00a0Everything else advertised in this release<\/span><\/li>\n<\/ul>\n<p>Within those sections, there are\u00a0<a href=\"https:\/\/documentation.cpanel.net\/display\/CKB\/Feature+Showcase#FeatureShowcase-Typesofshowcaseitems\">four types of items<\/a>\u00a0that the Feature Showcase supports:<\/p>\n<ul>\n<li class=\"public-DraftStyleDefault-unorderedListItem public-DraftStyleDefault-reset public-DraftStyleDefault-depth0 public-DraftStyleDefault-listLTR\"><u><strong>Announcements<\/strong><\/u>\u00a0Announce a new feature.\u00a0<span class=\"hardreadability\">Announcement features cannot\u00a0<\/span><span class=\"passivevoice\">be enabled<\/span><span class=\"hardreadability\">\u00a0or disabled by a user, nor can a user configure any settings of the announced feature<\/span>.<\/li>\n<li class=\"public-DraftStyleDefault-unorderedListItem public-DraftStyleDefault-reset public-DraftStyleDefault-depth0 public-DraftStyleDefault-listLTR\"><span class=\"veryhardreadability\"><u><strong>Background<\/strong><\/u>\u00a0These features do not appear in the Feature Showcase interface, and background features\u00a0<\/span><span class=\"passivevoice\">are enabled by<\/span><span class=\"veryhardreadability\">\u00a0default for new system installations<\/span><\/li>\n<li class=\"public-DraftStyleDefault-unorderedListItem public-DraftStyleDefault-reset public-DraftStyleDefault-depth0 public-DraftStyleDefault-listLTR\"><span class=\"hardreadability\"><u><strong>Activation<\/strong><\/u>\u00a0Announces a new feature where users\u00a0<\/span><span class=\"passivevoice\">are allowed<\/span><span class=\"hardreadability\">\u00a0to enable or disable the feature<\/span>. Activation items do not allow a user to configure a setting.<\/li>\n<li class=\"public-DraftStyleDefault-unorderedListItem public-DraftStyleDefault-reset public-DraftStyleDefault-depth0 public-DraftStyleDefault-listLTR\"><span class=\"hardreadability\"><u><strong>Configuration<\/strong><\/u>\u00a0Announces a new feature where users can configure a setting of the feature<\/span>.<\/li>\n<\/ul>\n<p><span class=\"veryhardreadability\">There are a few different\u00a0<a href=\"https:\/\/documentation.cpanel.net\/display\/CKB\/Feature+Showcase#FeatureShowcase-Actions\">actions<\/a>\u00a0you can request of a user who views the Feature Showcase item.<\/span><\/p>\n<ul>\n<li><span class=\"veryhardreadability\">enable or disable a feature (<code>enable<\/code>\u00a0or\u00a0<code>disable<\/code>)<\/span><\/li>\n<li><span class=\"veryhardreadability\">enable or disable as the default value (<code>set_default<\/code>)<\/span><\/li>\n<li><span class=\"veryhardreadability\">manage a user submitted form field (<code>handle_showcase_submission<\/code>)<\/span>.\u00a0<span class=\"veryhardreadability\"><br \/>\n<\/span><\/li>\n<\/ul>\n<p><span class=\"veryhardreadability\">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<\/span>.\u00a0Depending on the type of action the user does, the Feature Showcase can return a different value:<\/p>\n<ul>\n<li><code>enable<\/code>\u00a0and d<code>isable<\/code>\u00a0actions return a value of 1 for success and 0 for failure.<\/li>\n<li><code>set_default<\/code>\u00a0actions return a value of 0 for backward compatibility with Version 1.<\/li>\n<li><code>handle_showcase_submission<\/code>\u00a0actions return the form response.<\/li>\n<\/ul>\n<p>To remove a\u00a0Feature Showcase\u00a0item from display simply\u00a0remove the appropriate\u00a0<code>drivers.json<\/code>\u00a0file from the\u00a0<code>\/user\/local\/cpanel\/<\/code><code>Cpanel\/Config\/ConfigObj\/Driver<\/code>\u00a0directory.<\/p>\n<h2>Test Time!<\/h2>\n<p>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:<\/p>\n<ol>\n<li>Log in to WHM as the\u00a0<code>root<\/code>\u00a0user.<\/li>\n<li>Navigate to\u00a0<a href=\"https:\/\/hostname:2087\/\/scripts3\/feature_showcase\">https:\/\/hostname:2087\/\/scripts3\/feature_showcase<\/a>\u00a0(make sure to replace &#8216;hostname&#8217; with your server&#8217;s hostname)<\/li>\n<li>You should see something that resembles the following screen capture, with your new feature showcase item!<\/li>\n<\/ol>\n<p><a href=\"https:\/\/blog.cpanel.com\/wp-content\/uploads\/2018\/10\/feature-showcase.png\"><img decoding=\"async\" class=\"alignnone\" src=\"https:\/\/blog.cpanel.com\/wp-content\/uploads\/2018\/10\/feature-showcase.png\" \/><\/a><\/p>\n<h2>Get started!<\/h2>\n<p>It&#8217;s that easy! The uses for this are extremely exciting and allow our plugin developers a much deeper integration into the user experience.\u00a0If you have any questions or comments about the Feature Showcase, feel free to open a ticket with\u00a0<a href=\"https:\/\/tickets.cpanel.net\/submit\">our support team<\/a>, or reach out to us via\u00a0<a href=\"https:\/\/goto.cpanel.net\/slack\">Slack<\/a>,\u00a0<a href=\"https:\/\/goto.cpanel.net\/discord\">Discord<\/a>, or the Official cPanel\u00a0<a href=\"https:\/\/reddit.com\/r\/cpanel\">Subreddit<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you&#8217;ve ever logged in to WHM as a root-level user, you&#8217;ve assuredly seen a box with a notification of a new or improved feature. This dialogue box is known as the &#8220;Feature Showcase,&#8221; and has allowed us at cPanel to present information about changes to cPanel &amp; WHM. Since its creation, the Feature Showcase [&hellip;]<\/p>\n","protected":false},"author":77,"featured_media":65061,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[49],"tags":[],"class_list":["post-50705","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-products"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v21.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>WHM Feature Showcase update | cPanel<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"WHM Feature Showcase update | cPanel\" \/>\n<meta property=\"og:description\" content=\"If you&#8217;ve ever logged in to WHM as a root-level user, you&#8217;ve assuredly seen a box with a notification of a new or improved feature. This dialogue box is known as the &#8220;Feature Showcase,&#8221; and has allowed us at cPanel to present information about changes to cPanel &amp; WHM. Since its creation, the Feature Showcase [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/\" \/>\n<meta property=\"og:site_name\" content=\"cPanel\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/cpanel\/\" \/>\n<meta property=\"article:published_time\" content=\"2018-10-11T15:00:00+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/devel.www.cpanel.net\/wp-content\/uploads\/2018\/10\/2018.10.11.Featureshowcaseupdateno.png\" \/>\n\t<meta property=\"og:image:width\" content=\"3858\" \/>\n\t<meta property=\"og:image:height\" content=\"1527\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"cPanel Community\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@cPanel\" \/>\n<meta name=\"twitter:site\" content=\"@cPanel\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"cPanel Community\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/\",\"url\":\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/\",\"name\":\"WHM Feature Showcase update | cPanel\",\"isPartOf\":{\"@id\":\"https:\/\/devel.www.cpanel.net\/#website\"},\"datePublished\":\"2018-10-11T15:00:00+00:00\",\"dateModified\":\"2018-10-11T15:00:00+00:00\",\"author\":{\"@id\":\"https:\/\/devel.www.cpanel.net\/#\/schema\/person\/8cf97408aad4fb70cf55d11a1d4f57f8\"},\"breadcrumb\":{\"@id\":\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/devel.www.cpanel.net\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WHM Feature Showcase update\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/devel.www.cpanel.net\/#website\",\"url\":\"https:\/\/devel.www.cpanel.net\/\",\"name\":\"cPanel\",\"description\":\"Hosting Platform of Choices\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/devel.www.cpanel.net\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/devel.www.cpanel.net\/#\/schema\/person\/8cf97408aad4fb70cf55d11a1d4f57f8\",\"name\":\"cPanel Community\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/devel.www.cpanel.net\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e1949945083b5526bb95711bd3d616b3?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e1949945083b5526bb95711bd3d616b3?s=96&d=mm&r=g\",\"caption\":\"cPanel Community\"},\"description\":\"The web hosting industry's most reliable management solution since 1997. With our first-class support and rich feature set, it's easy to see why our customers and partners make cPanel &amp; WHM their hosting platform of choice. For more information, visit cPanel.net.\",\"sameAs\":[\"https:\/\/cpanel.net\"],\"url\":\"https:\/\/devel.www.cpanel.net\/blog\/author\/cpadmin\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"WHM Feature Showcase update | cPanel","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/","og_locale":"en_US","og_type":"article","og_title":"WHM Feature Showcase update | cPanel","og_description":"If you&#8217;ve ever logged in to WHM as a root-level user, you&#8217;ve assuredly seen a box with a notification of a new or improved feature. This dialogue box is known as the &#8220;Feature Showcase,&#8221; and has allowed us at cPanel to present information about changes to cPanel &amp; WHM. Since its creation, the Feature Showcase [&hellip;]","og_url":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/","og_site_name":"cPanel","article_publisher":"https:\/\/www.facebook.com\/cpanel\/","article_published_time":"2018-10-11T15:00:00+00:00","og_image":[{"width":3858,"height":1527,"url":"https:\/\/devel.www.cpanel.net\/wp-content\/uploads\/2018\/10\/2018.10.11.Featureshowcaseupdateno.png","type":"image\/png"}],"author":"cPanel Community","twitter_card":"summary_large_image","twitter_creator":"@cPanel","twitter_site":"@cPanel","twitter_misc":{"Written by":"cPanel Community","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/","url":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/","name":"WHM Feature Showcase update | cPanel","isPartOf":{"@id":"https:\/\/devel.www.cpanel.net\/#website"},"datePublished":"2018-10-11T15:00:00+00:00","dateModified":"2018-10-11T15:00:00+00:00","author":{"@id":"https:\/\/devel.www.cpanel.net\/#\/schema\/person\/8cf97408aad4fb70cf55d11a1d4f57f8"},"breadcrumb":{"@id":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/devel.www.cpanel.net\/blog\/products\/whm-feature-showcase-update\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/devel.www.cpanel.net\/"},{"@type":"ListItem","position":2,"name":"WHM Feature Showcase update"}]},{"@type":"WebSite","@id":"https:\/\/devel.www.cpanel.net\/#website","url":"https:\/\/devel.www.cpanel.net\/","name":"cPanel","description":"Hosting Platform of Choices","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/devel.www.cpanel.net\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/devel.www.cpanel.net\/#\/schema\/person\/8cf97408aad4fb70cf55d11a1d4f57f8","name":"cPanel Community","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/devel.www.cpanel.net\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e1949945083b5526bb95711bd3d616b3?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e1949945083b5526bb95711bd3d616b3?s=96&d=mm&r=g","caption":"cPanel Community"},"description":"The web hosting industry's most reliable management solution since 1997. With our first-class support and rich feature set, it's easy to see why our customers and partners make cPanel &amp; WHM their hosting platform of choice. For more information, visit cPanel.net.","sameAs":["https:\/\/cpanel.net"],"url":"https:\/\/devel.www.cpanel.net\/blog\/author\/cpadmin\/"}]}},"_links":{"self":[{"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/posts\/50705"}],"collection":[{"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/users\/77"}],"replies":[{"embeddable":true,"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/comments?post=50705"}],"version-history":[{"count":0,"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/posts\/50705\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/media\/65061"}],"wp:attachment":[{"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/media?parent=50705"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/categories?post=50705"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devel.www.cpanel.net\/wp-json\/wp\/v2\/tags?post=50705"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}