AC Custom Loop Shortcode
A simple WordPress plugin that creates a shortcode to loop through posts, pages, or custom post types and display them anywhere on your site.
Plugin info
Maintenance & Compatibility
Maintenance score
Stale • Last updated 350 days ago
Is AC Custom Loop Shortcode abandoned?
Likely maintained (last update 350 days ago).
Compatibility
Similar & Alternatives
Explore plugins with similar tags, and compare key metrics like downloads, ratings, updates, support, and WP/PHP compatibility.
Description
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).
Installation
- Install via WordPress Add New Plugin feature by searching “AC Custom Loop,” or upload the plugin files to
/wp-content/plugins/ac-wp-custom-loop. - Activate the plugin via the ‘Plugins’ screen in WordPress.
- Use
[ac_custom_loop]shortcode in any page, post, or widget supporting shortcodes. - The default setup displays your latest 4 posts. Customize with attributes like
typeandshow, e.g.,[ac_custom_loop type="page" show="3"]to display the latest three pages.
Frequently Asked Questions
Use [ac_custom_loop type="your_post_type"] to show posts from a specific custom post type.
Yes! Use [ac_custom_loop type="post" tax="tag" term="your_term"] to filter posts by taxonomy term.
Use [ac_custom_loop subtax="category,tag"] to group posts by taxonomies.
Yes, add exclude="term" to exclude posts tagged with that term.
Absolutely! Copy loop-template.php to your theme directory or create post-type-specific templates, such as loop-template-post.php.
Review feed
Screenshots
Changelog
1.7.1
- Fixed better support for custom templates
1.7
- Added better support for custom templates
- Fixed issue with timber template path on some php versions
- Fixed timber use statement
1.6.1
- Fixed issue that required Timber
- Fixed issue with using multiple taxonomy terms
1.6
- Added support for display taxonomy terms.
- Added support for pagination.
1.5.2
- Fix template issue.
1.5.1 (2024-11-01)
- Added support for grouping posts by multiple taxonomies.
- Refactored core code for improved maintainability.
1.5 (2021-04-04)
- Enhanced Timber compatibility.
1.4.3 (2019-12-06)
- Resolved release issues.
1.4.2 (2019-12-24)
- Fixed shortcode argument issues.
1.4.0 (2019-12-05)
- Added support for specific post type templates and custom Timber integration.
1.1.0 (2018-10-16)
- Added default post order and optional excerpt in the default template.
0.1.0 (2018-10-07)
- Initial release.