Module · Board

Board: settings and screens

Board adds seven screens to the Modules group of the ExpertPress menu:

Screen Ukrainian label Who Section below
Board (moderation queue) Дошка оголошень expertpress_moderate Board moderation
Reports Скарги expertpress_moderate Reports
Category fields Поля категорій expertpress_operate Category fields
Board cities Міста дошки оголошень expertpress_operate Board cities
Board categories Категорії дошки оголошень expertpress_operate Board categories
Unfinished erasure Незавершене стирання даних expertpress_operate Unfinished erasure
Board settings Налаштування дошки оголошень expertpress_operate Board settings

Before members can post, create at least one active category and confirm photo storage isolation.


Board settings

Where: ExpertPress → Modules → Board settings. All fields in the main form are saved with Save settings (Зберегти налаштування). The form is checked as a whole; one invalid value means nothing is saved.

If the site has a physical robots.txt file, the top of the screen shows “A physical robots.txt bypasses WordPress. Add this line to it manually:” followed by the Sitemap: line for the board sitemap.

Who can submit listings

  • Where: Board settings
  • What it does: Decides who may create and submit listings.
  • Default: All signed-in users.
  • Values / limits: All signed-in users; Users with the expertpress_board_post capability. The board itself has no screen to grant that capability; use a role-management plugin or custom code.
  • When to change it:
    • Only verified specialists may post: choose the capability option and grant expertpress_board_post to the Specialist role.
    • A closed community where every member may post: keep the default.
  • Related: Submissions per account in 24 hours

Currency (ISO 4217)

  • Where: Board settings
  • What it does: Currency of fixed listing prices.
  • Default: the marketplace pricing currency from General.
  • Values / limits: a known three-letter ISO 4217 code, such as UAH, EUR, USD. Existing listing amounts keep their original currency; an author editing such a listing is asked to enter the price in the new currency.
  • When to change it: your board serves a different market than your specialists' services, for example services priced in EUR and second-hand items in UAH.
  • Related: —

Submissions per account in 24 hours

  • Where: Board settings
  • What it does: Maximum number of listings one account can submit for moderation in a rolling 24-hour window.
  • Default: 10.
  • Values / limits: 1–1000.
  • When to change it: lower it (for example to 3) if spammers flood the queue; raise it for shops that post many items at once.
  • Related: Who can submit listings

Reports per account in 24 hours

  • Where: Board settings
  • What it does: Maximum number of reports one account can send in a rolling 24 hours.
  • Default: 10.
  • Values / limits: 1–1000.
  • When to change it: lower it if someone uses reports to harass a competitor.
  • Related: Reports

Messaging window for unavailable listings

Full label: “Messaging window for unavailable listings (days since the last message, or conversation start if empty)”.

  • Where: Board settings
  • What it does: After a listing stops being public (sold, expired, removed, deleted), its participants can still read their conversation, but may send new messages only within this many days of the last message (or of the conversation start if no messages were sent). Each message restarts the window. Conversations about public listings have no such limit.
  • Default: 30 days.
  • Values / limits: 1–36500. Works only with ExpertPress Messages.
  • When to change it: shorten it to 7 days if sold-item chats attract spam; lengthen it for listings like rentals where follow-up questions come months later.
  • Related: New listing conversations per account in 24 hours

New listing conversations per account in 24 hours

  • Where: Board settings
  • What it does: How many new listing conversations one account may start in a rolling 24 hours. Reopening an existing conversation does not count. Messages' own safety checks and rate limits still apply.
  • Default: 20.
  • Values / limits: 1–1000. Works only with ExpertPress Messages.
  • When to change it: lower it if accounts send the same message to dozens of authors.
  • Related: Messages

Publication period (days; 0 means no expiry)

  • Where: Board settings
  • What it does: How long an approved listing stays public. Applies to new approvals and renewals; existing deadlines stay unchanged.
  • Default: 30.
  • Values / limits: 0–36500; 0 means listings never expire.
  • When to change it: 7–14 days for fast-moving items or events; 0 for a directory-style board.
  • Related: Warn before publication ends

