[memb_update_account]

Description

Renders a form for logged-in users to update their own profile fields. Fields come from two sources:

• Core WordPress fields: first_name, last_name, display_name, nickname, description, user_url.
• Torii custom fields: any field slug registered in the Torii fields table.

Three rendering modes:

1. Default template, auto-generates the form from field data.
2. Custom template, a named template file under update-account/{template} with full layout control.
3. Inner content, {field:slug} placeholders inside the enclosed content for quick custom layouts.

The form's critical parameters (fields, required, readonly, success and failure URLs, tag IDs) are HMAC-signed so the submission handler can detect tampering.

Renders nothing when logged out, or when fields is empty.

The HTML this shortcode renders comes from a template you can override in your theme. See Shortcode Templates.

Shortcode Examples

[memb_update_account fields="first_name,last_name,phone"]

With required and readonly fields, custom submit text:

[memb_update_account fields="first_name:Given Name,last_name,phone" required="first_name" readonly="phone" submit_text="Save Profile"]

Shortcode Parameters

fields

Comma-separated field slugs to include. Supports custom labels via slug:Label syntax. Required, the shortcode renders nothing when empty. Default: ''.

required

Comma-separated slugs that must be filled in. Default: ''.

readonly

Comma-separated slugs rendered as read-only inputs. Default: ''.

template

Custom template name under update-account/. Falls back to default. Ignored when inner content is present. Default: 'default'.

submit_text

Submit button text. Default: 'Update'.

success_url

Redirect URL after a successful save. Default: ''.

failure_url

Redirect URL on failure. Default: ''.

tagids

Comma-separated tag IDs applied after a successful update. Default: ''.

css_id

HTML ID for the form (auto-generated when empty). Default: ''.

css_class

CSS class for the form. Default: ''.

Shortcode Attributes

Hooks

wpal/torii/update_account/post/pre (filter, POST data, params) runs first; meta_fields (filter) shapes the meta being saved; template_data, render_field_block, render_input, render_label, and field_type_map (filters) customize the form's rendering. On success, wpal/torii/update_account/completed (action, user ID, POST, params) fires and redirect (filter) sets the destination; on failure, update_account/error (action, error code, POST) fires.