Modules / Promotion

ExpertPress Promotion

Let specialists pay to be seen first.

PaidPrice at releaseIn testing

ExpertPress Promotion lets specialists pay to be shown in highlighted blocks of your marketplace: the block above the specialists directory, the block above the service catalog, and home-page blocks your theme displays. The site team decides how many seats each block has, which of them are paid, and how seats are sold: at a fixed price per period, or through a recurring auction. Payment, refunds and the money records go through the ExpertPress Payments module; this module never charges anyone by itself.

Key capabilities:

  • Promotion blocks ("places") with a set number of cards, mixing paid seats with free cards chosen by rating, by completed bookings, newcomers and ordinary catalog cards.
  • Fixed-price plans (for example "Profile · 7 days") that specialists buy in their cabinet; when every seat is taken, the purchase is queued to the nearest free date, and buying again extends the display without a break.
  • An optional auction per place: weekly (or other) periods, bids with a minimum price and step, a second-price clearing price, automatic charging of a saved card or invoices, and strikes and temporary bans for winners who do not pay.
  • Automatic pause when the promoted profile or service stops being public, and a "Needs a decision" queue where the team chooses what happens to the unused part.
  • Cancellation by the specialist with a proportional refund of the unused time and an optional fee, plus refunds and early termination by the team.
  • An optional "Sponsored" label on paid cards, impression and click statistics, and counting of booking requests that came from a paid card.
  • Admin reports (revenue reconciled with the money journal, occupancy, impressions and clicks, auctions) with CSV export, a 90-day placement schedule and a read-only paid places check.
  • Ten editable emails to specialists and to the promotion team, and a button that pauses all new sales at once.
  • Promotion of shop products and board listings when the ExpertPress Shop or ExpertPress Board modules are installed.

On this page

Related pages:

  • Settings and admin screens: every tab and option of ExpertPress → Promotion.
  • Campaigns: places, plans, buying, the queue, pauses, cancellation, refunds and manual campaigns.
  • Auctions: periods, bids, closing, payment, invoices, strikes and unsold seats.
  • Statistics, requests and revenue: impressions, clicks, attributed booking requests, reports, CSV and the paid places check.

Requirements

  • ExpertPress (core plugin) installed and active. The module declares Requires Plugins: expertpress, expertpress-payments, so WordPress activates it only after both. If the core is missing at activation, activation stops with "ExpertPress Promotion requires ExpertPress." If the core is too old for this module, the module turns itself off and shows an admin notice asking you to update ExpertPress.
  • ExpertPress Payments installed and active, with its online money engine working. Without it the module is inert: nothing is sold, no paid cards are shown, scheduled tasks skip, and the Promotion screen shows "Promotion is unavailable: it needs an active payment module." (Просування недоступне: потрібен активний платіжний модуль.)
  • WordPress 6.0 or later; PHP 7.4 or later.
  • A MySQL or MariaDB database with InnoDB tables. The module creates its own tables on activation; if they cannot be created as InnoDB, activation stops with "ExpertPress Promotion requires InnoDB tables for its schema."
  • WordPress scheduled tasks (WP-Cron or a server cron) must run. Campaign starts and ends, pauses, auction creation and closing, invoice deadlines, statistics and emails are processed by scheduled tasks (most of them hourly).
  • Third-party services: none of its own. The module makes no direct payment or fiscal network calls. Card payments, saved cards for auction auto-charge, receipts and refunds depend on the payment provider configured in ExpertPress Payments. Real money moves only when that module is connected to a real provider with live credentials; this module has no credential fields.
  • Optional: ExpertPress Shop (product promotion; Shop itself needs WooCommerce) and ExpertPress Board (board listing promotion from the client account). Without them, only specialist profiles and services can be promoted.

What changes on the site

Catalog and home page

The ExpertPress core already has "places": blocks of cards above the specialists directory and the service catalog, and home-page blocks. Without this module those blocks contain only free cards (by rating, by completed bookings, newcomers and ordinary catalog cards; see The public site and Ratings and reviews). The module adds:

  • Paid seats in each place. Paid cards are placed first, then the free sources fill the remaining seats.
  • A label on paid cards, if you turn on Paid placement label for the place (for example "Sponsored" or "Ad").
  • Counting of impressions and clicks on paid cards, and of booking requests that follow a click.

The built-in places are:

Place (admin label) Ukrainian label Shows Public display
Specialists directory · block above the list Каталог спеціалістів · блок над списком specialist profiles Shown by the core directory at /specialists/
Services directory · block above the list Каталог послуг · блок над списком services Shown by the core catalog at /services/
Home · specialists Головна · спеціалісти specialist profiles Only if your theme renders it
Home · popular services Головна · популярні послуги services Only if your theme renders it
Products on the home page, Shop catalog top Товари на головній, Верх каталогу магазину products With ExpertPress Shop and a theme or module that renders them
Board catalog · block above the list Каталог дошки · блок над списком board listings With ExpertPress Board

