AC Custom Loop Shortcode

外掛說明

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).

安裝方式

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

常見問題集

How do I show posts from a specific post type?

Use [ac_custom_loop type="your_post_type"] to show posts from a specific custom post type.

Can I display posts with a specific taxonomy term?

Yes! Use [ac_custom_loop type="post" tax="tag" term="your_term"] to filter posts by taxonomy term.

How can I group posts by taxonomies?

Use [ac_custom_loop subtax="category,tag"] to group posts by taxonomies.

Can I exclude specific terms?

Yes, add exclude="term" to exclude posts tagged with that term.

Can I use custom templates?

Absolutely! Copy loop-template.php to your theme directory or create post-type-specific templates, such as loop-template-post.php.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈AC Custom Loop Shortcode〉的開發相關工作。

參與者

將〈AC Custom Loop Shortcode〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

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.