Core

Getting started

This page takes you from installing the plugin to the first paid booking on your site.

Requirements

Item Requirement
WordPress 6.3 or newer (tested up to 7.1)
PHP 7.4 or newer
Permalinks Any structure except Plain. Booking links also work with Plain permalinks through query arguments, but the client account and the specialist cabinet need pretty permalinks.
Database Any version WordPress supports. Automatic cleanup by retention period needs MySQL 8.0.1+ or MariaDB 10.3+; without it, everything else still works.
Email WordPress must be able to send mail. Registration, booking and moderation emails go through the normal WordPress mail function.

You do not need WooCommerce, Elementor or another listing plugin. Elementor widgets are added only when Elementor is active.

Install and activate

  1. In wp-admin, open Plugins → Add New, search for ExpertPress, then install it. Alternatively, upload the expertpress folder to /wp-content/plugins/.
  2. Activate ExpertPress.
  3. On Multisite, network-activate the plugin. This lets ExpertPress protect participant accounts from being deleted from Network Admin. With per-site activation, deleting a user from Network Admin is not checked.

What activation does

Activation:

  • creates or updates the plugin's database tables;
  • registers the staff roles ExpertPress Manager, ExpertPress Moderator and ExpertPress Accountant;
  • registers the public addresses for the catalog, specialists and specialist registration;
  • imports the bundled service cover images into the media library.

Activation does not create any WordPress pages. Instead, administrators see this notice in wp-admin: "Finish setting up the marketplace: create the pages your visitors will see." The notice has an Open Setup link and a Dismiss button. You create the pages yourself in one step, described below.

The plugin adds a top-level ExpertPress menu in wp-admin.

Do these two things before anything else.

Time zone. Under Settings → General → Timezone, choose a city, for example New York or London, not a plain UTC offset.

  • If no time zone is set, booking times, what counts as "today" and money settlement are all calculated in UTC.
  • A plain UTC offset does not follow daylight saving time, so booking times would shift by an hour twice a year.
  • Until this is fixed, ExpertPress shows a red warning on its setup screens.

Permalinks. Under Settings → Permalinks, choose Post name or any other option except Plain, then save.

Step 2: Open the "Getting started" checklist

Open ExpertPress → Getting started (Початок роботи). The Getting started tab shows the checklist Path to the first paid booking (Шлях до першого оплаченого запису).

Each step is marked Done, Not done or Unknown automatically, based on what actually exists on the site. You never tick these steps yourself. Each row links to the screen where you fix it.

Checklist step What "Done" means
WordPress timezone A city time zone is set in WordPress.
Pretty permalinks The permalink structure is not Plain.
Brand name A brand name is set under Settings → General. Without one, emails use the WordPress site title.
Marketplace pages The catalog, specialists and search pages exist and match the chosen list mode (see Step 3).
Main menu Your theme shows a main menu (classic themes) or a header navigation (block themes).
"Become a specialist" page The information page that links to specialist registration is published.
Practice areas and session languages Both lists have entries. Empty lists do not block anything, but the catalog filters stay empty.
Published specialist At least one specialist profile has been approved.
Published service At least one service is published in the catalog.
Bookable availability At least one published service has a free time slot in the next 30 days.
Money mode Shows how payments work: manual payment, or the Payments module in test or live mode. Manual payment row text: “Manual payment: clients pay using the instructions in the booking, and payment is marked manually. Refund questions are handled by the site team. To accept online payments, install ExpertPress Payments.”
Manual payment details Appears only when the payee is The site and the site's payment details are empty: “Add the site's manual payment details. Until they are provided, clients will need to contact support for payment instructions.” Links to Settings → General → Manual payment.
Test payment Appears with ExpertPress Payments only. Checks that test mode is on.
First confirmed booking / First test payment Manual payment mode: a specialist has accepted at least one booking. With ExpertPress Payments: at least one successful test payment is recorded.
Mail The WordPress admin email is set and no email sending problems are recorded.

Optional modules can add their own rows. The same screen has two more tabs: Common questions, and Deleting the plugin, which explains what happens to your data when the plugin is deleted.

Step 3: Create the marketplace pages

Open ExpertPress → Settings → Create marketplace pages (Створити сторінки маркетплейсу). You can also reach it from the Open Setup link in the notice. The screen has the following sections.

Page addresses

The Page addresses section lists the current addresses, for example /services/ and /specialists/. To change them, use the Open Pages and terms link.

What the setup will do

This section is a preview table with the columns Page, Address, Page status after the setup and What will happen. The table updates as you change the form below it. Possible actions are:

  • Will be created
  • Will be updated
  • Already exists, nothing to change
  • Already exists and was edited, left as is
  • Cannot be created: another page already uses this address

The Create marketplace pages form

How to show the lists of services and specialists. Choose one of two options:

  • Recommended: the plugin shows the catalog lists itself, at their addresses (/services/, /specialists/). No separate WordPress pages are needed.
  • Create ordinary WordPress pages for the catalog lists, so you can edit them in the page editor. These pages own the list addresses, including pagination. If such a page is unpublished, or its catalog block is removed, the plugin falls back to showing the list itself, so visitors never get an empty page.

