=== Ultimate Member Widgets for Elementor – Login Form, Register Form & User Directory ===
Contributors: userelements
Tags: ultimate member elementor, elementor member directory, elementor login form, elementor user directory, elementor register form
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 2.9.2
Requires PHP: 8.0
Requires Plugins: elementor
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Design your Ultimate Member login, register, password reset, and member directory pages in Elementor — drag, drop, and style. No code. Free Elementor works.

== Description ==

= Turn your Ultimate Member site into a branded membership experience — without writing code =

**Ultimate Member Widgets for Elementor** is the free Elementor addon built specifically for [Ultimate Member](https://wordpress.org/plugins/ultimate-member/) membership sites.

If you run a community, association, school, marketplace, or any site where people sign up and log in, you already know the problem: Ultimate Member handles users brilliantly, but the default login page, register form, and member directory rarely match your brand. They look generic. Visitors notice.

This plugin fixes that. Drag widgets into Elementor, change colors, fonts, spacing, and layouts visually, and publish. No CSS files. No shortcodes. No child theme edits.

**You get a setup wizard on activation**, one-click starter templates for your core pages, and a **Member Pages** dashboard that maps your login, register, account, and profile URLs — then opens each page in Elementor with one click.

Works with the **free version of Elementor**. Elementor Pro is not required.

[Live Demos](https://demo.userelements.com/) | [Go Pro](https://www.userelements.com/ultimate-member-elementor/) | [Documentation](https://www.userelements.com/docs/ultimate-member-widgets-for-elementor/)

---

= Why site owners install this plugin =

* **Look professional from day one** — Branded login and register pages build trust before members even sign in.
* **Help visitors find members fast** — Searchable, filterable member directories update live as people type. No page reloads.
* **Start quickly, even if you are new to Elementor** — The setup wizard checks requirements, applies starter designs, and opens your pages in the editor.
* **Stay in control visually** — Every button, input, card, and label is styled inside Elementor. Change your mind later without touching code.
* **Grow when you are ready** — The free plugin covers login, register, password reset, directories, and basic profile fields. Upgrade to Pro only when you need profile builders, account pages, tables, or carousels.

---

= Style login, register, and password reset in Elementor — free =

Your login page is the first thing every member sees after signing up. Make it feel like your site — not a plugin default.

**Login / Register Form** — One widget handles both forms. Drag it onto your login or register page, pick Login or Register in the Content tab, and style inputs, labels, buttons, backgrounds, typography, padding, and shadows. Arrange fields in multi-column rows, reorder them, hide labels, and control column gaps — all without breaking Ultimate Member's validation. Works with any UM form. [Step-by-step login tutorial](https://www.userelements.com/ultimate-member-login-page-elementor/)

**Password Reset** — Style the Ultimate Member password reset page to match your login and register forms. A consistent sign-in flow means fewer confused visitors and fewer abandoned password resets.

**Logout** — Add a styled logout link for logged-in members. Uses your UM logout page when configured.

---

= Build a searchable member directory in Elementor — free =

Help visitors browse, search, and discover members on your site.

**Directory Grid** — Display Ultimate Member users in a responsive card or list layout. Visitors search by name and results update instantly (AJAX live search). Filter by user role or custom UM profile fields — up to two filter fields in the free version. Choose numbered pagination, Load More, or Infinite Scroll. Set one to six responsive columns. Sort by display name, registration date, last login, post count, or any custom field. Show only approved UM members with one toggle. Design each member card with a custom Elementor template for full creative control. [Live demo](https://demo.userelements.com/user-directory-grid/) | [Directory tutorial](https://www.userelements.com/create-user-directory-elementor/)

**WordPress Users** — List native WordPress users by role with any user meta field. Perfect for team pages, staff directories, and contributor lists. **Works without Ultimate Member installed.**

**Flip Cards** — Hover-to-flip profile cards that reveal a second set of fields on the back. A memorable layout for team showcases and member spotlights. [Live demo](https://demo.userelements.com/users-flipbox/)

---

= Profile widgets for Ultimate Member pages — free =

Build cleaner profile layouts on member profile pages.

**Profile Photo** — Standalone avatar widget with border, radius, size, and CSS filter controls.

**Profile Fields** — Show any combination of Ultimate Member profile fields for the member being viewed. Supports text, URL, phone, image, and file field types. Control who sees each field with visibility rules. [Live demo](https://demo.userelements.com/users-meta-fields/)

**Profile Name** — Output the profile user's name in any format (display name, first name, last name, full name, username, or nickname) with full Elementor typography and color controls. [Live demo](https://demo.userelements.com/user-profile-name/)

**UM Visibility** — Show or hide any nested Elementor content based on login status, user role, or field value conditions. Great for member-only sections on profile pages.

---

= Get started in minutes — setup wizard and starter templates =

New to Ultimate Member and Elementor? You are not alone.

1. **Activate the plugin** — A guided setup wizard opens automatically.
2. **Check requirements** — The wizard confirms Elementor and Ultimate Member are ready and your core pages are mapped.
3. **Apply a starter template** — One click adds a polished layout to your Login, Register, Password Reset, or Members Directory page.
4. **Open in Elementor** — Fine-tune colors, fonts, and spacing, then publish.

Your previous layout is backed up automatically before any starter template is applied. Restore it anytime from the Member Pages screen.

Find widgets in the Elementor panel under **UM Member Pages** (forms and profile fields) and **UM Member Directories** (directory grids and flip cards).

---

= Everything included free =

* Style UM **login, register, and password reset** forms in Elementor
* **AJAX live search** on member directories — results filter as visitors type
* **Role and custom field filters** — up to two filter fields in Directory Grid
* **Card, list, and custom template layouts** with full Elementor style controls
* **Three pagination modes** — numbered pages, Load More, or Infinite Scroll
* **Show only approved Ultimate Member users**, or list all WordPress users
* **High-performance query engine** enabled by default with smart cache invalidation
* **Member Pages screen** — map UM core pages and open them in Elementor
* **Our Plugins screen** — discover and install other free UserElements Ultimate Member add-ons (export, SEO, faceted search)
* **Setup wizard and starter templates** — go live faster without starting from scratch
* **Field layout controls** on login/register forms — multi-column rows, reorder, hide labels
* **Per-field visibility rules** — show fields to everyone, logged-in users, or specific roles
* **Works with free Elementor** — Elementor Pro is not required

---

= More free Ultimate Member tools from UserElements =

These free plugins work great alongside Ultimate Member Widgets for Elementor. Install them from **Ultimate Member → Our Plugins** or **Settings → Our Plugins**:

* **[Member Export for Ultimate Member](https://wordpress.org/plugins/userelements-member-export-for-ultimate-member/)** — Export and import member data as CSV with filters, column mapping, and saved presets
* **[SEO for Ultimate Member](https://wordpress.org/plugins/seo-for-ultimate-member/)** — Privacy-aware profile sitemap, Yoast & Rank Math integration, Person schema, and Open Graph tags
* **[Faceted Search for Ultimate Member](https://wordpress.org/plugins/faceted-search-for-ultimate-member/)** — Filter sidebar for member directories with live AJAX facet counts

---

= Upgrade to Pro when you need more =

The free plugin covers authentication pages and member directories. **UM Elementor Pro** unlocks every remaining Ultimate Member page:

* **[Member Carousel](https://demo.userelements.com/user-carousel-or-slider/)** — Touch-friendly slider for featured members, alumni spotlights, or testimonials
* **[Member Table](https://demo.userelements.com/sortable-user-table/)** — Sortable directory with clickable column headers, global AJAX search, and CSV export. [Tutorial](https://www.userelements.com/ultimate-member-user-table-tutorial/)
* **[Member Filter](https://demo.userelements.com/users-list-with-filter-buttons/)** — Standalone filter panel with unlimited fields, dropdowns, checkboxes, and radio buttons
* **[Member Card Grid](https://demo.userelements.com/2-column-user-list/)** — Multi-column and [zigzag](https://demo.userelements.com/zigzag-user-list/) directory layouts
* **[Member Search](https://demo.userelements.com/user-search-bar/)** — Dedicated AJAX search bar, independent of the directory grid
* **[Faceted Search](https://demo.userelements.com/ultimate-member-faceted-search/)** — Multi-criteria live filtering with real-time AJAX refresh
* **Account Page** — Style Ultimate Member account tabs (General, Password, Privacy, Notifications) in Elementor
* **Profile Page Builder** — Replace the default UM profile template with a custom Elementor layout: cover photo, header, bio, meta fields, social links, action bar, completion bar, custom tabs, and profile body. [Tutorial](https://www.userelements.com/ultimate-member-profile-templates/)
* **UM Directory Styler** — Full Elementor visual control over the native Ultimate Member directory shortcode
* **Member Loop Grid, Split View, and Alphabet Index** — Advanced directory layouts with Elementor templates, side-panel browsing, and A–Z name navigation

[See all Pro features and live demos →](https://www.userelements.com/ultimate-member-elementor/)

**Pricing:** Free — unlimited sites. Pro — $45/year.

Do not activate Free and Pro together. Pro replaces Free.

---

= What users say =

> "I have been seeking sortable user data tables for quite some time. Finally found it." – ★★★★★ *@nikotor · [WordPress.org](https://wordpress.org/support/topic/sortable-user-table/)*

> "I am new to Elementor and WP and this plugin has been a real help. Takes a lot of guesswork and effort out of the process." – ★★★★★ *@hawkekeye · [WordPress.org](https://wordpress.org/support/topic/sortable-user-table/)*

*[Read all reviews →](https://wordpress.org/support/plugin/ultimate-member-widgets-for-elementor/reviews/?filter=5)*

---

= Who is this for? =

* **Membership site owners** who want a branded Ultimate Member login page — not the default template
* **Community builders** creating searchable, filterable member directories in Elementor
* **Beginners** who want a guided setup instead of figuring out shortcodes and page assignments alone
* **Agencies** building Ultimate Member client sites with full visual control and no custom code
* **Schools and associations** that need staff directories, faculty listings, or member rosters
* **Marketplaces** where visitors browse, search, and filter service providers or contributors

== Installation ==

1. Install and activate [Elementor](https://wordpress.org/plugins/elementor/) — the free version is enough.
2. Install and activate [Ultimate Member](https://wordpress.org/plugins/ultimate-member/) for UM-powered widgets (login, register, directories, and profile fields).
3. Install this plugin via **Plugins → Add New**, or upload the zip file manually.
4. Activate the plugin.
5. The **setup wizard** opens automatically on first activation (or go to **Settings → Member Pages**, also under **Ultimate Member → Member Pages**).
6. Apply a starter template to each core page, then fine-tune in Elementor. Widgets appear under **UM Member Pages** and **UM Member Directories** in the Elementor panel.
7. Optional: open **Ultimate Member → Our Plugins** (or **Settings → Our Plugins**) to install related free Ultimate Member add-ons from UserElements.

Full walkthrough: [plugin documentation](https://www.userelements.com/docs/ultimate-member-widgets-for-elementor/)

== Frequently Asked Questions ==

= What does Ultimate Member Widgets for Elementor do? =

It adds Elementor widgets so you can design Ultimate Member login, register, password reset, member directory, and profile pages visually. Drag widgets onto a page, style them in Elementor, and publish — no coding required.

= How do I style the Ultimate Member login page in Elementor? =

Install the plugin, open your login page in the Elementor editor, and add the **Login / Register Form** widget. Choose Login in the Content tab. Use the Style tab to change colors, fonts, input borders, button styles, background, padding, and spacing. Every change updates in real time. Publish when done. Step-by-step guide: [How to Style the Ultimate Member Login Page with Elementor](https://www.userelements.com/ultimate-member-login-page-elementor/).

= How do I style the Ultimate Member register form in Elementor? =

Use the same **Login / Register Form** widget. Switch the form type to Register in the Content tab, then style field labels, inputs, section headers, submit button, and error messages visually. Both login and register are included free.

= Can I style the Ultimate Member password reset page in Elementor? =

Yes. The **Password Reset** widget is included free. Style it to match your login and register forms so the full sign-in flow looks consistent.

= How do I build a member directory in Elementor? =

Add the **Directory Grid** widget. Choose card or list layout, enable AJAX live search, add role or custom field filters, and configure pagination (numbered, Load More, or Infinite Scroll). Use **WordPress Users** if you only need native WordPress users without Ultimate Member. Full walkthrough: [Create a WordPress Membership Directory in Elementor](https://www.userelements.com/create-user-directory-elementor/).

= Do I need Elementor Pro? =

No. All free widgets work with the free version of Elementor. Pro widgets also work with free Elementor.

= Do I need Ultimate Member? =

Ultimate Member is recommended for login, register, password reset, directory grid, flip cards, profile photo, profile fields, and profile name widgets. The **WordPress Users** widget works on any WordPress site without Ultimate Member.

= Is this plugin good for beginners? =

Yes. On activation, a setup wizard walks you through requirements, maps your core UM pages, and lets you apply starter templates with one click. Each widget links to documentation from its **Need Help?** button in Elementor.

= Can I filter my member directory by custom Ultimate Member fields? =

Yes. The free Directory Grid supports AJAX meta field filters with no page reload. The free version supports up to two filter fields. Pro adds a standalone **Member Filter** widget with unlimited fields, dropdowns, checkboxes, and radio buttons.

= Can I show only approved Ultimate Member users in the directory? =

Yes. Enable **Show Only Approved Users** in the Directory Grid Content tab to list only members whose UM account status is approved.

= Can I sort the member directory by last login or a custom field? =

Yes. Sort by display name, first name, last name, registration date, last login, post count, user ID, or any custom meta field — all from the Elementor widget panel.

= Can I build a custom Ultimate Member profile page in Elementor? =

Yes, with Pro. The **Profile Page Builder** provides dedicated Elementor widgets that replace the default UM profile template: cover photo, header, bio, meta fields, social links, action bar, completion bar, custom tabs, and profile body. See [How to Customize the Ultimate Member Profile Page](https://www.userelements.com/ultimate-member-profile-templates/).

= Can I display members in a sortable table with CSV export? =

Yes, with Pro. The **Member Table** widget supports clickable column sorting, global AJAX search, and one-click CSV export of the filtered member list. Step-by-step guide: [Display Ultimate Member Users in an Elementor Table](https://www.userelements.com/ultimate-member-user-table-tutorial/).

= Can I add a member carousel or slider in Elementor? =

Yes, with Pro. The **Member Carousel** uses Swiper.js for smooth, touch-friendly sliding — ideal for homepage featured members and testimonials.

= Can I use the free and Pro versions together? =

No. Pro replaces Free. Deactivate one before activating the other.

= Is this compatible with caching plugins like WP Rocket or LiteSpeed Cache? =

Yes. If AJAX or directory scripts fail after minification, exclude `wp-content/plugins/ultimate-member-widgets-for-elementor/assets/js/` from your caching plugin's JavaScript processing.

= Does this work on WordPress multisite? =

Yes. Each site in the network operates independently with its own user query scope.

= Where can I see live demos? =

Visit [demo.userelements.com](https://demo.userelements.com/) — interactive demos for every widget. No login required.

== Screenshots ==

1. Ultimate Member login form styled in Elementor — dark glassmorphism layout with the Login / Register Form widget
2. Ultimate Member register form styled in Elementor — custom-branded registration with full visual controls
3. Ultimate Member password reset page styled in Elementor — matching auth flow design
4. Elementor member directory grid with AJAX live search and custom field filters
5. Ultimate Member user flip cards — front and back profile card layout in Elementor
6. Pro: Member Table with sortable columns, AJAX search, and CSV export
7. Pro: Member Carousel — touch-friendly slider for featured members
8. Pro: Profile Page Builder — custom Ultimate Member profile page in Elementor
9. Pro: Account Page styler — Ultimate Member account tabs designed in Elementor

== Changelog ==

= 2.9.2 =
* Added: Our Plugins admin page — discover and one-click install related free UserElements Ultimate Member plugins (Member Export, SEO for Ultimate Member, Faceted Search). Available under Ultimate Member → Our Plugins and Settings → Our Plugins.

= 2.9.1 =
* Fixed: Fatal error with Elementor Pro Theme Builder — `UM_Condition_Base::get_priority()` is now static to match Elementor Pro’s `Condition_Base` signature.

= 2.9 =
* Added: Custom Template layout on Member Directory Grid and WordPress User Grid — pick an Elementor library template (Loop Item / Container / Section) and render it once per member. UM dynamic tags resolve per card. Card and List layouts are unchanged.
* Improved: Elementor 4.2 compatibility — declared “Elementor tested up to: 4.2.0” and enforce a minimum Elementor 3.5.0 version with an admin notice when older.
* Improved: Directory list widgets use Elementor’s `elementsHandler.attachHandler` lifecycle (with legacy `element_ready` fallback) and expose pagination/layout settings via `frontend_available` for `data-settings`.
* Improved: AJAX directory handlers read saved widget settings through Elementor’s Documents API instead of walking raw `_elementor_data` meta.
* Improved: Soft Ultimate Member dependency — WordPress User Grid works without UM; UM widgets and AJAX register only when Ultimate Member is active, with a clear admin notice when it is missing.
* Fixed: Profile Photo dynamic tag now uses Elementor `Data_Tag` for Image controls; added a separate Profile Photo URL tag for URL controls.
* Fixed: Member Avatar and Member Name widgets used the deprecated `_register_controls()` method — migrated to `register_controls()`.
* Fixed: Member and profile widgets mark themselves as dynamic content and respect Elementor’s optimized markup experiment (`has_widget_inner_wrapper`).
* Fixed: WordPress User Grid now initializes correctly in the Elementor editor/preview via the frontend handler API.
* Added: Lightweight editor `content_template()` placeholders for directory widgets.

= 2.8 =
* Added: Field Layout for the Login & Register Form widget — arrange UM form fields visually: set widths (full, 2/3, half, 1/3) for multi-column rows, reorder fields, hide labels, and control column gap. Pure CSS on UM's own field wrappers; fields and validation stay managed in Ultimate Member, so nothing can desync.
* Added: Setup wizard — a guided 3-step first-run flow (requirements check, per-page starter designs, finish) that launches on activation and stays reachable from the Elementor Setup screen.
* Added: Starter templates — one-click Elementor layouts for the Login, Register, Password Reset, and Members Directory pages, applied to the mapped UM core page and opened straight in the editor.
* Added: Automatic layout backups — the previous Elementor layout of a page is saved before a starter template is applied and can be restored from the Elementor Setup screen.
* Improved: Widgets renamed into one consistent "Member" family (Member Login & Register Form, Member Password Reset, Member Flip Cards, Member Avatar, Member Name, Member Fields, WordPress User Grid, Logout Link) — panel search now finds every widget by natural keywords.
* Improved: Every widget links its Elementor "Need Help?" button to the matching tutorial or documentation page.
* Improved: The Members Directory page is no longer marked Pro in the wizard and setup dashboard — build it with the free Member Directory Grid; styling UM's native directory shortcode remains a Pro widget.
* Improved: Admin menu entries renamed to "Member Pages" (Settings + Ultimate Member) for a single product surface across free and Pro.
* Added: Free vs Pro comparison table on the setup screen with per-feature demo links.
* Added: Editor guidance when a directory query matches no members on a new site.
* Added: "Hide locked Pro widgets" option under Member Pages → Advanced.
* Added: One-time success toast after applying a starter template, with next-step guidance.
* Removed: Unused bundled image; tightened upgrade-notice copy.
* Fixed: Member directory widgets were capped at 100 users regardless of widget settings. Queries now respect Number of Members (up to 1000) and Users Per Page, including AJAX directory requests.

= 2.7 =
* Fixed: Removed duplicate legacy admin upgrade notice that could not be dismissed on Plugins/Dashboard screens.
* Fixed: In-editor Pro placeholder upgrade links now use centralized URLs with UTM attribution instead of a hardcoded price.
* Security: AJAX directory endpoints no longer trust client-supplied widget_settings query keys; meta filters are constrained to widget-exposed fields.
* Improved: New query engine enabled by default; cache invalidation only runs for directory-relevant meta changes.

= 2.6 =
* Added: UM Login & Register Form widget — style Ultimate Member login and register forms visually in Elementor.
* Added: Password Reset widget — complete your styled authentication flow in Elementor.
* Added: Pro widget placeholders in the Elementor editor — free users see upgrade cards for locked Pro widgets on the canvas.

= 2.5 =
* Security: AJAX filter endpoints now verify nonce before any file I/O or class loading.
* Security: meta_query items from widget_settings are sanitized before reaching WP_User_Query.
* Security: per_page in the UM AJAX handler clamped to a maximum of 100.
* Security: debug output gated behind WP_DEBUG on all error paths.
* Security: email address removed from default public meta fields in WP User List handler.
* Fixed: sort order control works for all options — ID, first/last name, last login, post count, email.
* Fixed: box shadow control uses Group_Control_Box_Shadow.
* Fixed: admin notice dismiss nonce mismatch caused silent dismiss failures.
* Fixed: PHP fatal when Elementor is inactive — undefined admin notice callbacks.
* Fixed: deprecated Elementor Scheme_Color and Scheme_Typography imports in flip card widget.
* Fixed: widget category sometimes did not appear due to hook registration timing.
* Fixed: meta key selector uncached table scan on every editor load — results cached one hour.
* Fixed: Pro layout values in database caused user cards to disappear — now fall back to card layout.
* Fixed: widget order_by and order settings not passed to the query engine.
* Added: Table and Carousel layout options visible in free widget with upgrade tooltip.
* Added: meta cache primed after user queries to avoid N+1 meta fetches.
* Added: query result transients invalidated on user profile, meta, or role changes.
* Improved: user-processing loop unified into shared static methods across AJAX handlers.
* Improved: pro upgrade notice scoped to admin-only roles and screens.
