Portfolio Loop Filter
| 开发者 | blumeblau |
|---|---|
| 更新时间 | 2026年9月17日 23:36 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 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.
- 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.
- Filter button ordering: alphabetical A-Z, alphabetical Z-A or manual.
- Manual ordering controls directly in the block sidebar.
- Newly added terms are appended automatically when manual ordering is used.
- Filters only the next Query Loop below the filter block.
- Optional "All" button, which remains first regardless of term ordering.
- 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.
安装:
- Upload the plugin files to the
/wp-content/plugins/portfolio-loop-filter/directory or install the plugin ZIP through the WordPress plugins screen. - Activate the plugin through the "Plugins" screen in WordPress.
- Edit a page or template that contains a Query Loop block.
- Insert the "Portfolio Loop Filter" block directly above the Query Loop that should be filtered.
- Select the post type and taxonomy in the block sidebar.
- Choose the desired filter button order and optional styling settings.
- 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.
How are filter buttons sorted?
You can sort taxonomy filter buttons alphabetically from A-Z, alphabetically from Z-A, or manually. In manual mode, use the arrow controls in the block sidebar to set the order. The optional "All" button always remains first.
What happens when I add a new taxonomy term while using manual ordering?
Newly used terms are appended after the saved manual order, so they remain visible without requiring the block to be recreated. You can then move them to the desired position in the editor.
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.
Does filtering load posts from other Query Loop pagination pages?
No. Filtering applies only to items already rendered in the targeted Query Loop on the current page. The plugin does not change the Query Loop query or fetch additional paginated posts.
更新日志:
- Added filter button ordering by alphabetical A-Z, alphabetical Z-A or manual order.
- Added accessible manual ordering controls in the block sidebar.
- Added a live editor preview using the actual used taxonomy terms and selected order.
- Added automatic handling for newly used taxonomy terms in manual order mode.
- Updated compatibility metadata and reviewed the block for WordPress 7.1, including the iframe-based editor.
- Updated plugin documentation and FAQ.
- 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.