Module · Claims

Claims: settings and screens

Where: ExpertPress → Claims → Settings (Заявки на картки → Налаштування). The same options are on the classic WordPress page ExpertPress → Claims settings (Налаштування заявок); the Classic Claims settings button on the app tab opens it.

Who can use what

What Who
Claims queue, claim card, evidence download, Approve / Reject Staff with expertpress_moderate: ExpertPress Moderator, ExpertPress Manager, administrators
Settings tab and Open a card for claims Staff with expertpress_operate: ExpertPress Manager and administrators

No option on this page is administrator-only. See Roles and access.

All options are saved together with Save settings (Зберегти налаштування); the page then shows "Settings saved." A number outside the allowed range is not refused: it is quietly moved to the nearest allowed value.


Settings

Enable claims

  • Where: ExpertPress → Claims → Settings (checkbox Allow public claim forms and moderation screens; Увімкнути заявки)
  • What it does: Turns the module on. When on, open cards show the Claim this card section and the shortcode works, and moderators can approve and reject. When off, no public form is shown, new claims are refused ("Claims are disabled on this site."), the claim card shows no decision form, and the queue shows "Claims module is disabled in settings." Existing claims stay visible in the queue, and the claim emails stay listed under Email templates.
  • Default: off.
  • Values / limits: on / off.
  • When to change it: turn it on once you have seeded the directory and opened the cards you want owners to take over; turn it off temporarily to stop new claims while the team is unavailable (claims already in review wait until you turn it back on).
  • Related: Open a card for claims, Overview

Mark verified on approve

  • Where: same tab (checkbox Set ownership state to owned_verified after approval; Позначити перевіреним після схвалення)
  • What it does: Chooses which ownership state an approved card receives: "owned_verified" when on, "owned" when off. Either way the card is closed for further claims and cannot be reopened with Open a card for claims. This module does not show a different label on public pages for the two states; the value is stored for the site's own use (for example by a theme). The setting applies to approvals made after the change.
  • Default: on.
  • Values / limits: on / off.
  • When to change it: turn it off if your team approves claims on light evidence and does not want them recorded as verified.

Max open claims per user

  • Where: same tab (Макс. відкритих заявок на користувача)
  • What it does: How many claims one user can have in review at the same time. Further submissions are refused with "You have reached the limit of open claims." until one of them is decided.
  • Default: 3.
  • Values / limits: 1–50.
  • When to change it: raise it (10–20) if one owner may run several pre-made services; lower it to 1 if you see people claiming many cards at once.
  • Related: Max claims per user per day

Max claims per user per day

  • Where: same tab (Макс. заявок на користувача на день)
  • What it does: How many claims one user can submit in a day, whatever their outcome. The day starts at 00:00 UTC, not in the site time zone. Further submissions are refused with "Daily claim limit reached. Try again tomorrow."
  • Default: 5.
  • Values / limits: 1–100.
  • When to change it: lower it to 1–2 if the queue is being flooded; raise it during a launch when many owners claim their whole service list at once.

Cooldown after reject (hours)

  • Where: same tab (Пауза після відхилення (годин))
  • What it does: After a user's claim for a card is rejected, that user must wait this many hours, counted from the rejection, before claiming the same card again ("Please wait before submitting another claim for this card."). Other users and other cards are not affected. 0 turns the pause off.
  • Default: 24 hours.
  • Values / limits: 0–720 hours (30 days).
  • When to change it: set 0 if you often reject only to ask for a better file; set 72–168 hours if the same person keeps resubmitting without new evidence.

Evidence max bytes

  • Where: same tab (Макс. розмір доказу (байт))
  • What it does: The largest evidence file accepted, in bytes. A larger file is refused with "Evidence file is too large." and the claim is not created. The server's own PHP upload limits also apply; a file above them fails with "Evidence upload failed."
  • Default: 5,242,880 bytes (5 MB).
  • Values / limits: 1,024 bytes (1 KB) to 20,971,520 bytes (20 MB). Allowed file types are fixed: PDF, PNG, JPG/JPEG, WEBP, TXT and DOCX, and the file content must match its extension.
  • When to change it: 10,485,760 (10 MB) if owners send scanned PDF documents; 2,097,152 (2 MB) if you only expect screenshots and want to save disk space.
  • Related: Privacy and data

Team inbox (optional)

  • Where: same tab (Скринька команди (опційно))
  • What it does: The address that receives the "New ownership claim submitted" email. Leave it empty to use the core team address, or the WordPress administration email if the core has none. Users with the ExpertPress Moderator role receive the same email at their own addresses in addition (unless an address is the same as the team inbox).
  • Default: empty.
  • Values / limits: one valid email address; an invalid address is saved as empty.
  • When to change it: set a shared moderation mailbox so new claims do not land in the administrator's personal inbox.
  • Related: Claim emails

