Skip to content

MainWP — Clients & Sites

WPSigner for MainWP surfaces contracts wherever agencies already work in MainWP — Dashboard, Clients, and Sites.


On the MainWP Dashboard overview, the Contracts metabox (imwp-contracts-widget) shows:

  • Alert when contracts are awaiting signature
  • Stats: Total / Awaiting / Completed
  • Recent contracts (up to 6)
  • Buttons: New contract, View all

View all opens the extension Contracts tab. New contract opens Create.


A compact Contract card appears on:

  • Client Overview
  • Site overview / dashboard contexts (when a site id is present)
ElementDescription
Latest contractTitle + status
CountsTotal linked · Awaiting signature
New contractOpens Create with client_id / site_id prefilled
Quick create & sendUses default template (hidden/disabled messaging if none set)
View allFiltered Contracts list for that Client or Site

The card syncs a short summary for the site via MainWP website option key imwp_contract, plus local mirrors:

  • imwp_client_contract_{client_id}
  • imwp_site_contract_{site_id}

These are convenience caches for the UI — source of truth remains wps_mainwp_links + WPSigner documents.


Path: Sites → [site] → WPSigner (MainWP site subpage slug WpsignerIndividual / Manage Sites WPSigner).

  • Site name and URL context
  • Create contract (prefilled site + linked client when available)
  • Quick create & send when Settings has a default template
  • Compact contracts table for that site (20 rows)

If the site id is missing from the request, the tab shows a site-not-found style message — open the tab from a valid site screen.


On Sites → Manage Sites, column WPSigner shows:

ValueMeaningTypical click-through
pendingOne or more awaiting signatureFiltered documents (awaiting) for that site
OKHas linked contracts, none awaitingSite contracts
NoneNo linked contractsCreate with site prefilled

If WPSigner is not ready, the column may show a dash.


On the MainWP Clients table, column WPSigner uses the same pending / OK / None pattern scoped to client_id.

Client widgets can show an onboarding CTA when the client has zero contracts.


When at least one linked contract is awaiting signature (sent or viewed), users may see:

  1. A WordPress admin notice
  2. A MainWP-style orange banner on MainWP-related screens

Both point to the Contracts list filtered to awaiting signatures for quick review.


SurfaceAction
Contract card (Client)Quick create & send for that client
Contract card (Site)Quick create & send for that site (+ client if linked)
Site WPSigner tabSame

Requirements and failure modes: Creating Contracts → Quick create.


  1. Connect Sites and Clients in MainWP as usual.
  2. Set Default template + agency signer in Settings.
  3. From a Client or Site card, use Quick create & send for standard agreements.
  4. Use Create for custom titles, extra signers, or one-off OTP/KYC.
  5. Watch the Dashboard Contracts widget and pending banners for follow-ups.
  6. Use Remind / bulk remind from the Contracts list.
  7. When fully signed, Open → Download PDF (completed only).