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: ZIP SEO page urgent widgetZIP: 19103City: PhiladelphiaWidget: Sticky mobile dispatch bar

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

ZIP SEO page urgent widget

Local search landing page needs ZIP-aware urgency capture and local trust framing.

  • Sticky mobile bar
  • Inline section after local trust copy
  • Repeat CTA lower on page

Hosted URL

Direct handoff link

https://leados.yourdeputy.com/local/19103

Preview

Hosted landing page

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

Open live pageNeed a plumber in 19103?

Widget install

Preset-aware JavaScript embed

<script>
  window.LeadOSConfig = {
    runtimeBaseUrl: "https://leados.yourdeputy.com",
    niche: "plumbing",
    service: "local-plumbing",
    family: "qualification",
    mode: "booking-first",
    entrypoint: "plumbing-local",
    audience: "client",
    pageType: "zip-seo-page",
    zip: "19103",
    city: "Philadelphia",
    launcherLabel: "Get local plumbing help"
  };
</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

Need a plumber in 19103?

Mobile-only emergency launcher designed for thumb-zone urgency behavior.

Sticky mobile dispatch barGet local plumbing help

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: "local-plumbing",
    family: "qualification",
    mode: "booking-first",
    entrypoint: "plumbing-local",
    audience: "client",
    pageType: "zip-seo-page",
    zip: "19103",
    city: "Philadelphia",
    launcherLabel: "Get local plumbing help"
  };
</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

ZIP SEO page urgent 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 Need a plumber in 19103?
 * Description: Generated LeadOS deployment plugin for Need a plumber in 19103?.
 * 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' => 'local-plumbing',
  'family' => 'qualification',
  'mode' => 'booking-first',
  'entrypoint' => 'plumbing-local',
  'audience' => 'client',
  'pageType' => 'zip-seo-page',
  'zip' => '19103',
  'city' => 'Philadelphia',
  'launcherLabel' => 'Get local plumbing help',
);
}

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-local-zip-seo-page-get-local-plumbing-help.php
Shortcode
[leados_embed]
Download
https://leados.yourdeputy.com/api/embed/wordpress-plugin?entrypoint=plumbing-local&pageType=zip-seo-page&niche=plumbing&audience=client&service=local-plumbing&family=qualification&mode=booking-first&launcherLabel=Get+local+plumbing+help&download=1&zip=19103&city=Philadelphia

Iframe fallback

Full hosted-page embed

<iframe src="https://leados.yourdeputy.com/local/19103" title="Need a plumber in 19103?" 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=zip-seo-page-urgent-widget&niche=plumbing&service=local-plumbing&entrypoint=plumbing-local&audience=client&pageType=zip-seo-page&zip=19103&city=Philadelphia
  • Widget boot: https://leados.yourdeputy.com/api/widgets/boot?niche=plumbing&service=local-plumbing&family=qualification&mode=booking-first&entrypoint=plumbing-local&audience=client&pageType=zip-seo-page&launcherLabel=Get+local+plumbing+help&zip=19103&city=Philadelphia
  • Embed manifest: https://leados.yourdeputy.com/api/embed/manifest
  • WordPress plugin: https://leados.yourdeputy.com/api/embed/wordpress-plugin?entrypoint=plumbing-local&pageType=zip-seo-page&niche=plumbing&audience=client&service=local-plumbing&family=qualification&mode=booking-first&launcherLabel=Get+local+plumbing+help&download=1&zip=19103&city=Philadelphia
  • WordPress shortcode: [leados_embed]

Success metrics

What this deployment should be judged by

  • Local page conversion rate
  • ZIP-specific booking starts
  • Human fallback usage

Bulk ZIP rollout

Generate many localized deployments at once

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

https://leados.yourdeputy.com/api/embed/generate-bulk?recipe=zip-seo-page-urgent-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/local/19103Sticky mobile dispatch bar
https://leados.yourdeputy.com/local/19104Sticky mobile dispatch bar
https://leados.yourdeputy.com/local/19107Sticky mobile dispatch bar