Module · Promotion
Promotion: settings and admin screens
Where: ExpertPress → Promotion (Просування), in the Modules group of the admin app. The same functions are on the classic WordPress page ExpertPress → Promotion; the Classic Promotion (Класичне Просування) button on the Plans and Reports tabs opens it.
The screen has these tabs. You see only the tabs your permissions allow.
| Tab | Ukrainian label | What it is for | Described in |
|---|---|---|---|
| Campaigns | Кампанії | List of campaigns, the "Needs a decision" queue, manual campaigns, campaign details | Campaigns |
| Placement schedule | Розклад місць | Paid seat occupancy per place for the next 90 days | Campaigns |
| Auctions | Аукціони | Auction periods, bids, outcomes, diagnostics | Auctions |
| Reports | Звіти | Revenue by period and by plan, CSV | Statistics, requests and revenue |
| Plans | Тарифи | Fixed-price plans | Plans on this page |
| Placements | Місця показу | Seats and sources of every place | Placements on this page |
| Paid places reconciliation | Звірка платних місць | Read-only check of paid places | Statistics, requests and revenue |
| Rules | Правила | Texts, emails, permissions, refunds, pauses, order and limits, purchase conditions, statistics | Rules on this page |
| Auction settings | Налаштування аукціону | Mode of each place, minimum prices, auction periods and rules | Auction settings on this page |
Who can use what
Access is controlled per action in Rules → Permissions (see Permissions). With the default matrix:
| What | Default access |
|---|---|
| Open Promotion, see campaigns, schedule and auctions | expertpress_operate, expertpress_moderate or expertpress_manage_money |
| Plans, Placements, Rules, Auction settings, manual campaigns, non-money pause decisions, ending campaigns, closing an auction early | expertpress_operate (ExpertPress Manager, administrators) |
| Refunds, money pause decisions, Reports and CSV | expertpress_manage_money (ExpertPress Accountant, ExpertPress Manager, administrators) |
| Cancel with refunds for an auction | both the Refunds and the End campaign permission |
| Pause sales / Resume sales | the Rules permission |
The Plans, Placements, Rules and Auction settings tabs are also visible, read-only, to staff with money access. No option of this module is restricted to WordPress administrators only, and none of them needs payment provider credentials. See Roles and access.
How saving works
- Placements, Rules and Auction settings each have their own save button: Save placements (Зберегти місця), Save rules (Зберегти правила), Save auction settings (Зберегти налаштування аукціону). The page then shows "Saved."
- The three forms share one revision counter. If another administrator saved any of them after you opened the page, your save is refused with "Another administrator changed the settings. Refresh the page." Nothing is saved; reload and repeat your change.
- Numbers outside the allowed range are not refused; they are quietly moved to the nearest allowed value.
- Some changes are refused while campaigns depend on the current value, for example lowering paid seats below the number of campaigns that occupy them, or switching an auction place to another mode while unpaid auction seats or open bids depend on it. The message names the place and what to wait for.
- A site plugin can change the built-in defaults of the Rules and Placements forms. The defaults below are those of the module itself.
Sales stop
Pause sales / Resume sales
- Where: a notice at the top of every Promotion screen ("Promotion sales are open." with Pause sales (Призупинити продаж); while paused, the notice is shown on every admin screen with Resume sales (Відновити продаж)).
- What it does: Stops all new promotion sales at once. While paused, new purchases and auction bids are refused with "Promotion sales are temporarily paused. Paid promotion keeps running. Try again later." Campaigns already paid keep showing.
- Default: sales open.
- Values / limits: open / paused. Needs the Rules permission.
- When to change it: pause while you change prices or places; pause while a payment provider problem is being solved; pause before switching a place between fixed price and auction.
- Related: Placements, Auction settings
Placements
Where: ExpertPress → Promotion → Placements (Місця показу). One panel per place. The panel title is the place name (see the table of places in the Overview). Saved with Save placements.
A place has N cards (Slots in the block (N)). They are filled in this order: paid campaigns (up to Paid slots), then By rating, By bookings and Newcomers, then Organic / fill. If the sources add up to less than N and Fill with organic cards is on, the rest is filled with ordinary catalog cards.
Built-in defaults:
| Place | On | N | Min. cards | Paid | M | Organic | Cards per row |
|---|---|---|---|---|---|---|---|
| Home · specialists | on | 10 | 1 | 0 | 0 | 10 | 5 |
| Specialists directory · block above the list | on | 5 | 3 | 0 | 0 | 5 | 5 |
| Services directory · block above the list | on | 5 | 3 | 0 | 0 | 5 | 5 |
| Home · popular services | on | 8 | 1 | 0 | 0 | 8 | 8 |
| Products on the home page, Shop catalog top (with Shop) | on | 0 | 0 | 0 | 0 | 0 | 0 |
| Board catalog · block above the list (with Board) | off | 4 | 1 | 4 | 4 | 0 (no organic fill) | 4 |
In all places Paid placement label is off, Fill with organic cards is on (except the board place and places whose type has no free sources), By rating, By bookings and Newcomers are 0, and Rows on desktop (services) is 1.
Under a place you may see hints: "The sources add up to less than N; available slots will be filled with organic cards or by rating.", "Fill up the block or choose who to show in the free slots.", "The number of slots does not match the theme grid…", or a warning that the place has no public display or no active plan. Fix these before selling the place.
On
- Where: ExpertPress → Promotion → Placements → a place panel (checkbox On; Увімкнено)
- What it does: Turns the place on. A place that is off shows no block and sells nothing; its paid capacity counts as zero.
- Default: on for the four core places and the shop places; off for the board place.
- Values / limits: on / off. Turning a place off is refused while campaigns occupy its paid seats ("…Wait for them to end or stop them before reducing paid capacity or disabling this place.").
- When to change it: turn off a home block your theme does not show; turn on the board place when you start selling board promotion.
- Related: Paid slots, Mode
Block title
- Where: same panel (Block title (Назва блоку); with several site languages, one field per language: Block title (language))
- What it does: The heading of the block on the public page. Each language has its own field; an empty per-language title falls back to the default title.
- Default: empty: the theme or the core uses its own heading.
- Values / limits: plain text.
- When to change it: "Recommended specialists" above the directory; "Top services this week" above the catalog; a translated heading for a second site language.
Paid placement label
- Where: same panel (checkbox Paid placement label; Позначка про платне розміщення)
- What it does: Shows a label on paid cards of this place.
- Default: off.
- Values / limits: on / off.
- When to change it: turn it on where your market or your own policy expects advertising to be marked; turn it on for the home page but leave it off in a block already titled "Sponsored".
- Related: Label text, Default "Sponsored" label
Label text (e.g. "Ad")
- Where: same panel (Label text (e.g. “Ad”); Текст позначки (напр. «Реклама»))
- What it does: The text of the label on paid cards of this place.
- Default: empty: the Default “Sponsored” label from Rules is used ("Sponsored" if that is empty too).
- Values / limits: plain text. Used only when Paid placement label is on.
- When to change it: "Ad", "Promoted", "Partner".
Slots in the block (N)
- Where: same panel (Slots in the block (N); Місць у блоці (N))
- What it does: The total number of cards in the block, paid and free together.
- Default: see the table above.
- Values / limits: 0–50. A hint shows the number of cards your theme fits into a desktop row; a mismatch is shown as a warning.
- When to change it: match the theme grid (for example 4 or 8 cards); raise it on a large directory; lower it on a small site where the block would repeat the list below.
Min. cards to show the block
- Where: same panel (Min. cards to show the block; Мін. карток для показу блоку)
- What it does: A block made only of free cards is hidden when it would have fewer cards than this. A block that contains a paid card is always shown.
- Default: see the table above.
- Values / limits: 0 to N. 0 shows the block whenever it has at least one card.
- When to change it: raise it so a half-empty "top" block does not look odd on a young site.
Paid slots
- Where: same panel (Paid slots; Платні місця)
- What it does: How many of the N cards can be paid cards. 0 means the place sells nothing.
- Default: 0 (4 for the board place).
- Values / limits: 0–50. The paid cards actually shown never exceed N. Lowering it is refused while more campaigns occupy the place. For Home · popular services the field is locked to 0 while “Popular services” with paid placements is off in Rules ("0 (off; enable in Rules → Order and limits)").
- When to change it: 2 paid seats out of 5 above the directory; 3 out of 10 on the home page; 0 to stop selling a place once its running campaigns end.
- Related: Max concurrent paid (M)
Max concurrent paid (M)
- Where: same panel (Max concurrent paid (M); Макс. одночасних платних (M))
- What it does: How many campaigns may run at the same time on this place. Purchases beyond it are queued to the nearest date when a seat frees. For fixed-price sales, a campaign shows in every fixed-price place of its type, so the queue of a type uses the smallest M among those places.
- Default: 0. The first time you give a place paid slots while M is still 0, M is set to the number of paid slots on save.
- Values / limits: 0 to the smaller of Paid slots and N. An explicit 0 while paid slots are set stops new sales on the place. Lowering it is refused while more campaigns run or wait on the place.
- When to change it: keep M equal to paid slots so every paying specialist is always visible; set M lower than paid slots to leave room for rotation; set 0 to stop selling while keeping paid seats for running campaigns.
- Related: Paid card order, Placement schedule
By rating
- Where: same panel (By rating; За оцінками)
- What it does: Free seats filled with the best-rated profiles or services, using the core rating settings.
- Default: 0.
- Values / limits: 0–50.
- When to change it: reserve 2 seats for the best-rated specialists above the directory.
- Related: Ratings and reviews
By bookings
- Where: same panel (By bookings; За записами)
- What it does: Free seats filled by the number of completed sessions over the period set in the core rating settings.
- Default: 0.
- Values / limits: 0–50.
- When to change it: reward specialists who actually hold sessions, not only those with good ratings.
Newcomers
- Where: same panel (Newcomers; Новачки)
- What it does: Free seats for newcomers, as defined in the core rating settings (a recent profile or few reviews).
- Default: 0.
- Values / limits: 0–50. Specialists listed in Manual newcomers (IDs) use these seats first.
- When to change it: give new specialists a chance to be seen in the first months.
- Related: Manual newcomers (IDs)
Organic / fill
- Where: same panel (Organic / fill; Неоплачені картки / заповнення)
- What it does: Free seats filled with ordinary catalog cards.
- Default: see the table above.
- Values / limits: 0–50.
Fill with organic cards
- Where: same panel (checkbox Fill with organic cards; Заповнювати неоплаченими картками)
- What it does: When the sources above give fewer cards than N, the remaining seats are filled with ordinary catalog cards. When off, the block can be shorter than N.
- Default: on (off for the board place).
- Values / limits: on / off.
- When to change it: turn it off for a block that should show only paid or only selected cards.
Rows on desktop (services)
- Where: same panel (Rows on desktop (services); Рядків на ПК (послуги))
- What it does: A layout hint for themes that show the block in several rows. The module stores it; whether it changes the layout depends on your theme.
- Default: 1.
- Values / limits: 1–4.
Cards per row (desktop)
- Where: same panel (Cards per row (desktop); Карток у ряд (ПК))
- What it does: How many cards your theme shows in one desktop row. Used for the grid hint and the "does not match the theme grid" warning.
- Default: see the table above.
- Values / limits: 0–24. 0 means unknown.
Manual newcomers (IDs)
- Where: same panel (Manual newcomers (IDs); Новачки вручну (ID))
- What it does: IDs you want shown in the Newcomers seats first: specialist IDs in specialist places, service IDs in service places. They use up the newcomer seats; the rest is chosen automatically.
- Default: empty.
- Values / limits: numbers separated by commas, spaces or semicolons.
- When to change it: feature a few new specialists you onboarded yourself for their first weeks.
Plans
Where: ExpertPress → Promotion → Plans (Тарифи). A plan is what a specialist buys at a fixed price: a type, a number of days and a price. Without at least one enabled plan of a type, fixed-price places of that type sell nothing (the place shows "This fixed-price paid place sells nothing: no active plan exists for …").
The table lists ID, Type, Days, Price, Enabled, Version and actions Edit and Turn off. The form below adds a New plan or edits the chosen one; it is saved with Save plan (Зберегти тариф). Plans are never deleted, only turned off. Editing the type, days or price raises the plan's Version; campaigns already bought keep the days and price they were bought with.
Type
- Where: ExpertPress → Promotion → Plans → plan form (Type)
- What it does: What the plan promotes: Profile, Service, and, with the matching modules, Product or Board listing.
- Default: the first type in the list.
- Values / limits: required ("Choose the type: profile, service, or product.").
- When to change it: create separate plans for profiles and services; profile promotion shows in specialist places, service promotion in service places.
Days
- Where: same form (Days; Строк у днях)
- What it does: How long the display lasts after it starts. The clock counts only time the campaign is actually shown (see pauses in Campaigns).
- Default: 7.
- Values / limits: 1–3660 ("The duration must be between 1 and 3,660 days.").
- When to change it: offer 7, 14 and 30 days as three plans with a lower price per day for longer periods.
Price
- Where: same form (Price; Ціна)
- What it does: The price of the plan, in the shop currency set in the payment module.
- Default: none; required.
- Values / limits: an exact amount greater than zero, with no more decimals than the currency has (for example 10 or 10.50). Errors: "Enter a price.", "The price must be greater than zero."
- When to change it: raise prices when the place is always fully booked; run a lower-priced 3-day plan to let specialists try promotion.
Enabled
- Where: same form (checkbox Enabled; Активний), and the Turn off (Вимкнути) button in the list
- What it does: Only enabled plans are offered in the specialist cabinet.
- Default: on for a new plan.
- Values / limits: on / off. Turning off asks "Turn off the plan?"; running campaigns are not affected.
- When to change it: replace an old price by adding a new plan and turning off the old one.
Rules
Where: ExpertPress → Promotion → Rules (Правила). One form with several sections, saved with Save rules. Empty texts keep the built-in wording.
Currency and brand
The section first shows the Shop currency (Валюта магазину), taken from the payment module's money settings. All promotion prices use it; it cannot be changed here.
Brand name
- Where: ExpertPress → Promotion → Rules → Currency and brand (Brand name; Назва бренду)
- What it does: The name used in promotion texts (
{brand}in texts and emails). - Default: empty: the core brand name (Settings → General), then the site title.
- Values / limits: plain text.
- When to change it: your marketplace uses a different name for its advertising service.
- Related: General settings
Dashboard intro
- Where: same section (Dashboard intro; Вступний текст кабінету)
- What it does: The first paragraph of the specialist's Promotion tab.
- Default: empty: "Reach more clients: paid placements in the “{brand} recommendations” block on the home page and in catalogs."
- Values / limits: plain text;
{brand}or{site}is replaced with the brand name. - When to change it: your theme does not show home-page blocks, so mention only the catalogs; explain who your typical clients are.
"How it works" heading
- Where: same section (“How it works” heading; Заголовок «Як це працює»)
- What it does: Heading of the explanation box in the specialist's Promotion tab.
- Default: empty: "How it works".
- Values / limits: plain text.
"How it works" text
- Where: same section (“How it works” text; Текст «Як це працює»)
- What it does: The explanation shown under that heading.
- Default: empty: "Display lasts for the whole paid period. If no places are free right now, the start is queued from the nearest date. Buying again for the same profile or service extends the display without a break."
- Values / limits: plain text.
- When to change it: add your own cancellation terms or a link to your advertising rules.
Payment hint
- Where: same section (Payment hint; Підказка оплати)
- What it does: A short note next to the payment buttons in the cabinet.
- Default: empty: "Card payment. This is a {brand} service — the receipt will come from the service."
- Values / limits: plain text;
{brand}or{site}is replaced. - When to change it: state who issues the receipt on your site, or that balance payment is possible.
Default "Sponsored" label
- Where: same section (Default “Sponsored” label; Підпис «Реклама» за замовчуванням)
- What it does: The label on paid cards for every place that has Paid placement label on but no Label text of its own.
- Default: empty: "Sponsored".
- Values / limits: plain text.
- When to change it: "Ad", "Promoted".
Receipt title template (profile)
- Where: same section (Receipt title template (profile); Шаблон назви в чеку (профіль))
- What it does: The name of a profile promotion purchase in the payment and on its receipt.
- Default: empty: "Profile promotion · {days} days".
- Values / limits: plain text with placeholders
{days},{subject},{brand}. - When to change it: your receipts must name the service in a specific way, for example "{brand} advertising: profile, {days} days".
Receipt title template (service)
- Where: same section (Receipt title template (service); Шаблон назви в чеку (послуга))
- What it does: The same for service promotion.
- Default: empty: "Service promotion “{subject}” · {days} days".
- Values / limits: plain text with
{days},{subject},{brand}.
Pause and balance payment
Pause actions
- Where: ExpertPress → Promotion → Rules → Pause and balance payment (one checkbox per action)
- What it does: Which decisions the team can take for a paused campaign in the Needs a decision queue:
- Pause display (the end date shifts) (Заморозити показ (строк зсувається)): keep the campaign paused; it continues when the profile or service is public again, and its end date moves by the paused time.
- Refund money (unused part) (Повернути гроші (невикористана частина)): refund the unused part and terminate the campaign. If the payment provider confirms refunds later, the campaign is terminated after the confirmation.
- Place funds on hold (held by the platform) (Заморозити гроші (тримає майданчик)): terminate the campaign without a refund; the platform keeps the money and the unused amount is recorded in the campaign log. Not available for auction seats.
- Apply to debt (the unused part pays off the debt) (Зарахувати в погашення боргу (невикористана частина гасить борг)): use the unused part to pay off the specialist's debt to the platform and terminate the campaign.
- Default: all four on.
- Values / limits: any combination, including none. The refund and debt actions also need the Refunds permission.
- When to change it: turn off Apply to debt if your site does not track specialist debts; leave only Pause display and Refund money for a simple policy.
- Related: Pauses
Allow paying for promotion from the available balance
- Where: same section (checkbox Allow paying for promotion from the available balance; Дозволити оплату просування з доступного балансу)
- What it does: Lets specialists pay for a plan from their available balance on the platform (Pay from balance (…) in the cabinet) instead of by card.
- Default: off.
- Values / limits: on / off. Available only when the payment module's money settings allow paying for purchases from the balance; otherwise the section says "Off: the Core balance offset clause for paying for purchases from the balance is not enabled (Money → settings)." and the option stays off.
- When to change it: specialists earn on the platform and prefer to spend part of their earnings on promotion.
Emails
The module sends ten emails. Each has its own panel with On, Subject and Body; empty subject and body keep the built-in letter. The same emails also appear in the core list under Settings → Email templates; once an email's on/off switch has been saved there, that switch is the one that counts.
| Email (admin label) | Ukrainian label | Sent to | When |
|---|---|---|---|
| Paid (to the specialist) | Оплачено (спеціалісту) | specialist | payment for a campaign is received |
| Display started (to the specialist) | Старт показу (спеціалісту) | specialist | a paid campaign starts showing |
| Ending soon (to the specialist) | Скоро закінчиться (спеціалісту) | specialist | N days before the end (see below) |
| Ended (to the specialist) | Завершено (спеціалісту) | specialist | the campaign has ended |
| New purchase (to the team) | Нова покупка (команді) | promotion team | a specialist bought a campaign |
| Paused — decision needed (to the team) | Пауза — потрібне рішення (команді) | promotion team | a campaign is paused and waits for a decision |
| Ended by the team (to the specialist) | Припинено командою (спеціалісту) | specialist | the team terminated the campaign |
| Outbid in an auction (to the specialist) | Перебито в аукціоні (спеціалісту) | specialist | someone outbid the specialist's bid |
| Won auction seat — pay the invoice (to the specialist) | Вигране місце аукціону — оплатіть рахунок (спеціалісту) | specialist | an auction seat was won and must be paid by invoice |
| Entered a top placement (to the specialist) | Потрапляння в топ (спеціалісту) | specialist | the profile or service entered a block for free (by rating, by bookings or as a newcomer) |
Placeholders available in subjects and bodies: {specialist}, {subject}, {start}, {end}, {amount}, {deadline}, {pay}, {reason}, {headline}, {site}, {brand}, {cabinet}, {admin}, {ending_days}, {campaign}. A template with an unknown placeholder is not saved; the previous text of that email is kept.
The reminder emails (ending soon, outbid, entered a top placement) contain a Turn off promotion reminder emails link, and specialists can switch them back on in their account settings. Emails about purchases, payments, refunds and team actions are always sent.
Email on/off, Subject, Body
- Where: ExpertPress → Promotion → Rules → Emails → one panel per email (On, Subject, Body)
- What it does: Turns the email on or off and replaces its subject and text.
- Default: every email on; subject and body empty (built-in text).
- Values / limits: subject is plain text; body is plain text with line breaks; placeholders as listed above.
- When to change it: turn off "New purchase (to the team)" if the team checks the Campaigns tab daily anyway; rewrite the invoice email to explain your payment deadline.
- Related: Email templates
Promotion team addresses
- Where: same section (Promotion team addresses; Адреси команди просування)
- What it does: Where the two team emails go.
- Default: empty: the core complaints address, then the WordPress administrator email.
- Values / limits: email addresses separated by commas or new lines.
- When to change it: send purchase and pause notices to a sales or advertising mailbox instead of support.
"Ending soon" N days before
- Where: same section (“Ending soon” N days before; «Скоро закінчиться» за N днів)
- What it does: How many days before the end the "Ending soon" email is sent. The number is also inserted into
{ending_days}. - Default: 2.
- Values / limits: 1–30.
- When to change it: 3–5 days for long plans, so specialists have time to extend without a gap.
Top placement mail cooldown (days)
- Where: same section (Top placement mail cooldown (days); Мінімальний інтервал між листами про потрапляння в топ (дні))
- What it does: A specialist gets at most one "Entered a top placement" email per place and per profile or service within this many days, even if the card leaves and re-enters the block. Paid seats use the "Display started" email instead.
- Default: 7.
- Values / limits: 1–90.
- When to change it: raise it on a site where free blocks change often, so specialists are not flooded.
Permissions
Where: ExpertPress → Promotion → Rules → Permissions (Права). One drop-down per action. Each action can be given to one of: OPERATE (manager) (expertpress_operate), MODERATE (moderator) (expertpress_moderate), MONEY (accountant) (expertpress_manage_money), BOOKINGS (view bookings) (expertpress_view_bookings); the viewing action also offers OPERATE or MODERATE or MONEY. WordPress administrators have all of them.
| Action | Ukrainian label | Default | What it covers |
|---|---|---|---|
| View campaigns / schedule | Перегляд кампаній / розкладу | OPERATE or MODERATE or MONEY | opening Promotion, the Campaigns, Placement schedule and Auctions tabs |
| Plans | Тарифи | OPERATE | the Plans tab |
| Placements | Місця показу | OPERATE | the Placements tab (and the Paid places reconciliation tab) |
| Rules / settings | Правила / налаштування | OPERATE | the Rules and Auction settings tabs, Pause sales |
| Manual campaign | Ручна кампанія | OPERATE | creating free manual campaigns |
| Pause actions (non-monetary) | Дії при паузі (не грошові) | OPERATE | the decisions that do not move money |
| End campaign | Припинення кампанії | OPERATE | terminating campaigns, closing an auction early |
| Refunds | Повернення коштів | MONEY | refunds, money pause decisions |
| Reports / CSV | Звіти / CSV | MONEY | the Reports tab and CSV export |
- When to change it: give View campaigns / schedule to BOOKINGS for a support person who answers specialists' questions; give Reports / CSV to OPERATE if your manager has no accountant; keep Refunds with MONEY when only the accountant may move money.
- Related: Roles and access
Withdrawal and refund
Withdrawal fee, %
- Where: ExpertPress → Promotion → Rules → Withdrawal and refund (Withdrawal fee, %; Комісія при відмові, %)
- What it does: When a specialist cancels a campaign that has already been shown, this percentage is kept from the refund of the unused part. Cancelling before the first display always refunds the full amount.
- Default: 0 (full proportional refund).
- Values / limits: 0–100.
- When to change it: 10% to discourage short trial runs that block seats for others.
Allow the specialist to withdraw from an active campaign
- Where: same section (checkbox Allow the specialist to withdraw from an active campaign; Дозволити спеціалісту відмовитися від активної кампанії)
- What it does: When on, the specialist can cancel a campaign after it has started (with a refund of the unused part). When off, Cancel promotion is available only before the first display.
- Default: on.
- Values / limits: on / off.
- When to change it: turn it off if your terms say a started promotion is not refundable.
Calculation step
- Where: same section (Calculation step; Крок розрахунку)
- What it does: The unit in which the unused part is measured: the unused time divided by the paid time, counted in whole seconds, hours or days.
- Default: Second (Секунда).
- Values / limits: Second, Hour (Година), Day (День). With hours or days, partly used units count as used.
- When to change it: Day if your terms promise refunds only for whole unused days.
Rounding
- Where: same section (Rounding; Округлення)
- What it does: How the calculated refund amount is rounded.
- Default: Down (Вниз).
- Values / limits: Down; Half up (До найближчого значення; половину — вгору); To a whole currency unit (До цілої одиниці валюти) rounds up to the next whole unit, never above the price.
- When to change it: To a whole currency unit if you prefer refunds without cents.
Pause and unpaid requests
Grace period before pause (minutes)
- Where: ExpertPress → Promotion → Rules → Pause and unpaid requests (Grace period before pause (minutes); Затримка перед призупиненням показу (хвилини))
- What it does: When a promoted profile or service stops being public (for example unpublished or removed from search), the campaign is paused only after this delay. If the profile or service is public again before then, nothing happens. Deleted subjects, a change of owner and a shop that cannot confirm a product pause at once regardless.
- Default: 0 (pause immediately).
- Values / limits: 0–10080 (7 days).
- When to change it: 30–60 minutes so a specialist who edits and re-submits a service for moderation does not lose display time to a pause.
Automatic action after N days of pause
- Where: same section (Automatic action after N days of pause; Автодія після N днів паузи)
- What it does: After a campaign has waited this many days in the decision queue, the Automatic action is applied.
- Default: 0 (no automatic action).
- Values / limits: 0–365.
- When to change it: 14 days so forgotten pauses do not stay open for months.
Automatic action
- Where: same section (Automatic action; Автодія)
- What it does: What happens after that number of days.
- Default: None (Немає).
- Values / limits: None, Refund the unused part (Повернути невикористане), End without a refund (Припинити без повернення).
- When to change it: Refund the unused part for a client-friendly policy; End without a refund only if your terms allow it.
Unpaid request lifetime (hours)
- Where: same section (Unpaid request lifetime (hours); Строк дії неоплаченої заявки (години))
- What it does: A purchase that stays Awaiting payment longer than this is cancelled automatically (an unpaid auction seat is settled the same way as a cancellation before payment).
- Default: 0 (never cancelled automatically).
- Values / limits: 0–8760.
- When to change it: 24 hours so abandoned checkouts do not hold queue positions.
Order and limits
Paid card order
- Where: ExpertPress → Promotion → Rules → Order and limits (Paid card order; Порядок платних карток)
- What it does: The order of paid cards inside a block.
- Default: By start date (За датою старту).
- Values / limits: By start date, Random (Випадково), Daily rotation (Ротація по днях).
- When to change it: Daily rotation when there are more paid cards than fit in one row, so no specialist is always last.
Queued campaigns per item limit
- Where: same section (Queued campaigns per item limit; Ліміт кампаній у черзі на обʼєкт)
- What it does: How many purchases may wait (awaiting payment or scheduled) for one profile or service. Extending a running campaign counts as a queued purchase.
- Default: 0 (no limit).
- Values / limits: 0–100. Over the limit, the purchase is refused with "The campaign queue limit for this subject has been reached."
- When to change it: 2, so one specialist cannot book the place months ahead.
Queue horizon (days)
- Where: same section (Queue horizon (days); Максимальний строк очікування в черзі (дні))
- What it does: A purchase is refused if the nearest possible start is further away than this.
- Default: 0 (no limit).
- Values / limits: 0–3650.
- When to change it: 30 days, so specialists do not pay today for a display that starts in three months.
Campaign start
- Where: same section (Campaign start; Старт кампанії)
- What it does: Aligns the start of a new campaign.
- Default: Immediately (as calculated) (Одразу (як пораховано)).
- Values / limits: Immediately (as calculated), From the next hour (З наступної години), From the start of the day (З початку дня, in the site time zone).
- When to change it: From the start of the day so periods are easy to explain ("from Monday to Sunday").
Paid cards on the first catalog page only
- Where: same section (checkbox Paid cards on the first catalog page only; Платні лише на першій сторінці каталогу)
- What it does: Paid cards in the blocks above the specialists directory and the service catalog appear only on the first page of the list. Home-page places are not affected.
- Default: on.
- Values / limits: on / off.
- When to change it: turn it off to show paid cards on every page of a long catalog.
"Popular services" with paid placements
- Where: same section (checkbox “Popular services” with paid placements; «Популярні послуги» з платними місцями)
- What it does: Allows paid seats in Home · popular services. When off, that place has 0 paid seats and its paid fields are locked.
- Default: on (the place itself still starts with 0 paid slots).
- Values / limits: on / off. Turning it off is refused while campaigns occupy paid seats there.
- When to change it: turn it off if the home "popular services" block must stay purely organic.
Purchase conditions
Verified payout details required
- Where: ExpertPress → Promotion → Rules → Purchase conditions (checkbox Verified payout details required; Обовʼязкові перевірені реквізити)
- What it does: Only specialists with verified payout details in the payment module can buy promotion ("Verified payout details are required (Finances section).").
- Default: off.
- Values / limits: on / off.
- When to change it: turn it on so refunds and receipts can always be matched to a verified person.
Block when a yellow card is active
- Where: same section (checkbox Block when a yellow card is active; Блокувати при жовтій картці)
- What it does: Specialists under an active reliability restriction cannot buy new promotion ("While a reliability yellow card is in effect, you cannot buy new promotion."). Running campaigns are not stopped.
- Default: off.
- Values / limits: on / off. Has an effect only when a reliability module issues such restrictions.
- When to change it: turn it on so unreliable specialists are not pushed to the top.
Profile must be in the catalog
- Where: same section (checkbox Profile must be in the catalog; Профіль має бути в каталозі)
- What it does: Only specialists with a published profile, at least one published service and a profile not removed from search can buy ("You need a published profile, at least one published service, and a profile that has not been removed from search.").
- Default: on.
- Values / limits: on / off.
- When to change it: keep it on; a paid card that leads to a hidden profile wastes the specialist's money.
Profiles can be promoted / Services can be promoted / Products can be promoted / Board listings can be promoted
- Where: same section (one checkbox per type: Profiles can be promoted (Можна просувати профіль), Services can be promoted (Можна просувати послугу), Products can be promoted (Товари можна просувати), Board listings can be promoted (Оголошення дошки можна просувати))
- What it does: Turns new purchases of that type on or off. Product and board types appear only with the matching modules.
- Default: on for every type.
- Values / limits: on / off. Running campaigns are not affected.
- When to change it: sell only service promotion and keep profile blocks free.
Below these options a hint shows the current core rating values (prior weight, top period, newcomer period and review count) with a link to Ratings and reviews; they decide the By rating, By bookings and Newcomers seats.
Impressions, clicks and CSV
Impression deduplication
- Where: ExpertPress → Promotion → Rules → Impressions, clicks and CSV (Impression deduplication; Об’єднання повторних показів)
- What it does: Whether repeated views of the same paid card by the same visitor count once.
- Default: None (every render) (Немає (враховувати кожен показ)).
- Values / limits: None (every render), Browser session (Сесія браузера), Visitor per day (Відвідувач / день). The two merging options set the
ep_promo_vidcookie. - When to change it: Visitor per day if specialists compare impressions with other advertising channels.
Click deduplication (minutes)
- Where: same section (Click deduplication (minutes); Об’єднання повторних кліків (хвилини))
- What it does: Repeated clicks of the same visitor on the same paid card within this time count once.
- Default: 0 (every click counts).
- Values / limits: 0–10080. Above 0 it uses the
ep_promo_vidcookie. - When to change it: 30 minutes, so a client going back and forth between pages is not counted several times.
Bot user agents (lines)
- Where: same section (Bot user agents (lines); UA ботів (рядки))
- What it does: Visits whose browser identification contains any of these words are not counted as impressions or clicks. Visits without a browser identification are never counted.
- Default:
bot,crawl,spider,slurp,facebookexternalhit,preview,curl/,wget,python-requests,httpclient,headless(one per line). - Values / limits: one fragment per line. An empty list is replaced with the default list on save.
- When to change it: add the name of a monitoring service that checks your site every minute.
CSV delimiter
- Where: same section (CSV delimiter; Роздільник CSV)
- What it does: The column separator in promotion CSV files.
- Default: Semicolon ;.
- Values / limits: Semicolon ;, Comma ,, Tab.
- When to change it: Comma , for spreadsheet software set to English number formats.
UTF-8 BOM in CSV
- Where: same section (checkbox UTF-8 BOM in CSV)
- What it does: Adds a byte-order mark at the start of CSV files so spreadsheet programs open non-Latin text correctly.
- Default: on.
- Values / limits: on / off.
- When to change it: turn it off if the CSV is processed by a script that does not expect the mark.
Lead attribution window (days)
- Where: same section (Lead attribution window (days); Період зарахування заявок до кампанії (дні))
- What it does: After a visitor clicks a paid card, a booking request made within this many days counts as a request of that campaign (and as a paid request once it is paid). It sets the
ep_promo_leadcookie for this period. - Default: 7.
- Values / limits: 0–90. 0 turns request counting off.
- When to change it: 14–30 days for services clients think about for a while; 0 if you do not want any attribution cookie.
- Related: Statistics, requests and revenue
Auction settings
Where: ExpertPress → Promotion → Auction settings (Налаштування аукціону). Saved with Save auction settings. How auctions work is described in Auctions.
Placement mode
One panel per place.
Mode
- Where: ExpertPress → Promotion → Auction settings → Placement mode → a place panel (Mode; Режим)
- What it does: How the paid seats of the place are sold.
- Fixed price (Фіксована ціна): specialists buy plans; a campaign of a type shows in every fixed-price place of that type.
- Auction (Аукціон): seats of this place are sold by periodic auctions, separately from other places.
- Off (Вимк.): the place shows no paid cards and sells nothing.
- Default: Fixed price for every place.
- Values / limits: a change is refused while campaigns occupy paid seats that would no longer belong to the place, or while unpaid auction seats or open bids depend on it ("…Wait for them to end or stop them before changing the place mode."). Pausing sales first makes the switch easier.
- When to change it: Auction for the block above the specialists directory when demand is higher than the seats; Off to stop paid display in one place while keeping the others.
- Related: Paid slots, Max concurrent paid (M)
Minimum prices
- Where: same panel ("Minimum prices (major units in shop currency):", one field per type)
- What it does: The lowest price of one seat for one auction period, per type. Unsold seats in Minimum price queue, then organic mode are offered at this price.
- Default: 0.
- Values / limits: an exact amount in the shop currency, 0 or more. An invalid amount refuses the whole save ("An amount is not a valid sum in the shop currency (for example 10 or 10.50). Nothing was saved."). No auction is opened for a place and type whose minimum price is 0.
- When to change it: set it close to the fixed price of a plan of the same length, so an auction never sells cheaper than your plans.
Period and closing
Period length (days)
- Where: ExpertPress → Promotion → Auction settings → Period and closing (Period length (days); Довжина періоду (днів), with "or custom")
- What it does: How long one auctioned display period lasts.
- Default: 7.
- Values / limits: 7, 14 or 30, or a custom 1–365 days (0 in the custom field means use the drop-down). A period that would overlap a running one after a change waits until the running one ends.
- When to change it: 14 or 30 days on a small market where weekly bidding is too much effort.
Period start (weekday)
- Where: same section (Period start (weekday); Старт періоду (день тижня), plus hour)
- What it does: The weekday and hour (site time zone) on which periods start; periods follow each other from that point every period length.
- Default: Monday, hour 0.
- Values / limits: Sunday–Saturday; hour 0–23.
- When to change it: start on Monday at 9 so the new week's top is in place for the working day.
Close bidding (hours before start)
- Where: same section (Close bidding (hours before start); Закриття торгів (годин до старту))
- What it does: Bidding for a period ends this many hours before the period starts, leaving time to charge winners and collect invoices.
- Default: 48.
- Values / limits: 1–720.
- When to change it: shorten it to 24 hours if most winners pay automatically by card.
Invoice payment deadline (hours)
- Where: same section (Invoice payment deadline (hours); Строк оплати рахунку (годин))
- What it does: How long a winner has to pay an invoice when the seat could not be charged automatically. An unpaid seat passes to the next bidder and the winner gets a strike.
- Default: 24.
- Values / limits: 1–720; never later than the period start.
- When to change it: shorten it when bidding closes close to the period start.
Stall threshold (hours)
- Where: same section (Stall threshold (hours); Поріг зависання (години))
- What it does: An auction that stays in an intermediate state (closing or cancelling) longer than this is marked Stalled transition in the auctions list and in diagnostics.
- Default: 24.
- Values / limits: 1–8760.
- When to change it: lower it if you check the admin daily and want to notice problems sooner.
Step and soft close
Step percent
- Where: ExpertPress → Promotion → Auction settings → Step and soft close (Step percent; Крок, відсоток)
- What it does: The bid step as a percentage of the current entry price.
- Default: 5.
- Values / limits: 1–100. The step is the larger of this percentage and Minimum step, rounded up to Step grid.
Minimum step
- Where: same section (Minimum step; Мінімальний крок)
- What it does: The smallest step between bids.
- Default: 10 units of the shop currency.
- Values / limits: an exact amount greater than 0.
- When to change it: match it to your price level, for example 50 when seats cost several thousand.
Step grid
- Where: same section (Step grid; Сітка кроку)
- What it does: Steps are rounded up to a multiple of this amount, so entry prices are round numbers.
- Default: 5 units of the shop currency.
- Values / limits: an exact amount greater than 0.
Soft close on late bid
- Where: same section (checkbox Enabled (off by default); Продовження при пізній ставці)
- What it does: A bid placed in the last minutes before bidding closes extends the closing time, so others can answer it. The extension never goes past the period start.
- Default: off.
- Values / limits: on / off; Window (minutes) (Вікно (хвилин)) 1–1440, default 5; Extend by (minutes) (Продовжити на (хвилин)) 1–1440, default 5.
- When to change it: turn it on if specialists complain about last-second bids.
Strikes, bans, unsold seats
Strikes before ban
- Where: ExpertPress → Promotion → Auction settings → Strikes, bans, unsold seats (Strikes before ban; Порушень до блокування)
- What it does: A winner who does not pay gets a strike. After this many strikes, the specialist is banned from bidding on that place and type.
- Default: 3.
- Values / limits: 1–50.
Ban length (periods)
- Where: same section (Ban length (periods); Тривалість бану (періодів))
- What it does: How many auction periods the ban lasts.
- Default: 2.
- Values / limits: 1–52.
Unsold seats
- Where: same section (Unsold seats; Нерозпродані місця)
- What it does: What happens to seats nobody won.
- Minimum price queue, then organic (Черга за мінімальною ціною, потім неоплачені картки): specialists can still buy them at the minimum price for the rest of the period; until then they show free cards.
- Organic immediately (Одразу неоплачені картки): they show free cards for the whole period.
- Default: Minimum price queue, then organic.
- When to change it: Organic immediately if late buyers at the minimum price would undercut those who bid.
Card auto-charge consent
Consent text
- Where: ExpertPress → Promotion → Auction settings → Card auto-charge consent (Consent text; Текст згоди)
- What it does: The text a specialist accepts before bidding with Card or Balance + card and before turning on automatic charges for wins. The accepted text, its version and date are stored with the bid.
- Default: empty: "I agree that if I win, the platform may charge my saved card for the auction clearing price (balance first when I chose balance + card)."
- Values / limits: plain text. Changing the text raises the version automatically; specialists must accept the new text before their card can be charged again.
- When to change it: align it with your terms of service for advertising.
Consent text version
- Where: same section (Consent text version; Версія тексту згоди)
- What it does: The version label stored with each acceptance.
- Default:
auction-autosave-v1. - Values / limits: up to 64 characters; raised automatically when the consent text changes.
Promotion entries in the core settings
The module also adds entries to two core settings tabs. They are set there, not on the Promotion screen.
- Email templates: the ten promotion emails listed above.
- Data retention: Promotion impressions and clicks (daily statistics), Promotion click snapshots (default 90 days), Promotion campaign requests, and, when the payment module supports it, the promotion campaign journal and auction history. All but the click snapshots are kept forever by default; records linked to payments, holds, consent, sanctions or evidence are never deleted by these rules.