Issues and Editions
Wire can group posts into editions, the way a magazine groups articles into issues. An edition is an ordinary public tag whose slug starts with issue-. As soon as a tag is named that way, Wire treats every post carrying it as part of that edition.
Setup Instructions#
- Navigate to ⛭ Settings → Tags
- Click New tag
- Enter a name, for example
Issue 01 - Open the tag's Slug field and set it to
issue-01— the slug has to start withissue- - Optionally add a Description and a Tag image
- Click Save
- Open each post that belongs to the edition, go to Post settings → Tags, and add the edition tag
An edition tag is a normal public tag, not an internal one. Do not type a
leading #. The slug is what turns a tag into an edition, so Issue 01 with
the slug issue-01 works, while Issue 01 with the slug first-issue does
not.
The /issues/ page needs the routes.yaml file that ships with the theme. If you have not uploaded it yet, follow the Getting Started guide first, otherwise the URL returns a 404.
Where Editions Appear#
| Place | What it shows |
|---|---|
/issues/ | Every edition, one block per edition, with up to 6 of its posts |
| Homepage Editions carousel | Up to 12 editions as cards, with a link to /issues/ |
| Bottom of a post | More from Issue 01 — up to 8 other posts from the same edition |
/tag/issue-01/ | The edition's own archive, with every other edition listed next to it |
The issues page#
The page opens with an Issues heading and then lists the editions, newest first. Ordering follows the date each tag was created, not the number in its name, so create your edition tags in publication order.
Each block on the page uses:
- the tag name as the heading
- the tag description as the line under the heading
- a View All link pointing at the edition's own archive
- up to 6 of the edition's posts, newest first
An edition with no published posts is skipped, so a tag created in advance stays invisible until you publish into it.
The homepage carousel#
The homepage shows up to 12 editions in a carousel titled Editions, with a Browse issues link to /issues/. Each card uses the tag's image, name, post count, and description, so an edition without a tag image shows its name over a plain panel. Setting an accent color on the tag colors that panel. See Editions for the homepage section itself.
More from an edition#
At the bottom of a post that belongs to an edition, Wire adds a More from Issue 01 carousel with up to 8 further posts from that edition. The post being read is always excluded, so a reader never sees a link back to the page they are on. A View issue link leads to the edition archive.
If a post belongs to two editions, it gets one carousel per edition.
The edition archive#
An edition tag has a normal Ghost tag archive at /tag/issue-01/. On that page the row of tag pills lists the other editions instead of your topic tags, so readers can move from one issue to the next.
Editions Stay Out of the Tag Lists#
Editions would otherwise crowd out your topic tags, so Wire hides every issue- tag from the lists that are built from your filter settings:
- the Tags page
- the tag carousel on the homepage
- the tag section on the homepage and on topic tag archives
This happens automatically. You do not need to change the filters to exclude them.
Post cards label a post with its first public tag, and the tag list in the post footer shows every public tag, editions included. Keep the topic tag first in Post settings → Tags and the edition tag after it, so cards keep showing the topic.
Notes#
- The tag has to be public. A tag whose name starts with
#is internal in Ghost and never reaches the edition lists. - Up to 50 editions are listed on
/issues/, and up to 12 in the homepage carousel. - To rename the Issues, Editions, or More from headings, edit the matching strings in the theme's translation file, as described in Section Headings.