{"id":9452,"date":"2018-04-04T06:00:45","date_gmt":"2018-04-04T10:00:45","guid":{"rendered":"https:\/\/blog.litespeedtech.com\/?p=9452"},"modified":"2018-04-04T06:00:45","modified_gmt":"2018-04-04T10:00:45","slug":"test-plugins-compatible-with-litespeed-cache-for-wordpress","status":"publish","type":"post","link":"https:\/\/lswp.store\/index.php\/2018\/04\/04\/test-plugins-compatible-with-litespeed-cache-for-wordpress\/","title":{"rendered":"WpW: Testing for Compatibility with LSCache"},"content":{"rendered":"<p>&nbsp;<\/p>\n<p><a href=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null.png\"><img fetchpriority=\"high\" decoding=\"async\" class=\"aligncenter size-full wp-image-9454\" src=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null.png\" alt=\"WordPress Wednesday: Is My Plugin Compatible With LiteSpeed Cache for WordPress?\" width=\"640\" height=\"320\" srcset=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null.png 640w, https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null-300x150.png 300w, https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null-600x300.png 600w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\n<p>Welcome to another installment of <a href=\"http:\/\/blog.litespeedtech.com\/tag\/wordpress-wednesday\">WordPress Wednesday<\/a>!<br \/>\nToday\u2019s topic is: <strong>Is My Plugin Compatible With LiteSpeed Cache for WordPress?<\/strong><\/p>\n<p><em><strong>Disclaimer<\/strong>: The information contained in this post is accurate for LSCWP v2.2.0.1 [<a href=\"https:\/\/wordpress.org\/plugins\/litespeed-cache\/#developers\">release log<\/a>]. If you are using a newer version of the plugin, some details may have changed. Please<a href=\"https:\/\/www.litespeedtech.com\/support\/wiki\/doku.php\/litespeed_wiki:cache:lscwp\"> refer to our wiki<\/a> for the latest!<\/em><\/p>\n<p>If you are wondering if a particular plugin is compatible with LiteSpeed Cache for WordPress, this guide can help you figure it out. We&#8217;ve tried to make these instructions as easy to understand as possible. <strong>You don&#8217;t need to be a developer<\/strong> in order to test for compatibility between two plugins. (Although, if you <em>are<\/em> a developer, you might find <a href=\"https:\/\/lswp.store\/2017\/10\/18\/wpw-lscache-and-your-plugin-perfect-together\/\">our article about the LSCache API<\/a> to be more your speed.)<\/p>\n<p><strong>NOTE<\/strong>: While you <em>could<\/em> perform these tests on a production site, we recommend using a test WordPress installation if you have one. This allows you to really take your time, and follow the steps carefully. Testing compatibility is not <em>hard<\/em>, per se, but it can be time-consuming. If you have to effectively take your production environment offline for the duration of the test, that can add pressure you don\u2019t need!<\/p>\n<h2>Before You Begin<\/h2>\n<p>You may not have to do a test at all!<\/p>\n<ol>\n<li><a href=\"https:\/\/www.litespeedtech.com\/support\/wiki\/doku.php\/litespeed_wiki:cache:lscwp:supported_plugins\">Check our compatibility list<\/a>. If the plugin appears there, then we&#8217;ve already tested it and we know it works.<\/li>\n<li>Check with the plugin author. They may already have tested for LSCWP compatibility.<\/li>\n<\/ol>\n<p>If you didn&#8217;t find any answers with the previous two ideas, not to worry.<strong> The vast majority of plugins is compatible with LiteSpeed Cache for WordPress<\/strong>.Here are a few rules-of-thumb. The plugin you want to test is probably compatible if:<\/p>\n<ol>\n<li>it doesn&#8217;t generate site content<\/li>\n<li>it doesn&#8217;t manipulate existing front-end content<\/li>\n<\/ol>\n<p>If the plugin generates or manipulates site content, it <em>still<\/em> may be compatible if:<\/p>\n<ol>\n<li>it generates or manipulates content that triggers <a href=\"https:\/\/www.litespeedtech.com\/support\/wiki\/doku.php\/litespeed_wiki:cache:lscwp:api#customized_smart_purging\">the same purge events that are monitored by LSCWP<\/a><\/li>\n<li>it generates or manipulates content that follows <a href=\"https:\/\/www.litespeedtech.com\/support\/wiki\/doku.php\/litespeed_wiki:cache:lscwp:api#customized_do-not-cache_rules\">the same caching rules that are followed by LSCWP<\/a><\/li>\n<\/ol>\n<p>If you&#8217;re still not sure, you&#8217;ll need to test for compatibility.<\/p>\n<h2>Testing for Compatibility<\/h2>\n<p>Since it&#8217;s cumbersome to keep saying \u201cthe plugin you want to test,\u201d let&#8217;s call it \u201cMyPlugin\u201d for this example.<\/p>\n<p>&nbsp;<\/p>\n<p><a href=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/wpwyya.jpg\"><img decoding=\"async\" class=\"aligncenter size-full wp-image-9466\" src=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/wpwyya.jpg\" alt=\"Is My Plugin Compatible With LiteSpeed Cache for WordPress?\" width=\"1000\" height=\"667\" srcset=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/wpwyya.jpg 1000w, https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/wpwyya-300x200.jpg 300w, https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/wpwyya-768x512.jpg 768w, https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/wpwyya-600x400.jpg 600w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><\/a><\/p>\n<p>In order to test for compatibility, we\u2019ll first deactivate all plugins with the exception of LiteSpeed Cache. Then we\u2019ll verify the LiteSpeed Cache is working. Once we\u2019ve determined that it is, we\u2019ll activate MyPlugin, and run through some basic scenarios, checking that the site looks and works as expected all along the way.<\/p>\n<p><strong>NOTE<\/strong>: If you suspect that your theme may be conflicting with LiteSpeed Cache, it\u2019s best to temporarily switch to a different theme for testing purposes. Try the WordPress Twenty Seventeen theme, which we know to be 100% compatible: Navigate to <strong>Appearance &gt; Themes<\/strong>, hover over the Twenty Seventeen card, and press the <strong>Activate<\/strong> button.<\/p>\n<h3>Deactivate<\/h3>\n<p>Deactivate all plugins except for LSCache. Here&#8217;s how:<\/p>\n<p><img decoding=\"async\" class=\"alignnone\" src=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null-1.png\" alt=\"Is My Plugin Compatible With LiteSpeed Cache for WordPress? Deactivate all plugins except LSCache\" width=\"672\" height=\"224\" \/><\/p>\n<p>From the WordPress Dashboard, navigate to <strong>Plugins<\/strong>, and click the checkbox next to the <strong>Plugins<\/strong> column as shown. All of the plugins will be checked. Un-check the box next to LiteSpeed Cache. Select <code>Deactivate<\/code> from the dropdown <strong>Bulk Actions<\/strong> box, and click the <strong>Apply<\/strong> button. All plugins, aside from LSCache will be disabled.<\/p>\n<h3>Verify<\/h3>\n<p>In whichever environment you are using (test or production), before activating MyPlugin, you should verify that LSCache for WordPress is working as desired. Here\u2019s how:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone\" src=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null-2.png\" alt=\"Is My Plugin Compatible With LiteSpeed Cache for WordPress? Verify LSCache is working\" width=\"672\" height=\"296\" \/><\/p>\n<ol>\n<li>Open an incognito window in your browser, and press <strong>F12<\/strong> to bring up the developer tools.<\/li>\n<li>Navigate to your site.<\/li>\n<li>Refresh the page.<\/li>\n<li>Click the first resource under the <strong>Name<\/strong> column in the developer tool window. This should be an HTML file and the resource&#8217;s headers should appear alongside it, as in the image above. For example, if your page is <code>http:\/\/example.com\/wordpress\/<\/code>, your first resource should either be something like <code>example.com\/wordpress\/<\/code> or <code>wordpress\/<\/code>.<\/li>\n<li>In a different, logged-in browser, visit your WordPress Dashboard, navigate to<strong> LiteSpeed Cache &gt; Manage<\/strong> and click the <strong>Purge All<\/strong> button.<\/li>\n<li>Reload the page in the first (incognito) browser and select the same resource again. You should see headings similar to:\n<pre>X-LiteSpeed-Cache: miss\nX-LiteSpeed-Cache-Control:public,max-age=1800\nX-LiteSpeed-Tag:B1_F,B1_\n<\/pre>\n<p>These headings mean that the page has not yet been cached, but that LiteSpeed has now stored it for future use.<\/li>\n<li>Reload the page a second time in the incognito window, and you should see <code>X-LiteSpeed-Cache: hit<\/code> in the response header. This means the page is being served by the cache and LSCWP is configured correctly.<\/li>\n<\/ol>\n<p>Now that you know that LSCWP works for you on its own, it\u2019s time to try it with MyPlugin.<\/p>\n<h3>Activate<\/h3>\n<p>Activate MyPlugin: Navigate to <strong>Plugins<\/strong>, locate MyPlugin in the list, and click the <code>Activate<\/code> link below the plugin name.<\/p>\n<h3>Purge<\/h3>\n<p>Purge the cache: Navigate to <strong>LiteSpeed Cache &gt; Manage &gt; Purge<\/strong> and press the <strong>Purge All<\/strong> button.<\/p>\n<h3>TEST!<\/h3>\n<p>This step varies, depending on how you use MyPlugin, and what it needs to be able to do. Run through your most common scenarios, and after each step, verify that MyPlugin is working as expected.<\/p>\n<p>If MyPlugin deals with any private information, run the through the steps twice: once logged-in, and once in incognito mode. When you visit the site incognito, be sure that you are not seeing any private information from your previous logged-in session.<\/p>\n<h4>Questions to Ask Yourself:<\/h4>\n<ul>\n<li>Do the pages look like they should look?<\/li>\n<li>Are cacheable pages being cached?<\/li>\n<li>Are non-cacheable pages <em>not<\/em> being cached?<\/li>\n<li>If there\u2019s supposed to be private data on the page, are you seeing the correct private data?<\/li>\n<\/ul>\n<h4>Some Examples<\/h4>\n<ul>\n<li>If MyPlugin is a forum plugin, run through the steps of creating an account, updating your profile, publishing a post, and submitting a comment. Check the cache and the display of private information at every step.<\/li>\n<li>If MyPlugin is a social sharing plugin that counts shares, use it to share a post or a page to social media and then verify that the share count has increased.<\/li>\n<li>If MyPlugin is a contact form plugin, use it to send yourself some feedback. Visit the form page again in an incognito window, and verify that you are <em>not<\/em> seeing any of your previous logged-in information.<\/li>\n<\/ul>\n<h3>Document + Report<\/h3>\n<p>If you encounter an issue that indicates the plugins are not working well together, document it. Take a screenshot, or copy the text of any error messages you may get. Visit the <a href=\"https:\/\/wordpress.org\/support\/plugin\/litespeed-cache\">LiteSpeed Cache for WordPress support forum<\/a> and share as many details as possible, including the above screenshots.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone\" src=\"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null-3.png\" alt=\"Is My Plugin Compatible With LiteSpeed Cache for WordPress? Submit an environment report\" width=\"672\" height=\"196\" \/><\/p>\n<p>It\u2019s always helpful to include a copy of your Environment Report so that the support team can see your system settings. To do so, navigate to <strong>LiteSpeed Cache &gt; Report <\/strong>and click the <strong>Send to LiteSpeed<\/strong> button. Then make note of the <strong>Report Numbe<\/strong>r and include it with your forum post.<\/p>\n<h3>Reactivate<\/h3>\n<p>Once you are satisfied that everything works well, or you have documented and reported anything that doesn&#8217;t, you may re-activate all of the plugins, and restore your preferred theme.<\/p>\n<h2>Testing Themes<\/h2>\n<p>Sometimes the plugins all get along well, but there is something unexpected happening in the theme.<\/p>\n<p>To test theme compatibility, follow the same steps as above, with the following differences:<\/p>\n<ul>\n<li>LiteSpeed Cache should be the only active plugin<\/li>\n<li>The theme you want to test should be activated<\/li>\n<\/ul>\n<p>&#8212;<\/p>\n<p>Have some of your own ideas for future <a href=\"http:\/\/blog.litespeedtech.com\/tag\/wordpress-wednesday\">WordPress Wednesday<\/a> topics? Leave us a comment!<\/p>\n<p>Don\u2019t forget to meet us back here next week for the next installment. In the meantime, here are a few other things you can do:<\/p>\n<ul>\n<li>Subscribe to the <a href=\"http:\/\/blog.litespeedtech.com\/tag\/wordpress-wednesday\/feed\/\">WordPress Wednesday RSS feed<\/a><\/li>\n<li>Download <a href=\"https:\/\/wordpress.org\/plugins\/litespeed-cache\/\">LiteSpeed Cache for WordPress plugin<\/a><\/li>\n<li>Learn more about the plugin <a href=\"https:\/\/www.litespeedtech.com\/products\/cache-plugins\/wordpress-acceleration\">on our website<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>If you are wondering if a particular plugin is compatible with LiteSpeed Cache for WordPress, this guide can help you figure it out.<\/p>\n","protected":false},"author":1,"featured_media":9454,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[28],"tags":[316,317],"class_list":["post-9452","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cache","tag-wordpress","tag-wordpress-wednesday"],"jetpack_featured_media_url":"https:\/\/lswp.store\/wp-content\/uploads\/2018\/04\/null.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/posts\/9452","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/comments?post=9452"}],"version-history":[{"count":0,"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/posts\/9452\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/media\/9454"}],"wp:attachment":[{"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/media?parent=9452"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/categories?post=9452"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lswp.store\/index.php\/wp-json\/wp\/v2\/tags?post=9452"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}