Title: Portfolio Loop Filter
Author: blumeblau
Published: <strong>2026 年 7 月 12 日</strong>
Last modified: 2026 年 7 月 12 日

---

搜索插件

![](https://ps.w.org/portfolio-loop-filter/assets/banner-772x250.png?rev=3605138)

![](https://ps.w.org/portfolio-loop-filter/assets/icon-256x256.png?rev=3605138)

# Portfolio Loop Filter

 作者：[blumeblau](https://profiles.wordpress.org/blumeblau/)

[下载](https://downloads.wordpress.org/plugin/portfolio-loop-filter.0.9.zip)

 * [详情](https://cn.wordpress.org/plugins/portfolio-loop-filter/#description)
 * [评价](https://cn.wordpress.org/plugins/portfolio-loop-filter/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/portfolio-loop-filter/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/portfolio-loop-filter/#developers)

 [支持](https://wordpress.org/support/plugin/portfolio-loop-filter/)

## 描述

Portfolio Loop Filter adds a dynamic block for the WordPress block editor. The block
creates filter buttons from the used terms of a selected taxonomy and filters the
next Query Loop block below it.

The plugin is designed for block themes and portfolio grids that already use the
native WordPress Query Loop block. It does not replace the Query Loop, does not 
register custom post types, and does not use AJAX on the frontend. The frontend 
script only toggles the visibility of existing Query Loop items.

Typical use cases:

 * Filter a portfolio Query Loop by project categories.
 * Filter posts by categories or tags.
 * Place multiple independent filter and Query Loop pairs on the same page.
 * Keep content management inside WordPress core blocks while adding lightweight
   frontend filtering.

Features:

 * Dynamic Gutenberg block.
 * Post type dropdown in the block settings.
 * Taxonomy dropdown based on the selected post type.
 * Automatic filter buttons from used taxonomy terms.
 * Filters only the next Query Loop below the filter block.
 * Optional “All” button.
 * Button alignment: left, center or right.
 * Color controls for text, active text, border, background, active background and
   hover/focus border.
 * Fallback styles when no custom colors are selected.

## 区块

该插件提供了 1 个区块.

 *   Portfolio Loop Filter Creates filter buttons from used taxonomy terms and filters
   only the next Query Loop below the block.

## 安装

 1. Upload the plugin files to the `/wp-content/plugins/portfolio-loop-filter/` directory
    or install the plugin ZIP through the WordPress plugins screen.
 2. Activate the plugin through the “Plugins” screen in WordPress.
 3. Edit a page or template that contains a Query Loop block.
 4. Insert the “Portfolio Loop Filter” block directly above the Query Loop that should
    be filtered.
 5. Select the post type and taxonomy in the block sidebar.
 6. Save the page or template.

## 常见问题

### Does this plugin create a portfolio post type?

No. It intentionally does not register custom post types or taxonomies. You can 
use WordPress posts, ACF-generated post types, or any other public post type that
appears in the block settings.

### Does the plugin replace the Query Loop block?

No. The native WordPress Query Loop block remains responsible for rendering the 
grid. This plugin only adds filter buttons and a small frontend script.

### Can I use multiple filters on one page?

Yes. Each filter block controls the next Query Loop block below it. Use the structure“
Filter, Query Loop, Filter, Query Loop” when placing multiple filterable grids on
the same page.

### Why do some terms not appear as buttons?

The block only renders terms that are used by published posts of the selected post
type. On the frontend, buttons without a matching item in the next Query Loop are
hidden automatically.

### Does the frontend filtering reload the page?

No. The plugin filters existing items in the browser. It does not perform frontend
AJAX requests.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Portfolio Loop Filter」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ blumeblau ](https://profiles.wordpress.org/blumeblau/)

[帮助将「Portfolio Loop Filter」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/portfolio-loop-filter)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/portfolio-loop-filter/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/portfolio-loop-filter/)，或通过[RSS](https://plugins.trac.wordpress.org/log/portfolio-loop-filter/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/portfolio-loop-filter/)。

## 更新日志

#### 0.9

 * Added the Portfolio Loop Filter block.
 * Added post type and taxonomy dropdowns.
 * Added automatic taxonomy term buttons.
 * Added next Query Loop targeting for multiple independent filter and loop pairs.
 * Added button alignment controls.
 * Added color controls and fallback styles.
 * Added WordPress.org-style plugin headers, readme and GPL license information.

## 额外信息

 *  版本 **0.9**
 *  最后更新：**3 周前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.3 或更高版本 **
 *  已测试的最高版本为 **7.0.2**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/portfolio-loop-filter/)
 * 标签
 * [block](https://cn.wordpress.org/plugins/tags/block/)[gutenberg](https://cn.wordpress.org/plugins/tags/gutenberg/)
   [portfolio](https://cn.wordpress.org/plugins/tags/portfolio/)[query loop](https://cn.wordpress.org/plugins/tags/query-loop/)
   [taxonomy filter](https://cn.wordpress.org/plugins/tags/taxonomy-filter/)
 *  [高级视图](https://cn.wordpress.org/plugins/portfolio-loop-filter/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/portfolio-loop-filter/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/portfolio-loop-filter/reviews/)

## 贡献者

 *   [ blumeblau ](https://profiles.wordpress.org/blumeblau/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/portfolio-loop-filter/)