Journal Plugin

:information_source: Summary Turn a Discourse topic into a one-to-many journal where one user can post entries that other users comment on
:hammer_and_wrench: Repository Link https://github.com/paviliondev/discourse-journal
:open_book: Install Guide How to install plugins in Discourse

Watch this video for an introduction to the plugin:

How to get started

First, enable journaling for a category in the category settings. Click “Settings” on the left, scroll down to the bottom, check “Enable journaling in this category” click “Save Category” and refresh the page. The “New Topic” button in the category will now read “Create Journal”, click it to create your first journal.

13 Likes

Thx for posting! From our practical experience, journal/diary/log category format is one of the most powerful categories you can add to your community.

We are looking forward for further development of the plugin.

4 Likes

It works only on category level, not via a tag?
Will comments fall back to normal places if the plugin is deactivated?

2 Likes

Currently, yes.

Discourse doesn’t have plugin deactivation hooks like Wordpress, so it won’t happen automatically, but there’s a button in the category settings that lets you restore posts in a category to their normal order. So while the plugin is still enabled you would:

  1. Disable the journal functionality in the category.
  2. Restore the posts to normal order.
  3. Deactivate the plugin (if you want to).
4 Likes

A few points of potential improvements for a possible future v2.0 of the journal plugin. Consider this just spitballing ideas and not actual feature requests. I just wanna hammer them out into the public and see what other users thin.

Better or different comment “engine”

Instead of regular posts, comments (aka replies to journal entries) should work in a similar fashion as in the post voting plugin. Gotta reference big brother Facebook here, where posting comment experience is the best example.

The question is whether those comments are counted into user activityor should even be counted in the first place.

That way also the timeline won’t be as buggy as only topic owner posts will be counted towards it.

Spec suggestion/draft:

  • Post voting comment “engine”
  • Comments don’t count towards activity (possible plugin setting on/off)
  • display half size user avatar and username next to comments (but hide avatar flair)

Shared journals (rather a nice-to have)

This is rather a stretch and not super crucial. But we had some users requesting journal topics whereas you basically have two topic owners. Question is how feasible it is in the first place?

Spec ideas:

  • topic owner can add co-authors
  • co-author can make new journal entry
  • (if feasible) topic owner and co-author avatar displayed stacked over each other in topic list
1 Like

I recommend one improvement to the plug-in (which is awesome!). The comment button should be more visible, for examples for instances using Reactions, the button is not even visible unless one horizontal scrolls. Since this is this a new feature, for UI/UX purposes I’d put the comment button in a clear visible way.

1 Like

Just to be sure… I don’t allow mega-topics and after 50th post that topic shall be closed and new topic is created.

  • such automatic created are own by system, so I have to change owner, right?
  • in my case 50 post limit is still valid and because Journal is ”just” a topic in steroids, even comments of enries are counted toward 50 limit because technically those are comments of a post when entries are comments of topic, right?

This is more area of Discourse, but can I change a comment that is now entry instead beeing comment of an entry? I couldn’t find from UI such option. If I have to use rails, then I don’t bother. Too much hazzle because of such minor thing.

I have a lot journal type topics and Ichanged those to this system, but everyone commented to topic, and now those show as entries. Well, old topic and quite few new members read those even and I’m totally sure they don’t care how content is shown.

1 Like

Thanks for the plugin! I started using it not too long ago but it had an “abandoned” vibe so I was unsure about it. It seems to work well though! (Here’s an example that uses it , I have modified the css to hide details and streamline the look)

I think the only thing I could highly recommend improving is how it jumps to new comments when you revisit the topic. It’s hard to explain but sometimes it’s janky/unclear where the new comments is when you’re catching up

2 Likes

Could you be more specific on this front? You think it should be identical?

Note that the Post Voting plugin was originally the Question Answer Plugin, which the Journal Plugin was a spun out of (see further). Bringing this one up to speed with the commenting changes in Post Voting is doable.

Interesting. Not sure if that’s an issue with this plugin or the post menu itself, but yes that’d need to be resolved. Is that mobile or desktop? What browser is it?

hm, interesting system you have going there. The answer will depend on how you’ve set up this automated topic splitting system. Entries are distinguished from Comments on the basis of whether the post has a reply_to_post_number, i.e.

entries = posts.where(reply_to_post_number: nil)
comments = posts.where.not(reply_to_post_number: nil)

So you could tweak your topic splitting algorithm to take that into account.

To turn a Comment into an Entry remove its reply_to_post_number value.

hm not quite sure what you mean here, but hopefully my explanation of the distinction between entries and comments will give you the answer.

Yes, the “topic entry” and timeline UX would need to be improved.

Working to do list

  • Improve comment UX
  • Improve topic entry and timeline UX
  • Add full suites of frontend and backend tests
  • Resolve UX conflicts with other widely used plugins and core.
1 Like

It’s a core feature

Well, I’m using the feature of the core, so propably I don’t tweak anything. As usual :joy:

I’m trying just to understand what will happend in the future. But if I understand that right entries are counted toward max post limit, but comments not. If so, it is splendeed.

Meta’ish off topic, but are mega topic generally accepted norm :flushed: Those are hidious reading to every new member and horrific to find something to older ones. Now I start understand why summaries are so wanted feature. It is inevitable that mega topics will lead endless repetions and large amount of off topic.

I see.

As it stands, both entries and comments will be counted toward the limit. I could possibly tweak it so that only entries would count. But I’d have to look at that more closely.

1 Like

I start missing focus here, and I’m asking 101 level things, but if posts.where and posts.where.not does same thing what is the difference then? But I assume that nil was just an example and real value is used :thinking:

But anyway. This limited length question is really not major one, so if you want to look it do it when you are bored and you have nothing more important to do. Because at some moment I will know how it works in live environment.

1 Like

They don’t mean the same thing. nil is the real value.

posts.where(reply_to_post_number: nil)

means posts where reply_to_post_number is nil, which means it’s a post not in reply to another post (i.e. it’s an entry).

posts.where.not(reply_to_post_number: nil)

means posts where reply_to_post_number is not nil, which means it’s a post in reply to another post (i.e. a comment).

Anyway, you probably don’t need to worry about rails querying. I’ll let you know if we add support for not counting comments in core auto-topic-splitting.

1 Like

Thanks to explain that. Now I get it.

1 Like

I have successfully installed the plugin and enabled it but now am a bit lost?

Would it be possible to update this thread with a bit of a getting started post?

Hey @apidevlab, I’ve added a little description of how to get started above

Hi @angus thanks so much really appreciated, I have been able to locate the additional settings when setting up a category and it’s now working as expected, many thanks for your addition and work on this excellent plugin :slight_smile:

1 Like

Hey guys, a work spec is currently being ironed out for this plugin. If you’re interested in extending / using this plugin and want to know more please send me a message on coop.pavilion.tech.

3 Likes

This plugin is pretty cool. I can see a variety of uses for this.