Warn before publication ends (days)

  • Where: Board settings
  • What it does: When the author gets the expiry warning email and the “Expires soon” mark in the account.
  • Default: 3.
  • Values / limits: 1–36500.
  • When to change it: raise it to 7 for 60-day periods so authors have time to renew.
  • Related: Publication period

Photos per listing

  • Where: Board settings
  • What it does: Maximum photos per listing.
  • Default: 10.
  • Values / limits: 1–100. Each upload: JPEG, PNG or WebP, up to 5 MB.
  • When to change it: lower it to 3–5 to save disk space on small hosting.
  • Related: Private photo storage
  • Where: Board settings
  • What it does: Lets authors show a phone or email on their listing after ticking a consent box. When off, contacts are never shown, even if previously consented.
  • Default: on.
  • Values / limits: on / off.
  • When to change it: turn it off if all contact must go through chat (with Messages) to protect members from spam and fraud.
  • Related: Messaging window

Allow cities outside the directory

  • Where: Board settings
  • What it does: Lets authors choose Not in the list and type a city that is not in Board cities. Such listings do not appear in radius search.
  • Default: on.
  • Values / limits: on / off.
  • When to change it: turn it off once your city directory covers your whole region, so every listing can be found by distance.
  • Related: Manage cities link on the same screen

URL prefix

  • Where: Board settings
  • What it does: First part of all board addresses: /board/, /board/c/<category>/, /board/sitemap.xml.
  • Default: board.
  • Values / limits: 1–60 characters: lowercase letters, digits and hyphens, starting with a letter or digit. It cannot match the slug of any existing WordPress post or page, or a reserved word (account, specialist, wp-json, wp-admin, feed, author, category, tag, search). Changing it retires the previous board URLs.
  • When to change it: set it before launch to a word in your site language, for example oholoshennia or marketplace.
  • Related: Search engines (SEO)

Placement rules

  • Where: Board settings
  • What it does: Text of the rules authors must accept when submitting a listing; shown on the form and in the account under Placement rules.
  • Default: empty.
  • Values / limits: plain text (HTML is removed).
  • When to change it: before launch: list forbidden items, photo requirements and how contacts may be used.
  • Related: Board moderation

Keep rejected, withdrawn, removed, sold and expired listings (days after the status changed)

  • Where: Board settings
  • What it does: Daily cleanup deletes such listings (with photos and favorites) this many days after their status changed. Listings kept as moderation evidence (any report, any moderation decision, a rejection reason or recorded contact consent) are never deleted by this cleanup.
  • Default: 90.
  • Values / limits: 1–36500. Pending and hidden listings are not deleted.
  • When to change it: follow your privacy policy, for example 30 days for a strict data-minimisation policy.
  • Related: Data retention

Keep unchanged drafts (days after the last edit)

  • Where: Board settings
  • What it does: Deletes drafts that have not been edited for this many days.
  • Default: 180.
  • Values / limits: 1–36500.
  • When to change it: shorten it if many abandoned drafts collect photos on disk.
  • Related: —

Note: the hint under these two fields says that resolved reports are removed 180 days after resolution. The current code keeps resolved reports as moderation evidence and does not delete them by age.

Delete board data when uninstalling the plugin

  • Where: Board settings
  • What it does: When on, deleting the plugin removes private photos first, then board tables, settings and the timestamps used for daily limits. If some files cannot be removed, data is kept and the removal can be retried after reinstalling.
  • Default: off.
  • Values / limits: on / off.
  • When to change it: only right before you uninstall the board for good.
  • Related: —

Private photo storage

  • Where: Board settings → Private photo storage
  • What it does: Shows the real path of the photo folder and whether it is Ready. You must confirm that the web server cannot serve this folder directly: tick I verified that the web server does not publish this directory through any mapping. and press Confirm web isolation for this path.
  • Default: not confirmed; the folder is expertpress-private/board-photos next to the document root. A developer can choose another absolute path with the expertpress_board_storage_root filter.
  • Values / limits: confirmation is reset when the real path changes. If the configured path changes after photos were stored, the board keeps using the first folder and shows Storage location changed; moving storage is not supported in this version.
  • When to change it: confirm once after installation and again after any change to web server mappings (Alias, location blocks, virtual hosts).
  • Related: Photos per listing

