README

Classifieds

Turn any tag in your Flarum forum into a classified-ads section: photo galleries, price & price ranges, location, sold/bumped status, OLX-inspired listing cards and a dedicated discussion page that replaces the standard hero with a marketplace-style layout. Originally written for Flarum 0.1 by Jason Clemons, completely rebuilt for Flarum 2.0.

Features

Marketplace UX

• OLX-style listing cards — Discussions in classifieds tags show as horizontal cards with cover photo, price, label badge, location, and time
• Dedicated discussion page — Two-column hero (gallery + info), breadcrumb, contact-seller button, share/copy-link, edit, and a seller card showing per-tag listing count
• Photo carousel — Up to 20 photos per listing, drag-and-drop upload at compose time, lightbox-ready hero carousel with thumbnails
• Subtle tag-color tint — The hero background gets a soft fade in the tag's color, plus a thin accent stripe — identity without being loud
• Currency-aware prices — Price + optional max (range), automatic symbol resolution (USD → $, BRL → R$, EUR → €, …) with a forum-wide default fallback

Listing fields

• Labels — ISO, WTB, WTS, TRADE out of the box; admin can add custom labels (OLX, PROMO, TROCA, etc.) via comma-separated config
• Status — active, sold, completed with event-posts in the stream when changed
• Bump — Re-promote your listing with a single click, also recorded as an event-post
• Edit-after-create — Modal to update label/price/range/currency/location at any time
• Required fields — Admin toggles for required label / price / location

Admin

• Per-tag opt-in — Pick which tags act as classifieds tags via the native flarum-tags select-tags widget
• Default currency code — One source of truth for currency symbol; per-listing override available
• Auto-prune — Scheduled command removes sold/inactive listings after N days; configurable
• Permissions — discussion.markListingSold, discussion.bumpListing, discussion.editListing

Composer

• Tag-gated extension — The classifieds composer (image uploader + label pills + price row + location) only activates when at least one of the selected tags is flagged as classifieds in the admin
• Native styling — Pills built on Flarum's .Button component, inputs use FormControl, all Flarum theme tokens (--primary-color, --control-bg, --muted-color, …) — drops in cleanly with any theme

Requirements

• Flarum ^2.0.0
• flarum/tags (used for the per-tag opt-in widget)

Installation

composer require ramon/classifieds
php flarum migrate
php flarum cache:clear

Then enable Classifieds in Admin → Extensions and pick the tags that should behave as classifieds.

Updating

composer update ramon/classifieds --with-dependencies
php flarum migrate
php flarum cache:clear

Configuration

All settings are available in the admin panel under the Classifieds extension:

Permissions

API Endpoints

The Discussion resource is extended with listingLabel, listingStatus, listingPrice, listingPriceMax, listingCurrency, listingLocation, listingSoldAt, listingBumpedAt, listingImages, plus the booleans isClassifieds, canMarkListingSold, canBumpListing, canEditListing.

The User resource is extended with classifiedsListingsCount (number of listings in classifieds tags only — not the user's total discussion count).

The Tag resource is extended with isClassifieds.

Console

# Prune sold/expired listings according to admin settings
php flarum classifieds:prune

# Override the retention window for this run only
php flarum classifieds:prune --days=30

# See what would be deleted without committing
php flarum classifieds:prune --days=30 --dry-run

# Also remove listings that are still active beyond the window
php flarum classifieds:prune --days=30 --include-active

The command is also scheduled to run daily automatically via Extend\Console::schedule.

Links

• GitHub
• Issues
• Donate

Authors

• Ramon Guilherme — Flarum 2.0 rewrite, photo galleries, OLX-style hero, per-tag opt-in, marketplace UX
• Jason Clemons — original Flarum 0.1 classifieds concept

License

MIT