[Feature] Tag Management

[novaugust]

Here's the original UI issue: #3926 , and the markup was added in #4171. The big picture vision for tags is written up in the Tag 101 document on the wiki, which covers tonnes of advanced features.

---

In order to ship tag management we need to deliver a minimum working version. Here's what we think it should look like:

This list shows each tag in a list. The list needs to have infinite scroll applied to it, much the same as the users or posts list. The number on the right is the number of posts that the tag is associated with.

Clicking on any one of the tags in the list will open up the 'tag settings menu' or TSM :)

This allows for editing the tag name, slug, description, and post cover image. There is also a meta data screen the same as in the post settings menu. Editing the slug updates a live URL preview.

This screen should only appear for users with the role 'Editor' or higher.

Development How-To

The tags UI is hidden behind a feature flag! To see, use, and develop with the tags settings you must set tagsUI: true in the development object of your config.js.

E.g:

development: {
    url: 'http://localhost:2368',
    tagsUI: true,
    ...

Server Side

Tag API

• Full BREAD baby! (Currently, only Browse is implemented) API: full BREAD Tag endpoints #4263
• Output number of posts associated with tag (issue API: Make it possible to get a post count for each tag #4521)
• Ensure API permissions are correct

Client Side

• Add new page to settings Create Tags Management Stubs for Ember #4260
• BREAD (WIP PR Tags management api hookup #4489)
• Add infinite scroll (done in PR Tags management api hookup #4489)
• Add autosave and remove save button (issue Tag Settings Menu Autosave #4517)
• Add the cover image (issue Tag Management: Cover image upload #4506)
• Add number of posts (issue Update tag management UI with the post count #4683, requires API: Make it possible to get a post count for each tag #4521)
• Permissions - Only editors and up
• Add meta data screen (issue Tag Management: Meta Data Screen #4509)
• Fixup the delete flow (issue Tag Management: Delete flow #4633)
• Dynamic URL preview (issue Tag Management: Dynamic URL Preview #4499)
• Dry up the code (issue Create Settings-Menu-Component to DRY up settings menu interactions #4642)

Themes

• Use tag meta data on tag archive pages (issue Structured Data 2.0 #4677)
• Make sure {{image}} helper works for tags (issue Tag Management: Cover image upload #4506)

Bugs & Improvements

• Bug: Settings menu doesn't close on transition bug ember (issue Bug: Settings menu doesn't close on transition #4504)
• UX Issue: Tag management list needs larger click area ember (issue UX Issue: Tag management list needs larger click area #4505)
• Tag Management: Functional Tests (issue Tag Management: Functional Tests #4507)
• Enforcing uniqueness of tag names (issue Tag names - unique constraint. #4687)

See Tag 101 for a description of advanced features we'll be adding later like hierarchy, visibility and search.

[novaugust]

The UI suggests stuff I'm not sure is implemented on the backend yet - things like tag hierarchy, and tags having customizable slugs. Can anyone tell me whether I need to open another issue for that? @halfdan @sebgie @ErisDS

There's also the idea that a tag should report back how many posts it has been used with; pretty sure that needs backend implementation as well eh?

[sebgie]

@novaugust Only tags.browse is implemented atm. All other api endpoints need an issue.

[novaugust]

@sebgie updated the issue description, let me know what you think

[ErisDS]

The way I had thought to do this was to implement the tag management UI only for the features that we do support, and then raise separate issues for adding new features (like hierarchy, visibility, etc)

[JohnONolan]

Who can do what with tags? cc @JohnONolan

I'm thinking Editor+ can see/manage all aspects of this screen.

NB: That modal screenshot above is outdated, this UI will now exist within a slide-out settings menu.

[novaugust]

Cool, and so authors can neither interact nor see?

On Wed, Oct 8, 2014 at 2:38 AM, JohnONolan [email protected] wrote:

Who can do what with tags? cc @JohnONolan https://github.com/JohnONolan

I'm thinking Editor+ can see/manage all aspects of this screen.

NB: That modal screenshot above is outdated, this UI will now exist within
a slide-out settings menu.

—
Reply to this email directly or view it on GitHub
#4248 (comment).

[JohnONolan]

Correct!

[ErisDS]

Further to @JohnONolan's note about the screenshot being outdated, I've updated the main issue with new screenshots. Here's what it looks like now:

[sorniva]

Howdy, unsure if this is the place to report it, knowing it is still being worked on.. but I've not been able to find it reported elsewhere.. and was unsure if a new issue/report should be raised.

I use ghost with the "fileStorage: false" option in my config due to the use of ephemeral storage and I noticed when using the tag management panel the section where an image is added has some odd behavior.

Initially there are multiple submit boxes and buttons for what presumably should simply be one box for the URL and a submit button.. But, even more interesting is if one clicks away out of this tag-info section and moves to another tag, and then another tag after that.. the URL boxes and submit buttons keep building up.

If one clicks away to another section, such as 'General' or 'Users' and returns to the 'tags' section to again click on a tag to edit its tag-info section, it returns to the initial errant amount of URL boxes and submit buttons.

this is happening on 0.5.7 with a postgres database and filestorage disabled.

here are some images showing first the initial state, and second what happens after navigating to a few other tags:

[ErisDS]

@Lemur3 That's really odd but it is easy to reproduce it. Could you possibly raise it as a bug? That way it's easier to track, thanks 👍

[MaluNoPeleke]

Could you please also add this kind of tag list to the editor so that it is easier to use existing tags for new posts?

[ErisDS]

@MaluNoPeleke there is already a tag suggestions box in the editor - if you start typing it will pop up:

[MaluNoPeleke]

I know but if I don't remember which tags I have used for a similar post I have to search them by entering different letters which is not very user friendly.
Wordpress for example offers a list of the most used tags in a word cloud.

[ErisDS]

Now that 0.5.8 is released, we've achieved the basic tag management feature laid out in this issue. Therefore I'm closing this in favour of #4798.