walsgit/flarum-discussion-cards

Output of discussions lists in form of cards

1.2.0 2024-12-17 16:57 UTC

Requires

• flarum/core: ^1.0
• flarum/tags: ^1.0

MIT

• Wa!id

• extension
• discussion
• cards
• flarum

README

A Flarum extension (Fork of @Dem13n's discussion-cards). Allows you to display discussions in the form of cards, the first image of the first post is used as a preview, if there are no images, a stub is displayed.

This fork adds new features where you can now set custom cards settings per tag page (different default image along with number and width of primary cards). On the index page (all discussions), if a discussion has multiple tags with their own custom image set, the displayed image will be chosen according to these priority rules:

1. The image of the the highest positioned child primary tag of the highest positioned parent primary tag
2. The image of the highest positioned parent primary tag
3. The image of the secondary tag with the lowest id
4. The general default image

Also it changes how the setting to distinguish between read & unread discussion cards work: now the read discussions are filtred with a grayscale instead of the unread ones. As of 1.2.0 read discussion cards a no longer filtered with a grayscale but have just a lighter title and text.

3rd party extension support

• flarumite/simple-discussion-views : show discussion view count on cards
• As of version 1.1.0 added support for the v17development/flarum-blog extension. If activated, you can set to use the blog's extension images for blog posts' cards and/or their article summary as preview text on the cards.
• As of version 1.2.0 added support for the shebaoting/repost extension. If activated, you can set it so that when you click on the card title of a discussion starting with a url, it will open that url, and clicking anywhere else on the card will open the discussion as usual.

Notes

• Developed and tested on Flarum 1.8.7 then tested on 1.8.8.
• Thanks to whomever suggested on Discord to use the tags selection component (sorry, we can no longer access the messages on Discord to mention them properly).
• New settings page inspired by Friends of Flarum's Best Answer Extension.
• Additional tags settings based on @askvortsov's Discussion Templates Extension.
• Developped this with the help of AI (mainly ChatGPT, Cody & Gemini).

Installation

Install with composer:

composer require walsgit/flarum-discussion-cards

Updating

composer update walsgit/flarum-discussion-cards
php flarum migrate
php flarum cache:clear

Links

• Packagist
• GitHub
• Discuss
• Donate