When implementing a Page Fragment Caching Exception, you are telling W3 Total Cache to bypass cache for a particular section of content. A great use case for this is dynamic content that you wish to update in real time, separate from the page caching itself. The following article will walk you through the process.<\/p>\n

As of W3 Total Cache 2.10.0<\/strong>, Page Fragment Cache tags work differently. Instead of placing PHP or a file path inside<\/em> the tag, you register a callback once and reference it from the tag by name. W3 Total Cache runs only your registered callback when it serves the cached page. Tags from older versions that still contain raw PHP or a file path are no longer run, so they must be migrated using the steps below. (Using a version before 2.10.0? See How to Implement a Page Fragment Caching Exception (versions before 2.10.0)<\/a>.)<\/em><\/p>\n

\n
\n
\n
<\/div>\n
\n
Speed Up Your WordPress Website.<\/strong><\/p>\n
A Difference of Just 100ms in Page Load Speeds Can Cause a Visitor to Prefer Your Competitor’s Website.<\/p>\n<\/div>\n
\n
View Plans<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
Select your page cache method in Performance → General Settings\n
\n
We recommend a memory-based caching backend such as Redis or memcached<\/a>. Disk: Basic<\/strong> also works. Disk: Enhanced is not supported<\/strong> for fragment exceptions, because it serves cached pages without running PHP.<\/li>\n<\/ul>\n<\/li>\n
Enable “late initialization” on the Page Cache settings page<\/li>\n
Add define('W3TC_DYNAMIC_SECURITY', 'mycode');<\/code> to your wp-config.php file (change mycode<\/code> to your own unique value)<\/li>\n
Register a callback for each fragment using the w3tc_dynamic_callbacks<\/code> filter<\/li>\n<\/ul>\nAnd finally, use this format to implement the caching exception. First, register the callback in your theme’s functions.php (or a small site plugin):<\/p>\n \/\/ functions.php\r\nadd_filter(\r\n 'w3tc_dynamic_callbacks',\r\n function ( $callbacks ) {\r\n $callbacks['my_fragment'] = function ( $args, $kind ) {\r\n \/\/ Return the dynamic HTML for this fragment.\r\n \/\/ $args = JSON from the tag (decoded to an array); $kind = 'mfunc' or 'mclude'.\r\n return somefunction();\r\n };\r\n return $callbacks;\r\n }\r\n);<\/pre>\nThen emit the tag in your template where the dynamic content should appear, referencing the callback by name with call:<slug><\/code>. W3 Total Cache adds the integrity signature automatically, so you never write it yourself:<\/p>\n <\/pre>\nYour callback must return<\/strong> a string of HTML (don’t echo<\/code>). To pass data into a fragment, include JSON in the tag — for example call:my_fragment {\"id\":42}<\/code> — and read $args['id']<\/code> in the callback. mclude<\/code> works the same way: register a slug that returns the included output (for example with ob_start()<\/code> \/ ob_get_clean()<\/code>) and reference it with call:<slug><\/code>; raw file paths are no longer included directly. If you use Minify, add mfunc<\/code> and mclude<\/code> to the Ignored comment stems<\/em> setting. Third-party plugins or themes that shipped their own legacy tags must adopt this same filter — a site owner cannot re-enable the old in-tag-code behavior.<\/p>\n \nImplementing a Page Fragment Caching Exception for Comments in Twenty Twenty<\/h2>\nThe following example demonstrates how to render blog post comments dynamically on an otherwise cached page using the default WordPress theme, Twenty Twenty, and W3 Total Cache 2.10.0 or later.<\/p>\n Resources:<\/p>\n \nTwenty Twenty theme<\/li>\n Twenty Twenty child theme<\/li>\n<\/ul>\nInstall both themes in your WordPress installation and activate the Twenty Twenty child theme.<\/p>\n Copy the comments.php file from the Twenty Twenty theme over to the child theme root directory.<\/p>\n Install and activate W3 Total Cache and set your Pro license.<\/p>\n Navigate to Performance<\/b> > General Settings<\/b> and enable Page Cache<\/b>. If you do not have memory based caching available on your server (Redis or Memcached) then select Disk: Basic<\/b> for the Page Cache Method<\/b>. (Disk: Enhanced is not supported for fragment exceptions.)<\/p>\n Access your Page Cache settings by navigating to Performance<\/b> > Page Cache<\/b> in your WordPress dashboard and enable Late initialization<\/b> under the Advanced<\/b> section.<\/p>\n Add the code define(‘W3TC_DYNAMIC_SECURITY’, ‘comments’);<\/b> to the wp-config.php file associated with your website just before the line \/* That’s all, stop editing! Happy publishing. *\/<\/b><\/p>\n Register the comments callback by adding the following to your child theme’s functions.php file:<\/p>\n \/\/ Twenty Twenty child theme — functions.php\r\nadd_filter(\r\n 'w3tc_dynamic_callbacks',\r\n function ( $callbacks ) {\r\n $callbacks['comments_list'] = function ( $args, $kind ) {\r\n ob_start();\r\n wp_list_comments(\r\n array(\r\n 'walker' => new TwentyTwenty_Walker_Comment(),\r\n 'avatar_size' => 120,\r\n 'style' => 'div',\r\n )\r\n );\r\n return ob_get_clean();\r\n };\r\n return $callbacks;\r\n }\r\n);<\/pre>\nOpen comments.php located in your child theme directory using your preferred text editor. Locate the wp_list_comments<\/code> call and replace it with the matching tag, which references the callback you just registered. Your code should look like this:<\/p>\n <\/pre>\n <\/p>\n<\/body><\/html>\n","protected":false},"excerpt":{"rendered":" When implementing a Page Fragment Caching Exception, you are telling W3 Total Cache to bypass cache for a particular section of content. A great use case for this is dynamic content that you wish to update in real time, separate from the page caching itself. The following article will walk you through the process. As […]<\/p>\n","protected":false},"author":1307,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"bgseo_title":"","bgseo_description":"","bgseo_robots_index":"index","bgseo_robots_follow":"follow","footnotes":""},"categories":[749,740,692],"tags":[],"class_list":["post-173355","post","type-post","status-publish","format-standard","hentry","category-fragment-cache","category-page-cache","category-w3-total-cache"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/posts\/173355","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/users\/1307"}],"replies":[{"embeddable":true,"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/comments?post=173355"}],"version-history":[{"count":5,"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/posts\/173355\/revisions"}],"predecessor-version":[{"id":173360,"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/posts\/173355\/revisions\/173360"}],"wp:attachment":[{"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/media?parent=173355"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/categories?post=173355"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.boldgrid.com\/support\/wp-json\/wp\/v2\/tags?post=173355"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}