WordPress Membership Plugin

Membrly Premium Documentation

A topic-based setup guide for installing Membrly, configuring membership onboarding, enabling payments, publishing frontend shortcodes, activating premium modules, and preparing mobile integrations.

Overview

Membrly Premium is a modular WordPress membership system for onboarding, OTP verification, plan selection, UPI payments, member dashboards, donations, official documents, events, admin tools, and mobile app integrations.

Free Core

Registration, OTP login, membership plans, payments, basic dashboard/profile tools, member menu controls, public profiles, reporting snapshots, settings, and mobile API basics.

Premium Modules

KYC, referrals, campaign achievements, downloads, member letters, admin committees, donation administration, receipts, email campaigns, events, and organization directory tools.

Best Fit

Organizations that need controlled member onboarding, role progression, referral-driven campaigns, official member documents, and UPI-based payments inside WordPress.

Quick Start

Use this order for a clean first-time setup.

  1. Upload the membrly folder to /wp-content/plugins/, or install it from the WordPress Plugins screen.
  2. Activate Membrly Premium from Plugins in WordPress admin.
  3. Open Membrly > Settings and save organization, support, OTP, and founding-date settings.
  4. Create or review membership plans from the Membrly admin screens, including role mapping for General, Primary, Active, and Founder members.
  5. Open Membrly > Payments > Gateway APIs and configure UPI or UPI Pay before collecting payments.
  6. Create public WordPress pages for registration, plans, dashboard, profile, donor plan, recent members, and member documents using the shortcodes in this guide.
  7. Open Membrly > License to verify a premium license if the site needs paid modules.
  8. Test a full member journey: register, verify OTP, select plan, submit payment, approve payment, view dashboard, download documents, and confirm email delivery.
Login redirect note: When a published page contains [membrly_registration], [membrly_onboarding], or [membrly_auth_button], unauthenticated wp-admin and wp-login.php visits redirect to the frontend Membrly login/register experience.

Admin Menu Map

The main WordPress admin entry is Membrly. Some menus appear only after the related premium feature is active.

Menu Use It For Availability
Membrly Dashboard Overview cards, member metrics, payment summaries, and quick access to core admin tasks. Free core
Members Review members, approve statuses, assign plans, and open individual member records. Free core
Assignment Panel Review member activity, referral progress, wallet data, candidate metrics, and office-bearer assignments. Free core with premium data where enabled
Payments Configure gateway availability and verify payment records. Gateway APIs include manual UPI and UPI Pay settings. Free core
Office Bearers Manage hierarchy, titles, appointment-letter text overrides, and signing authority assignments. Free core with premium document integrations
Candidate Selection Board Define criteria and assign registered members or donation visitors to candidate positions. Premium
Assembly and Lok Sabha Manage committee assignments for Assembly and Lok Sabha levels. Premium
Message Board Send member-facing broadcast notices. Free core
ID Card Design Configure card header, logos, typography, colors, and global branding. Premium
Member Letters Configure membership letters, appointment letters, placeholders, graphics, signatures, and stamps. Premium
Member Policy, Welcome Email, Typography Control policy content, welcome email branding, dashboard headings, and member-media styling. Free core with premium fields where enabled
API View REST root, endpoint map, authentication guidance, and sample requests. Free core
License or License & Sales Verify site licenses, buy licenses on customer sites, or manage sales settings on the author portal. Free core; unlocks premium modules
Events Create events, notify selected members or the full membership base, and share event links. Premium

Payments and UPI Pay

Membrly includes a gateway registry with UPI Pay, Cashfree, and PayU contracts. UPI Pay is available for membership payments, donations, premium license purchases, and WooCommerce checkout when WooCommerce is active.

Required UPI Pay Setup

  1. Open Membrly > Payments > Gateway APIs.
  2. Enable UPI Pay in gateway availability.
  3. Paste the UPI Pay user_token from the merchant dashboard.
  4. Keep the gateway URL as https://paygo.bmpparty.org unless the provider gives you a different base URL.
  5. Copy the displayed webhook URL into the UPI Pay dashboard.
  6. Enable debug logging only while testing. WooCommerce logs use the membrly-upi-pay source when WooCommerce logging is available.

Manual UPI

For manual UPI collection, set the UPI VPA and, optionally, the UPI QR image URL before publishing membership or donation payment flows.

WooCommerce

When WooCommerce is active, Membrly registers the same UPI Pay gateway for checkout. WooCommerce-specific UPI settings are not required; the gateway reads Membrly payment settings.

Premium License

Core workflows run without a paid license. A verified Membrly site license unlocks advanced modules and controls update eligibility for the licensed email and site URL.

