WP Manifestindependent plugin directory
manifest / content / wakechef-cook-mode

WakeChef Cook Mode

WakeChef Cook Mode: a WordPress plugin that adds a Cook Mode toggle to recipes, keeping readers' screens awake with the Screen Wake Lock API. Works with WP Recipe Maker, any post type, a block, or a shortcode.

by Ali Nawaz · github.com/bealinawaz/wakechef-cook-mode · website

★ 0stars

Install

Download source zip No release zip yet

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/bealinawaz/wakechef-cook-mode/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/bealinawaz/wakechef-cook-mode ↗

WakeChef Cook Mode on WordPress.org · formerly Recipe Cook Mode

A WordPress plugin that adds a Cook Mode toggle to recipes. When a reader switches it on, their screen stays awake until they switch it off or leave the page, so it doesn't go dark while they cook.

Features

  • WP Recipe Maker: one checkbox adds the toggle to every recipe card, at the top or bottom. No template editing needed.
  • Any post type or category: automatically add the toggle to posts, pages, or custom post types, optionally limited to chosen categories. Works with recipes from any plugin or written straight into the post.
  • Block: a Cook Mode block for the block editor, with per-block label and description.
  • Shortcode: [wakechef_cook_mode label="Keep screen on" description="Handy while kneading"].
  • Resumes automatically: browsers release the wake lock when a page is hidden. Cook Mode turns back on when the reader returns.
  • Several recipes per page: every toggle works and they stay in sync.
  • Accessible: a labelled switch with keyboard support and screen reader status announcements.
  • Lightweight: plain JavaScript, no jQuery. Assets load only on pages that show the toggle, and the toggle is hidden when printing.

If a post contains a WP Recipe Maker card, a Cook Mode block, or the shortcode, automatic placement skips it, so a post never shows two toggles.

How it works

Cook Mode uses the browser's Screen Wake Lock API, supported in current Chrome, Edge, Safari (16.4+), and Firefox. In browsers without support, the toggle is disabled and explains why. Nothing is sent to any server.

Setup

  1. Install it from Plugins → Add New (search for "WakeChef Cook Mode") and activate it.
  2. Go to Settings → WakeChef Cook Mode to set the label, description, and accent color.
  3. With WP Recipe Maker active, the toggle is added to recipe cards automatically. Choose its position.
  4. For other recipes, choose post types and categories under Automatic placement, or use the block or shortcode.

Project structure

wakechef-cook-mode.php                          Plugin header and bootstrap
includes/class-wakechef-cook-mode.php           Toggle markup, WP Recipe Maker hook, auto-insert, shortcode, block
includes/class-wakechef-cook-mode-settings.php  Settings defaults and validation
includes/class-wakechef-cook-mode-admin.php     Settings screen
assets/cook-mode.js                             Wake lock handling
assets/cook-mode.css                            Toggle styles
assets/block.js                                 Block editor integration
uninstall.php                                   Removes the plugin's settings
readme.txt                                      WordPress.org readme

Requirements

  • WordPress 6.2 or later (tested up to 7.1)
  • PHP 7.4 or later (tested up to 8.5)
  • WP Recipe Maker is optional

License

GPLv2 or later. See https://www.gnu.org/licenses/gpl-2.0.html.