From db3c05f07d78f11bbf3aee056049708d064446be Mon Sep 17 00:00:00 2001 From: Lisa Clarke Date: Fri, 10 Nov 2023 15:02:27 -0500 Subject: [PATCH] Edited README and updated screenshot --- README.md | 82 +++++++++++++++++-------------------------------------- 1 file changed, 25 insertions(+), 57 deletions(-) diff --git a/README.md b/README.md index 1413781..2fb6a56 100644 --- a/README.md +++ b/README.md @@ -2,29 +2,23 @@ LiteSpeed Cache for Drupal 8+ ============================ * Fastest Page cache for Drupal CMS. - * Page Cache for both Logged In and Logged Out users. - * Auto Purge relate Page Caches when content changes. - * Drush and non-Drush cli commands for Cache warmup/clear. +* Web GUI warmup will also warm up **Private Cache for Logged In Users** if enabled. +* Supports latest releases of Drupal 8+, 9+ and 10+ . -* Web GUI warmup will also warmup "Private Cache for Logged In Users" if enabled. - -* Support latest release of Drupal 8+, 9+ and 10+ . - -See https://www.litespeedtech.com/products/cache-plugins for more information. - +See [the LiteSpeed Website](https://www.litespeedtech.com/products/cache-plugins/drupal-acceleration) for more information about LiteSpeed Cache for Drupal. +See [the full documentation](https://docs.litespeedtech.com/lscache/lscdrupal/) for more installation and configuration help. Prerequisites ------------- This version of LiteSpeed Cache requires Drupal 8 or later and LiteSpeed Web Server (LSWS) 5.2.3 or later. - Download ------------- -Download LiteSpeed Cache Module to your local computer from: +Download the LiteSpeed Cache Module to your local computer from: https://github.com/litespeedtech/lscache-drupal/archive/master.zip @@ -48,23 +42,19 @@ Once you have downloaded the plugin, you can install by visiting: http://example.com/admin/modules/install -Using the browse button you can upload the plugin you just downloaded and start the installation. Once installed, enable the plugin by going to: +Using the browse button, you can upload the plugin you just downloaded and start the installation. Once installed, enable the plugin by going to: -http://example.com/drupal/admin/modules + http://example.com/drupal/admin/modules ![LiteSpeed Cache Drupal](https://www.litespeedtech.com/support/wiki/lib/exe/fetch.php/litespeed_wiki:cache:enable_lscache_drupal.png) * Use the search box to search for a module. +* Check the checkbox next to **LiteSpeed Cache**. +* Click **Install**. +* Turn on LiteSpeed Cache in **Module Settings**. -* Check the checkbox next to LiteSpeed Cache. - -* Click Install. - -* Turn on LiteSpeed Cache in Module Settings. - - -Configurations +Configuration ------------- This step is optional. Once the plugin is activated, your cache is already up and running, but on the configuration screen, you can customize few settings. @@ -72,39 +62,17 @@ This step is optional. Once the plugin is activated, your cache is already up an Go to http://example.com/admin/config/development/lscache - - ![LiteSpeed Cache Drupal Plugin Configurations](https://www.litespeedtech.com/support/wiki/lib/exe/fetch.php/litespeed_wiki:cache:configure-lscache.png?cache=) - -* Warmup this site - -Warmup the LSCache of current Drupal site. It will also warmup "Private Cache for Logged In Users" if enabled. - -* Clear this site - -Clears the LSCache of current Drupal site. It will not clear LSCache of other sites if multiple CMS sites run on the same virtual host. - -* Public Cache TTL - -Amount of time LiteSpeed web server will save pages in the public cache. - -* Private Cache TTL - -Amount of time LiteSpeed web server will save "ESI Block contents" in the Private cache. OpenLiteSpeed does not support Private Cache. - -* ESI Blocks Setting - -The ESI block list of general logged in pages. ESI Block should be the DIV ID inside HTML source. for example, a DIV block: - -``` -
...
-``` - -ESI Block Setting: id=bar-administrator - -* Debug - -If turned on, LiteSpeed Cache will print lscache header to LSWS web server Log files. - + ![LiteSpeed Cache Drupal Plugin Configuration](https://docs.litespeedtech.com/imgs/lscache/lscdrupal/configure-lscache.png) + +* **Warmup this site**: Warm up the LSCache of the current Drupal site. It will also warm up **Private Cache for Logged In Users** if enabled. +* **Clear this site**: Clears the LSCache of the current Drupal site. It will not clear the LSCache of other sites if you have multiple CMS sites running on the same virtual host. +* **Public Cache TTL**: Amount of time LiteSpeed Web Server will save pages in the public cache. +* **Private Cache TTL**: Amount of time LiteSpeed web server will save **ESI Block Contents** in the Private cache. OpenLiteSpeed does not support Private Cache. +* **ESI Blocks Setting**: The list of ESI blocks on general logged in pages. The ESI Block name should be the same as the `div id` inside the HTML source. For example, in the following `div` block, the ESI Block name would be `bar-administrator`: + ``` +
...
+ ``` +* **Debug**: If turned on, LiteSpeed Cache will print the LSCache header to LSWS log files. CLI commands ------------- @@ -117,7 +85,7 @@ CLI commands are only allowed to execute from the website host server. curl -N "http://example.com/lscpurgeall" ``` -or in /drupal_root/vendor/bin folder, execute drush command: +or in `/drupal_root/vendor/bin` folder, execute `drush` command: ``` ./drush lscache:purgeall example.com @@ -129,10 +97,10 @@ or in /drupal_root/vendor/bin folder, execute drush command: curl -N "http://example.com/lscwarmup" ``` -or in /drupal_root/vendor/bin folder, execute drush command: +or in `/drupal_root/vendor/bin` folder, execute `drush` command: ``` ./drush lscache:warmup example.com ``` -CLI warm up command can only warmup public page caches, if you wants to warmup "Private Cache for Logged In users", you need to use the Web Gui warmup in LSCache admin panel. +CLI `warmup` command can only warm up public page caches. If you want to warm up **Private Cache for Logged In Users**, you need to use the Web GUI warmup in the LSCache admin panel.