Customer Site Flow

  1. Open Membrly > License.
  2. Use Buy License when available, complete the UPI Pay checkout, and wait for approval.
  3. Verify the generated license key from the same screen if automatic activation does not complete.
  4. Confirm premium feature labels appear as active.

Author Portal Flow

  1. Use https://membrly.zeeface.com/ as the primary licensing dashboard unless changed by constants or filters.
  2. Configure plugin price, subscription duration, sales UPI details, and UPI Pay token settings.
  3. Verify the master license key before generating customer site licenses.
  4. Process or auto-accept valid UPI license submissions.

Premium Feature Catalog

Member KYC Verification Member Letters Referrals Campaign Achievements Downloads Admin Assemblies Module Admin Lok Sabha Module Admin Member Letters Module Admin Membership Cards Module Candidate Selection Board Admin Email Campaigns Module Events Module Admin Organization Directory Module Admin Donations Module Admin Donation Receipt Module
License lock: Generated licenses are locked to both the licensed administrator email address and the exact WordPress site URL submitted by that site.

Frontend Pages

Create normal WordPress pages and place the relevant shortcode inside each page or shortcode-enabled block.

Suggested Page Shortcode Purpose
Join / Register [membrly_registration] Full onboarding flow with OTP, personal details, plan selection, and payment.
Header Login Button [membrly_auth_button label="Login / Register"] Popup login/register button for a header, top bar, or reusable block.
Generate PIN [membrly_forgot_password] Frontend PIN recovery or PIN generation page.
Logout [membrly_logout] Page-based sign-out link for menus or navigation flows.
Plans [membrly_plans] Public plan listing and plan selection entry point.
Dashboard [membrly_dashboard] Logged-in member dashboard, profile, referrals, campaign links, documents, events, and license purchase panels.
Profile [membrly_profile] Editable member profile form.
Donor Plan [membrly_donor_plan] Donation plan and donor registration entry point.
Organization Directory [membrly_team_directory] Filterable directory for team members, office bearers, committees, and eligible candidates.
Recent Members [membrly_recent_members] Display the latest completed or publicly visible members.

Navigation Menu Placeholders

Classic WordPress navigation menus can render member controls by adding a Custom Link with one of these placeholder URLs:

#membrly-member-menu
#membrly-member-messages
#membrly-member-notifications
#membrly-member-avatar

Shortcodes

These shortcodes are registered by the plugin modules.

Shortcode Typical Use Helpful Attributes
[membrly_registration] Complete registration and onboarding flow. None required.
[membrly_onboarding] Alternative onboarding shortcode registered by the registration module. None required.
[membrly_auth_button] Popup login/register launcher. label, auto_open="yes". Also supports opening with ?membrly_popup=1.
[membrly_member_menu] Compact member menu with messages, notifications, avatar, and account dropdown. show, guest, message_limit, notification_limit, badges.
[membrly_member_messages] Messages control only. Use where the full member menu is not needed.
[membrly_member_notifications] Notifications control only. Use where the full member menu is not needed.
[membrly_member_avatar] Member avatar and account dropdown only. Use in a header or top bar.
[membrly_team_directory] Public organization directory. title, description, view, include_members, show_email, show_member_status, empty_message, button_label.
[membrly_recent_members] Latest visible members. limit, columns, status, show_joined, show_status, show_plan, show_profile_button, empty_message, button_label.
[membrly_donor_plan] and [membrly_donation_form] Donation and donor-registration flows. None required.
[membrly_membership_card] Front/back membership card with QR verification. Requires member data and premium download/design features for full document flows.
[membrly_membership_letter] Membership confirmation letter. Premium member-letter settings control layout and content.
[membrly_appointment_letter] Office-bearer appointment letter. Office Bearers can provide title-specific body overrides.

Examples

[membrly_auth_button label="Login / Register"]
[membrly_auth_button auto_open="yes"]
[membrly_member_menu show="messages notifications avatar" badges="yes"]
[membrly_team_directory view="team" include_members="yes"]
[membrly_recent_members limit="8" columns="4"]

Memberships

Membrly tracks members through plan selection, payment status, member status, role progression, and optional founder-member date handling.

Roles

Members can progress through General Member, Primary Member, and Active Member roles. Plans can be mapped to roles from the plan editor.

Active Member Plan

The plugin seeds a direct Active Member self-registration plan at INR 1,000. Automatic Active Member promotion through referral quorum is part of the premium Referrals feature.

Suggested Membership Setup

  1. Create public membership plans and confirm pricing, duration, and role mapping.
  2. Publish the registration and plans pages.
  3. Test OTP delivery for the selected email and SMS providers.
  4. Submit a test payment and approve it from the admin payment review screen.
  5. Confirm that completed members can open the dashboard, profile, and document pages.

Donations and Campaigns

