Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision Next revision Both sides next revision | ||
litespeed_wiki:cache:lscwp:configuration:esi [2017/10/13 16:00] Lisa Clarke Migrated from main config page |
litespeed_wiki:cache:lscwp:configuration:esi [2018/02/06 15:11] Lisa Clarke [Vary Groups] Added more details |
||
---|---|---|---|
Line 2: | Line 2: | ||
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. | 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. | ||
+ | |||
+ | [[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|}} | {{:litespeed_wiki:cache:lscwp:lscwp-settings-esi.png?direct&800|}} | ||
Line 23: | Line 25: | ||
===== Vary Groups ===== | ===== 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. | 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 34: | Line 47: | ||
If two user roles share the same view, put them in the same group by giving them the same number. | If two user roles share the same view, put them in the same group by giving them the same number. | ||
- | |||
- |