A place is sold only while a public page actually displays it. If no page displays a place, its settings show "This place has no available public display. New purchases and bids are blocked." and the place cannot be bought. A theme or module that renders a place declares it to the module; the core catalogs do this on their own as long as the catalog lists use the plugin's standard display.

By default paid cards in the directory and catalog blocks appear only on the first page of the list (see Paid cards on the first catalog page only in Settings).

Booking flow

Promotion does not change the booking flow. A client who clicks a paid card goes to the ordinary profile or service page and books as usual (request → specialist confirms → payment → session → review; see The booking flow). The module only records that the request came after a click on a paid card, so the specialist can see how many requests and paid bookings the promotion brought. See Statistics, requests and revenue.

Cabinets

  • Specialist cabinet: a new Promotion (Просування) tab at /specialist/promotion/, and a short line about active promotion on the cabinet overview.
  • Client account: a Promotion tab at /account/promotion/. It appears in the menu only when the site offers something a client can promote (for example board listings with ExpertPress Board); the page itself stays reachable so that payment returns and earlier campaigns keep working.
  • Account settings: specialists can turn off promotion reminder emails (see Emails).

Admin

A Promotion (Просування) item in the Modules group of the ExpertPress admin app, with the tabs Campaigns, Placement schedule, Auctions, Reports, Plans, Placements, Paid places reconciliation, Rules and Auction settings. Its counter shows how many paused campaigns wait for a decision. A Classic Promotion button opens the same functions on a classic WordPress admin page. See Settings and admin screens.

The module also adds a "Paid promotion" line to the core setup checks, its emails to the core email list, and four entries to the core data retention settings.

What each person sees

Client (visitor)

  • Paid cards in the blocks above the specialists directory and the service catalog (and on the home page if the theme shows those blocks), mixed with free cards. Paid cards carry the place's label if the team turned it on.
  • Nothing else changes: the cards open the same profile and service pages, and booking works the same way.
  • The site may set two technical cookies: ep_promo_lead after a click on a paid card (lasts for the request-counting window, 7 days by default) and ep_promo_vid only if the team turned on repeated-impression or repeated-click merging. Mention them in your cookie notice if you list cookies.

Specialist

On the Promotion tab of the specialist cabinet:

  • an introduction and a How it works (Як це працює) note, both editable by the team;
  • Current promotion (Поточне просування): each campaign with its status (Awaiting payment, Scheduled, Active, Paused, Ended, Canceled, Terminated), period, impressions, clicks, requests and paid requests, a day-by-day view, receipts, and a Cancel promotion (Відмовитися) button where cancellation is allowed;
  • Buy promotion (Оформити просування), or Extend or add (Продовжити або додати) when a promotion already runs: What to show (the profile or one of the published services), Duration (the active plans with their price and the date the display would end), and the payment button (Pay by card, or Pay from balance (…) when the team allows it);
  • the purchase conditions and whether each is met (approved profile in the catalog, verified payment details if required, no reliability restriction if required);
  • the Auction section for places sold by auction: open periods, the entry price and step, the current bid, bid buttons, Open invoices (Відкриті рахунки), My auctions (Мої аукціони) and the Automatic charge card (Картка автосписання) settings;
  • History (Історія) of earlier campaigns.

Specialists receive emails when a promotion is paid, starts, is about to end, ends or is ended by the team, when they are outbid or win an auction seat, and when their profile or service enters a top block for free. See Emails.

Site owner and team

  • The Promotion admin screen with campaigns, the decision queue, schedule, auctions, reports, plans, places, rules and auction settings.
  • A notice on Promotion screens with Pause sales (Призупинити продаж) / Resume sales (Відновити продаж). While sales are paused, new purchases and auction bids are refused; campaigns that are already paid keep running.
  • Emails to the promotion team about new purchases and about paused campaigns that need a decision.
  • Which team members can do what is set in Rules → Permissions; see Permissions.

Before you start selling

After activation nothing is for sale: every built-in place has 0 paid seats and there are no plans. To start:

  1. Make sure ExpertPress Payments is active and its payment provider is set up; the specialist sees "Payment is off: the payment provider is not set up." otherwise.
  2. In Promotion → Placements, give a place Paid slots and check Max concurrent paid (M) (it is set to the paid slots automatically the first time you add paid slots). Click Save placements.
  3. For fixed-price places, add at least one enabled plan of the matching type in Promotion → Plans (for example "Profile, 7 days"). For auction places, set the mode to Auction and a minimum price in Promotion → Auction settings.
  4. Optionally adjust texts, emails, refund and pause rules in Promotion → Rules.
  5. Check the core setup checklist: the "Paid promotion" line turns green when at least one place sells and nothing blocks it. Otherwise it explains what is missing (for example "No place sells paid promotion yet: give a place paid seats and concurrent seats (M).").

Uninstalling

Deleting the plugin removes its own database tables (campaigns, plans, auctions, statistics and the related records). When the ExpertPress setting to delete all data on uninstall is on, it also removes the module's settings, queues, scheduled tasks and saved-card auction permissions. Bookings and the money records kept by the core and the payment module are not removed by this module.