← All use cases

Agency client deployment

Hand a directory site to a client without locking them to a plugin brand

Block-first, theme-agnostic, fully extensible via documented hooks. White label renames the plugin and its admin menu for the client. Clients get a directory under their brand, agencies keep maintenance sane.

What you are building

A directory site that a client paid you to build, that runs on stock WordPress, that doesn’t lock the client to your custom code, that you can hand off without becoming a permanent support contract. The client’s brand on every surface. Your customizations layered on top via documented hooks, not by editing plugin source.

Think the typical WordPress agency engagement - quoted at $15K-$50K - delivered with the build effort cut in half because the directory plugin already shipped 80% of what the client asked for.

Why custom + bolt-on stacks become maintenance contracts

The two ends of the agency project are both broken:

Custom build. Write a directory from scratch (CPT + ACF + faceted search + payments + claims + reviews + anti-spam). Quote 4-8 weeks. Spend 12. Take on permanent maintenance because you wrote it.

Bolt-on stack. Stitch together Directorist + Pricing Plans + Multi-Vendor + Featured Listings + Reviews extension + Stripe + a CAPTCHA plugin. Quote 2 weeks. Spend 4. The client now depends on 6 plugins from 4 vendors, each with their own update cadence. Maintenance is a constant fire drill.

Listora was designed to be the agency-friendly third path: ship the directory + the monetization in one plugin, then make every surface overrideable via documented hooks so you can customize without forking.

What makes Listora agency-friendly

Block-first, theme-agnostic. 11 Gutenberg blocks with the Interactivity API + 5 Pro blocks. Works with any block theme (Astra, Kadence, GeneratePress, Blocksy, BuddyX) or classic theme via WooCommerce-style template overrides. No theme dependency.

Hundreds of documented extension hooks. Actions and filters with full argument signatures. Want to add data to the listing card? Filter wb_listora_card_view_data. Want to gate submission behind a custom rule? Hook wb_listora_before_create_listing. Documented, versioned, never breaks on a Listora update.

Template overrides (WooCommerce-style). Copy any template from wb-listora/templates/ to {your-theme}/wb-listora/ and edit. Override only the templates that need it, leave the rest to inherit the plugin’s defaults. Updates to Listora never overwrite your overrides.

Service locator + interfaces. Pro consumes Free through documented hooks + service-locator keys + \WBListora\Contracts\* interfaces. The same architecture is available to agency code - never reach into \WBListora\Core\* directly, always consume the public surface.

White label (every Pro licence). Rename the plugin on the Plugins screen and in the admin menu, and hide the author details there. The same screen sets the logo, accent colour and login background for the mobile app. Front-end text and email templates are yours to edit through templates and the notification settings.

What you save on a typical agency build

The directory features that would take 8-12 weeks to hand-build all ship in Free:

  • Faceted search with geo + radius (Free)
  • Frontend submission wizard with conditional fields per type (Free)
  • Business claims workflow (Free)
  • Layered anti-spam: honeypot, rate limits, keyword blacklist, URL-density checks (Free)
  • Reviews with owner reply + helpful votes (Free)
  • 9 demo packs across verticals (Free)
  • 70+ REST routes for headless or mobile frontends (Free)
  • 13 WP-CLI subcommands for bulk ops (Free)

Pro adds the monetization stack that another 4-6 weeks would cost:

  • Credit-based pricing plans with Hold-and-Commit activation
  • Seven ways to take payment into one credit ledger: Stripe and PayPal built in, plus five plugin adapters
  • A lead form that emails the owner and counts each enquiry per listing
  • Verification badges, ready-made review criteria sets with a ratings breakdown, photo reviews
  • Side-by-side comparison
  • Reverse Needs Marketplace
  • Moderators role with scoped capabilities
  • Saved searches with daily alerts
  • More REST routes, for 140+ in total with Free

A quote that would have been 14 weeks of build effort drops to 4-6 weeks of customization + theme work. The other 10 weeks become margin.

How you customize cleanly

Three layers of customization, in order of preference:

1. theme.json + CSS. Match the client’s color palette + typography via theme.json and the v2 token cascade. No PHP needed.

2. Template overrides. Copy the templates that need brand-specific markup (listing card, listing detail, submission steps) to {theme}/wb-listora/. Edit. Stay on the documented template hook signatures.

3. Code via hooks. Drop a mu-plugin or theme-functions snippet that uses the documented filters and actions. Field validation, custom emails, integration with the client’s CRM or analytics, third-party payment gateways via the Wbcom Credits SDK.

Every customization is documented + versioned. Listora updates don’t break your code.

Pricing for an agency-tier license

Listora Pro Agency ($199 / year or $499 lifetime) includes:

  • Unlimited client sites on the annual licence (the lifetime licence covers 3)
  • White label, as in every Pro licence
  • Live chat for urgent issues and free migration of your first client
  • Priority release-candidate access
  • 30-day money-back guarantee

Support tickets get a first reply within 1-2 business days. On the annual licence, one license covers your whole client roster, so the economics work out on the first project.