Open a card for claims

Where: ExpertPress → Claims, at the top of the queue (Відкрити картку для заявок). Managers and administrators only.

Marks a pre-made specialist profile or service as claimable. Choose Kind (Specialist profile or Service), enter its ID (the ExpertPress record ID of the profile or service, as shown in the queue's Target column, for example specialist_profile #12) and press Open for claims (Відкрити для заявок).

  • Success: "Card opened for claims." The Claim this card section appears on that page while the module is on.
  • "Target not found." — no profile or service with that ID.
  • "Could not open the card (it already has a real owner, or the update was skipped)." — the card was already taken over through an approved claim.

There is no button to close a card again; it closes on its own when a claim for it is approved. Opening a service does not open its specialist's profile, and the other way round.

Claims queue

Where: ExpertPress → Claims (tab Claims). Classic page: ExpertPress → Ownership claims (Classic Claims button).

  • Filters: All, In review (the default), Approved, Rejected, and Old unresolved (over 7 days), which lists claims in review for more than 7 days, oldest first. Cancelled claims appear only under All.
  • Counters: "Pending review: N" (all claims in review) and "Total: N" for the current filter. The same pending number is shown next to Claims in the admin menu. If the database cannot be read, the page says "Pending count unavailable." or "The claims list is unavailable right now. Refresh the page later." instead of showing zero.
  • Columns: ID (opens the claim), Target (kind and ID), Claimer (username), Status, Created (UTC), Age; the age of a claim waiting more than 7 days is in bold.
  • 50 claims per page, with previous and next page links. Refresh reloads the list.

Statuses: in_review (waiting for a decision), approved, rejected, and cancelled. A claim is cancelled when its evidence file could not be stored, when the card closed while it was being submitted, or when another claim for the same card (or the profile that owns the service) was approved.

Claim card

Opened from the queue (or from the link in the team email). Shows Status, Target (title and ID), Claimer, Details (the claimer's explanation) and Evidence — a download link for the file, if one was attached. The file downloads as an attachment and is not opened in the browser.

For a claim in review, while the module is on:

  • Public reason (sent to the claimer) — required for a rejection. The choices are the texts the claimer receives:
    • The submitted evidence was not enough to confirm ownership.
    • The claim did not show that you are the owner of this card.
    • This card is no longer open for ownership claims.
    • The claim was rejected after review.
  • Internal note (not mailed) — optional note kept with the claim for the team.
  • Approve — moves ownership to the claimer and closes the card for claims; "Claim approved and ownership transferred." For a profile, all services of its previous holder move with it, and open claims on those services are cancelled. If the move cannot be done (for example the claimer already has a specialist profile, or the card changed holder meanwhile), the page shows "Ownership transfer failed." with the reason and the claim stays in review.
  • Reject — "Claim rejected." If no other claim is waiting for the card, it becomes free for new claims again, and the claimer's email says they can submit a new claim with clearer evidence (after the cooldown).

If two staff members act at the same moment, one of them sees "This claim was already decided; refresh the claims list." or "Another claim change is in progress. Please try again."

Claim emails

Where: ExpertPress → Settings → Email templates, group Claims. See Email templates for editing, per-language texts and turning emails off.

Email Recipient Placeholders
Ownership claim submitted (team) Team inbox and each ExpertPress Moderator {target_title}, {claimer_label}, {admin_url}, {cabinet_url}, {brand}, {site}
Ownership claim approved (claimer) The claimer same
Ownership claim rejected (claimer) The claimer same, plus {public_reason} and {next_step}

All three are on by default and can be turned off. In the rejection email the reason and the next step are always included: if your own text leaves out {public_reason} or {next_step}, they are added at the end. {cabinet_url} always points to /specialist/ on your site. If a claim email was not queued because a request stopped part-way, the module queues it again during the core's regular background check.

Rejected and cancelled claims

  • Where: ExpertPress → Settings → Data retention → Editable retention periods (Відхилені та скасовані заявки)
  • What it does: Deletes rejected and cancelled claims, together with their explanations and evidence files, once their decision is older than the period. Approved claims and current ownership are always kept. The most recent claim on the site is also kept, as is any claim whose evidence file cannot be confirmed as deleted or missing; such a claim is retried on a later run.
  • Default: 0 (keep indefinitely).
  • Values / limits: 0, 30–36,500 days or 2–1,200 months.
  • When to change it: 180 days to keep rejected evidence for possible disputes but not forever; 30–90 days if your privacy policy promises short storage of identity documents.
  • Related: Data retention, Privacy and data