Filters
Several Wire settings take the same short filter string. It answers two questions at once: which items to show, and in what order.
Where filters are used#
| Setting | Controls | Default |
|---|---|---|
section_tags_filter | The tag carousel under the homepage cover | popular:5 |
section_tag_posts_filter | The tag posts section and its pills | popular:2 |
section_authors_filter | The authors carousel on the homepage | popular:6 |
page_tags_filter | The Tags page | popular |
page_authors_filter | The Authors page | popular |
All of them live in ⛭ Settings → Design → Customize → Theme.
Syntax#
| Value | Result |
|---|---|
popular | Most posts first. For tags and authors this counts published posts, not page views |
a-z | Alphabetical by name |
z-a | Reverse alphabetical |
recent | Newest first, by the date the tag or author was created |
popular:6 | Any of the above with a limit — here, the six with the most posts |
reviews,interviews,gear | Exactly these items, in the order you list their slugs |
| (empty) | Hides the section completely |
The limit accepts up to three digits, so popular:100 is valid.
Examples#
Show the eight busiest tags in the homepage carousel:
popular:8
Pin three sections in a fixed order, ignoring how many posts they have:
reviews,interviews,scenes
List every author alphabetically on the Authors page:
a-z
Hide the homepage authors carousel:
Notes#
- Slugs, not names: use
field-recording, notField Recording. - A tag or author with no published posts is skipped, so a filter can return fewer items than the limit.
- Tag filters always leave out editions — any tag whose slug starts with
issue-. They have their own home on the Issues page. See Issues. - An unknown slug in a comma list is ignored rather than breaking the section.