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 homepage emergency widgetZIP: 19103City: PhiladelphiaWidget: Urgent dispatch 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 homepage emergency widget

Independent plumber or local service website needs urgent demand conversion without redirecting away.

  • Sticky launcher
  • Hero CTA
  • Emergency service page sidebar

Hosted URL

Direct handoff link

https://leados.yourdeputy.com/plumbing/emergency

Preview

Hosted landing page

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

Open live pageNeed a plumber fast in your area?

Widget install

Preset-aware JavaScript embed

<script>
  window.LeadOSConfig = {
    runtimeBaseUrl: "https://leados.yourdeputy.com",
    niche: "plumbing",
    service: "emergency-plumbing",
    family: "qualification",
    mode: "booking-first",
    entrypoint: "plumbing-emergency",
    audience: "client",
    pageType: "provider-homepage",
    zip: "19103",
    city: "Philadelphia",
    launcherLabel: "Need a plumber now?"
  };
</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 fast in your area?

Fast-launching drawer optimized for emergency plumbing and same-session dispatch intent.

Urgent dispatch drawerNeed a plumber now?

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: "emergency-plumbing",
    family: "qualification",
    mode: "booking-first",
    entrypoint: "plumbing-emergency",
    audience: "client",
    pageType: "provider-homepage",
    zip: "19103",
    city: "Philadelphia",
    launcherLabel: "Need a plumber now?"
  };
</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 homepage emergency 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 fast in your area?
 * Description: Generated LeadOS deployment plugin for Need a plumber fast in your area?.
 * 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' => 'emergency-plumbing',
  'family' => 'qualification',
  'mode' => 'booking-first',
  'entrypoint' => 'plumbing-emergency',
  'audience' => 'client',
  'pageType' => 'provider-homepage',
  'zip' => '',
  'city' => 'Philadelphia',
  'launcherLabel' => 'Need a plumber now?',
);
}

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-emergency-provider-homepage-need-a-plumber-now.php
Shortcode
[leados_embed]
Download
https://leados.yourdeputy.com/api/embed/wordpress-plugin?entrypoint=plumbing-emergency&pageType=provider-homepage&niche=plumbing&audience=client&service=emergency-plumbing&family=qualification&mode=booking-first&launcherLabel=Need+a+plumber+now%3F&download=1&city=Philadelphia

Iframe fallback

Full hosted-page embed

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

Success metrics

What this deployment should be judged by

  • Widget open rate
  • Dispatch-start rate
  • Booked lead rate

Bulk ZIP rollout

Generate many localized deployments at once

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

https://leados.yourdeputy.com/api/embed/generate-bulk?recipe=provider-homepage-emergency-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/plumbing/emergencyUrgent dispatch drawer
https://leados.yourdeputy.com/plumbing/emergencyUrgent dispatch drawer
https://leados.yourdeputy.com/plumbing/emergencyUrgent dispatch drawer