Deployment blueprint

Plumbing marketplace deployment generator

Use this page to generate preset-aware hosted URLs, widget snippets, iframe fallbacks, and WordPress-ready embed blocks for provider sites, ZIP pages, estimate pages, commercial pages, and provider recruitment.

Recipe: Provider recruitment widgetZIP: 19103City: PhiladelphiaWidget: Provider network drawer

Deployment recipes

Choose the page pattern you are generating for

Provider homepage emergency widgetBest default for provider websites that want more emergency plumbing calls and bookings.ZIP SEO page urgent widgetBest for high-volume local SEO deployments across many ZIPs.Estimate page widgetBest for water heater, repiping, fixture, and planned project pages.Commercial service page widgetBest for property teams, facilities managers, and building operators.Provider recruitment widgetBest for scaling the supply side of the marketplace.

What this recipe is best for

Provider recruitment widget

Marketplace or region page needs to recruit more plumbers into coverage cells.

  • Recruiting microsite
  • Join our network page
  • Marketplace footer CTA

Hosted URL

Direct handoff link

https://leados.yourdeputy.com/join-provider-network

Preview

Hosted landing page

Best for ads, SEO, SMS, QR codes, directory links, and dedicated conversion handoffs.

Open live pageJoin a plumbing network built for better-fit local jobs

Widget install

Preset-aware JavaScript embed

<script>
  window.LeadOSConfig = {
    runtimeBaseUrl: "https://leados.yourdeputy.com",
    niche: "plumbing",
    service: "provider-network",
    family: "qualification",
    mode: "form-first",
    entrypoint: "plumbing-provider",
    audience: "provider",
    pageType: "provider-recruitment-page",
    zip: "19103",
    city: "Philadelphia",
    launcherLabel: "Join provider network"
  };
</script>
<script src="https://leados.yourdeputy.com/embed/lead-os-embed.js"></script>

Preview

Embedded widget behavior

This preview shows how the launcher will present itself on a client website before the drawer opens.

Client site preview

Join a plumbing network built for better-fit local jobs

Supply-side onboarding drawer for service-area, specialty, and coverage intake.

Provider network drawerJoin provider network

WordPress HTML block

Paste into Gutenberg or a custom HTML widget

<!-- LeadOS HTML block for WordPress -->
<div class="leados-embed-slot"></div>
<script>
  window.LeadOSConfig = {
    runtimeBaseUrl: "https://leados.yourdeputy.com",
    niche: "plumbing",
    service: "provider-network",
    family: "qualification",
    mode: "form-first",
    entrypoint: "plumbing-provider",
    audience: "provider",
    pageType: "provider-recruitment-page",
    zip: "19103",
    city: "Philadelphia",
    launcherLabel: "Join provider network"
  };
</script>
<script src="https://leados.yourdeputy.com/embed/lead-os-embed.js"></script>

Preview

WordPress block result

Use this when the client site needs a paste-ready deployment inside a page builder or custom HTML block.

Placement

Provider recruitment widget

  • Paste into a Gutenberg custom HTML block.
  • The script boots the matching LeadOS widget and launcher label automatically.
  • Best for teams that want widget deployment without plugin installation.

WordPress plugin file

Install a generated plugin instead of pasting snippets manually

<?php
/**
 * Plugin Name: LeadOS Join a plumbing network built for better-fit local jobs
 * Description: Generated LeadOS deployment plugin for Join a plumbing network built for better-fit local jobs.
 * Version: 0.1.0
 * Author: LeadOS
 */

if (!defined('ABSPATH')) {
    exit;
}

function leados_generated_default_config() {
    return array(
  'runtimeBaseUrl' => 'https://leados.yourdeputy.com',
  'niche' => 'plumbing',
  'service' => 'provider-network',
  'family' => 'qualification',
  'mode' => 'form-first',
  'entrypoint' => 'plumbing-provider',
  'audience' => 'provider',
  'pageType' => 'provider-recruitment-page',
  'zip' => '',
  'city' => 'Philadelphia',
  'launcherLabel' => 'Join provider network',
);
}

function leados_generated_enqueue_runtime() {
    wp_enqueue_script(
        'leados-generated-runtime',
        'https://leados.yourdeputy.com/embed/lead-os-embed.js',
        array(),
        null,
        true
    );
}
add_action('wp_enqueue_scripts', 'leados_generated_enqueue_runtime');

