Version 2.1 introduces the display-based architecture, the weighted relation engine, WooCommerce placements and CTR analytics. Template overrides now live in your-theme\/advanced-css3-related-posts-widget\/ \u2014 the previous folder still works.<\/p>"},"ratings":{"1":"2","2":0,"3":0,"4":0,"5":"4"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3676863,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3676863,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon-512-512.png":{"filename":"icon-512-512.png","revision":3676863,"resolution":"512x512","location":"assets","locale":"","width":512,"height":512}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3676863,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3676863,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3676863,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"landingPage\":\"\\\/wp-admin\\\/admin.php?page=srpp-displays\",\"preferredVersions\":{\"php\":\"8.0\",\"wp\":\"latest\"},\"phpExtensionBundles\":[\"kitchen-sink\"],\"steps\":[{\"step\":\"login\",\"username\":\"admin\",\"password\":\"password\"},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"advanced-css3-related-posts-widget\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":{"stunning-related\/related-content":{"name":"stunning-related\/related-content","title":"Stunning Related Related Content"}},"tagged_versions":["1.0","1.2","2.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3676863,"resolution":"1","location":"assets","locale":"","width":1026,"height":767},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3676863,"resolution":"2","location":"assets","locale":"","width":1026,"height":595},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3676863,"resolution":"3","location":"assets","locale":"","width":1044,"height":564},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3676863,"resolution":"4","location":"assets","locale":"","width":1554,"height":784}},"screenshots":{"1":"The template library.","2":"The editor with live preview and device toggles.","3":"The collabsed tabs contains every control for a display.","4":"The first admin page."}},"plugin_section":[],"plugin_tags":[3669,1089,6903,21280,12268],"plugin_category":[53],"plugin_contributors":[78387],"plugin_business_model":[],"class_list":["post-27892","plugin","type-plugin","status-publish","hentry","plugin_tags-recommendations","plugin_tags-related-posts","plugin_tags-related-products","plugin_tags-relevant","plugin_tags-similar","plugin_category-ratings-and-reviews","plugin_contributors-wp-buy","plugin_committers-wp-buy"],"banners":{"banner":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/banner-772x250.jpg?rev=3676863","banner_2x":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/banner-1544x500.jpg?rev=3676863","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/icon-128x128.png?rev=3676863","icon_2x":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/icon-256x256.png?rev=3676863","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/screenshot-1.png?rev=3676863","caption":"The template library."},{"src":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/screenshot-2.png?rev=3676863","caption":"The editor with live preview and device toggles."},{"src":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/screenshot-3.png?rev=3676863","caption":"The collabsed tabs contains every control for a display."},{"src":"https:\/\/ps.w.org\/advanced-css3-related-posts-widget\/assets\/screenshot-4.png?rev=3676863","caption":"The first admin page."}],"raw_content":"\n
Most related-content plugins give you one global settings page and one block at the bottom of the article. This one is built around a different idea: you create Displays<\/strong>, and every display answers three separate questions.<\/p>\n\n That separation runs all the way through the architecture:<\/p>\n\n One article can run several displays at once, each with its own content rules, position, design and priority \u2014 and the same item is never repeated twice on the page:<\/p>\n\n Displays are ordered by a priority<\/strong> value, can be activated or deactivated individually, duplicated, and exported to JSON for another site.<\/p>\n\n Instead of \"same category\", candidates are scored and ranked:<\/p>\n\n Every weight is adjustable from 0 to 100, so two posts sharing a category and three tags naturally outrank one sharing only a category. The primary category set by Yoast SEO<\/strong> or Rank Math<\/strong> is recognised and weighted separately. A Basic<\/strong> engine mode is included when you want plain term matching where every shared term counts the same.<\/p>\n\n Other content controls:<\/p>\n\n In-content insertion is resolved with a DOM pass. A block is only ever placed between<\/strong> top-level elements, so lists, tables, blockquotes, galleries and shortcodes are never split \u2014 content is never cut on Available positions: before content, after title, after content, after paragraph X, before paragraph X, after X% of the article, middle of the article, before the first heading, after the first heading, before the last heading, before the conclusion, every X paragraphs, and every X words \u2014 the repeating positions with a maximum block count.<\/p>\n\n 24 product, shop, cart, checkout and order hooks:<\/p>\n\n Cart, checkout and order-received recommendations are derived from what is actually in the cart or in the completed order, and never recommend a product the customer already has.<\/p>\n\n The engine is not hard-coded to post \u2192 post. Set a source and a target and a blog article can recommend products, while a product page recommends the guides that explain it. Cross-content matching links the two by matching term slugs across the taxonomies of the target post types.<\/p>\n\n A display runs only where you want it:<\/p>\n\n Inside the post or product editor, a Related Content<\/strong> metabox can override the global behaviour for that item: use global settings, automatic, custom only, custom first then automatic, or disabled entirely \u2014 plus its own always-recommend and never-recommend lists with an AJAX search picker.<\/p>\n\n Layout controls the structure, the template controls the visual DNA, and the two are independent.<\/p>\n\n The editor renders a real preview from real content on your site while you work, with desktop, tablet and mobile device toggles, a full-screen preview overlay and a template navigator for stepping through all 12 templates without leaving the screen.<\/p>\n\n Impressions and clicks are aggregated per day, so you can see click-through rate per template, per placement, per display and per recommended item \u2014 which recommendation strategy actually works, not just which one looks nice. Aggregated counters only: no cookies and no personal data. A retention window (0\u20131825 days) prunes old rows automatically.<\/p>\n\n Clear the recommendation cache, reset statistics, and export or import displays as JSON to move a configuration between staging and production.<\/p>\n\n Never recommend the current item, password-protected content, private content, content marked noindex by Yoast SEO or Rank Math, or out-of-stock products \u2014 plus excluded terms, excluded authors, excluded item IDs, and a guard against showing the same item twice on one page.<\/p>\n\n The plugin sends nothing to any external service. Analytics rows contain a display ID, a source post ID, a target post ID, a template key, a placement key, a date and two counters \u2014 no IP addresses, no cookies, no visitor identifiers.<\/p>\n\n\n Optional: Related Content \u2192 Settings<\/strong> holds the global switches (cache, stylesheet, lazy images, analytics, retention, delete-on-uninstall), and Related Content \u2192 Tools<\/strong> holds cache clearing, statistics reset and JSON export\/import.<\/p>\n\n\n Yes. Every public post type registered on the site is detected automatically \u2014 courses, documentation, portfolio, downloads, jobs, events and so on. The same applies to public taxonomies, which can all be used for relatedness.<\/p><\/dd>\n No. WooCommerce is optional. When it is active, the product placements, the product fields (price, rating, Add to Cart, sale badge), the product templates and the price-range condition appear automatically.<\/p><\/dd>\n No. In-content insertion uses a DOM pass and only places blocks between top-level elements. Lists, tables, blockquotes, galleries and shortcodes are never split.<\/p><\/dd>\n Yes, that is the point. Each one has its own priority, and the duplicate guard stops the same item appearing in two blocks on one page.<\/p><\/dd>\n Yes. Copy any file from id, srpp_related_ids, Relationship resolution is the expensive part of any related-content plugin, so it is done once per post and cached, and scoring runs as a single grouped SQL query. Front-end assets are conditional, so pages without recommendations load nothing at all.<\/p><\/dd>\n Nothing is deleted unless you first enable Delete all plugin data on uninstall<\/strong> in Settings. With that switch on, displays, cached recommendation lists, per-post overrides, the statistics table and the plugin options are removed.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
Content Provider \u2192 Relation Engine \u2192 Filters \/ Exclusions \u2192 Ranking \u2192 Cache \u2192 Placement Engine \u2192 Layout Renderer \u2192 Template\n<\/code><\/pre>\n\nUnlimited independent displays<\/h4>\n\n
\n
Weighted relation engine<\/h4>\n\n
related_score = primary category + categories + tags + custom taxonomies + product attributes + same author + recency\n<\/code><\/pre>\n\n\n
Selection modes<\/h4>\n\n
\n
HTML-aware in-content placement<\/h4>\n\n
<\/p><\/code> with a string function.<\/p>\n\nWooCommerce placements<\/h4>\n\n
\n
Cross-content recommendations<\/h4>\n\n
Display conditions<\/h4>\n\n
\n
Per-post overrides<\/h4>\n\n
Layouts, templates and responsive columns<\/h4>\n\n
\n
Design controls<\/h4>\n\n
\n
Live preview<\/h4>\n\n
Performance<\/h4>\n\n
\n
Analytics<\/h4>\n\n
Manual placement<\/h4>\n\n
\n
[smart_related id=\"5\"]<\/code><\/li>\n<?php srpp_the_related_content( 5 ); ?><\/code> (the older smart_related_content()<\/code> still works)<\/li>\n<\/ul>\n\nTools<\/h4>\n\n
Exclusions<\/h4>\n\n
Privacy<\/h4>\n\n
\n
\/wp-content\/plugins\/<\/code>, or install the ZIP from Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n\n
Does it work with custom post types?<\/h3><\/dt>\n
Does it need WooCommerce?<\/h3><\/dt>\n
Will it break my article markup?<\/h3><\/dt>\n
Can several displays run on the same article?<\/h3><\/dt>\n
Can I change the templates?<\/h3><\/dt>\n
advanced-css3-related-posts-widget\/templates\/<\/code> into your-theme\/advanced-css3-related-posts-widget\/<\/code> and it will be used instead. The template helper functions (srpp_tpl_image()<\/code>, srpp_tpl_title()<\/code>, srpp_tpl_meta()<\/code>, \u2026) are available there, and $context<\/code>, $display<\/code> and $items<\/code> are in scope. Custom templates can also be registered with the srpp_templates<\/code> filter.<\/p><\/dd>\nWhich shortcode attributes are supported?<\/h3><\/dt>\n
post_id<\/code>, items<\/code>, template<\/code>, layout<\/code>, columns<\/code>, tablet<\/code>, mobile<\/code> and heading<\/code>. For example: [smart_related id=\"5\" items=\"4\" columns=\"4\" template=\"tpl-07\"]<\/code>.<\/p><\/dd>\nWhich hooks are available for developers?<\/h3><\/dt>\n
srpp_item_data<\/code>, srpp_render<\/code>, srpp_templates<\/code>, srpp_conditions_pass<\/code>, srpp_post_types<\/code>, srpp_taxonomies<\/code>, srpp_fields<\/code>, srpp_image_size<\/code>, srpp_placeholder_image<\/code> and srpp_words_per_minute<\/code>.<\/p><\/dd>\nIs it slow on large sites?<\/h3><\/dt>\n
What happens when I uninstall it?<\/h3><\/dt>\n
2.1<\/h4>\n\n
\n
[smart_related]<\/code> shortcode, Related Content block, widget and srpp_the_related_content()<\/code>.<\/li>\nadvanced-css3-related-posts-widget<\/code>. Theme template overrides load from your-theme\/advanced-css3-related-posts-widget\/<\/code>; the previous folder keeps working.<\/li>\n<\/ul>\n\n1.2<\/h4>\n\n
\n
1.0<\/h4>\n\n
\n
0.8<\/h4>\n\n
\n
0.7<\/h4>\n\n
\n
0.5<\/h4>\n\n
\n