On this page
What the widget does
The Weekend Pitmasters Smoke Planner is a free BBQ cook-time calculator that works backward from your target serve time. It accounts for the meat type and weight, pit and fuel, wrap strategy, cold-start penalty, and live weather conditions to produce a minute-by-minute schedule that tells you exactly when to fire up, when to wrap, and when to pull.
When embedded on your site, your visitors get the complete planning experience — without ever leaving your page.
postMessage so the iframe grows with the content — no scroll bars.
Quick start
Paste this <iframe> tag into your page HTML. That's it — no scripts, no API keys, no backend setup required.
<iframe
src="https://www.weekendpitmasters.com/?embed=1"
id="wpm-planner"
width="100%"
height="800"
frameborder="0"
title="Weekend Pitmasters Smoke Planner"
loading="lazy"
></iframe>
The ?embed=1 query parameter hides the Weekend Pitmasters navigation and footer so the planner sits cleanly inside your own page layout. The starting height of 800 is a safe default — use the auto-resize snippet below to keep it exact as the content changes.
Auto-resize the iframe height
The planner sends a postMessage event each time its content height changes — for example when the results panel expands after a plan is calculated, or when the confidence breakdown is toggled open. Add this small script to your host page so the iframe always matches its content exactly.
window.addEventListener('message', function (e) {
if (e.data && e.data.type === 'wpm-resize') {
var frame = document.getElementById('wpm-planner');
if (frame) frame.style.height = e.data.height + 'px';
}
});
The planner emits { type: 'wpm-resize', height: <pixels> } whenever a ResizeObserver detects a layout change. The script above reads e.data.height and updates frame.style.height. No polling, no timers — purely event-driven.
Multiple iframes on one page: if you embed more than one instance, verify event.origin against https://www.weekendpitmasters.com and match the iframe element by ID or data attribute before applying the height, so messages from one frame do not affect the other.
Example 1 — BBQ blog post
This is the simplest integration. Drop the iframe directly into a blog post or recipe page. The planner will appear inline with your content and visitors can use it without navigating away.
Add this block anywhere in your article — after your timing section is a natural spot.
<!-- Weekend Pitmasters Smoke Planner widget -->
<div style="margin: 2rem 0;">
<h3 style="margin-bottom: 0.5rem;">Plan your brisket cook</h3>
<p style="margin-bottom: 1rem; color: #666;">
Use this free planner to get your exact fire-up time and full timeline.
</p>
<iframe
src="https://www.weekendpitmasters.com/?embed=1"
id="wpm-planner"
width="100%"
height="800"
frameborder="0"
title="BBQ Smoke Planner"
loading="lazy"
></iframe>
</div>
This produces a clean, scrollable planner widget. No additional JavaScript is required for this basic use case. Visitors who want to share or print their plan can do so entirely within the widget.
Example 2 — Advanced embed with auto-resize
This example adds the auto-resize listener so the iframe grows and shrinks with the content. It also sets the initial meat selection to brisket via the URL, so your readers land directly on the most relevant configuration.
A dedicated tools page that always resizes correctly and starts on brisket.
<!-- Weekend Pitmasters Smoke Planner — auto-resizing embed -->
<iframe
src="https://www.weekendpitmasters.com/?embed=1"
id="wpm-planner"
width="100%"
height="820"
frameborder="0"
style="border: none; border-radius: 8px; display: block;"
title="Weekend Pitmasters Smoke Planner"
loading="lazy"
></iframe>
<script>
window.addEventListener('message', function (e) {
if (e.origin !== 'https://www.weekendpitmasters.com') return;
if (e.data && e.data.type === 'wpm-resize') {
var frame = document.getElementById('wpm-planner');
if (frame) frame.style.height = (e.data.height + 32) + 'px';
}
});
</script>
The + 32 adds a small buffer (32 px) to prevent any content from being cut off by sub-pixel rounding differences between browsers. Adjust this number up or down to taste.
The e.origin check is a security best practice: it ensures your resize handler only responds to messages from the planner, and not from other iframes or third-party scripts that might also use postMessage.
Live preview
This is exactly what your visitors will see — the full planner, without the Weekend Pitmasters header or footer.
What's included in the widget
- Meat selector — 14 cuts across pork, beef, poultry, and lamb, with cooking style (Low & Slow, Steady, Hot & Fast, High Heat)
- Pit & fuel selection — Big Green Egg, offset smoker, pellet grill, kamado, bullet/WSM, charcoal, gas, or custom
- Serve time picker — quick Today / Tomorrow buttons or a custom date and time
- Advanced options — wrap strategy (none / butcher paper / foil), rest duration, buffer window, and glaze finish toggle
- Environment settings — bone-in / bone-out, fridge-cold / room-temp, water pan on / off
- Weather adjustment — preset condition profiles or live NWS forecast for any US ZIP code
- Full timeline — trim & prep, fire-up, on-smoker, wrap window, glaze, pull & rest, and serve time
- Confidence score — a reliability rating (50–100 %) with a breakdown of every factor that affects the estimate
- Fuel estimate — pounds of charcoal, lump, pellets, or wood splits needed
- Print & share — print a cook sheet or generate a shareable URL that pre-fills the planner
What embed mode hides
When ?embed=1 is present, the planner omits:
- The Weekend Pitmasters hero / branding section
- The site navigation bar
- The site footer (including the photo credit)
Everything else — all calculations, weather integration, sharing, and printing — works identically to the full site.
Terms of use
The embed widget is offered free of charge under the following terms. By embedding the planner you agree to these terms.
✓ Permitted uses
Commercial and non-commercial use. You may embed the planner on any website, blog, or web application — whether or not that site carries advertising or charges for access — at no cost.
Multiple pages or domains. You may embed the planner on as many pages or domains as you like under the same terms.
Styling and layout customisation. You are free to size the iframe, add a surrounding container, apply CSS to your wrapper, or pre-scroll to the planner — so long as the iframe itself points to the canonical URL.
Offline / PWA contexts. Embedding on a Progressive Web App or service-worker-cached page is permitted, provided the iframe src still resolves to the live URL when connectivity is available.
✗ Not permitted
Removing or obscuring attribution. Do not overlay, hide, or otherwise suppress the "Weekend Pitmasters" credit that appears inside the planner. The attribution must remain visible to end users.
Hotlinking assets directly. Do not reference individual JavaScript, CSS, or image files from the Weekend Pitmasters origin. Only the full-page iframe URL (https://www.weekendpitmasters.com/?embed=1) is offered for embedding.
Misrepresenting the tool as your own. You may introduce the planner as a tool you are providing to your readers, but you may not claim to have built it or present it in a way that intentionally deceives users about its origin.
Embedding on sites that violate applicable law. The widget may not be embedded on sites that promote illegal activity or that otherwise violate applicable local, national, or international law.
The planner and all related content are provided "as is" without warranty of any kind. Weekend Pitmasters makes no guarantee of uptime, accuracy, or fitness for a particular purpose. Cook times are estimates — always verify doneness by internal temperature.
These terms may be updated at any time. Continued use of the embed constitutes acceptance of any revised terms. If you have questions or want to discuss a partnership, reach out.