Deployment recipes
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.
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/19103Preview
Best for ads, SEO, SMS, QR codes, directory links, and dedicated conversion handoffs.
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
This preview shows how the launcher will present itself on a client website before the drawer opens.
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
Use this when the client site needs a paste-ready deployment inside a page builder or custom HTML block.
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
This option is best when you want a reusable installable WordPress deployment instead of page-by-page snippet pasting.
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
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=csvPreview
Use this when rolling out emergency or estimate widgets across many ZIP-level pages at once.
Preview of generated ZIP packages