Differences

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

--- litespeed_wiki:cache:lscwp:configuration:esi [2017/11/17 20:13]
Lisa Clarke [LSCWP Configuration Settings: ESI]
+++ litespeed_wiki:cache:lscwp:configuration:esi [2020/05/04 13:41]
Shivam Saluja
@@ Line 1: / Line 1: @@
-====== LSCWP Configuration Settings: ESI ======
+====== LiteSpeed Cache for WordPress Settings: ESI ======
+**Please Note**: This wiki is valid for v2.9.x and below of the LiteSpeed Cache Plugin for WordPress. If you are using v3.0 or above, please see [[https://docs.litespeedtech.com/lscache/lscwp/overview/|the new documentation]].
 To learn about ESI and the implications of enabling it in LSCWP, please see [[litespeed_wiki:cache:lscwp:esi|this wiki]]. Please note: ESI is not available with OpenLiteSpeed. You need LiteSpeed Web Server Enterprise edition or LiteSpeed Web ADC in order to use ESI.
@@ Line 5: / Line 6: @@
 [[https://blog.litespeedtech.com/2017/09/06/wpw-esi-and-litespeed-cache/|Learn more about ESI on our blog.]]
-{{:litespeed_wiki:cache:lscwp:lscwp-settings-esi.png?direct&800|}}
+You can turn shortcodes into ESI blocks. [[litespeed_wiki:cache:lscwp:configuration:esi:shortcode|Learn how here.]]
+{{:litespeed_wiki:cache:lscwp:lscwp-settings-esi.png?nolink|}}
 ===== Enable ESI =====
@@ Line 25: / Line 28: @@
 ===== Vary Groups =====
-With Vary Groups you can have multiple publicly-cached versions of a single page, based on the permissions of the users who view the page.
+**NOTE**: Despite its location on the ESI settings tab, the Vary Groups function is not actually related to ESI.
-For example, in some themes administrator functions will appear right on the public pages (like an “edit” link at the end of a post). If you create a vary group for administrators, then LSCache will save two public copies of the page: one with all of the editing permissions displayed on it for anyone in the administrator group, and the default copy of the page without the editing links for everyone else.
+Vary Group functionality combines the concepts of [[litespeed_wiki:cache:developer_guide:cache-vary|cache varies]] and [[https://codex.wordpress.org/Roles_and_Capabilities|user roles]]: with Vary Groups you can have multiple publicly-cached versions of a single page, based on the permissions of the users who view the page.
-Your list of user roles may vary from those in the image above. That's normal.
+(Your list of user roles may vary from those in the image above. That's normal.)
+Vary Groups do not change the behavior of your application. They simply allow separate cached copies to be saved for each public view that is //already being generated by your app//. Without Vary Groups, apps that generate different views for different user roles would need to leave logged-in users uncached, or serve to them from private cache.
+Learn more about Vary Groups [[https://blog.litespeedtech.com/2017/09/13/wpw-vary-groups/|on our blog]].
+==== Example 1 ====
+In some themes administrator functions will appear right on the public pages (like an “edit” link at the end of a post). If you create a vary group for administrators, then LSCache will save two public copies of the page: one with all of the editing permissions displayed on it for anyone in the administrator group, and the default copy of the page without the editing links for everyone else.
+==== Example 2====
+A shop has two user roles: ''retail_customer'' and ''wholesale_customer''. There are two sets of prices, and three different ways that the site can be viewed: users in the group ''retail_customers'' will see the highest prices. Users in the group ''wholesale_customers'' will see the lowest prices. Users who are not yet customers will see the default page with no pricing whatsoever. This scenario would require two Vary Groups: one for ''retail_customer'' and one for ''wholesale_customer''.
+==== Settings ====
 To create a vary group for any user role shown, enter a non-zero value into the box next to that user role. If a user role has a ''0'' next to it, then it will be served the default cached copy.
@@ Line 36: / Line 50: @@
 If two user roles share the same view, put them in the same group by giving them the same number.