Topic List Excerpts

Theme component
,
1
:discourse2: Summary Topic List Excerpts allows you to enable excerpts for unpinned topics (by default, Discourse only displays topic excerpts for pinned topics).
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-topic-excerpts
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

Features

topic list excerpts example
topic list excerpts example2288×1422 459 KB

Works great alongside Topic List Thumbnails in “list” mode!

:information_source: The excerpts themselves are generated by Discourse Core, using the same logic as the excerpts of ‘pinned’ topics. If you have a query / suggestion about how the excerpts are built, please make a new support topic.

:bulb: Tip: you can keep line breaks in excerpts by adding this CSS to your theme:

.topic-list .topic-excerpt {
    white-space: pre-line;
}

Be aware that results may look off depending on the posts’ contents.

Settings

Name Description
show excerpts mobile
show excerpts desktop
enabled categories Enable excerpts in specific categories. Leave both categories and tags blank to show excerpts on all routes
enabled tags Enable excerpts in specific tags. Leave both categories and tags blank to show excerpts on all routes.

:discourse2: Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.

Last edited by @JammyDodger 2024-06-15T19:28:50Z

Check documentPerform check on document:
46 Likes
3

Great, a blog-like topic listing (together with Topic List Thumbnails Component)! :clap:

Can it be restricted by category like the other component?

7 Likes
4

Sure, I just added a category setting:

https://github.com/discourse/discourse-topic-excerpts/commit/aed85ba07007d38fe98de8889e3b155c69aeb812

13 Likes
5

Thanks, much appreciated.

I also take the chance to report that there is some kind of incompatibility with the Topic Thumbnails component, since the images appear twice for each topic in the topic list (topic list option on thumbnails component + topic excerpts component).

2 Likes
6

You’re right, sorry about that. Should be fixed now

8 Likes
15

Love this component; thank you! Is there any way to adjust the word/character length of the excerpts displayed in topic lists? (Never mind, I found the topic excerpt maxlength site setting, adjusted it, and rebuilt HTML for the topic posts in question.)

3 Likes
26

The category setting works but the tag setting is not working on the latest discoures.

2 Likes
27

@th21 tag handling should now be fixed - sorry for the delay!

3 Likes
29

A post was split to a new topic: Being able to display excerpts for some categories only on /latest

32

A post was split to a new topic: Differentiate contents from the topic list rows using different colors

34

Hi,why the read more is grey in my site but in yours is blue, how can i chane the color?

1 Like
35

Hi, you can use CSS to customize.

For example, using the predefined color for links. Though, you can provide the color you want.

.topic-excerpt-more {
    color: var(--tertiary);
}
1 Like
36

Hi, this component gets rendered on the discourse docs plugin page and makes the excerpt clickable to the url of the discourse discussion not the doc url, is there anyway to avoid this from happening?

37

Hi, it’s possible to show the latest post instead of the first post?

1 Like
38

I have a plugin + theme-component for this: Topic List Latest-Post Excerpt

2 Likes
39

There is a problem with the theme component in desktop?

when i have it enabled, thats shows avatars like that:

L'image montre une pile de tags de discussion avec différents symboles et lettres, et un compteur indiquant le chiffre 6 sur un fond sombre. (Captioned by AI)

i have updated my discourse today

EDIT: IS there a way to limit the number of lines/characters for the excerpt?

1 Like