Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
litespeed_wiki:cpanel:whm-plugin-custom-cpanel-plugin-template [2019/04/22 17:51]
Michael Alegre [Setting A Custom Template]
litespeed_wiki:cpanel:whm-plugin-custom-cpanel-plugin-template [2021/10/06 15:19] (current)
Lisa Clarke Redirect to new Documentation Site
Line 1: Line 1:
-====== WHM Plugin - Using A Custom cPanel Plugin Template ====== +~~REDIRECT>​https:​//docs.litespeedtech.com/cp/​cpanel/​cpanel-plugin/#use-custom-template~~
- +
-The LiteSpeed Web Cache Manager plugin for cPanel can be customized to load a custom template through the LiteSpeed WHM plugin. A custom template allows a hosting provider to modify or completely replace the content of the LiteSpeed Web Cache Manager plugin'​s landing page for all cPanel users without modifying existing plugin files directly. +
- +
-===== Preparing A Custom Template ===== +
-Preparing and using a custom template for the LiteSpeed Web Cache Manager plugin for cPanel is an easy process. Simply navigate to ''​/usr/local/​cpanel/​base/​frontend/​paper_lantern/​ls_web_cache_manager/​landing''​ and create a directory named for your custom template, such as ''​myCustomTemplate''​. +
- +
-Once you have created the template directory, you can either copy the existing ''​index.php''​ file under ''​/usr/local/cpanel/base/​frontend/​paper_lantern/​ls_web_cache_manager/​landing/​default''​ into this directory to get started, or copy over your own version from elsewhere. This file will handle calling any custom code or files you need to manage. It will display the new landing page while still having relative access to all the existing classes, functions, and pages already built into the plugin. +
- +
-**Note:** It is strongly recommended that all custom template code be backed up at different location to prevent possible loss of the LiteSpeed Web Cache Manager plugin during uninstall or upgrade. As such, we also recommend using a symlink in place of these files in the actual plugin location. +
- +
-===== Setting A Custom Template ===== +
- +
-To set a custom template for use, first make sure that the LiteSpeed Web Cache Manager plugin has been [[litespeed_wiki:​cpanel:​whm-plugin-cpanel-plugin#​installation|installed through the LiteSpeed WHM plugin]]. Once this step has been completed, select the **Settings** icon from the **cPanel Plugin** section of the LiteSpeed WHM plugin. +
- +
-{{ :​litespeed_wiki:​cpanel:​whm-plugin-main_cpanelpluginsettings.png?​nolink |}} +
- +
-You should now be on the **cPanel Plugin Settings** page which will display a **Use Custom Template** setting field. +
- +
-{{ :​litespeed_wiki:​cpanel:​whm-v3.1.0-cpanel-plugin-settings.png?​nolink |}} +
- +
-Here you can set a custom ​template ​to be used if it has already been created. Using the example from the previous section, we would enter ''​myCustomTemplate''​ here and save.  If the template folder exists and contains the required ''​index.php''​ file, the save operation should succeed. From now on, all cPanel users should see your custom landing page when accessing the LiteSpeed Web Cache Manager plugin through the cPanel dashboard. +
- +
  • Admin
  • Last modified: 2021/10/06 15:19
  • by Lisa Clarke