=== Nightly — Dark Mode Toggle === Contributors: badhonrocks, plugpressco Tags: dark mode, night mode, dark theme, light mode, toggle, accessibility, gutenberg, block, FSE, classic themes Requires at least: 5.0 Requires PHP: 7.4 Tested up to: 6.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Add a professional dark mode toggle to your WordPress site. Works with any theme - FSE or classic. Lightweight, accessible, and user-friendly. == Description == **Transform your WordPress site with a sleek dark mode toggle that your visitors will love.** Nightly is a lightweight, professional dark mode plugin that seamlessly integrates with any WordPress theme. Whether you're using modern FSE (Full Site Editing) themes or classic themes, Nightly provides the perfect dark mode solution for your website. = 🌙 Why Choose Nightly? = * **Universal Compatibility** - Works with FSE themes, classic themes, and everything in between * **Smart Theme Detection** - Automatically adapts interface based on your theme type * **Multiple Implementation Options** - Gutenberg block, floating toggle, or manual integration * **Accessibility First** - WCAG 2.1 AA compliant with full keyboard navigation and screen reader support * **Performance Optimized** - Lightweight code that won't slow down your site * **User Preference Respect** - Automatically detects and honors system dark mode preferences * **Smooth Transitions** - Customizable animation speeds for seamless theme switching = 🚀 Perfect for Any Website = * **Business Websites** - Professional appearance with improved user experience * **Blogs & News Sites** - Reduce eye strain for readers, especially during evening hours * **E-commerce Stores** - Modern shopping experience that customers expect * **Portfolio Sites** - Showcase your work with elegant dark mode aesthetics * **Documentation Sites** - Essential for developer-focused content * **Any WordPress Site** - Universal solution that works everywhere = ⚡ Key Features = **For FSE (Block) Themes:** * Dedicated admin dashboard for global floating toggle configuration * Gutenberg block for page-specific toggle placement * Clean, streamlined interface focused on what you need **For Classic Themes:** * Full-featured admin dashboard with all configuration options * Auto-injection of floating toggle for site-wide coverage * Gutenberg block also available for flexible placement **Universal Features:** * System preference detection (respects prefers-color-scheme) * Customizable transition animations (0-1000ms) * Multiple floating toggle positions (all four corners) * localStorage persistence for user preferences * Synchronized toggles (multiple toggles stay in sync) * Mobile-responsive design * RTL language support = 🎨 Easy to Use = **Getting Started is Simple:** 1. **Install & Activate** - One-click installation from WordPress.org 2. **Choose Your Method** - Use the Gutenberg block or enable the floating toggle 3. **Customize Settings** - Configure position, animation speed, and preferences 4. **Done!** - Your visitors can now enjoy dark mode **No coding required. No theme modifications needed. Just install and go.** = 🛠️ Developer Friendly = * Clean, well-documented code following WordPress standards * CSS custom properties for easy theme integration * JavaScript events for advanced customization * Hooks and filters for extensibility * Modern build process with optimized assets = 🌐 Accessibility & Performance = * **WCAG 2.1 AA Compliant** - Full accessibility support * **Keyboard Navigation** - Tab, Enter, and Space key support * **Screen Reader Compatible** - Proper ARIA attributes and announcements * **High Contrast Support** - Works with Windows high contrast mode * **Lightweight** - Minimal impact on page load times * **Conditional Loading** - Assets only load when needed = 🎯 Use Cases = * Add dark mode to any WordPress theme without coding * Improve user experience for evening and night browsing * Reduce eye strain for visitors reading long-form content * Create a modern, professional appearance * Meet accessibility requirements for your website * Provide user choice and customization options == Installation == = Automatic Installation = 1. Log in to your WordPress admin dashboard 2. Navigate to Plugins → Add New 3. Search for "Nightly Dark Mode Toggle" 4. Click "Install Now" and then "Activate" 5. Go to Appearance → Nightly to configure settings = Manual Installation = 1. Download the plugin zip file 2. Upload to your `/wp-content/plugins/` directory 3. Extract the files 4. Activate the plugin through the WordPress admin 5. Configure settings under Appearance → Nightly = Quick Setup = **For FSE Themes:** 1. Go to Appearance → Nightly 2. Enable "Enable floating toggle" 3. Choose your preferred corner position 4. Save settings - done! **For Classic Themes:** 1. Go to Appearance → Nightly 2. Enable "Auto-inject floating toggle" 3. Customize position and animation settings 4. Save settings - your site now has dark mode! **Using Gutenberg Blocks:** 1. Edit any page or post 2. Add a new block and search for "Nightly" 3. Insert the block where you want the toggle 4. Customize the button text and appearance 5. Publish - visitors can now toggle dark mode on that page == Frequently Asked Questions == = Does this work with my theme? = Yes! Nightly is designed to work with any WordPress theme - FSE, classic, custom, or premium themes. It uses CSS custom properties that adapt to your existing design. = Will this slow down my website? = No. Nightly is performance-optimized and only loads assets when needed. The total footprint is minimal and won't impact your site speed. = Can I customize the appearance? = Absolutely! You can customize colors, position, animation speed, and behavior. Advanced users can use CSS custom properties for deeper customization. = Is it accessible for users with disabilities? = Yes. Nightly is WCAG 2.1 AA compliant with full keyboard navigation, screen reader support, and high contrast compatibility. = Can I use both the block and floating toggle? = Yes! You can use the Gutenberg block on specific pages and the floating toggle for site-wide coverage. They work together seamlessly. = Does it remember user preferences? = Yes. User preferences are saved in localStorage and persist across sessions. The plugin also respects system dark mode preferences. = Can I disable it on certain pages? = Yes. The floating toggle can be disabled globally, and blocks can be added or removed from specific pages as needed. = Is it translation ready? = Yes. Nightly is fully internationalized and ready for translation into any language. = Does it work with caching plugins? = Yes. Nightly is compatible with all major caching plugins and CDNs. = Can I customize the toggle button design? = Yes. The plugin provides CSS custom properties for easy styling, and developers can override styles as needed. == Screenshots == 1. **Admin Dashboard** - Clean, intuitive settings interface for both FSE and classic themes 2. **Floating Toggle** - Professional floating toggle in action on a live website 3. **Gutenberg Block** - Easy-to-use block editor integration with customization options 4. **Dark Mode Active** - Beautiful dark mode transformation of a typical WordPress site 5. **Mobile Responsive** - Perfect appearance and functionality on all device sizes 6. **Accessibility Features** - Keyboard navigation and screen reader compatibility in action == Changelog == = 1.0.0 = * Initial release * Gutenberg block for flexible toggle placement * Floating toggle with 4 position options * FSE and classic theme support * Admin dashboard with theme-specific interfaces * System preference detection * Accessibility compliance (WCAG 2.1 AA) * Performance optimizations * RTL language support * Mobile responsive design * localStorage preference persistence * Smooth transition animations * Multiple toggle synchronization == Upgrade Notice == = 1.0.0 = Initial release of Nightly - the professional dark mode solution for WordPress. Install now to give your visitors the modern dark mode experience they expect. == Support == Need help? We're here for you! * **Documentation**: Comprehensive guides and examples * **Support Forum**: Community support and troubleshooting * **Developer Resources**: Hooks, filters, and customization guides Visit [plugpress.io](https://plugpress.io/) for additional resources and premium support options. == Privacy == Nightly respects user privacy: * No data is sent to external servers * User preferences are stored locally in the browser * No tracking or analytics * GDPR compliant * No cookies used Your users' privacy is protected while they enjoy the dark mode experience.