{"id":150483,"date":"2021-11-30T08:13:22","date_gmt":"2021-11-30T08:13:22","guid":{"rendered":"https:\/\/de.wordpress.org\/plugins\/yarpp-block\/"},"modified":"2026-09-24T14:27:05","modified_gmt":"2026-09-24T14:27:05","slug":"list-yarpp-block","status":"publish","type":"plugin","link":"https:\/\/en-za.wordpress.org\/plugins\/list-yarpp-block\/","author":756138,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"3.1.0","stable_tag":"3.1.0","tested":"7.0.6","requires":"6.5","requires_php":"","requires_plugins":null,"header_name":"List YARPP Block","header_author":"Marc T\u00f6nsing","header_description":"YARPP Block","assets_banners_color":"","last_updated":"2026-09-24 14:27:05","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/marc.tv\/out\/donate","header_plugin_uri":"https:\/\/marc.tv\/","header_author_uri":"https:\/\/toensing.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":4504,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.2":{"tag":"1.2","author":"MarcDK","date":"2021-11-30 09:35:45","revision":2637313},"1.3":{"tag":"1.3","author":"MarcDK","date":"2021-11-30 10:18:09","revision":2637352},"1.4":{"tag":"1.4","author":"MarcDK","date":"2021-11-30 10:39:13","revision":2637364},"1.5":{"tag":"1.5","author":"MarcDK","date":"2022-01-09 21:10:42","revision":2654898},"1.8":{"tag":"1.8","author":"MarcDK","date":"2022-08-11 04:46:09","revision":2769173},"1.9":{"tag":"1.9","author":"MarcDK","date":"2022-08-11 06:07:39","revision":2769181},"2.0":{"tag":"2.0","author":"MarcDK","date":"2022-09-29 15:09:37","revision":2791971},"2.1":{"tag":"2.1","author":"MarcDK","date":"2022-09-30 18:33:17","revision":2792640},"2.2":{"tag":"2.2","author":"MarcDK","date":"2022-10-01 14:47:03","revision":2792865},"2.4":{"tag":"2.4","author":"MarcDK","date":"2024-11-17 16:26:16","revision":3190703},"2.5":{"tag":"2.5","author":"MarcDK","date":"2025-11-21 18:02:42","revision":3400636},"2.6":{"tag":"2.6","author":"MarcDK","date":"2025-11-28 17:54:24","revision":3405429},"2.7":{"tag":"2.7","author":"MarcDK","date":"2026-03-27 15:02:21","revision":3492748},"2.7.1":{"tag":"2.7.1","author":"MarcDK","date":"2026-03-27 15:10:50","revision":3492752},"2.7.2":{"tag":"2.7.2","author":"MarcDK","date":"2026-05-17 09:26:11","revision":3534408},"3.0.0":{"tag":"3.0.0","author":"MarcDK","date":"2026-09-24 14:17:08","revision":3711473},"3.1.0":{"tag":"3.1.0","author":"MarcDK","date":"2026-09-24 14:27:05","revision":3711498}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2791971,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2791971,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":{"yarpp-block\/list":{"$schema":"https:\/\/json.schemastore.org\/block.json","apiVersion":3,"name":"yarpp-block\/list","version":"3.1.0","title":"List YARPP Block","category":"layout","icon":"ellipsis","description":"Will show 3 related posts or will not appear if no related posts are found.","supports":{"align":["wide","full"]},"attributes":{"use_cache":{"type":"boolean","default":false},"updated":{"type":"number","default":0},"blocktype":{"type":"string","default":"related"},"align":{"type":"string"},"headline":{"type":"string","default":"Related posts"},"level":{"type":"string","default":"h3"},"targetblank":{"type":"boolean","default":false},"imgsize":{"type":"number","default":300}},"textdomain":"list-yarpp-block","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css"}},"tagged_versions":["1.2","1.3","1.4","1.5","1.8","1.9","2.0","2.1","2.2","2.4","2.5","2.6","2.7","2.7.1","2.7.2","3.0.0","3.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2791971,"resolution":"1","location":"assets","locale":"","width":2316,"height":1329},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2791971,"resolution":"2","location":"assets","locale":"","width":2316,"height":1329},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2791971,"resolution":"3","location":"assets","locale":"","width":2316,"height":1329}},"screenshots":{"1":"List YARPP block in Gutenberg editor.","2":"List YARPP block in the Theme Twenty-Twenty-Two","3":"List YARPP block supports custom width."}},"plugin_section":[],"plugin_tags":[1220,201618,148076,1089,11164],"plugin_category":[],"plugin_contributors":[84390],"plugin_business_model":[],"class_list":["post-150483","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_tags-full-site-editing","plugin_tags-gutenberg","plugin_tags-related-posts","plugin_tags-yarpp","plugin_contributors-marcdk","plugin_committers-marcdk"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/list-yarpp-block\/assets\/icon-128x128.png?rev=2791971","icon_2x":"https:\/\/ps.w.org\/list-yarpp-block\/assets\/icon-256x256.png?rev=2791971","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/list-yarpp-block\/assets\/screenshot-1.png?rev=2791971","caption":"List YARPP block in Gutenberg editor."},{"src":"https:\/\/ps.w.org\/list-yarpp-block\/assets\/screenshot-2.png?rev=2791971","caption":"List YARPP block in the Theme Twenty-Twenty-Two"},{"src":"https:\/\/ps.w.org\/list-yarpp-block\/assets\/screenshot-3.png?rev=2791971","caption":"List YARPP block supports custom width."}],"raw_content":"<!--section=description-->\n<p>Displays YARPP related posts with the native Query Loop block. YARPP only provides the related post IDs, rendering is done by core blocks like Post Template, Post Featured Image and Post Title, so the layout can be styled in the Site Editor.<\/p>\n\n<p>The legacy List YARPP block is still included for existing sites.<\/p>\n\n<p>This block <strong>requires<\/strong> the <a href=\"https:\/\/wordpress.org\/plugins\/yet-another-related-posts-plugin\/\">YARPP plugin<\/a> and relies on the <em>yarpp_get_related()<\/em> function.<\/p>\n\n<h4>Query Loop integration<\/h4>\n\n<p>Insert the <strong>YARPP Related Posts<\/strong> variation of the Query Loop block, or add these optional keys to the <code>query<\/code> attribute of any Query Loop block:<\/p>\n\n<ul>\n<li><code>\"related\": \"yarpp\"<\/code> \u2013 Shows the YARPP related posts of the current post in YARPP order.<\/li>\n<li><code>\"excludeCurrent\": true<\/code> \u2013 Excludes the currently viewed post.<\/li>\n<li><code>\"excludeDisplayed\": true<\/code> \u2013 Excludes posts already shown by Query Loops rendered earlier on the same page.<\/li>\n<li><code>\"requireThumbnail\": true<\/code> \u2013 Only shows posts with a featured image.<\/li>\n<li><code>\"hideEmpty\": true<\/code> \u2013 Hides the whole Query Loop, including headings inside it, if no posts are found.<\/li>\n<li><code>\"minPosts\": 3<\/code> \u2013 Hides the whole Query Loop if fewer posts are found. Posts of a hidden Query Loop are not excluded by <code>excludeDisplayed<\/code>.<\/li>\n<\/ul>\n\n<p>Example: related posts followed by the latest posts without duplicates.<\/p>\n\n<pre><code>&lt;!-- wp:query {\"queryId\":1,\"query\":{\"perPage\":3,\"postType\":\"post\",\"inherit\":false,\"related\":\"yarpp\",\"excludeCurrent\":true,\"minPosts\":3}} --&gt;\n&lt;!-- wp:query {\"queryId\":2,\"query\":{\"perPage\":3,\"postType\":\"post\",\"inherit\":false,\"excludeCurrent\":true,\"excludeDisplayed\":true}} --&gt;\n<\/code><\/pre>\n\n<p>The editor preview shows regular posts; the related posts are applied on the frontend.<\/p>\n\n<h4>Legacy block features<\/h4>\n\n<ul>\n<li>Gutenberg column width support.<\/li>\n<li>The block is not visible in the frontend if no related posts are found.<\/li>\n<li>Minimum html and css that is based on the standard Gutenberg Latest Posts block.<\/li>\n<li>Valid HTML output.<\/li>\n<li>Inherits the style of your theme for links and headlines.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/list-yarpp-block<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>3.1.0<\/h4>\n\n<ul>\n<li>Added: Query Loop key minPosts hides a Query Loop that finds fewer posts. Posts of a hidden Query Loop don't count as displayed.<\/li>\n<\/ul>\n\n<h4>3.0.0<\/h4>\n\n<ul>\n<li>Added: Query Loop integration. YARPP related posts can be displayed with the native Query Loop block.<\/li>\n<li>Added: \"YARPP Related Posts\" Query Loop block variation.<\/li>\n<li>Added: Optional Query Loop keys related, excludeCurrent, excludeDisplayed, requireThumbnail and hideEmpty.<\/li>\n<li>Changed: Requires WordPress 6.5 or later.<\/li>\n<li>The legacy List YARPP block keeps working.<\/li>\n<\/ul>\n\n<h4>2.7.2<\/h4>\n\n<ul>\n<li>Prepared release for WordPress 7.0 compatibility.<\/li>\n<\/ul>\n\n<h4>2.7.1<\/h4>\n\n<p>Fix: Added missing direct WordPress package dependencies so the JavaScript lint workflow passes.<\/p>\n\n<h4>2.7<\/h4>\n\n<p>Added: Frontend block output caching with automatic invalidation on content changes.\nImproved: Faster latest-post queries through leaner ID-only lookups and cache priming.\nImproved: GitHub Actions now use dependency caching for lint, build and deployment.\nFix: Renderer sanitizes stored block attributes before generating markup.\nFix: Latest mode works independently from missing or insufficient YARPP related posts.<\/p>\n\n<h4>2.6<\/h4>\n\n<p>Added: Tested compatibility with WordPress 6.9\nAdded: Migration to block api V3.\nFix: Links in the block UX are disabled.<\/p>\n\n<h4>2.5<\/h4>\n\n<p>Fix: Width of images is now 100% within the padding limits.<\/p>\n\n<h4>2.3<\/h4>\n\n<p>Fix: Image width set to auto.<\/p>\n\n<h4>2.2<\/h4>\n\n<p>Fix: Target blank broken link\nFix: image width won't be saved.<\/p>\n\n<h4>2.1<\/h4>\n\n<ul>\n<li>Feature: New coding standards<\/li>\n<li>Feature: Automatic WordPress repository deployment with GitHub actions.<\/li>\n<\/ul>\n\n<h4>1.5<\/h4>\n\n<ul>\n<li>Feature: Added option to open links in new tab.<\/li>\n<\/ul>\n\n<h4>1.4<\/h4>\n\n<ul>\n<li>Feature: Added YARPP required notice. <\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Fixed: fatal error if not enough related posts are found.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Inital version.<\/li>\n<\/ul>","raw_excerpt":"Adds a block that lists yarpp related posts.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/150483","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=150483"}],"author":[{"embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/marcdk"}],"wp:attachment":[{"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=150483"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=150483"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=150483"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=150483"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=150483"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/en-za.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=150483"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}