function leados_generated_render_embed($atts = array()) {
    $defaults = leados_generated_default_config();
    $merged = shortcode_atts(
        array(
            'runtimeBaseUrl' => $defaults['runtimeBaseUrl'],
            'niche' => $defaults['niche'],
            'service' => $defaults['service'],
            'family' => $defaults['family'],
            'mode' => $defaults['mode'],
            'entrypoint' => $defaults['entrypoint'],
            'audience' => $defaults['audience'],
            'pageType' => $defaults['pageType'],
            'zip' => $defaults['zip'],
            'city' => $defaults['city'],
            'launcherLabel' => $defaults['launcherLabel'],
        ),
        $atts,
        'leados_embed'
    );

    $config = array_filter($merged, function ($value) {
        return $value !== null && $value !== '';
    });

    ob_start();
    ?>
    <div class="leados-embed-slot" data-leados-entrypoint="<?php echo esc_attr($config['entrypoint']); ?>"></div>
    <script>
      window.LeadOSConfig = Object.assign({}, window.LeadOSConfig || {}, <?php echo wp_json_encode($config); ?>);
    </script>
    <?php
    return ob_get_clean();
}
add_shortcode('leados_embed', 'leados_generated_render_embed');

function leados_generated_maybe_render_sitewide() {
    if (apply_filters('leados_generated_sitewide_enabled', false) !== true) {
        return;
    }
    echo leados_generated_render_embed();
}
add_action('wp_footer', 'leados_generated_maybe_render_sitewide');

Preview

Plugin package preview

This option is best when you want a reusable installable WordPress deployment instead of page-by-page snippet pasting.

Plugin file
lead-os-provider-provider-recruitment-page-join-provider-network.php
Shortcode
[leados_embed]
Download
https://leados.yourdeputy.com/api/embed/wordpress-plugin?entrypoint=plumbing-provider&pageType=provider-recruitment-page&niche=plumbing&audience=provider&service=provider-network&family=qualification&mode=form-first&launcherLabel=Join+provider+network&download=1&city=Philadelphia

Iframe fallback

Full hosted-page embed

<iframe src="https://leados.yourdeputy.com/join-provider-network" title="Join a plumbing network built for better-fit local jobs" loading="lazy" style="width:100%;min-height:860px;border:0;border-radius:24px;"></iframe>

Preview

Iframe embed result

Best when a client wants the full hosted LeadOS experience embedded instead of a widget launcher.

APIs

Use these endpoints in plugins and agency tooling

  • Generator endpoint: https://leados.yourdeputy.com/api/embed/generate?recipe=provider-recruitment-widget&niche=plumbing&service=provider-network&entrypoint=plumbing-provider&audience=provider&pageType=provider-recruitment-page&zip=19103&city=Philadelphia
  • Widget boot: https://leados.yourdeputy.com/api/widgets/boot?niche=plumbing&service=provider-network&family=qualification&mode=form-first&entrypoint=plumbing-provider&audience=provider&pageType=provider-recruitment-page&launcherLabel=Join+provider+network&city=Philadelphia
  • Embed manifest: https://leados.yourdeputy.com/api/embed/manifest
  • WordPress plugin: https://leados.yourdeputy.com/api/embed/wordpress-plugin?entrypoint=plumbing-provider&pageType=provider-recruitment-page&niche=plumbing&audience=provider&service=provider-network&family=qualification&mode=form-first&launcherLabel=Join+provider+network&download=1&city=Philadelphia
  • WordPress shortcode: [leados_embed]

Success metrics

What this deployment should be judged by

  • Provider application starts
  • Approved provider rate
  • Coverage growth by ZIP

Bulk ZIP rollout

Generate many localized deployments at once

https://leados.yourdeputy.com/api/embed/generate-bulk?recipe=provider-recruitment-widget&city=Philadelphia&zips=19103%2C19104%2C19107&limit=12

https://leados.yourdeputy.com/api/embed/generate-bulk?recipe=provider-recruitment-widget&city=Philadelphia&zips=19103%2C19104%2C19107&limit=12&format=csv

Preview

Bulk rollout result

Use this when rolling out emergency or estimate widgets across many ZIP-level pages at once.

3 generated packagesPhiladelphia

Preview of generated ZIP packages

First 3 localized deployments

https://leados.yourdeputy.com/join-provider-networkProvider network drawer
https://leados.yourdeputy.com/join-provider-networkProvider network drawer
https://leados.yourdeputy.com/join-provider-networkProvider network drawer