RS Diwali Lantern

RS Diwali Lantern brings festive charm to your WordPress website with beautifully animated Diwali lanterns and a wide range of customization options. The latest version introduces a significantly enhanced experience with a live visual preview directly in the WordPress admin area, multiple lantern designs, support for custom lantern images and GIFs, and flexible positioning controls for desktop, tablet and mobile devices. Whether you want to display a single traditional lantern or create a beautiful combination of multiple decorations, you can customize their appearance, size, placement, animations and visibility to suit your website. With scheduling, page-specific display rules, optional festive greetings and performance-conscious animations, RS Diwali Lantern makes it easy to bring the festive spirit of Diwali to your website. Key Features Multiple Lanterns: Add, duplicate, remove and independently configure up to three lanterns. Beautiful Designs: Choose from three original animated GIFs, six lightweight SVG designs or upload your own custom image or GIF. Live Visual Preview: Preview and customize your lanterns directly in the WordPress admin area, even when website decorations are disabled. Flexible Positioning: Choose from nine placement positions and fine-tune X/Y offsets for precise positioning. Device-Specific Controls: Configure lantern visibility, dimensions and positioning independently for desktop, tablet and mobile. Drag-and-Drop Placement: Drag lanterns within the preview to fine-tune their positions for different screen sizes. Animation Effects: Combine swing, float, pulse, bounce or static movement with optional glow effects such as steady, breathing and flickering. Custom Appearance: Adjust animation speed, intensity, glow color and glow strength. Ready-to-Use Presets: Choose one-, two- or three-lantern layouts, or a lightweight single-SVG layout. Flexible Scheduling: Schedule decorations for specific date and time ranges, with optional annual repetition. Display Rules: Show lanterns across your website, on the homepage, selected pages/posts, or exclude specific pages and posts. WooCommerce Compatibility: Optionally hide decorations on the WooCommerce checkout page. Interactive Greetings: Add optional links, accessible click-to-open festive greetings and session-only dismissal. Settings Management: Export and import settings using JSON, with an explicit option to restore defaults. Performance-Conscious: Conditional asset loading, lightweight SVG designs, mobile performance mode and reduced-motion support. Privacy-Friendly: No third-party scripts, remote fonts, analytics or tracking services. Performance and accessibility Built-in SVG lantern designs are tiny and do not require extra JavaScript. Images have explicit intrinsic dimensions and are loaded lazily, with low fetch priority. The lanterns are fixed-position, so they should not shift document content. By default, the plugin shows one lantern and mobile performance mode is enabled. Mobile performance mode disables CSS animations and glow on small screens. Built-in animated GIF lanterns use bundled static PNG images on mobile. For a custom animated GIF, also select a non-animated fallback image; otherwise it is hidden on mobile when mobile performance mode is active and hidden for visitors who request reduced motion. Animation is disabled for visitors using prefers-reduced-motion. Hover or keyboard focus pauses CSS-based animation. No plugin can guarantee an unchanged Lighthouse/PageSpeed score on every site: results depend on hosting, themes, other plugins, network conditions, cache behavior, image choice, and enabled effects. Benchmark your website on both versions with the same settings and test on desktop and mobile before enabling additional lanterns. Schedule visibility is decided by the server in the WordPress timezone. End times are exclusive: an end time of 16:30 stops at 16:30:00. For already-generated cached pages, an inline JavaScript guard hides the decorations after the scheduled end, including on pages left open past the boundary. Because a page cached before a scheduled start contains no decoration markup, arrange a cache expiration or purge at the start to guarantee immediate activation. Annual schedules repeat on the same month/day, not the changing lunar date of Diwali. If an end date is missing, a nonannual schedule remains active after its start without expiring; specify both boundaries for a bounded event. Invalid or reversed ranges are kept visible for correction in settings, but hidden on the public website (fail closed).

1. In WordPress, open Plugins > Add New > Upload Plugin and upload the plugin ZIP.
2. Activate the plugin. Existing v2.4/v2.5 configuration is read and migrated automatically.
3. Go to Dashboard > RS Diwali Lantern.
4. Configure the lanterns and their device-specific positions, or select a preset.
5. Optionally add schedules, page rules, and click interactions.
6. Click Save Lantern Settings and inspect both desktop and mobile views of your live website.

To upgrade, make a backup of your site's files and database first. Never uninstall an existing version merely to install the update: uninstalling removes the stored settings.

3.0.4

• Stop at the exact end minute, without the previous extra 59 seconds.
• Keep reversed/invalid schedule ranges hidden instead of silently deleting the end date.
• Add a lightweight, conditional inline safeguard for cached pages and pages kept open through end time.
• Show current WordPress site time and schedule status in the editor.
• No additional external front-end assets; unscheduled decorations still use CSS only.
• Fixed the admin preview remaining invisible when the master enable switch was on (the switch is outside the settings form).
• Decoupled the live editor preview from the website publishing switch, so decorations can be designed while disabled on the public site.
• Added a clear website-display status indicator to the preview editor.
• No changes to frontend code, styles, or images.
• Updated compatibility metadata for WordPress 7.1.x, including 7.1.3. No functionality or frontend asset changes.
• Corrected escaping at the HTML output boundary for admin form field names.
• Protected import/reset status notices with nonce verification.
• Documented validated handling of PHP temporary upload metadata and removed an unrelated database-query sniff false positive.
• Completed WordPress readme compatibility metadata, short description and tags.
• Kept frontend CSS, JavaScript and image assets unchanged from 3.0.0.
• Added an independently configurable three-lantern manager with drag-adjustable live preview.
• Added six built-in SVG designs and five starter presets.
• Added composable CSS movement and ambient glow controls.
• Added per-device position, X/Y offset, width and visibility options.
• Added start and end times, annual date repetition and page inclusion/exclusion rules.
• Added optional greeting/dialog actions and dismiss-for-session controls.
• Added settings export/import and explicit restore-defaults action.
• Added stronger input validation, URL escaping and administrative nonces/capability checks.
• Added mobile static fallback for built-in GIF artwork and reduced-motion handling.
• Reduced frontend dependencies: CSS only on eligible pages, JS only if needed for interactions.
• Preserved compatibility with v2.4 and v2.5 settings without activation resets.
• Added master enable, desktop/tablet/mobile settings, nine positions, scheduling, display rules, and live preview.
• Added lantern width control, positions, and mobile visibility.