ShaunSocial docs ShaunSocial user guide
Version 1.5.6
  • 1.5.6 (this version)

ShaunSocial user guide 1.5.6 / Features

Marketplace

AdminMember

The Marketplace lets members and business pages offer things for sale, rent or hire as listings: products, services, rentals, jobs or links to products on other sites. This page shows admins how to set up the categories (needed before anyone can list), the featured listing packages and the settings, and shows members how to add and manage a listing, browse and filter listings, find listings nearby, feature a listing and contact a seller.

How this page was checked

Checked against the 1.5.6 code and the categories of a demo site. The steps for adding, featuring and contacting were read from the code, not run; screenshots follow.

Categories and attributes#

Admin

Last updated: 2026-11-17 · v1.5.6

Moderators need the Manage Categories switch in their role (see Moderator roles).

Categories have up to three levels, for example Cars & Vehicles → Cars → SUV. A listing is always put in a sub-category (the second or third level), never directly in a top-level category. The second level decides which fields the listing form asks for: condition, price, discount, free delivery, available units. A third-level category uses the fields of the second-level category above it.

Create sub-categories before members can list

The site comes with 12 top-level categories and no sub-categories: Cars & Vehicles, Computers & Accessories, Devices, Contracts, Electronics & Appliances, Fashions, Foods, Furniture, Houses & Lands, Jobs, Pet Services and Phone & Tablets. Until you create at least one sub-category, members find nothing to choose in the listing form's Category field and cannot add a listing. Create the sub-categories your community needs (below), or import them from a CSV file.

AdminCP Manage Categories: Import categories and Create new, the twelve top-level categories with their icons, and under Furniture the sub-categories Home Decor and Kitchen and Office Furniture with Edit, Manage Attributes and Delete
AdminCP → Core Features → Marketplace → Manage Categories: the category tree with Edit, Manage Attributes and Delete. Screenshot taken 2026-11-17.

Create a category#

  1. Click Create new.
  2. Enter the Name and, if you like, upload an Icon; the icon is shown in the Categories block of the Marketplace page and in the category choice.
  3. Choose the level:
    • a top-level category: leave Parent empty;
    • a sub-category: choose a top-level category as Parent. If that category already has sub-categories, a second list appears; leave it empty;
    • a third-level category: choose the top-level category as Parent, then the sub-category in the second list.

    What you should see: for a sub-category, the field options below the parent lists (see the table).

  4. Tick the fields listings in this sub-category need, leave Active on and click Submit.

    What you should see: "Marketplace category has been created." and the category in the tree.

The Create window for a new sub-category Garden and Outdoor: Name, Icon, Parent set to Furniture with a second level list, the field options for condition, price, discount, free delivery and available unit, Active, Submit and Cancel
The Create window for a sub-category: Name, Icon, Parent and the field options. Screenshot taken 2026-11-17.
Option (sub-categories only)What members see in the listing form
Enable condition (New or Used) fieldConditions, required: New or Used
Enable price fielda required price, labelled after your choice: Fixed price gives Price, Monthly price gives Monthly price (rentals), Salary gives Salary (jobs). Without it the listing has no price
Enable discount fieldan optional Discount, as an amount or a percentage of the price. Not useful with Salary
Enable free delivery fielda Free Delivery tick box
Enable available unit fieldAvailable unit - Leave it empty if unlimited
  • Rename a category: click Edit, then Translate under the name, and change the name there for each language (see Translate a name or text). The Name field cannot be changed after creating. The other fields can.
  • Order: drag the rows to set the order members see.
  • Active off hides the category from members.
  • Delete removes the category with its sub-categories and the category's own attributes. It is refused while a listing uses the category or one of its sub-categories: "Cannot delete this category. It has been associated with listings."

Import categories from a CSV file#

  1. Click Import categories and then Download sample csv to see the format.
  2. Prepare your file: one category per line, with the columns level, name, is_active, price_type, enable_condition, enable_discount, enable_free_delivery and enable_available_unit (see the example below).
  3. Under Import under, keep — Top level — or choose an existing category to add the new ones below it. The level in the file counts from there: level 1 is a direct child of what you chose.
  4. Choose the file under File CSV and click Import.

    What you should see: "Categories imported successfully. Created: [number], skipped: [number]." A category whose name already exists at the same place is skipped, not duplicated.

level,name,is_active,price_type,enable_condition,enable_discount,enable_free_delivery,enable_available_unit
1,Vehicles,1,,,,,
2,Cars,1,fixed_price,1,1,1,0
3,SUV,1,,,,,
2,Motorcycles,1,fixed_price,1,0,1,0
  • A row belongs to the nearest row above it with a lower level.
  • price_type is fixed_price, monthly_price, salary or empty (no price); the other options are 1 (on) or 0 (off). They are used only for rows that become second-level categories in the tree: with — Top level — those are the level-2 rows, under a top-level category they are the level-1 rows.
  • The whole file is checked first. If one line is wrong, nothing is imported and the window lists the lines to fix, for example "Line 4: missing a parent row at level 1.".

