HM\BackUpWordPress\Notices

Complexity

Total Complexity

19

Size/Duplication

Total Lines	150
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	0

Importance

Changes	2
Bugs	2	Features	1

9 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	1	1
A	__clone()	0	1	1
A	__wakeup()	0	1	1
A	get_instance()	0	9	2
B	set_notices()	0	31	6
A	get_notices()	0	16	4
A	get_all_notices()	0	3	1
A	get_persistant_notices()	0	7	2
A	clear_all_notices()	0	4	1

<?php

namespace HM\BackUpWordPress;


/**
 * Class for managing notices
 *
 * Notices are messages along with an associated context, by default
 * they are stored in the db and thus persist between page loads.
 */
class Notices {

	/**
	 * The array of notice messages
	 *
	 * This is a multidimensional array of
	 * `array( context => array( 'message' ) );``
	 *
	 * @var array
	 */
	private $notices = array();

	/**
	 * Contains the instantiated Notices instance
	 *
	 * @var Path $this->get_instance
	 */
	private static $instance;

	/**
	 * Protected constructor to prevent creating a new instance of the
	 * *Singleton* via the `new` operator from outside of this class.
	 */
	protected function __construct() {}

	/**
	 * Private clone method to prevent cloning of the instance of the
	 * *Singleton* instance.
	 */
	private function __clone() {}

	/**
	 * Private unserialize method to prevent unserializing of the *Singleton*
	 * instance.
	 */
	private function __wakeup() {}

	/**
	 * Returns the *Singleton* instance of this class.
	 *
	 * @staticvar Notices $instance The *Singleton* instances of this class.
	 *
	 * @return Notices The *Singleton* instance.
	 */
	public static function get_instance() {

		if ( ! ( self::$instance instanceof Notices ) ) {
			self::$instance = new Notices();

It seems like new \HM\BackUpWordPress\Notices() of type object<HM\BackUpWordPress\Notices> is incompatible with the declared type object<HM\BackUpWordPress\Path> of property $instance.

		}

		return self::$instance;

	}

	/**
	 * Set an array of notice messages for a specific context
	 *
	 * @param string  $context    The context of the notice message
	 * @param array   $messages   The array of messages
	 * @param boolean $persistant Whether the notice should persist via the database. Defaults to true.
	 */
	public function set_notices( $context, array $messages, $persistant = true ) {

		// Clear any empty messages and avoid duplicates
		$messages = array_unique( array_filter( $messages ) );

		if ( empty( $context ) || empty( $messages ) ) {
			return false;
		}

		$this->notices[ $context ] = array_merge( $this->get_notices( $context ), $messages );

		if ( $persistant ) {

			$new_notices = $notices = $this->get_persistant_notices();

			// Make sure we merge in any existing notices
			if ( ! empty( $notices[ $context ] ) ) {
				$new_notices[ $context ] = array_merge( $notices[ $context ], $messages );
			} else {
				$new_notices[ $context ] = $messages;
			}

			// Only update the database if the notice array has changed
			if ( $new_notices !== $notices ) {
				update_option( 'hmbkp_notices', $new_notices );
			}
		}

		return true;

	}

	/**
	 * Fetch an array of notices messages
	 *
	 * If you specify a context then you'll just get messages for that context otherwise
	 * you get multidimensional array of all contexts and their messages.
	 *
	 * @param string $context The context that you'd like the messages for
	 *
	 * @return array The array of notice messages
	 */
	public function get_notices( $context = '' ) {

		$notices = $this->get_all_notices();

		if ( $notices ) {

The expression $notices of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

			if ( $context ) {
				return isset( $notices[ $context ] ) ? $notices[ $context ] : array();
			}

			return $notices;
		}

		return array();

	}

	/**
	 * Get both standard and persistant notices
	 *
	 * @return array The array of contexts and notices
	 */
	private function get_all_notices() {
		return array_map( 'array_unique', array_merge_recursive( $this->notices, $this->get_persistant_notices() ) );
	}

	/**
	 * Load the persistant notices from the database
	 *
	 * @return array The array of notices
	 */
	private function get_persistant_notices() {
		$notices = get_option( 'hmbkp_notices' );
		if ( ! empty( $notices ) ) {
			return $notices;
		}
		return array();
	}

	/**
	 * Clear all notices including persistant ones
	 */
	public function clear_all_notices() {
		$this->notices = array();
		delete_option( 'hmbkp_notices' );
	}
}