Module · Claims

ExpertPress Claims

ExpertPress Claims lets the real owner of a specialist profile or service that your team created in advance ask to take it over. The owner signs in, explains why the card is theirs and can attach a private evidence file; a moderator reviews the claim and, on approval, ExpertPress moves the profile or service to the owner's account. Use it when you fill the directory with pre-made cards before the specialists themselves join.

Key capabilities:

  • Staff choose which pre-made specialist profiles and services are open for claims; nothing can be claimed until a card is opened.
  • A Claim this card form at the end of the specialist profile and service pages, plus a shortcode to place the form anywhere.
  • Optional evidence file (PDF, PNG, JPG, WEBP, TXT or DOCX) checked by content and kept in a private folder outside the public web root.
  • A moderation queue with filters, a pending counter, claim age and an "old unresolved" filter for claims waiting more than 7 days.
  • Approve to move ownership (a profile moves together with all its services), or reject with a public reason the claimer sees and an internal note that is never mailed.
  • Limits against abuse: open claims per user, claims per user per day, and a waiting period after a rejection.
  • Three emails (new claim to the team, approved and rejected to the claimer), editable under Email templates.
  • An optional data retention rule that deletes old rejected and cancelled claims with their evidence files.

The module is off after installation. It is meant for directories seeded by the site team; leave it off if specialists create their own profiles.

Requirements

  • ExpertPress (core plugin) installed and active. The module declares Requires Plugins: expertpress; WordPress will not activate it without the core, and activation stops with "ExpertPress Claims requires ExpertPress." if the core is missing.
  • WordPress 6.0 or later; PHP 7.4 or later.
  • Two database tables of its own ({prefix}expertpress_claims, {prefix}expertpress_claim_targets), created on activation. If they cannot be created, activation stops with "ExpertPress Claims could not install its database tables."
  • For evidence files: a writable folder outside the public web root. By default the module uses a folder named expertpress-claims-private placed next to the folder that contains your WordPress installation (one level above it). If that location is not writable or would be publicly served, evidence uploads are refused with a message asking to configure a private folder; a developer can set another path with the expertpress_claim_evidence_storage_dir filter. Folders under the WordPress folder, wp-content or uploads are never used. Claims without a file work without this folder.
  • No third-party services or accounts. Emails go through the core's outgoing mail queue and your site's normal WordPress mail setup.

How a claim works

  1. Staff open a card. In ExpertPress → Claims, a manager or administrator enters the profile or service ID in Open a card for claims (Відкрити картку для заявок). A card that already has a real owner through an approved claim cannot be opened again. See Settings and screens.
  2. The owner finds the card. On the public specialist profile or service page of an open card, a Claim this card (Заявити цю картку) section appears at the end. Visitors who are not signed in see Log in to claim this card instead of the form. The section is not shown to the account that already holds the card, and it disappears once the card is claimed.
  3. The owner submits. The form asks Why are you the owner? (Чому ви власник?, at least 10 and at most 10,000 characters) and an optional Evidence file (Файл доказу). After Submit claim (Подати заявку) the page reloads with "Your claim was submitted for review." or the reason it was refused. A card can have only one open claim at a time; another person who tries gets "This card already has an open claim."
  4. The team is notified. The "New ownership claim submitted" email goes to the team inbox and to every user with the ExpertPress Moderator role, with a link to the claim.
  5. A moderator decides. On the claim card the moderator reads the explanation, downloads the evidence and chooses Approve or Reject. A rejection requires a public reason.
  6. The claimer is told the result. "Your ownership claim was approved" links to the specialist cabinet; "Your ownership claim was rejected" gives the public reason and says whether the card is still open for a new claim.

Rules checked when someone submits a claim:

