{"id":4510,"date":"2022-04-01T15:43:28","date_gmt":"2022-04-01T12:43:28","guid":{"rendered":"https:\/\/creativethemes.com\/blocksy\/?post_type=documentation&#038;p=4510"},"modified":"2026-10-13T09:34:30","modified_gmt":"2026-10-13T06:34:30","slug":"offset-blocksy_posts-shortcode","status":"publish","type":"documentation","link":"https:\/\/creativethemes.com\/blocksy\/docs\/code-snippets\/offset-blocksy_posts-shortcode\/","title":{"rendered":"Offset [blocksy_posts] Shortcode"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Many of you have asked for a way to skip some articles from the [ blocksy_posts ] shortcode. Here&#8217;s the snippet for this.<\/p>\n\n\n<div class=\"ct-code-box wp-block-blocksy-landing-child-code-box\" data-type=\"php\">\n\t<div class=\"ct-code-box__header\">\n\t\t<div class=\"ct-code-box__meta\">\n\t\t\t<span class=\"ct-code-box__label\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m9 8-4 4 4 4\"\/><path d=\"m15 8 4 4-4 4\"\/><\/svg>PHP<\/span>\n\t\t\t\t\t<\/div>\n\t\t<button type=\"button\" class=\"ct-code-box__copy\" aria-label=\"Copy code\">\n\t\t\t<svg class=\"ct-code-box__icon-copy\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"9\" y=\"9\" width=\"11\" height=\"11\" rx=\"2\"\/><path d=\"M5 15V6a2 2 0 0 1 2-2h9\"\/><\/svg>\n\t\t\t<svg class=\"ct-code-box__icon-check\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2.2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M5 12.5l4.5 4.5L19 7.5\"\/><\/svg>\n\t\t\t<span class=\"ct-code-box__copy-label\">Copy<\/span>\n\t\t<\/button>\n\t<\/div>\n\t<pre class=\"ct-code-box__code\"><code>add_filter(&#039;blocksy:general:shortcodes:blocksy-posts:args&#039;, function ($args) {\t\n  $args&#91;&#039;offset&#039;] = 5;\n  return $args;\n} );<\/code><\/pre>\n<\/div>\n\n\n\n<h2 id=\"change-instances\" class=\"wp-block-heading\">Bonus! Shortcode instances<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You can also use shortcode instances, and offset them independently.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Simply insert your shortcode like [ blocksy_posts shortcode_instance=&#8221;instance-1&#8243; ], then control it like this.<\/p>\n\n\n<div class=\"ct-code-box wp-block-blocksy-landing-child-code-box\" data-type=\"php\">\n\t<div class=\"ct-code-box__header\">\n\t\t<div class=\"ct-code-box__meta\">\n\t\t\t<span class=\"ct-code-box__label\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m9 8-4 4 4 4\"\/><path d=\"m15 8 4 4-4 4\"\/><\/svg>PHP<\/span>\n\t\t\t\t\t<\/div>\n\t\t<button type=\"button\" class=\"ct-code-box__copy\" aria-label=\"Copy code\">\n\t\t\t<svg class=\"ct-code-box__icon-copy\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"9\" y=\"9\" width=\"11\" height=\"11\" rx=\"2\"\/><path d=\"M5 15V6a2 2 0 0 1 2-2h9\"\/><\/svg>\n\t\t\t<svg class=\"ct-code-box__icon-check\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2.2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M5 12.5l4.5 4.5L19 7.5\"\/><\/svg>\n\t\t\t<span class=\"ct-code-box__copy-label\">Copy<\/span>\n\t\t<\/button>\n\t<\/div>\n\t<pre class=\"ct-code-box__code\"><code>add_filter(\n\t&#039;blocksy:general:shortcodes:blocksy-posts:args&#039;,\n\tfunction ($query_args, $shortcode_args) {\n\t\tif (\n\t\t\t! isset($shortcode_args&#91;&#039;shortcode_instance&#039;])\n\t\t\t||\n\t\t\t$shortcode_args&#91;&#039;shortcode_instance&#039;] !== &#039;instance-1&#039;\n\t\t) {\n\t\t\treturn $query_args;\n\t\t}\n\n\t\t\/\/ Update $query_args as you wish\n\n\t\treturn $query_args;\n\t},\n\t10, 2\n);<\/code><\/pre>\n<\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Controlling Multiple Instances<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You can also control multiple instances with a minimal amount of code. Just like this!<\/p>\n\n\n<div class=\"ct-code-box wp-block-blocksy-landing-child-code-box\" data-type=\"php\">\n\t<div class=\"ct-code-box__header\">\n\t\t<div class=\"ct-code-box__meta\">\n\t\t\t<span class=\"ct-code-box__label\"><svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m9 8-4 4 4 4\"\/><path d=\"m15 8 4 4-4 4\"\/><\/svg>PHP<\/span>\n\t\t\t\t\t<\/div>\n\t\t<button type=\"button\" class=\"ct-code-box__copy\" aria-label=\"Copy code\">\n\t\t\t<svg class=\"ct-code-box__icon-copy\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"9\" y=\"9\" width=\"11\" height=\"11\" rx=\"2\"\/><path d=\"M5 15V6a2 2 0 0 1 2-2h9\"\/><\/svg>\n\t\t\t<svg class=\"ct-code-box__icon-check\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2.2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"M5 12.5l4.5 4.5L19 7.5\"\/><\/svg>\n\t\t\t<span class=\"ct-code-box__copy-label\">Copy<\/span>\n\t\t<\/button>\n\t<\/div>\n\t<pre class=\"ct-code-box__code\"><code>add_filter(\n  &#039;blocksy:general:shortcodes:blocksy-posts:args&#039;,\n  function ($query_args, $shortcode_args) {\n    if (! isset($shortcode_args&#91;&#039;shortcode_instance&#039;])) {\n      return $query_args;\n    }\n\n    \/\/ &#91;blocksy_posts shortcode_instance=&quot;instance-1&quot;]\n    if ($shortcode_args&#91;&#039;shortcode_instance&#039;] === &#039;instance-1&#039;) {\n      $query_args&#91;&#039;offset&#039;] = 5;\n    }\n\n    \/\/ &#91;blocksy_posts shortcode_instance=&quot;instance-2&quot;]\n    if ($shortcode_args&#91;&#039;shortcode_instance&#039;] === &#039;instance-2&#039;) {\n      $query_args&#91;&#039;offset&#039;] = 10;\n    }\n    \n    \/\/ &#91;blocksy_posts shortcode_instance=&quot;instance-3&quot;]\n    if ($shortcode_args&#91;&#039;shortcode_instance&#039;] === &#039;instance-3&#039;) {\n      $query_args&#91;&#039;offset&#039;] = 15;\n    }\n\n    return $query_args;\n  },\n  10, 2\n);<\/code><\/pre>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Many of you have asked for a way to skip some articles from the [ blocksy_posts ] shortcode. Here&#8217;s the snippet for this. Bonus! Shortcode instances You can also use shortcode instances, and offset them independently. Simply insert your shortcode like [ blocksy_posts shortcode_instance=&#8221;instance-1&#8243; ], then control it like this. Controlling Multiple Instances You can [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_categories":[125],"class_list":["post-4510","documentation","type-documentation","status-publish","hentry","doc_categories-code-snippets"],"acf":[],"_links":{"self":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/4510","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/types\/documentation"}],"author":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/comments?post=4510"}],"version-history":[{"count":1,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/4510\/revisions"}],"predecessor-version":[{"id":15393,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/4510\/revisions\/15393"}],"wp:attachment":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media?parent=4510"}],"wp:term":[{"taxonomy":"doc_categories","embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/doc_categories?post=4510"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}