Skip to content
Documentation

Your EMCP guide

Answers from our docs

YOUR CHAT, YOUR CHOICE

Before we chat

MSR Builds processes your question and up to four recent messages on our server to answer from the EMCP docs. AI is optional and needs your separate permission.

The chat is kept in this page's memory, not saved as a conversation in our database or browser storage. Our hosting and security services process connection information, such as your IP address, to prevent abuse.

Cloudflare Turnstile checks your browser and connection to prevent automated abuse when you send a question. No login is required.

Please leave out personal, sensitive or confidential information, passwords and API keys.

You can withdraw consent and clear this page's chat at any time. This cannot undo a request already sent or erase provider/security records.

Chat privacy, retention & your rights ↗ · Privacy contact

Starting chat consents to this processing. You can browse our docs without using the chat.

Ultimate Member

New in 3.21.1 (Pro). Two dispatcher tools work with Ultimate Member 2.14.1:

ToolDefaultPurpose
ultimate-member-readOnStatus, forms, directories, member status and content restrictions (7 operations)
ultimate-member-writeOffA form’s main button label and a directory’s page size (2 operations)

Enable the write tool under Tools > Plugins > Ultimate Member.

Requirements

Section titled “Requirements”
  • An active EMCP Pro licence.
  • Ultimate Member 2.14.1 exactly, on a single site. Another version answers unsupported_version; multisite answers unsupported_environment.
  • An administrator (manage_options). Forms, directories and posts are checked with WordPress’s edit permission, members with edit_user.

Read operations

Section titled “Read operations”
OperationWhat it does
statusVersion, whether forms and directories are registered; membership_writes_supported is false
list-formsForms (limit up to 100, offset): ID, title, status, mode, whether custom settings are on, main button label, version
get-formOne form by id, plus up to 200 fields with key, type, label and required
list-directoriesMember directories: ID, title, status, page size on desktop and mobile, version
get-directoryOne directory by id
get-member-statusOne member’s account status by user id: approved, inactive, rejected, awaiting admin review, awaiting email confirmation, or unset
get-content-restrictionThe restriction stored on a post or page: custom or not, audience (everyone, logged out, logged in), roles, hidden from queries

Lists cover up to 5,000 forms or directories. No user emails, passwords or other user data are returned. The content restriction is the post’s stored rule only; global rules and extensions can restrict further.

Write operations

Section titled “Write operations”

Both need the object’s version and confirm: true; dry_run: true validates first.

OperationWhat it does
set-form-labelSet the main button label of a register, login or profile form: label, plain text up to 120 characters
set-directory-page-sizeSet page_size (1 to 100) for device desktop (default) or mobile

Rules and refusals

Section titled “Rules and refusals”
  • The form must already use custom settings in Ultimate Member, or the answer is unsupported_form.
  • A setting stored in more than one row is refused for writes and undo, even with force (unsupported_storage).
  • The current and new values must both fit the supported format (unsupported_value).
  • The operation must match the object: a label for a form, a page size for a directory (wrong_type).
  • Roles, account status, approvals, restriction rules, templates, registration and emails are never changed.

History

Section titled “History”

Both changes can be undone from History, which puts back the earlier value, or removes it if it was not set, with a conflict check. If a hook fails, EMCP puts the value back and records a recovery entry.