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
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-networkPreview
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: "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
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: "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
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 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
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/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
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=csvPreview
Use this when rolling out emergency or estimate widgets across many ZIP-level pages at once.
Preview of generated ZIP packages