Attributes and their values#

Attributes are the details a buyer filters by, such as Brand or Engine type, each with a list of values (Petrol, Diesel, Electric). They belong to a second- or third-level category; a third-level category offers its own attributes and those of the category above it.

  1. Click Manage Attributes next to a sub-category, then Create new.
  2. Enter the Name, upload an Icon if you like, and choose Single choice or Multiple choice. To copy the values of an attribute you already made for another category, choose it under Import values from existing attributes. Click Submit.
  3. Click Manage Values next to the attribute and Create new for each value. Tick Add to other attribute to add the same value to other attributes at once.
AdminCP Manage attributes of Home Decor and Kitchen: the attributes Material and Colour with Status Yes and the Edit, Manage Values and Delete links
The attributes of a sub-category with their Manage Values, Edit and Delete links. Screenshot taken 2026-11-17.

On the values screen, tick several values to delete or activate them together. An attribute or a value that a listing uses cannot be deleted; switch it off with Active instead. Attribute names and values are renamed with Translate, like categories.

Adding a listing#

Member

Last updated: 2026-11-17 · v1.5.6

Click Marketplace in the main menu, then Add new in the Categories block. The form is also at https://example.com/marketplaces/listings/create.

The empty Create new listing form: Main thumbnail and Photos, Listing name, Info, Type, Category, Hashtags, Contact Information, Country, Term and Condition, and the Cancel, Save Draft, Preview and Submit buttons
The Create new listing form: the main thumbnail, the photos, the details, the category fields, the location and the buttons. Screenshot taken 2026-11-17.
FieldWhat to enter
Main thumbnailrequired: the photo, or an MP4 video, shown first. A video is accepted only when your site can process videos (see FFmpeg and Imagick on the server)
Photosrequired: at least one photo, up to 10 after installing
Listing namerequired, up to 255 characters
Inforequired: the description, up to 1000 characters after installing
TypeRegular: you sell or offer it yourself and buyers chat with you. Affiliate: you point to a product on another website; enter its address (starting with http:// or https://) and buyers get a Link to buy button instead of Chat
Categoryrequired: click it and choose a sub-category. If the sub-category has its own sub-categories, a second list appears; choosing one there is optional, the listing can stay in the sub-category
Select listing attributesthe details of the item, such as brand or size, when the category has attributes. You can also add or change them later with Add Attributes or Edit attributes on the listing's Info tab
Conditions, Price (or Monthly price, Salary), Available unit, Discount, Free Deliveryshown when the category asks for them. Prices are in your site's currency. A percentage discount must be below 100, an amount below the price
Hashtagswords that help people find the listing
Contact Informationhow to reach you, up to 1000 characters
LocationCountry is required; State and City help buyers nearby find you
Term & Conditionyour conditions of sale, up to 1000 characters
  1. Fill in the form.
  2. Click Submit to publish, Save Draft to keep it for later, or Preview to save a draft and see the listing page as buyers will.

    What you should see: after Submit, "Your listing has been created successfully." and the listing page. If your site reviews new listings, you see "Your listing is pending for approval." instead, and you get the notification "Your listing '…' is approved" when an admin approves it. After Save Draft, "Your draft listing has been saved successfully.".

  • Save Draft and Preview are offered only while your site publishes new listings without review.
  • When the site is set up so, a post "created a new listing" appears on your profile and in your followers' home feeds once the listing is published. It is hidden again while the listing is a draft or switched off. Listing posts and review posts are never shown on Explore (see Discovery and Explore).
  • Whether you may add listings and how many a day depends on your member role: you may see "You don't have listing creation permission." or "To prevent spam, we only allow you to share a maximum of [x] listings per day.". When you post as a business page, the site must allow pages to create listings.

Change, unpublish or delete your listing#

Your listings are in Lists → Listings (https://example.com/lists/listings), with a Status filter: Active, Pending (waiting for an admin), Draft and Disable (switched off by an admin). On a listing page, the three dots hold:

Menu itemWhat it does
Editopens the form; click Update to save, or Publish for a draft
Set as drafttakes the listing out of view: "This listing has been marked as draft and is no longer visible to buyers." Use it when the item is sold or no longer offered. The listing's feed post and its review posts are hidden too
Publish listingputs a draft back on view. A listing an admin approved once is published at once; a listing never approved goes to the admins again if your site reviews listings
Delete listingdeletes the listing with its photos, reviews and feed posts, after you confirm
Shareshares the listing like a post

Changing an active listing does not send it for review again.

Browsing listings, nearby listings and reviews#

Member

Last updated: 2026-11-17 · v1.5.6

Click Marketplace in the main menu (https://example.com/marketplaces). Visitors who are not signed in can browse too, unless Force Login is on. After installing the page shows four blocks; a block with nothing to show is hidden.

The Marketplace page of Emma Carter: the Categories block with Add new, Featured Listings with the Handmade Ceramic Mug Set, Latest Listings and Nearby Listings in Oregon
The Marketplace page: the Categories block with Add new, then Featured Listings, Latest Listings and Nearby Listings. Screenshot taken 2026-11-17.
BlockWhat it shows
Categoriesthe top-level categories with their icons, and the Add new button for adding a listing
Featured Listingslistings their sellers featured (see Featured listings), in random order
Latest Listingsthe newest listings
Nearby Listingsthe newest listings near you (see below)

Each listing card shows the photo, the name, the price (with the old price crossed out and the discount on the photo when there is one), the place and the category. Listings also appear in the site search on the Listing tab, on members' profiles on the Listings tab, and can be saved with the bookmark button (see Bookmarks).

Nearby listings#

The Nearby Listings block shows the newest listings in the country of the location in your profile, and in the same state when your profile has one. You set that location in Settings → Profile → Location. Visitors and members without a country in their profile do not see the block. View all opens all listings near your location.

Admins can also put the Nearby Listings block on other pages, such as the home page, in the Layout editor.

Find listings with categories and filters#

  1. Click a category in the Categories block, or View all on a block.

    What you should see: the Listings page, with the path of the category at the top and its sub-categories to click through.

  2. Narrow the list with the filters: Location, Sort (rating or price, highest or lowest first) and, when the category uses them, Condition and Delivery.
  3. Click More Filter for a price range, a review range and the category's attributes, then Apply Filter. Clear empties the window.

The filters in use are shown under the bar; click the cross on one to remove it.

The Listings page of the Furniture category: the path Home and Furniture, the Select Location, Sort and More Filter bar, the sub-categories Home Decor and Kitchen and Office Furniture, Add New Listing and the first listings
The Listings page of a category: the path, the sub-categories, the filter bar and the listings. Screenshot taken 2026-11-17.

The listing page#

The listing page of the Handmade Ceramic Mug Set: the photos, the price 48 dollars, the rating from 3 reviews, the category and condition, the location, Chat, the bookmark, share and options buttons, the listing owner Mia Thompson, Do you recommend, the Info and Reviews tabs and Related Listings
A listing page: the photos, the price, the rating, the location, Chat, the bookmark, share and options buttons, the seller and the Info and Reviews tabs. Screenshot taken 2026-11-17.
  • At the top: the photos and video (click one to enlarge it), the name, the price, the rating with the number of reviews, the place and, if the seller entered it, the number of available units.
  • Chat sends the seller a message about this listing (see Chat with the seller); an affiliate listing has Link to buy instead, which opens the product on the other website.
  • The bookmark, share and three-dot buttons; the three dots hold Report (see How members report) and, for the seller, the menu described in Change, unpublish or delete your listing.
  • Listing owner shows the seller (a member or a business page) with their followers.
  • The Info tab shows the description, the attributes, the hashtags, the contact information, the terms and free delivery; the Reviews tab shows the reviews. Related Listings shows other listings of the same category.

Recommend a listing (reviews)#

  1. On a listing page, answer Do you recommend [listing name]? with Yes or No.
  2. Write a few words in the window that opens and click Send.

    What you should see: "Your review have been sent." The review is published as a post and appears on the listing's Reviews tab; the seller gets "wrote a review for your listing.".

Each member can review a listing once, and not their own. The rating is shown out of 10: each Yes counts 10 and each No counts 0, averaged over all reviews, for example "Rating · 7.5 (4 reviews)". Deleting the review post removes the review and updates the rating.

Chat with the seller#

Member

Last updated: 2026-11-17 · v1.5.6

When you contact a seller from a listing, the listing travels with your message, so the seller knows at once what you are asking about.

  1. Sign in, open the listing and click Chat.
  2. Type your message in the Message window and click Send.

    What you should see: the chat with the seller opens, with a card of the listing (photo, name, date, place, category, condition, free delivery and price) above your message. Click the card to open the listing.

Emma Carter's chat with the seller Chloe Dubois: the card of the Minimal Desk Lamp with its photo, time, place, category, condition and price, Emma's question below it and Chloe's answer
A chat with a seller: the listing card and the buyer's message below it. Screenshot taken 2026-11-17.
  • Chat is shown on regular listings of other members; affiliate listings have Link to buy instead. Visitors who are not signed in and click Chat are sent to the sign-in page.
  • You need permission to send messages in your member role, and the seller's message settings apply: you may see "You cannot send messages to this user." (or "…to this page." for a business page). A conversation you already have with the seller is always open.
  • The card is shown while the listing is active; a listing set as draft or deleted no longer shows it.

Chat itself is explained on the Chat page.

Listings admin and settings#

Admin

Last updated: 2026-11-19 · v1.5.6

Marketplace settings#

The screen saves each setting as soon as you change it.

The Marketplace part of AdminCP General Configuration: the Enable, Auto create feed and Auto approve switches, the pending and draft badge colours, Users and Pages can create listing, the photo and description limits, the reminder days and the currency symbol position
AdminCP → General Configuration → Marketplace: the switches, the badge colours, the limits and the currency symbol position. Screenshot taken 2026-11-17.
SettingAfter installingWhat it does
Enableonoff: the Marketplace menu entries disappear, the marketplace pages can no longer be opened and the listing posts leave the feeds. Nothing is deleted: switch it on again and everything comes back. The AdminCP Marketplace menu stays
Auto create feed for new listingonadds a post "created a new listing" to the seller's profile and followers' feeds for each new listing, shown while the listing is active
Auto approve new listingonon: new listings are published at once, and sellers can also save drafts and preview. Off: new listings wait for an admin (see below)
Pending badge Background Color, Pending badge Border Color, Pending badge Text Color#DDCBAD, #CBCBCB, #000000the colours of the Pending label sellers see on their own listings
Draft badge Background Color, Draft badge Border Color, Draft badge Text Color#4CB3EB, #737474, #000000the colours of the Draft label
Users can create listingonoff: members cannot add listings from their own account
Pages can create listingonoff: business pages cannot add listings
Maximum photos can be attached10photos per listing; 0 means no limit
Maximum description length1000characters in a listing's Info. Enter a number above 0; for long descriptions enter a large one, such as 10000. 0 or an empty box does not remove the limit
Auto-renew listing featured subscription will be notified to users in advance (days)5how many days before a featured listing renews the seller is reminded
Currency symbol positionBefore amount ($100)where the currency symbol stands in marketplace prices

Who may add listings, and how many a day, is also set per role in AdminCP → Users → Manage User Roles → Permissions → Marketplace: Allow listing creation (on after installing) and Maximum number of listings can create per day (0 is unlimited) (0). Super admins and moderators are not held to the daily limit; see Per-day limits. Listing prices are in your site's default currency.

Manage listings#

Moderators need the Manage Listings switch in their role. The list shows every listing, newest first, with ID, Name, Created, Agent (the seller), Status, Location and Featured. Filter by status (Active, Disable, Pending, Draft) or search by name or listing ID, and click Search.

AdminCP Manage Listings with the status filter and search, and the listings with ID, photo, name and price, Created, Agent, Status, Location, Featured and the Disable and Delete actions
AdminCP → Core Features → Marketplace → Manage Listings: the filters and the listings with their actions. Screenshot taken 2026-11-17.
ActionShown onWhat it does
Approvepending listingspublishes the listing. The seller gets "Your listing '…' is approved"
Disableactive listingshides the listing from everyone but its seller, who sees "This listing is disabled by admin". The seller gets "Your listing '…' is disabled"
Activedisabled listingspublishes the listing again. The seller gets "Your listing '…' is activated"
Deleteall listingsdeletes the listing with its photos, reviews and feed posts. This cannot be undone. Tick several listings and use the delete button under the list to delete them together
  • Listings waiting for approval: whenever listings are waiting (for example while Auto approve new listing is off), every super admin and moderator gets one notification a day, at midnight, such as "you have 3 listings pending approval". It is sent by the cron job (see What stops when the cron job does not run). Filter the list by Pending to see them.
  • Featured shows whether a seller's feature subscription is running; listings are featured through the packages (see Featured listings).
  • Blocks: the pages are laid out in the Layout editor (pages Marketplace Page, Listings Page and Listing Detail), with the blocks Categories, Featured Listings, Latest Listings and Nearby Listings.
  • Members can report a listing from its three-dot menu; reports are handled in the Moderation Center.

Change log#

Last updated: 2026-11-19 · v1.5.6

Date (GMT+7)SectionWhat changed
2026-11-17allFirst version for 1.5.6, written from the 1.5.6 code for members and for site owners and their admins.
2026-11-17categories, create-listing, featured, chat, adminCorrections after review: the description length limit, the second Parent list, optional third level, what Delete removes, the CSV options, PayPal and Stripe payments and renewals, the daily pending notice, finding the subscription, the Manage Categories switch, the photo limit, attributes from the Info tab, visitors and Chat, listing posts and Explore, Set as draft and reviews.
2026-11-17featured, chatLinks to the Payment gateways, eWallet and Chat pages, which are now written.
2026-11-19adminThe full labels of the badge colour settings.