PHPackages walsgit/flarum-discussion-cards - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. walsgit/flarum-discussion-cards ActiveFlarum-extension[Utility & Helpers](/categories/utility) walsgit/flarum-discussion-cards =============================== Output of discussions lists in form of cards 2.0.1(1mo ago)33.8k—1.8%3[1 issues](https://github.com/WalsGit/flarum-discussion-cards/issues)MITPHP Since Nov 15Pushed 1mo agoCompare [ Source](https://github.com/WalsGit/flarum-discussion-cards)[ Packagist](https://packagist.org/packages/walsgit/flarum-discussion-cards)[ Fund](https://walsgit.github.io/Donations/)[ RSS](/packages/walsgit-flarum-discussion-cards/feed)WikiDiscussions master Synced 2d ago READMEChangelog (10)Dependencies (4)Versions (22)Used By (0) Flarum Discussion Cards ----------------------- [](#flarum-discussion-cards) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/9625b8c4187ea07f484288d36682e3bb5d745db24638f0072334713ede9101af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f77616c736769742f666c6172756d2d64697363757373696f6e2d63617264732e737667)](https://packagist.org/packages/walsgit/flarum-discussion-cards) [![Total Downloads](https://camo.githubusercontent.com/dd187c4ed21b8f9a30e100648120387cf7d16bcd3a33e6c69f7254bf038ebde9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77616c736769742f666c6172756d2d64697363757373696f6e2d63617264732e737667)](https://packagist.org/packages/walsgit/flarum-discussion-cards) [![Donate here](https://camo.githubusercontent.com/c2fd425cefaa02eeee538e7d99d1f8ad234a964c3a1325ed4815264f55fab8d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d686572652d253233303038653937)](https://walsgit.github.io/Donations/) A [Flarum](https://flarum.org) extension (**Fork** of `@Dem13n`'s [discussion-cards](https://github.com/Dem13n/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* makes changes and 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 ``` For full list of changes & new features, please refer to the CHANGELOG.md file. 📢 IMPORTANT NOTICE ------------------ [](#-important-notice) > Versions `2.x` and up will target Flarum V2. > Versions `1.4.x` will be the final versions targeting Flarum V1. No more new features will be added, but some bug fixes & security updates will still be provided (if necessary) until full support will be dropped sometime before the end of 2026 or early 2027. All future dev efforts will be for versions `2.x` and up targeting Flarum V2. ### 🧩 3rd party extensions support [](#--3rd-party-extensions-support) - **Flarum V2** - As of version `2.0.0` only `fof/discussion-views`is supported. The other extensions that where supported in V1 have yet to be ported for Flarum V2 as of the latest release. Support will be added once they'll be ported or it will be dropped unless an alternative is released. - **Flarum V1** - Until version `1.3.0` `flarumite/simple-discussion-views` was supported to show discussion views count on cards (see replacement below) - 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. - As of version `1.3.0` added support for the `michaelbelgium/flarum-discussion-views` extension. - As of version `1.4.0` added support for the `fof/discussion-views` extension (replacing the abandoned flarumite/simple-discussion-views) ### 🖥️ Console Commands (CLI) [](#️-console-commands-cli) As of version `1.4.0` new CLI commands have been added to manage card images: - `php flarum discussion-cards:migrate-images` (runs automatically on update). - `php flarum discussion-cards:purge-images` to delete unused or all card images from server. - `php flarum discussion-cards:regenerate-images` to regenerate card images or generate missing card images. All details on how to use them can be found in the extension's wiki on github (See Documentation in the Links section below or in the Admin Settings Page). You can also add the `--help` flag to each command to list options. 🖼️ Screenshots -------------- [](#️-screenshots) [![Discussion Cards](https://camo.githubusercontent.com/c2f86971cbe0b30d44a6a94141cbd0c1ccadd5c7843e23b1fab6d8ef08939592/68747470733a2f2f63646e2e646973637573732e666c6172756d2e6f72672f323032362d30342d30372f313737353539323337382d3739313638362d696d6167652e706e67)](https://camo.githubusercontent.com/c2f86971cbe0b30d44a6a94141cbd0c1ccadd5c7843e23b1fab6d8ef08939592/68747470733a2f2f63646e2e646973637573732e666c6172756d2e6f72672f323032362d30342d30372f313737353539323337382d3739313638362d696d6167652e706e67) ### 💬 Languages [](#-languages) The extension is natively in English 🇬🇧 & French 🇫🇷; it's partially translated to other language by the Flarum translation community: [![State of translations for Flarum V2](https://camo.githubusercontent.com/42f81bf1c9a5dde8802918a9e32f571af1fa872781a32ccd06ac671f58433e9d/68747470733a2f2f7765626c6174652e726f623030362e6e65742f776964676574732f666c6172756d322f2d2f77616c736769742d64697363757373696f6e2d63617264732f6d756c74692d6175746f2e737667)](https://weblate.rob006.net/engage/flarum2/)You can help translate it to your language via Weblate: [here for Flarum V2](https://weblate.rob006.net/projects/flarum2/walsgit-discussion-cards/) & [here for Flarum V1](https://weblate.rob006.net/projects/flarum/walsgit-discussion-cards/). ### 🗒️ Notes [](#️-notes) - V2 developed and tested on Flarum 2.0.0-rc.1 (first version released `2.0.0`). - V1 developed and tested on Flarum 1.8.7 (first version released `1.0.0`) and last version `1.4.4` was developed and tested on Flarum 1.8.16. - As of version `1.4.0` it requires a Flarum minimum version of 1.8.0. - 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](https://github.com/FriendsOfFlarum/best-answer) Extension. - Additional tags settings based on `@askvortsov`'s [Discussion Templates](https://github.com/askvortsov1/flarum-discussion-templates) Extension. - Developed this with the help of AI (mainly ChatGPT, Gemini & Claude Code using Ollama Cloud models). 📥️ Installation --------------- [](#️-installation) ### ⚠️ IMPORTANT [](#️-important) > if you're **installing any version for the first time** or are **updating from a version older than 1.4.0** you will need to ***regenerate card images*** for all existing discussions after activating the extension as it no longer does it in the frontend on page loads (performance issues). You can run `php flarum discussion-cards:regenerate-images`first to regenerate images for the 20 latest discussion (default) or use the button in the admin settings page (click on *tools > regenerate images* then on the *Regenerate 20 latest card images* button. **Don't forget to add a general and/or tag default images first** and if all is OK, you can regenerate card images for ALL discussions using the proper options with the command (see [full documentation here](https://github.com/WalsGit/flarum-discussion-cards/wiki/CLI-Commands#discussion-cardsregenerate-images)) Install with composer: ``` composer require walsgit/flarum-discussion-cards ``` Then to generate card images for your discussion cards, **activate the extension** and run this command: ``` # For discussion cards without images (max 20 if no number is specified) php flarum discussion-cards:regenerate-images -w [Number] ``` *(see [full documentation here](https://github.com/WalsGit/flarum-discussion-cards/wiki/CLI-Commands#discussion-cardsregenerate-images) for more options on the command)* ℹ️ *Note that, as of versions `2.0.1` (V2) & `1.4.4` (V1), right after the installation, an automatic command will run to generate card images for the 20 latest, top & newest discussions* ↕️ Updating ----------- [](#️--updating) > ℹ️ If you're updating from version `1.3.0` or earlier TO version `1.4.0` or later not that the `discussion-cards:migrate-images` command will be automatically run to move and convert old images used for cards to new file structure and format (See changelog of version `1.4.0` for more details). You will also need to need to regenerate card images if you updating from those older versions (see post installation instruction above) ``` composer update walsgit/flarum-discussion-cards php flarum migrate php flarum cache:clear ``` 🆕 🔧 Troubleshooting & Support --------------------------------- [](#--troubleshooting--support) As of version `2.0.1` (V2) & `1.4.4` (V1) a Debugging Information tools was added to the Tools menu in the Admin Settings Page. You can use it to check how & why a discussion has a specific card image (see what the resolver sees and checks). Before you post an issue, copy & paste the debugging information from this tools along with your `php flarum info`output and any relevant screen capture. 🔗 Links ------- [](#--links) - [Packagist](https://packagist.org/packages/walsgit/flarum-discussion-cards) - [GitHub](https://github.com/walsgit/flarum-discussion-cards) - [Documentation](https://github.com/WalsGit/flarum-discussion-cards/wiki) - [Discuss](https://discuss.flarum.org/d/36343-flarum-discussion-cards) - [Donate](https://walsgit.github.io/Donations/) ### Health Score 45 — FairBetter than 91% of packages Maintenance82 Actively maintained with recent releases Popularity27 Limited adoption so far Community10 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 84.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~32 days Recently: every ~3 days Total 18 Last Release 54d ago Major Versions 1.4.3 → 2.0.02026-04-29 1.4.4.x-dev → 2.0.1.x-dev2026-05-11 1.4.4 → 2.0.12026-05-11 ### Community Maintainers ![](https://www.gravatar.com/avatar/1b48a7ff9849fd382c6abbd2f357000d805ca686296388ccdd48e621042a33e9?d=identicon)[walsgit](/maintainers/walsgit) --- Top Contributors [![WalsGit](https://avatars.githubusercontent.com/u/108340184?v=4)](https://github.com/WalsGit "WalsGit (234 commits)")[![Dem13n](https://avatars.githubusercontent.com/u/52776643?v=4)](https://github.com/Dem13n "Dem13n (44 commits)") --- Tags flarumflarum-extensionextensionflarumdiscussioncards ### Embed Badge ![Health badge](/badges/walsgit-flarum-discussion-cards/health.svg) ``` [![Health](https://phpackages.com/badges/walsgit-flarum-discussion-cards/health.svg)](https://phpackages.com/packages/walsgit-flarum-discussion-cards) ``` ### Alternatives [flarum-lang/russian Russian language pack for Flarum. 12128.3k](/packages/flarum-lang-russian)[fof/discussion-language Specify the language a discussion is written in & sort by language 1034.8k4](/packages/fof-discussion-language)[fof/byobu Well integrated, advanced private discussions. 59120.6k13](/packages/fof-byobu)[flarum-lang/french French language pack to localize the Flarum forum software plus its official and third-party extensions. 1938.7k](/packages/flarum-lang-french)[fof/masquerade User profile builder extension for your Flarum forum. 2025.4k5](/packages/fof-masquerade)[fof/mason Add custom fields to discussions 206.5k](/packages/fof-mason) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)