# Simple Unread List

**URL:** https://meta.discourse.org/t/simple-unread-list/70013
**Category:** Plugin
**Tags:** deprecated
**Created:** [September 14, 2017, 1:54am UTC](https://meta.discourse.org/t/simple-unread-list/70013 "2017-09-14T01:54:02Z")
**Posts on this page:** 12
**Page:** 1

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [September 14, 2017, 1:54am UTC](https://meta.discourse.org/t/simple-unread-list/70013/1 "2017-09-14T01:54:02Z")

</div>

> ⚠ **DEPRECATED:** the ‘unseen’ view can now be added to the top\_menu setting in discourse core without this plugin. See the [release notes](https://meta.discourse.org/t/2-8-0-beta5-pm-improvements-unseen-view-allow-uploaded-avatar-by-trust-level-and-more/202357) for more information

### ~~Repository: [https://github.com/davidtaylorhq/discourse-simple-unread](https://github.com/davidtaylorhq/discourse-simple-unread)~~

This plugin adds another way of listing topics: the “Unseen” tab. It combines what you’d see under New and Unread, or to put it another way, it’s the same as Latest except it hides the topics you have fully read.

It has the same live-update functionality as the built-in pages:

 ![46](https://global.discourse-cdn.com/meta/original/3X/c/f/cf8d51a32a7cc071ab066c49840587c4ac669e08.png)

> **How is this different from the existing new/unread tabs?**
>
> > [@](#):
> >
> > **The existing “New” tab** displays:
> > 
> > - Topics in any category **created** in the time frame you specify in your `Consider topics new when` setting, that you have not yet opened
> > 
> > **The existing “Unread” tab** displays:
> > 
> > - New replies, to topics you have already viewed at least once, and are tracking. Even if you are tracking a category, the topic will not show up in “Unread” unless you have opened it at least once.
> > 
> > If an old topic in a category you are tracking has new replies, but you have never opened it, it will not display in either list. For us, that means that the “Latest” tab is the only reliable option. For more discussion on this limitation, check out [Spooky tracking happenings 👻 - #8 by david](https://meta.discourse.org/t/spooky-tracking-happenings-ghost/61255/8)
> > 
> > **This plugin’s “Unseen” tab** displays topics matching BOTH criteria:
> > 
> > - Has replies since you first logged into the forum
> > - You have not read the last post

“Unseen” is not a great title, but it needed to be something different to “Unread”. On my forum, we have renamed the existing “Unread” page to “Tracked”, and then renamed “Unseen” to “Unread”.

## Installation

First install this plugin as any other: add one line to your app.yml:

```plaintext
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/davidtaylorhq/discourse-simple-unread.git

```

Then rebuild the container:

```plaintext
cd /var/discourse
sudo ./launcher rebuild app

```

The plugin is enabled using the `simple_unread_enabled` site setting.

---

<div class="post-metadata">

### Author: ![Dannii](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dannii/32/129087_2.png) [@Dannii](https://meta.discourse.org/u/Dannii)
#### Post date: [April 14, 2019, 11:37am UTC](https://meta.discourse.org/t/simple-unread-list/70013/2 "2019-04-14T11:37:45Z")

</div>

Since migrating from phpBB, some of our users have complained that the Unread tab’s behaviour is very different from what it used to be. This looks like it could make it do what they expect. Thank you for making it!

> [@david](#):
>
> “Unseen” is not a great title, but it needed to be something different to “Unread”. On my forum, we have renamed the existing “Unread” page to “Tracked”, and then renamed “Unseen” to “Unread”.

How did you go about this? Can you just do it through the admin text content interface?

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [April 14, 2019, 1:44pm UTC](https://meta.discourse.org/t/simple-unread-list/70013/3 "2019-04-14T13:44:42Z")

</div>

> [@Dannii](#):
>
> Can you just do it through the admin text content interface?

Yes, admin/customize/text-content

---

<div class="post-metadata">

### Author: ![davidkingham](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/davidkingham/32/119528_2.png) [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [April 14, 2019, 5:16pm UTC](https://meta.discourse.org/t/simple-unread-list/70013/4 "2019-04-14T17:16:51Z")

</div>

This looks really useful David, but after installing it is not showing up in `top menu`, I do see it’s installed under plugins, any ideas?

 ![image](https://global.discourse-cdn.com/meta/original/3X/d/f/df332141bc3a1d11dd032832e1a148024ab9aa6d.png)

---

<div class="post-metadata">

### Author: ![Dannii](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dannii/32/129087_2.png) [@Dannii](https://meta.discourse.org/u/Dannii)
#### Post date: [April 22, 2019, 11:50pm UTC](https://meta.discourse.org/t/simple-unread-list/70013/5 "2019-04-22T23:50:19Z")

</div>

I can confirm “unseen” is not an option in the top menu setting.

I think this became impossible here: [Invalid items can be added to the top\_menu setting - #9 by sam](https://meta.discourse.org/t/invalid-items-can-be-added-to-the-top-menu-setting/80074/9)

I’d guess the plugin needs to add itself to the choices list.

It would also be good if it could add itself to the user’s Preferences→Interface→Default Home Page (and in a way which can be renamed through text content).

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [April 23, 2019, 10:43am UTC](https://meta.discourse.org/t/simple-unread-list/70013/6 "2019-04-23T10:43:03Z")

</div>

I haven’t used this plugin for a long time, and I don’t know of any sites using it successfully. I’ll move it to #plugin:broken-plugin for now, but will happily accept a pull request to fix the issues.

---

<div class="post-metadata">

### Author: ![Dannii](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dannii/32/129087_2.png) [@Dannii](https://meta.discourse.org/u/Dannii)
#### Post date: [April 23, 2019, 11:30am UTC](https://meta.discourse.org/t/simple-unread-list/70013/7 "2019-04-23T11:30:12Z")

</div>

Well the core of the plugin seems to work to me. Using the [Nav Links Component](https://meta.discourse.org/t/custom-top-navigation-links/87225) I added a link to it, and from what I can tell it’s working properly.

So maybe all that’s needed is better instructions here. I was thinking of making some edits anyway to explain what text content keys to change. (Though I’m not sure what extent that’s still even needed with the Nav Links Component now.)

I guess the real sore point is the menu management. The Nav Links Component is great if you just want to add a link to the end, but I’d ideally add this after latest, before the original Unread tab (which I’d rename to Tracked), before Top and New and Bookmarks etc. But I expect using the component will stop the menu items from showing a number. The component also has some poor quirks, such that if you start typing and change tabs, you’ll lose everything you entered. Even the original [navigation plugin](https://meta.discourse.org/t/navigation-add-custom-menu-items/53124) didn’t look like it made it easy to rearrange the menu items.

So this does work. It’s just depends on a very sub-optimal part of the Discourse ecosystem.

---

<div class="post-metadata">

### Author: ![Dannii](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dannii/32/129087_2.png) [@Dannii](https://meta.discourse.org/u/Dannii)
#### Post date: [June 5, 2021, 5:49am UTC](https://meta.discourse.org/t/simple-unread-list/70013/9 "2021-06-05T05:49:03Z")

</div>

After updating to the latest beta, this now seems to be erroring with `TypeError: this.isFilterPage is not a function` errors. I wasn’t even using it, but it completely took down my site.

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [January 31, 2023, 11:36am UTC](https://meta.discourse.org/t/simple-unread-list/70013/10 "2023-01-31T11:36:33Z")

</div>

This isn’t relevant plugin anymore and setting `unseen` does same thing, right?

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [October 10, 2023, 9:30am UTC](https://meta.discourse.org/t/simple-unread-list/70013/11 "2023-10-10T09:30:01Z")

</div>

I had to dig around to learn that [“unseen” is a thing you can add to the Top Menu list](https://meta.discourse.org/t/2-8-0-beta5-pm-improvements-unseen-view-allow-uploaded-avatar-by-trust-level-and-more/202357#new-unseen-view-5). Cool!  
Yeah, it does seem to render this plugin obsolete.

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [October 10, 2023, 10:23am UTC](https://meta.discourse.org/t/simple-unread-list/70013/12 "2023-10-10T10:23:11Z")

</div>

Yep, absolutely right. I’ve added a note to the OP, and to the GitHub README. Thanks for the prompts @Jagster and @ToddZ

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [October 16, 2023, 7:00am UTC](https://meta.discourse.org/t/simple-unread-list/70013/13 "2023-10-16T07:00:38Z")

</div>

This topic was automatically closed after 5 days. New replies are no longer allowed.
