How do I add a tag list page

Developer help
1

I configured a lot of tags in the background, and marked different articles with different labels. How to add a tag list page to display all tags, and then click the tag to jump to the corresponding article list page

2

This tutorial is a little older but it should still work. :)

1 Like
3

You can follow this post too.

1 Like
4

These tips are great and this looks like precisely what I need. I’m running the Source theme but on hosted Ghost Pro, so I have no access to theme files. Is there a way to do this with, e.g. an HTML card?

5

Just to clarify - that’s only true on the starter plan.

6

Oh, that’s news! I’m on the Ghost Pro Creator plan, so how do I access theme files?

7

Lots of good resources there! ^^

1 Like
8

Yes, I’ve been using this extensively, thanks. Very helpful!

1 Like
9

Hmm, maybe a penny just dropped.

If I go to Settings > Design & branding > Theme > Change theme > Installed > [theme name …] > Download, I can download the zipfile containing the theme.

Then, if I edit a file to, say, add or change some functionality, I can zip up the theme again, and upload it. So I could create a new .hbs file for Tags and follow the guidance here! Is this the way to do this?

10

Yes, that will work. And for small changes, that’s all I’d do.

But… it’s really annoying to have to make edits, zip, and upload, if you’re progressively making changes. Plus you can’t see any logs if you’re uploading to a server where you don’t have shell access. (That includes Ghost Pro.) So… I’d suggest getting set up to run Ghost locally. It’s going to take some time (although much of it will just be waiting on things to download/install), but it will make the development experience SOOO much better. (The {{log}} helper is your friend…)

There are directions for installing locally for theme development, but if you’re on Windows, I’d encourage you to install WSL2 (Ubuntu 22) and then follow the Linux directions.

1 Like
11

Thanks, that was in my mind too - this seems a pretty laborious way to go about things. Yet, I realise that if I want or need to make changes that involve theme editing, I should really be on self-hosted Ghost.

I was on self-hosted WordPress for 18 years; one reason (not the primary) for moving to hosted Ghost was not to do any admin-creator work anymore. Still, it’s hard to fully let go!

For now, I’ll do the small changes I need to via the theme download/upload route. Appreciate your insights, thank you.

12

You don’t need to be self hosted to make theme edits. There’s nothing magic about self hosting, and I wasn’t recommending it!

You can set up to deploy your theme changes via Github with Ghost Pro (or any other hosting/self-hosting setup as long as you have access to integrations), which makes getting the theme live on the server faster. Here are directions: Official Ghost + GitHub Integration

But the reason to recommend setting up local development (which you only have to do once) is because it’ll make the process a lot more pleasant – and that’s regardless of where you host. You don’t have to wait while you get your code to the server its going to, you get to see changes instantly. :)

While you /could/ edit files live on the server if you’re self-hosting, that’s not a great idea. You’ll (probably) miss out on using a real IDE, typing over an SSH tunnel is unpleasant for any length of time, and do you really want to risk breaking your live server while you experiment with your theme? (Answer: probably not!)

13

No, I didn’t think you were suggesting it. I was merely pointing out how I relish the idea of distraction-free writing at Ghost without the backend admin!

Everything you say makes good sense and I will set up a local install. Likely tinkering ahead.

1 Like
14

Got it! Well, theme changes are definitely tinkering, although no real backend admin. :)