Classifieds

Part of the IP4CMS portal. ← All module guides

What it's for — Classifieds is your community marketplace. Members of your community post items they want to sell (furniture, vehicles, pets, services, and so on), and other members browse them in the customer app. From the portal you set up the categories and pricing rules, review and approve incoming listings, create listings on a member's behalf, and manage the images attached to each one.

Where to find it — In the portal's left-hand menu, open the Community group and choose Classifieds. That opens the Listings screen, which is the heart of the module. Category setup and the approval setting live under Settings → Classifieds (tabs Categories and Settings).

Before you start

Key tasks

Set up categories

Categories group listings so members can filter them (for example "Vehicles", "Furniture", "Pets").

  1. Go to Settings → Classifieds → Categories (or click Set up classifieds categories from the New listing form).
  2. Click Add category.
  3. Fill in the fields and click Add:
  1. To change one later, click Edit on its row; to remove it, click Delete.

Good to know: deleting a category does not delete the listings in it — those listings simply lose their category (they become uncategorised) rather than being removed. You need the Manage categories permission to add, edit, or delete.

Configure the approval rule (pricing/config)

The Classifieds Settings tab holds the one tenant-wide rule that controls the approval workflow.

  1. Go to Settings → Classifieds → Settings.
  2. Toggle Require approval for new listings:
  1. The toggle saves automatically as soon as you switch it.

There is no per-listing fee or pricing configured here; "price" is the asking price the seller sets on each individual listing, in your tenant's default currency. You need the Manage config permission to change this setting.

Create a listing

You can create a listing yourself — useful for walk-in members or when posting on someone's behalf.

  1. On the Listings screen, click New listing.
  2. Complete the form and click Add listing:

A listing you create from the portal still follows the approval rule, so it may land as Pending.

Approve, decline, or close listings (approval workflow)

When Require approval is on, listings arrive with status Pending. Statuses are Pending, Approved, Declined, and Closed, shown as a coloured badge on each row.

  1. To find work waiting on you, use the Status filter and choose Pending (you can also reach this directly via a notification link).
  2. Click View on a listing to open its detail panel — title, price, category, expiry, description, images, and the seller's contact details.
  3. For a Pending listing, click Approve to publish it. Approving sets the status to Approved and records who approved it.
  4. To reject a Pending listing, click Delete on its row (or Delete from the detail view). Because the listing is Pending, this is treated as a Decline: you confirm, the listing is marked Declined, and the seller is notified — the listing is not removed.
  5. For listings that are already live, Delete removes them after a confirmation.

You need the Approve permission to approve, and an appropriate Delete permission to decline or delete.

Edit a listing

  1. On the Listings screen, click Edit on the row (or open View then edit).
  2. Adjust any of the same fields as the create form and click Save changes.

You can edit any listing if you have Update all; with Update own you can only edit listings tied to your own member record.

Manage listing images

Each listing can carry several images; the first image is the main thumbnail.

  1. In the New listing or Edit listing form, find Listing images and click the dashed upload area.
  2. Pick one or more files. Allowed types are JPEG, PNG, GIF, and WebP, each up to 5 MB. Files outside those limits are rejected with a message.
  3. New images show as thumbnails before you save; click the × on a thumbnail to drop it before saving.
  4. When editing, existing images appear in their own row — click the red × on an image to delete it immediately from the listing.
  5. Save the form; images upload one after another. If an upload fails you'll see a warning but the rest of the listing is still saved.

How the data connects

The module is built from four linked records:

So: a member owns many listings; each listing optionally sits in one category and carries many images; the tenant's config decides whether new listings need approval before going live.

Permissions & access

Your role's permissions decide what you can do. The relevant ones are:

The module also requires the classifieds licence on your tenant, regardless of permissions.

Tips & gotchas