Rule Message the claimer sees
The module is on Claims are disabled on this site.
The user is signed in You must be logged in to submit a claim.
The card exists, is open for claims and is not already held by this user This card is not open for claims. / You already hold this card.
No other open claim on the card This card already has an open claim.
Under the open-claims limit You have reached the limit of open claims.
Under the daily limit (the day starts at 00:00 UTC) Daily claim limit reached. Try again tomorrow.
Waiting period after this user's last rejection for this card has passed Please wait before submitting another claim for this card.
For a service: the claimer already has a specialist profile Claim a specialist profile first, or create your specialist profile before claiming a service.
Evidence file: allowed type, real content matches the type, within the size limit Evidence file type is not allowed. / Evidence file is too large. / Evidence upload failed.

What changes for each group

Clients and visitors

Nothing changes in booking. On open cards they see the Claim this card section at the end of the profile or service page; a visitor who is not signed in only sees a sign-in link.

Specialists and owners of pre-made cards

  • A person who already has an account can claim a pre-made profile. On approval the profile, all services of its previous holder, and the profile photo and certificate files move to the claimer's account, and the account is marked as a specialist account. The claimer then manages the card from the specialist cabinet (see Specialists).
  • A person who already has their own specialist profile cannot take over a second profile: approval fails with "Ownership transfer failed." They can claim individual services instead.
  • Claiming a single service requires the claimer to have a specialist profile already.
  • Past bookings and reviews are not rewritten; they keep the specialist recorded at the time and still display after the transfer.
  • When a profile is approved, any open claims on its services are cancelled, because those services moved with the profile.

The site team

  • A Claims item (Заявки на картки) in the Modules group of the ExpertPress admin app, with the number of claims in review. Moderators see the queue; managers and administrators also see the Settings tab and the Open a card for claims form. See Settings and screens and Roles and access.
  • Classic WordPress pages under the ExpertPress menu: Ownership claims and Claims settings.
  • Claim events (submitted, approved, rejected, cancelled) appear in a participant's history for the claimer, the previous holder and the moderator who decided.
  • Three emails in a Claims group under Email templates.
  • A Rejected and cancelled claims row under Data retention.

Shortcode

[expertpress_claim_button target_kind="specialist_profile" target_id="12"]

Attribute Values Default
target_kind specialist_profile or service specialist_profile
target_id The ExpertPress ID of the profile or service (the same ID used in Open a card for claims) none; without it nothing is shown

The shortcode shows the same section as the automatic one on profile and service pages, with the same rules: it outputs nothing when the module is off or the card is not open for claims. For other blocks and shortcodes see Blocks, shortcodes and widgets.

Privacy and data

Stored on your site:

  • For each claim: the card (kind and ID), the claimer's user ID, the explanation text, the evidence file's original name and its location, the status, the moderator's user ID, the internal note, the public reason, the previous holder's user ID after approval, and creation, update and decision times (UTC).
  • For each card that was opened: whether it is open for claims and its ownership state.
  • Evidence files are stored in the private folder under a random name. They are never linked from public pages; only staff who can moderate claims can download them, from the claim card.

Sent outside your site: nothing to third-party services. The claim emails are sent through WordPress mail to the team inbox, to users with the ExpertPress Moderator role and to the claimer. The team email contains the card title and the claimer's username; the claimer's emails contain the card title and, for a rejection, the public reason. The internal note is never mailed.

How long it is kept: by default, indefinitely. You can set a retention period for rejected and cancelled claims (30 days to 100 years) under ExpertPress → Settings → Data retention; see Rejected and cancelled claims. Approved claims are always kept.

Deactivating and deleting the plugin:

  • Deactivating keeps claims, settings and evidence files.
  • Deleting the plugin first deletes the evidence files that this site's claims point to, then removes the module's tables and settings. Other files in the private folder, its marker files and the folder itself are left in place, because the folder may be shared with another site. Booking and payment data of the core is not touched.
  • If an evidence file cannot be read or safely deleted, the tables and settings are kept and the option expertpress_claims_uninstall_incomplete records when and at which stage it failed (without file paths or claim details). Fix the folder access, install the module again and delete it again. Files already deleted stay deleted.