The Classified Ads add-on adds a full-featured classified ads marketplace to your Larapen site — users can create, browse, search, and manage listings with custom fields, image galleries, buyer-seller messaging, and admin moderation.
Key Features
- Custom fields — Define unlimited custom fields per category or globally. Supports 10 field types including text, select, checkbox, date, and price range.
- Moderation system — Optional admin approval workflow. Approve, reject (with reason), or auto-publish listings. Configurable per site.
- Search & filtering — Full-text search across titles, descriptions, and locations. Filter by category, price range, condition, city, and custom fields.
- Buyer-seller messaging — Built-in contact form with email notifications. Messages tracked per listing with read/unread status.
- Favorites — Authenticated users can bookmark listings for later. Toggle save/unsave with a single click.
- Auto-expiration — Listings expire after a configurable number of days. Expired listings are automatically hidden from public view.
- Image galleries — Upload multiple images per listing (configurable maximum) with a featured image and gallery.
- Community reporting — Users can report inappropriate listings. Admins review, dismiss, or act on reports from a dedicated panel.
- Categories — Organize listings using the unified Larapen category system with hierarchical support.
- Email notifications — Configurable notifications for new listings, approvals, rejections, messages, reports, and expirations.
- Multilingual — All listing content, categories, and custom fields are translatable. Authors can optionally provide translations.
Admin Panel
| Section | Description |
|---|---|
| Listings | Create, edit, and manage all classified listings. Filter by category and status. Approve or reject pending submissions. |
| Categories | Manage listing categories using the unified category system with hierarchical nesting. |
| Custom Fields | Define custom fields globally or per category. 10 field types: text, textarea, select, multi-select, checkbox, radio, number, date, URL, and price range. |
| Messages | View all buyer-seller messages tracked per listing with read/unread status. |
| Reports | Review user-submitted reports on listings. Dismiss or take action on reported content. |
| Settings | Configure publishing rules, moderation, listing duration, image limits, guest access, notifications, and feature toggles. |
Front-end
- Listings page with search, category filtering, price range, condition, location, custom field filters, and pagination.
- Listing detail page with image gallery, description, custom field values, seller info, contact form, and reporting option.
- Create and edit listing forms with category selection, custom fields, image uploads, and location fields.
- My Listings page for authenticated users to manage their own listings.
- Saved Listings page for bookmarked/favorited listings.
- Category archive pages filtering listings by category.
Configuration
| Setting | Default | Description |
|---|---|---|
| Listings per page | 12 | Number of listings on the front-end listing page. |
| Max images | 5 | Maximum images per listing (featured + gallery). |
| Listing duration (days) | 30 | Days until a listing expires (0 = never expires). |
| Allow publishing | Yes | Allow users to create listings on the front-end. |
| Guest browsing | Yes | Allow non-authenticated visitors to browse listings. |
| Guest contact | No | Allow guests to send messages to sellers. |
| Moderation enabled | Yes | Require admin approval before listings go live. |
| Enable reports | Yes | Allow users to report listings. |
| Enable favorites | Yes | Allow users to save/bookmark listings. |
Dependencies
None — the Classified Ads add-on works independently. It uses the core users table for listing ownership, messaging, favorites, and reporting.
Ideal for
- General marketplaces (buy/sell/trade).
- Business directories with custom fields.
- Real estate and vehicle listing sites.
- Job boards and service directories.
- Internal asset boards for organizations.