AC Custom Loop Shortcode
by Richie Arnold on WordPress.org
A simple WordPress plugin that creates a shortcode to loop through posts, pages, or custom post types and display them anywhere on your site.
Easily display posts, pages, custom post types or taxonomy terms in content areas using a customizable shortcode. Display your latest posts, group by taxonomies, display your post tags or categories, use custom templates with Timber for Twig support.
Shortcode Options and Examples
Display a specific post type:
[ac_custom_loop type=”foo”]
This displays posts from the foo custom post type.
Display a specific post type and use a timber template:
[ac_custom_loop timber=’true’ type=”foo”]
This displays the same as the previous example but uses a nice timber template.
Display posts with specific tags:
[ac_custom_loop type=”post” tax=”tag” term=”foo”]
This displays posts tagged with foo.
Group posts by taxonomy (e.g., categories and tags):
[ac_custom_loop type=”post” subtax=”category,tag”]
Groups posts by categories, then by tags within each category.
Exclude posts by specific tags:
[ac_custom_loop type=”post” tax=”post_tag” term=”foo,bar” exclude=”baz”]
This displays posts tagged with foo and bar, but excludes those tagged with baz.
Display post tag terms:
[ac_custom_loop type=”category” tax=”post_tag” ]
This displays all your category terms and link to those post.
Use a custom template for loop display:
To use a custom template, copy loop-template.php from the plugin folder to the root of your theme folder and modify as desired. You can also create templates for specific post types (e.g., loop-template-post.php).
