{"id":92373,"date":"2018-10-10T18:34:22","date_gmt":"2018-10-10T18:34:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ac-custom-loop-shortcode\/"},"modified":"2025-01-15T14:58:46","modified_gmt":"2025-01-15T14:58:46","slug":"ac-custom-loop-shortcode","status":"publish","type":"plugin","link":"https:\/\/scn.wordpress.org\/plugins\/ac-custom-loop-shortcode\/","author":2988644,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.7.1","stable_tag":"1.7.1","tested":"6.7.5","requires":"5.2","requires_php":"5.2.4","requires_plugins":null,"header_name":"AC Custom Loop Shortcode","header_author":"AmberCouch","header_description":"Shortcode ( [ac_custom_loop] ) that allows you to easily list post, pages or custom posts with the WordPress content editor or in any widget that supports short code.","assets_banners_color":"f4f3f3","last_updated":"2025-01-15 14:58:46","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/ambercouch.co.uk\/","header_plugin_uri":"https:\/\/ambercouch.co.uk","header_author_uri":"http:\/\/ambercouch.co.uk","rating":0,"author_block_rating":0,"active_installs":30,"downloads":2743,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1":{"tag":"0.1","author":"ambercouch","date":"2018-10-10 18:38:38"},"0.1.1":{"tag":"0.1.1","author":"ambercouch","date":"2018-10-13 10:08:19"},"1.1.0":{"tag":"1.1.0","author":"ambercouch","date":"2018-10-16 10:58:27"},"1.2.0":{"tag":"1.2.0","author":"ambercouch","date":"2018-10-24 15:42:59"},"1.3.0":{"tag":"1.3.0","author":"ambercouch","date":"2019-05-15 20:52:46"},"1.4.0":{"tag":"1.4.0","author":"ambercouch","date":"2019-12-06 07:06:37"},"1.4.1":{"tag":"1.4.1","author":"ambercouch","date":"2019-12-06 07:41:05"},"1.4.2":{"tag":"1.4.2","author":"ambercouch","date":"2019-12-24 14:25:49"},"1.5":{"tag":"1.5","author":"ambercouch","date":"2021-04-05 09:27:39"},"1.5.1":{"tag":"1.5.1","author":"ambercouch","date":"2024-11-01 16:16:00"},"1.5.2":{"tag":"1.5.2","author":"ambercouch","date":"2024-11-03 05:59:56"},"1.6":{"tag":"1.6","author":"ambercouch","date":"2024-12-12 08:28:43"},"1.6.1":{"tag":"1.6.1","author":"ambercouch","date":"2024-12-19 13:19:33"},"1.7":{"tag":"1.7","author":"ambercouch","date":"2025-01-15 14:36:47"},"1.7.1":{"tag":"1.7.1","author":"ambercouch","date":"2025-01-15 14:58:46"}},"upgrade_notice":{"1.5.2":"

Fix template issue.<\/p>","1.5.1":"

Added support for grouping posts by multiple taxonomies and refactored core code for flexibility and clarity.<\/p>","1.5":"

Improved Timber support.<\/p>","1.4.3":"

Fixed release issues.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":1956262,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":1956262,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1","0.1.1","1.1.0","1.2.0","1.3.0","1.4.0","1.4.1","1.4.2","1.5","1.5.1","1.5.2","1.6","1.6.1","1.7","1.7.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Adding the shortcode to any content area that supports shortcodes.","2":"Posts, pages, or custom post types appear styled in your chosen layout on the front end."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[162850,32204,80,17809,17808],"plugin_category":[43],"plugin_contributors":[162851],"plugin_business_model":[],"class_list":["post-92373","plugin","type-plugin","status-publish","hentry","plugin_tags-list-custom-posts","plugin_tags-list-post","plugin_tags-shortcode","plugin_tags-timber","plugin_tags-twig","plugin_category-customization","plugin_contributors-ambercouch","plugin_committers-ambercouch"],"banners":{"banner":"https:\/\/ps.w.org\/ac-custom-loop-shortcode\/assets\/banner-772x250.png?rev=1956262","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ac-custom-loop-shortcode\/assets\/icon-256x256.png?rev=1956262","icon_2x":"https:\/\/ps.w.org\/ac-custom-loop-shortcode\/assets\/icon-256x256.png?rev=1956262","generated":false},"screenshots":[],"raw_content":"\n

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.<\/p>\n\n

Shortcode Options and Examples<\/h3>\n\n

Display a specific post type:<\/strong>\n [ac_custom_loop type=\"foo\"]\nThis displays posts from the foo<\/code> custom post type.<\/p>\n\n

Display a specific post type and use a timber template:<\/strong>\n [ac_custom_loop timber='true' type=\"foo\"]\nThis displays the same as the previous example but uses a nice timber template.<\/p>\n\n

Display posts with specific tags:<\/strong>\n [ac_custom_loop type=\"post\" tax=\"tag\" term=\"foo\"]\nThis displays posts tagged with foo<\/code>.<\/p>\n\n

Group posts by taxonomy (e.g., categories and tags):<\/strong>\n [ac_custom_loop type=\"post\" subtax=\"category,tag\"]\nGroups posts by categories, then by tags within each category.<\/p>\n\n

Exclude posts by specific tags:<\/strong>\n [ac_custom_loop type=\"post\" tax=\"post_tag\" term=\"foo,bar\" exclude=\"baz\"]\nThis displays posts tagged with foo<\/code> and bar<\/code>, but excludes those tagged with baz<\/code>.<\/p>\n\n

Display post tag terms:<\/strong>\n [ac_custom_loop type=\"category\" tax=\"post_tag\" ]\nThis displays all your category terms and link to those post.<\/p>\n\n

Use a custom template for loop display:<\/strong>\nTo use a custom template, copy loop-template.php<\/code> 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<\/code>).<\/p>\n\n\n

    \n
  1. 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<\/code>.<\/li>\n
  2. Activate the plugin via the \u2018Plugins\u2019 screen in WordPress.<\/li>\n
  3. Use [ac_custom_loop]<\/code> shortcode in any page, post, or widget supporting shortcodes.<\/li>\n
  4. The default setup displays your latest 4 posts. Customize with attributes like type<\/code> and show<\/code>, e.g., [ac_custom_loop type=\"page\" show=\"3\"]<\/code> to display the latest three pages.<\/li>\n<\/ol>\n\n\n
    \n

    How do I show posts from a specific post type?<\/h3><\/dt>\n

    Use [ac_custom_loop type=\"your_post_type\"]<\/code> to show posts from a specific custom post type.<\/p><\/dd>\n

    Can I display posts with a specific taxonomy term?<\/h3><\/dt>\n

    Yes! Use [ac_custom_loop type=\"post\" tax=\"tag\" term=\"your_term\"]<\/code> to filter posts by taxonomy term.<\/p><\/dd>\n

    How can I group posts by taxonomies?<\/h3><\/dt>\n

    Use [ac_custom_loop subtax=\"category,tag\"]<\/code> to group posts by taxonomies.<\/p><\/dd>\n

    Can I exclude specific terms?<\/h3><\/dt>\n

    Yes, add exclude=\"term\"<\/code> to exclude posts tagged with that term.<\/p><\/dd>\n

    Can I use custom templates?<\/h3><\/dt>\n

    Absolutely! Copy loop-template.php<\/code> to your theme directory or create post-type-specific templates, such as loop-template-post.php<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n\n

    1.7.1<\/h4>\n\n
      \n
    • Fixed better support for custom templates<\/li>\n<\/ul>\n\n

      1.7<\/h4>\n\n
        \n
      • Added better support for custom templates<\/li>\n
      • Fixed issue with timber template path on some php versions<\/li>\n
      • Fixed timber use statement<\/li>\n<\/ul>\n\n

        1.6.1<\/h4>\n\n
          \n
        • Fixed issue that required Timber<\/li>\n
        • Fixed issue with using multiple taxonomy terms<\/li>\n<\/ul>\n\n

          1.6<\/h4>\n\n
            \n
          • Added support for display taxonomy terms.<\/li>\n
          • Added support for pagination.<\/li>\n<\/ul>\n\n

            1.5.2<\/h4>\n\n
              \n
            • Fix template issue.<\/li>\n<\/ul>\n\n

              1.5.1 (2024-11-01)<\/h4>\n\n
                \n
              • Added support for grouping posts by multiple taxonomies.<\/li>\n
              • Refactored core code for improved maintainability.<\/li>\n<\/ul>\n\n

                1.5 (2021-04-04)<\/h4>\n\n
                  \n
                • Enhanced Timber compatibility.<\/li>\n<\/ul>\n\n

                  1.4.3 (2019-12-06)<\/h4>\n\n
                    \n
                  • Resolved release issues.<\/li>\n<\/ul>\n\n

                    1.4.2 (2019-12-24)<\/h4>\n\n
                      \n
                    • Fixed shortcode argument issues.<\/li>\n<\/ul>\n\n

                      1.4.0 (2019-12-05)<\/h4>\n\n
                        \n
                      • Added support for specific post type templates and custom Timber integration.<\/li>\n<\/ul>\n\n

                        1.1.0 (2018-10-16)<\/h4>\n\n
                          \n
                        • Added default post order and optional excerpt in the default template.<\/li>\n<\/ul>\n\n

                          0.1.0 (2018-10-07)<\/h4>\n\n
                            \n
                          • Initial release.<\/li>\n<\/ul>","raw_excerpt":"A simple WordPress plugin that creates a shortcode to loop through posts, pages, or custom post types and display them anywhere on your site.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/92373","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=92373"}],"author":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ambercouch"}],"wp:attachment":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=92373"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=92373"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=92373"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=92373"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=92373"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=92373"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}