Which pages to create:

Page Address Content Ticked by default
Services the services catalog address (/services/) Service Catalog block yes
Specialists the specialists address (/specialists/) Specialist Directory block yes
Search /search-services/ Search Form block (searches services) yes
Become a specialist /become-a-specialist-info/ A short text and a button that leads to specialist registration (/become-specialist/) yes
Saved /saved-info/ A short text and an Open saved list button that leads to /account/saved/ no

Options:

  • Add to the main menu. Adds links to the main menu if they are not there yet: Services, Specialists, Search and Become a specialist.
  • Create as drafts first (not published).
  • Dry run — only show what would be created. Changes nothing.
  • Create the pages anyway (this site normally manages its own pages, so use with care). This option only appears when page creation is switched off on the site, or when the pages already exist.

Click Create marketplace pages to run the setup.

The setup does not overwrite a page you have edited by hand.

Manage the created pages

These buttons work only on pages the setup created:

  • Fix page addresses: after you change addresses under Pages and terms.
  • Restore the original text of pages you have not edited
  • Unpublish the created pages
  • Move the created pages to Trash

Under Created pages you get Edit and View links for each page.

Pages that are not WordPress pages

Some addresses are provided by the plugin itself and never appear under Pages:

  • each service (/service/<slug>/) and each specialist profile (/specialists/<id>/);
  • booking pages (/booking/...);
  • the client account (/account/...) and the specialist cabinet (/specialist/...);
  • specialist registration (/become-specialist/).

Do not create WordPress pages with these addresses.

Step 4 (optional): Add demo data

The Create marketplace pages screen also has a Demo data (Демо-дані) panel.

Create demo data adds six sample specialists, each with a published profile and published, bookable services. The services include one group workshop. No reviews are added.

The demo data has these properties:

  • Each demo specialist works 09:00–17:00 every day, in the site time zone.
  • Demo accounts use @example.invalid email addresses and receive no notifications.
  • Public pages show a Demo sample (Демо-приклад) label on demo items. To hide it, untick Show the public "Demo sample" label, then click Save label setting.

Before demo data can be created, all of the following must hold:

  • You tick I want to create demo data on this site.
  • If the site already has specialists, services or orders, you also tick I understand that demo data will be added alongside existing data.
  • Payments are in manual mode or test mode. Live payment mode blocks demo data.
  • Your account has moderation permission. Administrators and ExpertPress Managers do.
  • The WordPress users and terms tables use InnoDB.

To try the specialist side with a demo account, read the Demo specialist login shown in the panel. Open Open the WordPress user profile, set a password, and sign in on the site with that account.

To delete the samples, click Remove demo data. For the limits of removal, see the FAQ.

Step 5: Fill the lists

Open ExpertPress → Lists and registration questions (Списки та питання реєстрації). Add practice areas, session languages and service types, and cities if you use a city list. Specialists choose from these lists in their profiles and services, and clients filter by them in the catalog.

To ask clients extra questions on the booking request or review form, open ExpertPress → Custom fields and questions.

See Settings and Admin screens for these screens.

Step 6: Your first real booking

  1. Share the specialist registration link (/become-specialist/). The specialist registers, confirms their email, fills in the profile and clicks Submit for moderation. See Specialists.
  2. Approve the profile in ExpertPress → Check before publishing (the moderation queue). Unless premoderation is switched off, profiles and services wait there for approval.
  3. The specialist sets weekly hours under Calendar, then creates a service under Services and submits it. Approve the service.
  4. A client opens the service page, picks a date and time, and clicks Continue booking. They sign in or create an account, review the request and click Send request.
  5. The specialist clicks Accept on the booking page.
  6. The client pays:
    • Without ExpertPress Payments, the client pays using the instructions in the booking. Who receives the money is set under Settings → General → Manual payment (default: The site). Staff marks the booking as paid when the payee is the site; the specialist (or staff) marks it when the payee is the specialist.
    • With ExpertPress Payments in test mode, the client pays with the built-in test bank. No real money is charged.
  7. After the session, the specialist clicks Mark the session as held. The client confirms, or the booking completes automatically, and the client can then leave a review.

The full flow is described in The booking flow.

Admins cannot open the specialist cabinet. The cabinet only works for specialist accounts. To test the specialist side yourself, register a second account through /become-specialist/ with a different email, or use a demo specialist.

WP-CLI

If you have shell access, you can run the page setup from the command line:

wp expertpress setup status
wp expertpress setup plan [--surface=<mode>] [--force]
wp expertpress setup run [--dry-run] [--draft] [--add-menu] [--surface=<mode>] [--force]
wp expertpress setup repair-slugs|reset-content|unpublish|trash

The --surface option takes one of two modes:

  • engine_hosts: the plugin shows the lists (the recommended option).
  • wp_pages: WordPress pages own the lists.

Run plan or run --dry-run first on a live site.

Next