Board categories

Where: ExpertPress → Modules → Board categories.

Categories form a tree up to six levels deep. Switching a category off hides its whole branch. Use Create category, or edit an existing one and press Save category.

Field What it means Limits
Name Shown to visitors and authors. up to 200 characters
Slug (permanent) Part of the category address /board/c/<slug>/. Set once at creation. up to 191 characters
Parent Root category or another category. up to six levels
Position Sort order among siblings; lower first. −100000…100000
Active Off hides the category and all its subcategories with their listings. on / off

Example: create “Home and garden” (root), then “Furniture” and “Tools” with parent “Home and garden”.

Category fields

Where: ExpertPress → Modules → Category fields.

A field belongs to its category and all subcategories. Authors choose a category first, then fill in its fields. New field opens the form; Save field saves; Delete unused field works only while no listing uses it.

Field What it means Limits
Category Where the field applies (and below). required
Slug (permanent, 2–40 lowercase letters, digits or underscores) Internal name; also used by Board Pro CSV import as attr.<slug>. permanent
Type (permanent) text, number, select, multiselect or checkbox. permanent
Label Shown on the form and listing.
Configuration (JSON) Number: {"min":"0","max":"100","step":"0.5"}. Select/multiselect: {"options":[{"key":"red","label":"Red","active":1}]} (keys: lowercase letters, digits, underscore, up to 40). Text and checkbox: {}. option keys are permanent
Position Order on the form.
Required on submission Must be filled before submitting.
Filterable (except text) Offered as a catalogue filter for the category. Up to six filters per category are shown. not for text
Active Off hides the field but keeps saved values.

Text values are limited to 500 characters. To retire a field or an option, switch it off rather than deleting it; existing values are kept during ordinary edits.

Example: under “Cars”, add a number field year with {"min":"1950","max":"2030","step":"1"}, marked filterable.

Board cities

Where: ExpertPress → Modules → Board cities.

Add city, then Save. Delete unused city works only for cities no listing refers to.

Field Limits
Country (ISO alpha-2) for example UA; permanent
Region up to 100 characters; permanent
City name up to 150 characters; permanent
Latitude −90…90; can be corrected later
Longitude −180…180; can be corrected later
Active off excludes the city from selection and radius search; existing listings keep it

To fix a wrong name, create a new city and switch the old one off. Coordinates describe the city centre and are never shown publicly.


Board moderation

Where: ExpertPress → Modules → Board (page title Board moderation).

  • Listing status chooses the queue; it opens on Awaiting moderation.
  • Each item shows the listing with photos, category fields, author account number and a preview link.
  • Reason (required for rejection or removal) is sent to the author.
  • Approve publishes the listing for the publication period. Reject returns it to the author with the reason. Remove takes a listing off the site and closes its open reports; the author gets one removal email.
  • If the author changed the listing while you were reviewing it, your decision is refused; refresh and review again.

Reports

Where: ExpertPress → Modules → Reports.

Report reasons visitors can choose: Prohibited item or service, Suspected fraud, Wrong category, Duplicate listing, Offensive content, Other (details required; up to 1,000 characters).

All open reports for a listing are shown together with the listing version. Dismiss reports closes them and leaves the listing public. Remove listing needs Reason for removal (required when removing), removes the listing and closes the reports. If new reports arrived meanwhile, the decision is refused with a request to refresh.

Unfinished erasure

Where: ExpertPress → Modules → Unfinished erasure.

Closing or deleting an account erases its board data. If files could not be deleted, the account appears here with Files and Attempts counts and the reason. Failed erasures retry daily; after three failures an admin notice appears. After restoring file permissions, press Retry erasure for this account. Verify a former user's identity outside WordPress privacy tools before retrying by account number. The screen also lists Retained privacy erasures and Export reports awaiting deletion.