Keep Screen On

WordPress plugin that allows visitors to keep their screen on while viewing your website.

Description

Prevent screens from turning off while visitors view your content. Perfect for recipes, tutorials, or workout instructions.

Features:

• Simple shortcode: [keep_screen_on]
• Action hook: do_action('keep_screen_on_display')
• Multiple toggles sync automatically
• Customizable with CSS variables
• Requires HTTPS and modern browser

Requirements

• WordPress 6.9+
• PHP 8.2+
• HTTPS connection (or localhost)

Installation

1. Upload to /wp-content/plugins/keep-screen-on/
2. Activate the plugin
3. Add [keep_screen_on] to any page or post

Usage

Shortcode

Basic usage:

[keep_screen_on]

With custom text:

[keep_screen_on text="Keep display active"]

In Theme Template

<?php do_action('keep_screen_on_display'); ?>

FAQ

Why does it require HTTPS?

The Screen Wake Lock API requires HTTPS for security. Use localhost during development.

Can I customize the appearance?

Yes, use CSS custom properties:

:root {
    --kso-primary-color: #2196F3;
    --kso-switch-width: 60px;
    --kso-switch-height: 34px;
}

Can I have multiple toggles on one page?

Yes! All toggles automatically synchronize.

Screenshots

Toggle switch ready to be activated - Keep your screen on

Toggle activated - screen will stay on

Toggle deactivated - Screen can turn off

Changelog

1.0.0

• Initial release
• Screen Wake Lock API integration
• Shortcode and action hook support
• Multiple toggle synchronization
• Danish translation

License

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