\SearchWP_Live_Search_Notice::DISMISS['global'], * 'slug' => 'fatal_error_3678975', * ] * ); * * @example Dismissible - per user: * \SearchWP_Live_Search_Notice::warning( * 'Do something please.', * [ * 'dismiss' => \SearchWP_Live_Search_Notice::DISMISS['user'], * 'slug' => 'do_something_1238943', * ] * ); * * @example Dismissible - global, add custom class to output and disable auto paragraph in text: * \SearchWP_Live_Search_Notice::error( * 'Fatal error!', * [ * 'dismiss' => \SearchWP_Live_Search_Notice::DISMISS['global'], * 'slug' => 'fatal_error_348975', * 'autop' => false, * 'class' => 'some-additional-class', * ] * ); * * @example Not dismissible: * \SearchWP_Live_Search_Notice::success( 'Everything is good!' ); */ class SearchWP_Live_Search_Notice { /** * Dismiss level. * * A number attended to use as the value of the $args['dismiss'] argument. * * DISMISS['none'] means that the notice is not dismissible. * DISMISS['global'] means that the notice will have the dismiss button, and after clicking this button, the notice will be dismissed for all users. * DISMISS['user'] means that the notice will have the dismiss button, and after clicking this button, the notice will be dismissed only for the current user. * * @since 1.7.0 */ const DISMISS = [ 'none' => 0, 'global' => 1, 'user' => 2, ]; /** * Added notices. * * @since 1.7.0 * * @var array */ private $notices = []; /** * Hooks. * * @since 1.7.0 */ public function hooks() { add_action( 'admin_notices', [ $this, 'display' ] ); add_action( 'wp_ajax_searchwp_live_search_notice_dismiss', [ $this, 'dismiss_ajax' ] ); } /** * Enqueue assets. * * @since 1.7.0 */ private function enqueues() { wp_enqueue_script( 'searchwp-live-search-admin-notices', SEARCHWP_LIVE_SEARCH_PLUGIN_URL . 'assets/js/admin/notices.js', [ 'jquery' ], SEARCHWP_LIVE_SEARCH_VERSION, true ); wp_localize_script( 'searchwp-live-search-admin-notices', 'searchwp_live_search_admin_notices', [ 'ajax_url' => admin_url( 'admin-ajax.php' ), 'nonce' => wp_create_nonce( 'searchwp-live-search-admin' ), ] ); } /** * Display the notices. * * @since 1.7.0 */ public function display() { $dismissed_notices = $this->get_dismissed_notices(); foreach ( $this->notices as $slug => $notice ) { if ( isset( $dismissed_notices[ $slug ] ) && ! empty( $dismissed_notices[ $slug ]['dismissed'] ) ) { unset( $this->notices[ $slug ] ); } } $output = implode( '', $this->notices ); echo $output; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped // Enqueue script only when it's needed. if ( strpos( $output, 'is-dismissible' ) !== false ) { $this->enqueues(); } } /** * Add notice to the registry. * * @since 1.7.0 * * @param string $message Message to display. * @param string $type Type of the notice. Can be [ '' (default) | 'info' | 'error' | 'success' | 'warning' ]. * @param array $args The array of additional arguments. Please see the $defaults array below. */ public static function add( $message, $type = '', $args = [] ) { static $uniq_id = 0; $defaults = [ 'dismiss' => self::DISMISS['none'], // Dismissible level: one of the self::DISMISS_* const. By default notice is not dismissible. 'slug' => '', // Slug. Should be unique if dismissible is not equal self::DISMISS['none']. 'autop' => true, // `false` if not needed to pass message through wpautop(). 'class' => '', // Additional CSS class. ]; $args = wp_parse_args( $args, $defaults ); $dismissible = (int) $args['dismiss']; $dismissible = min( $dismissible, self::DISMISS['user'] ); $class = $dismissible > self::DISMISS['none'] ? ' is-dismissible' : ''; $global = ( $dismissible === self::DISMISS['global'] ) ? 'global-' : ''; $slug = sanitize_key( $args['slug'] ); ++ $uniq_id; $uniq_id += ( $uniq_id === (int) $slug ) ? 1 : 0; $id = 'searchwp-live-search-notice-' . $global; $id .= empty( $slug ) ? $uniq_id : $slug; $type = ! empty( $type ) ? 'notice-' . esc_attr( sanitize_key( $type ) ) : ''; $class = empty( $args['class'] ) ? $class : $class . ' ' . esc_attr( sanitize_key( $args['class'] ) ); $message = $args['autop'] ? wpautop( $message ) : $message; $notice = sprintf( '