Add 'Related Content' section

[comnam90]

Are there any plans to add a related content section to the single page posts?
It'd be nice to have just above the comments section using the built in hugo related content functionality.

[Vimux]

I have no plans, but PRs are always open to everyone.

[gooseyman]

@Vimux I would like to work on this - just read the contribution guidelines, ok to start on this?

[Vimux]

@gooseyman,

OK, but I would like to see design mockups or ideas, to read in a few words what exactly you want to do with this and how.

[gooseyman]

@Vimux I'm proposing that this:

• should be an additional sidebar widget that users can choose to enable or disable based on need.
• have the same styling as the"Recent Posts" widget
• default to using "tags" as the basis for relating posts.

From the default pages, "Getting Started with Hugo" and "(Hu)go Template Primer" are related by the development tag. The image below shows and example of the Related Posts widget in the sidebar.

[Vimux]

should be an additional sidebar widget

It should be section. The original title and description state it clear:

#193 (comment)

Are there any plans to add a related content SECTION to the single page posts?
It'd be nice to have JUST ABOVE THE COMMENTS section using the built in hugo related content functionality.

By default, Mainroad sidebar contains widgets directly not connected with the current page content. So, no TOC, no comments, no related content widgets inside sidebar.

---

default to using "tags" as the basis for relating posts

I do not think that this should be the responsibility of the theme.

[comnam90]

I mean I'm not opposed to the idea of it being a side bar instead. I've just found it more common to have it as a section at the end of a post

[gooseyman]

Understood on #193 (comment) indicating section vs. widget. My proposal was for the widget nonetheless. However, good context on the Mainroad widgets being non-article specific. I agree that it should be a section on the page.

The Wordpress version of theme handles this like so:

https://mhthemes.com/demo/?theme=magazine

I do not think that this should be the responsibility of the theme.

I'm not following what you mean. The relation needs to leverage some variables in order to run - what did you have in mind if not using article tags?

[Vimux]

My quick thoughts about this section:

• The maximum number of similar articles should be user-configurable through the site config.
• Related item contains: title (minimal, required), image? (optional), DateTime (optional). Something else?
• The 3-columns view looks good. Possible edge cases: what if there is only one item inside? Five items? What if some of them don't have thumbnails?

---

The relation needs to leverage some variables in order to run...

I mean, we should use standard configuration by default. Something like this: .Site.RegularPages.Related .

REF:
https://gohugo.io/content-management/related/#list-related-content
https://gohugo.io/content-management/related/#configure-related-content

[metbril]

This issue is little over 2 years old. Any progress or update on this?

[Vimux]

Nothing has changed since then.

1. I don't plan to work on it. See Add 'Related Content' section #193 (comment)
2. I have not seen any mockups of how it should look&feel nor draft solutions trying to solve the problem (and not get around it or just copying from other themes)
3. I don't see this feature being popular over these two years.