=== Dark Mode by GracePress ===
Contributors: christp2p
Tags: dark mode, night mode, dark theme, accessibility, toggle
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 5.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A dark mode for your whole site, with a floating toggle, OS sync, no flash on load, and fine control over the look.

== Description ==

Dark Mode by GracePress gives every page of your site a dark version that visitors can switch on and off.

* A floating toggle, a shortcode, a menu button and a keyboard shortcut (Ctrl+Alt+D).
* No flash of the wrong mode when a page loads.
* Follows the visitor's operating system, the time of day on the visitor's own clock, or a fixed default.
* Pictures keep their true colors: photos, videos, background pictures, and the frames and captions printed on them.
* Brightness, contrast and media dimming sliders with a live preview.
* Choose which pages and which parts of a page stay as they are: leave out pages, post types, categories, tags or WooCommerce.
* Show the button on desktop, tablet and phone separately.
* A different logo for dark mode.
* A block and a widget for the switch, as well as the shortcode.
* Six toggle styles and five transition effects.
* Every setting lives in one config file, and also works from the command line (WP-CLI). Back up or restore just these settings in one click.

= Privacy =

Dark Mode stores the visitor's own choice (dark or light) in their own browser, in local storage under the name gracepressDarkMode. It sets no cookies, contacts no other website and collects nothing about visitors.

Dark Mode sends nothing about your site. It has no usage counter.

== Credits ==

Banner photo: "Fulll Moon at KSC" by NASA/Ben Smegelsky, Kennedy Space Center, June 12, 2022. NASA images are in the public domain under NASA's media usage guidelines. Source: https://images.nasa.gov/details/KSC-20220612-PH-JBS01_0034 (cropped and compressed).

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install it from the Plugins screen.
2. Activate it.
3. Open Settings, then Dark Mode (or GracePress Central, then Dark Mode) to choose how it behaves.

== Frequently Asked Questions ==

= Where are the settings kept? =

In one file, `wp-content/uploads/gracepress/config/dark-mode.json`. The settings page edits that file.

= My server runs nginx. Do I need to do anything? =

Apache sites are covered by a rule the plugin writes. On nginx, add `location ^~ /wp-content/uploads/gracepress/ { deny all; }` to your server block so the settings and backups folder is never served.

= Can I change settings without the admin screen? =

Yes. Use `wp gracepress dark-mode config list`, `get`, `set` and `update`. Back up with `wp gracepress dark-mode backup`.

= How do I put the toggle in a specific place? =

Add the shortcode `[gracepress_dark_toggle]`. For a different look in one place: `[gracepress_dark_toggle style="switch"]`.

== Changelog ==

= 5.2.0 =
* Pictures no longer show as negatives: background pictures, pictures inside other pictures' frames, loading placeholders and text printed on photos all keep their true colors. Printing in dark mode prints pictures correctly.
* Automatic mode follows each visitor's own clock.

= 5.1.4 =
* The footer credit is a fixed signature again; everything else stays translatable.

= 5.1.3 =
* Every label, link and message is now translatable, and the block's script is refreshed whenever it changes.

= 5.1.1 =
* New: a "No animation" choice for the switch, and an on/off switch for dimming pictures and videos.
* Removed: "Only on chosen pages" (leaving dark mode off chosen pages, types, categories, tags and WooCommerce is unchanged).

= 5.1.0 =
* New: show the button by device; a logo for dark mode; run only on chosen pages; leave out post types, categories, tags and WooCommerce; a block and a widget for the switch.

= 5.0.0 =
* Settings now live in one config file with backup and restore, command-line control, a dashboard widget and a Help & Usage panel.

= 4.8.19 =
* Added the Paper Sketch toggle style.
