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:cpanel-plugin [2019/06/25 20:34]
Lisa Clarke [Translations] Proofreading
litespeed_wiki:cpanel:cpanel-plugin [2021/10/06 15:20] (current)
Lisa Clarke Redirect to new Documentation Site
Line 1: Line 1:
-====== cPanel Plugin - LiteSpeed Web Cache Manager ====== +~~REDIRECT>​https://docs.litespeedtech.com/​cp/​cpanel/​cpanel-plugin/​~~
- +
-===== Where Did This Plugin Come From? ===== +
- +
-The LiteSpeed Web Cache Manager plugin for cPanel is a companion plugin to the LiteSpeed plugin for WHM. If a hosting provider is using both LiteSpeed Web Server and the LiteSpeed plugin for WHM, they are able to [[litespeed_wiki:​cpanel:​whm-plugin-cpanel-plugin#​installation|install this plugin]] for their cPanel end-users. +
- +
- {{ :​litespeed_wiki:​cpanel:​cpanel-v1.0.0-advanced-icon.png?​nolink |}} +
- +
- +
-===== Plugin Breakdown ===== +
- +
-==== Main Page ==== +
- +
-This is the first page shown when visiting the plugin page. Here you will be presented with 3 sections and a link to the settings page. +
- +
-{{ :​litespeed_wiki:​cpanel:​cpanel-v1.0.0-main-page.png?​nolink |}} +
- +
-  * **Why Use LSCache?** - Contains some information on LSCache and the various available LSCache plugins through the [[https://​litespeedtech.com/​products/cache-plugins|Available LSCache Plugins]] link. +
-  * **Flush LSCache** - This section contains a button for flushing the contents of your LSCache folder. This will clear the cache for all owned sites with LSCache enabled. +
-  * **LiteSpeed Cache Management** - This section contains a link to the LiteSpeed Cache Management page for owned WordPress sites where LSCWP can be selectively enabled and disabled on a per site basis. +
-  * **Settings** - This link will take you to the plugin settings page. +
- +
-The **LiteSpeed Cache Management** and **Settings** pages will be covered in more detail below. +
- +
-==== LiteSpeed Cache Management - WordPress Cache ==== +
- +
-The manage view is where most of the magic happens. ​ Here you can manage LSCWP for your WordPress installations individually or in groups. +
- +
-{{ :​litespeed_wiki:​cpanel:​cpanel-v1.0.0-manage-wordpress.png?​nolink |}} +
- +
-Starting from the actual table we have the following fields: +
- +
-  * **Discovered WordPress Installations**: ​ This field contains the path of each WordPress installation discovered during the last scan operation. +
- +
-  * **Cache Status**: Displays the last known status of LSCWP for the listed WordPress installation. +
- +
-  * **Flag**: This field can either be blank or display a flag icon. While an installation is flagged (in other words, displaying the flag icon), it will be excluded from all future Mass Enable/Disable LSCWP operations in the WHM plugin. +
- +
-  * **Actions**:​ This field contains action buttons that perform a specific action only for the related WordPress installation. These actions include Enable/​Disable LSCWP and Flag/Unflag this installation. +
- +
-Looking at the top row of buttons, we have **Scan/​Re-scan**,​ **Refresh Status**, and to the right, **Flush All**. +
- +
-  * **Scan/​Re-scan**:​ Discovers all WordPress installations under each cPanel user's known document root. These discovered installations will then be saved to a data file and displayed on the manager screen. If this data file is removed or corrupted, simply scan again to repopulate the list. +
- +
-  * **Refresh Status**: Each listed WordPress installation will have an LSCWP Status reflecting the status of LSCWP for that installation. The **Refresh Status** button will update this value to the most current status for all listed WordPress installations. +
-   +
-  * **Flush All**: Like the button of the same name on the main page, this button will flush the contents of your LSCache folder. This will clear the cache for all owned sites with LSCache enabled. +
- +
-Moving on we have the the bottom row of buttons which are used to perform group operations. These buttons work in tandem with the check-boxes found next to each discovered installation to allow you to perform some basic operations for only the selected group. +
- +
-  * **Enable Selected & Disable Selected**: These buttons allow you to enable and disable LSCWP for the selected WordPress installations. +
- +
-  * **Flag Selected & Unflag Selected**: These buttons allow you to set or unset the flag field for the selected WordPress Installations. Flagged installations will be excluded from **Mass Enable/​Disable LSCWP** operations in the WHM plugin. +
- +
-==== Settings ==== +
- +
-The Settings page allows you to control various plugin related settings (one at the moment). +
- +
-{{ :​litespeed_wiki:​cpanel:​cpanel-v1.0.0-settings.png?​nolink |}} +
- +
-  * **Log File Level**: This setting controls the highest level of log messages that will be written to the log file located at ''/​home/​$user/​lscmData/​ls_webcachemgr.log''​. The default value is ''​INFO''​. +
- +
-===== Translations ===== +
- +
-As of the cPanel user-end ​plugin ​v1.2.2, a ''​lang/''​ directory has been added. This will allow custom translations for plugin text. The translation language used is based on the cPanel dashboard locale selected. +
- +
-The ''​lang/''​ directory will also contain any translations submitted to LiteSpeed for inclusion in the plugin package. Be aware that these translations will be bypassed if any custom translations for that locale exist in the ''​lang/​cust/''​ directory. +
- +
-Instructions for translating the plugin are included in the plugin'​s ''​lang/​cust/''​ directory ''​README''​ file, included below: +
- +
-<​file>​ +
-Welcome to the LiteSpeed Web Cache Manager user-end cPanel plugin'​s '​lang/​cust'​ +
-directory. This directory will contain any custom translations you would like +
-to use with the LiteSpeed Web Cache Manager user-end cPanel plugin. +
- +
-This file will now explain how to provide your own custom translations for this +
-plugin based on the language selected in a user's cPanel dashboard. +
- +
-1) Choose a cPanel locale to provide translations for. A full list of available +
-locales can be found through WHM under +
- +
-Home >> Locales >> View Available Locales +
- +
-2) Once a locale has been chosen, create a directory under this plugin'​s +
-'​lang/​cust'​ directory for that locale using the same name as the locale. Then +
-create an '​en_US'​ directory under that, and an '​LC_MESSAGES'​ directory under the +
-'​en_US'​ directory. +
- +
-Using French as an example (cPanel locale '​fr'​) our directory structure would look +
-like: +
- +
-lang/ +
--cust/ +
---fr/ +
----en_US/ +
-----LC_MESSAGES/​ +
- +
-Note: The '​en_US'​ directory exists as a workaround for linux systems that may not +
-contain certain locales, as it is commonly installed on most systems. If you +
-are running into issues getting your translations to appear, please make sure +
-that the '​en_US.utf8'​ locale is installed on your system. +
- +
-Note: As long as the '​lang/​cust/​fr'​ directory exists, this directory will always be +
-used when looking for translation files, regardless of wheather or not any +
-exist. If you would like to go back to checking the official translation +
-directory under '​lang',​ you must remove/​rename the '​cust'​ locale directory. +
- +
-3) Generate a '​messages.po'​ file for your desired language based on the +
-'​messages.pot'​ file provided under the '​lang'​ directory, or copy the '​messages.po'​ file +
-for your locale if it has already been officially provided under the '​lang'​ +
-directory. +
- +
-4) Update the generated '​messages.po'​ file with any new translations. You should +
-also update the '​messages.po'​ file header info if you have not already. +
- +
-5) Generate a '​messages.mo'​ file based on your updated '​messages.po'​ file and place +
-both the '​messages.po'​ and '​messages.mo'​ files under the custom '​LC_MESSAGES'​ +
-directory created earlier. +
- +
-6) Visit the LiteSpeed user-end cPanel plugin through a cPanel dashboard and +
-confirm that your translations are appearing. +
- +
-CAUTION: Any custom translation files will be lost upon uninstalling the +
-LiteSpeed Web Cache Manager user-end cPanel plugin. Please keep a copy of any +
-custom translation files elsewhere to prevent loosing these files. +
- +
-That should be all that is required to begin using custom translations with the +
-LiteSpeed user-end cPanel plugin. +
- +
-If you would like to have your custom translations included as official +
-translations in future versions of the LiteSpeed Web Cache Manager user-end +
-cPanel plugin, or have updates for exisitng official translations,​ please send +
-an email including the locale and both '​messages.po'​ and '​messages.mo'​ files to +
-info@litespeedtech.com. +
-</​file>​+
  • Admin
  • Last modified: 2019/06/25 20:34
  • by Lisa Clarke