Membrly seeds campaign-aware donation types and can credit member wallets, generate referral links, track candidate pledge quorums, and send donation receipts when premium donation modules are active.

Seeded Donation Types

Membership Drive Sankalp Mitra Campaign Digital Election Campaign Donor Registration

Candidate Pledge Targets

Supporters Candidate Panel Default Pledge Model
100 Village Head / Block Head INR 50 monthly pledge for 60 months
200 Ward Member / Municipal Level INR 50 monthly pledge for 60 months
1,000 Legislative Assembly INR 50 monthly pledge for 60 months
2,000 Lok Sabha INR 50 monthly pledge for 60 months

Referral Rules

With premium Member KYC Verification, Referrals, and Campaign Achievements active, verified members receive unique membership and donation campaign referral URLs. Campaigns can require KYC before referral-linked donations are accepted.

Documents

Membrly can render membership cards, membership letters, appointment letters, donation receipts, and donor certificates. Premium settings control card design, document graphics, body copy, placeholders, signatures, and stamps.

ID Cards

Configure global card header, logo branding, font size, font type/style, text colors, and front/back logos in Membrly > ID Card Design.

Letters

Configure membership certificates and appointment letters in Membrly > Member Letters. Office-bearer titles can supply title-specific appointment-letter bodies.

Document Delivery

When membership is activated and premium document features are enabled, Membrly can email the Membership Card and Membership Certificate links once. Approved donation submissions can email donation receipts and Certificates of Appreciation when the donation receipt module is active.

Founder Join Dates

Founder-member dates let historical founding members display an organization join date that differs from their onboarding timestamp.

  1. Set the organization-wide founding date in Membrly > Settings > Organization Founding Date.
  2. Assign the Founder Member plan from Membrly > Members > View Member.
  3. Optionally set a member-specific Founder Join Date Override on the same member view.
  4. Confirm the founder join date on the member profile, membership card, and membership-letter surfaces.
Founder expiry behavior: Founder join dates change the displayed historical record only. Membership-card expiry continues to use the actual activation or onboarding date.

Mobile API

Membrly exposes REST endpoints under wp-json/membrly/v1/mobile/. In WordPress admin, open Membrly > API for live endpoint URLs, authentication guidance, and copyable request samples.

Endpoint Method Purpose Auth
/mobile/bootstrap GET Site, plugin, authentication, edition, and route metadata. Public
/mobile/plans GET Public self-registration plans and available payment gateways. Public
/mobile/campaigns GET Public campaign data. Public
/mobile/me GET Authenticated member profile, membership, pending payment, dashboard, and edition data. Logged in
/mobile/me/profile POST, PUT, or PATCH Authenticated text-based member profile updates. Logged in

Authentication

Use standard WordPress REST authentication: Application Passwords, cookie authentication for first-party apps, or a site-level REST authentication plugin. The bootstrap endpoint reports whether WordPress Application Passwords are available.

License Upgrade API

The license manager also registers /license-upgrade/config, /license-upgrade/request, /license-upgrade/payment, and /license-upgrade/status/{request_id} for the premium license purchase flow.

Troubleshooting

Issue What To Check
Frontend login does not open Confirm a published page contains [membrly_registration], [membrly_onboarding], or [membrly_auth_button]. Clear cache and test with ?membrly_popup=1.
OTP is not delivered Review OTP provider configuration, email deliverability, SMS provider hooks, and any resend throttling from the active provider.
UPI Pay checkout is unavailable Confirm UPI Pay is enabled, the user_token is saved, the gateway URL is correct, and the webhook URL is present in the UPI Pay dashboard.
Premium menus are missing Open Membrly > License and verify that the site license is active for the current administrator email and exact site URL.
Documents show old branding Review ID Card Design, Member Letters, media uploads, browser cache, and any page-cache plugin serving old document HTML.
Mobile app cannot read member data Public endpoints should load without authentication. Member endpoints require a logged-in REST session, Application Password, or compatible REST auth plugin.

Launch Checklist

  • Plugin activated and WordPress/PHP requirements confirmed.
  • Organization name, support details, founding date, OTP settings, and policy content saved.
  • Membership plans, role mappings, and Active Member pricing reviewed.
  • UPI or UPI Pay settings configured and test payment completed.
  • Registration, plans, dashboard, profile, donor, directory, and document pages published.
  • Header or menu includes member login, messages, notifications, and avatar controls where needed.
  • Premium license verified on sites that need premium modules.
  • ID card, member letter, welcome email, typography, and donation receipt branding reviewed.
  • Founder member handling tested for at least one founder profile when founders are used.
  • REST API bootstrap, plans, campaigns, and authenticated member endpoints tested for mobile integrations.
  • Full member journey tested from registration through dashboard and document delivery.