Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/cjbodullo/essential-checklist-audiobook/archive/refs/heads/main.zipWordPress plugin with a Babylist-style editorial hospital bag checklist page and a custom audio player widget.
Plugin file: essential-checklist-plugin.php
Version: 1.0.0
Text domain: essential-checklist-plugin
Inspired by Babylist's hospital bag guide.
Requirements
- WordPress 5.x+
- PHP 7.4+
Installation
- Copy the
essential-checklist-pluginfolder intowp-content/plugins/. - Activate Essential Hospital Bag Checklist under Plugins.
- Go to Settings → Hospital Bag Checklist and configure the audio widget (optional).
- Add a shortcode to any page or post.
Shortcodes
| Shortcode | Description |
|---|---|
[essential_checklist] |
Full checklist article + audio widget |
[essential_checklist_audio] |
Audio player widget only |
Basic usage
[essential_checklist]
[essential_checklist_audio]
With options
[essential_checklist max_width="100%"]
[essential_checklist_audio max_width="800px"]
[essential_checklist show_audio="no"]
[essential_checklist audio_url="https://yoursite.com/audio.mp3" logo_url="https://yoursite.com/logo.webp"]
Shortcode attributes
| Attribute | [essential_checklist] |
[essential_checklist_audio] |
Default |
|---|---|---|---|
max_width |
Yes | Yes | 1200px |
audio_url |
Yes | Yes | Settings, or assets/essential.mp3 |
logo_url |
Yes | Yes | Settings, or assets/logo.webp |
listen_label |
Yes | Yes | Settings, or Listen Now |
show_audio |
Yes | — | yes |
Attribute values from the shortcode override Settings → Hospital Bag Checklist.
Settings
Settings → Hospital Bag Checklist
| Setting | Description |
|---|---|
| Audio file URL | MP3 for the player. Use Media Library to pick a file. |
| Logo image URL | Image on the left of the audio widget. |
| Listen label | Text above the waveform (default: Listen Now). |
If audio or logo URLs are left blank, the plugin uses bundled files:
assets/essential.mp3assets/logo.webp
Checklist page layout
- Hero title + subtitle
- Intro paragraphs
- In This Article sidebar (1/4 width) with section jump links
- Main article content (3/4 width)
- H2 / H3 sections with permalink heading links
- Checklist lists with optional product links
- Default max width:
1200px
The audio widget is placed above How To Organize Your Hospital Bags via the `` placeholder in the HTML content file.
Audio widget
- Logo, play / pause button, waveform progress, listen label
- Elapsed time / total duration (
0:00 / 5:32) - Click waveform to seek
- Speed button cycles: 1x → 1.25x → 1.5x → 2x
- Scrolls with the page (not sticky)
Use [essential_checklist_audio] to embed the player alone on any page.
Updating checklist content
Edit assets/html/hospital-checklist-content.html directly.
Useful CSS classes:
| Class | Purpose |
|---|---|
ecl-article |
Article wrapper |
ecl-section |
Major section |
ecl-heading / ecl-heading-link |
Linked section headings |
ecl-checklist |
Bullet checklist |
ecl-checklist--links |
Checklist with product links |
ecl-toc |
Sidebar table of contents |
Styles: assets/css/essential-checklist.css
To move the audio widget, move `` in the HTML file.
Plugin files
| File | Purpose |
|---|---|
essential-checklist-plugin.php |
Bootstrap, settings, shortcodes |
assets/html/hospital-checklist-content.html |
Checklist article HTML |
assets/css/essential-checklist.css |
All frontend styles |
assets/js/essential-checklist.js |
Audio player + sidebar nav |
assets/js/essential-checklist-admin.js |
Media Library picker in admin |
assets/essential.mp3 |
Default audio (bundled fallback) |
assets/logo.webp |
Default logo (bundled fallback) |
Development notes
- All frontend styles are scoped under
.ecl-shell. - Checklist HTML is loaded with
file_get_contents()and cached per request. - Audio markup is injected by replacing `` in the HTML file.
- CSS/JS versions use the
ECL_VERSIONconstant (1.0.0) for cache busting.