<?php

/**
 * Title: Floating Admin Notice with Auto-Dismiss
 * Description: Makes admin notices float above the Code Snippets Pro editor and automatically dismiss after a configurable time period. Perfect for keeping notices visible while scrolling but preventing them from cluttering the interface.
 * Version: 2.0.0
 * Author: SnipSnip.pro & brandonjp.com
 * Last Updated: 2024-11-30
 * Blog URL: https://snipsnip.pro [Placeholder for future post]
 * Requirements: WordPress 5.0+, Code Snippets Pro plugin
 * License: GPL v2 or later
 * 
 * Changelog:
 * 2.0.0 - Added auto-dismiss functionality
 *       - Added configuration options
 *       - Added security measures
 *       - Improved error handling
 */

if (!class_exists('WP_Floating_Admin_Notice_With_AutoDismiss')):

    class WP_Floating_Admin_Notice_With_AutoDismiss {
        /**
         * Default configuration values
         */
        const DEFAULT_DISMISS_DELAY = 5000; // milliseconds
        const DEFAULT_NOTICE_OFFSET = 40; // pixels from top
        const OPTION_NAME = 'floating_notice_settings';

        /**
         * Store instance configuration
         */
        private $settings;

        /**
         * Initialize the functionality
         *
         * @since 2.0.0
         */
        public function __construct() {
            $this->init_settings();
            add_action('admin_enqueue_scripts', [$this, 'add_snippet_page_styles']);
            add_action('admin_enqueue_scripts', [$this, 'add_snippet_page_scripts']);
            add_filter('code_snippets/scroll_to_notices', '__return_false');
            add_action('admin_init', [$this, 'register_settings']);
        }

        /**
         * Initialize settings with defaults
         *
         * @since 2.0.0
         */
        private function init_settings() {
            $defaults = [
                'dismiss_delay' => self::DEFAULT_DISMISS_DELAY,
                'notice_offset' => self::DEFAULT_NOTICE_OFFSET
            ];
            
            $saved_settings = get_option(self::OPTION_NAME, []);
            $this->settings = wp_parse_args($saved_settings, $defaults);
        }

        /**
         * Register settings in WordPress
         *
         * @since 2.0.0
         */
        public function register_settings() {
            register_setting(
                'floating_notice_options',
                self::OPTION_NAME,
                [
                    'type' => 'array',
                    'sanitize_callback' => [$this, 'sanitize_settings']
                ]
            );
        }

        /**
         * Sanitize settings before saving
         *
         * @since 2.0.0
         * @param array $input The raw settings input
         * @return array Sanitized settings
         */
        public function sanitize_settings($input) {
            $sanitized = [];
            
            $sanitized['dismiss_delay'] = isset($input['dismiss_delay']) 
                ? absint($input['dismiss_delay']) 
                : self::DEFAULT_DISMISS_DELAY;

            $sanitized['notice_offset'] = isset($input['notice_offset'])
                ? absint($input['notice_offset'])
                : self::DEFAULT_NOTICE_OFFSET;

            return $sanitized;
        }

        /**
         * Add custom styles for floating notices
         *
         * @since 2.0.0
         * @param string $hook The current admin page
         */
        public function add_snippet_page_styles($hook) {
            if (!$this->is_snippet_page($hook)) {
                return;
            }

            $css = <<<'STYLES'
div#edit-snippet-form-container div#message {
    position: sticky;
    z-index: 999;
    transition: opacity 0.3s ease-in-out;
}

div#edit-snippet-form-container div#message.notice-dismissing {
    opacity: 0;
}
STYLES;

            // Add dynamic top offset
            $offset = esc_attr($this->settings['notice_offset']);
            $css .= "\ndiv#edit-snippet-form-container div#message { top: {$offset}px; }";

            wp_add_inline_style('wp-admin', $css);
        }

        /**
         * Add JavaScript for auto-dismissing notices
         *
         * @since 2.0.0
         * @param string $hook The current admin page
         */
        public function add_snippet_page_scripts($hook) {
            if (!$this->is_snippet_page($hook)) {
                return;
            }

            $delay = esc_js($this->settings['dismiss_delay']);
            
            $js = <<<'JAVASCRIPT'
window.addEventListener("load", function() {
    (function createAutoDismissScope() {
        "use strict";
        
        function autoDismissNotice(notice) {
            if (!notice) return;
            
            setTimeout(() => {
                notice.classList.add('notice-dismissing');
                setTimeout(() => {
                    notice.style.display = 'none';
                }, 300);
            }, DISMISS_DELAY);
        }

        function initAutoDismiss() {
            const notices = document.querySelectorAll('#edit-snippet-form-container #message');
            notices.forEach(autoDismissNotice);

            // Watch for new notices
            const observer = new MutationObserver((mutations) => {
                mutations.forEach((mutation) => {
                    mutation.addedNodes.forEach((node) => {
                        if (node.id === 'message') {
                            autoDismissNotice(node);
                        }
                    });
                });
            });

            const container = document.getElementById('edit-snippet-form-container');
            if (container) {
                observer.observe(container, { childList: true, subtree: true });
            }
        }

        initAutoDismiss();
    })();
});
JAVASCRIPT;

            // Add dynamic delay value
            $js = "const DISMISS_DELAY = {$delay};\n" . $js;
            
            wp_add_inline_script('jquery', $js);
        }

        /**
         * Check if current page is a snippet editor page
         *
         * @since 2.0.0
         * @param string $hook The current admin page hook
         * @return boolean True if on snippet page
         */
        private function is_snippet_page($hook) {
            return in_array($hook, ['snippets_page_add-snippet', 'snippets_page_edit-snippet']);
        }
    }

endif;

// Initialize if class exists
if (class_exists('WP_Floating_Admin_Notice_With_AutoDismiss')):
    new WP_Floating_Admin_Notice_With_AutoDismiss();
endif;