<?php
/**
 * Block Category Registration
 *
 * Registers the Acumenpopup block category for the block editor.
 *
 * @since      1.0.0
 * @package    Acumenpopup
 * @subpackage Acumenpopup/includes/Blocks
 */

namespace Acumenpopup\Blocks;

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class Category
 *
 * Manages block category registration (Singleton).
 *
 * @since   1.0.0
 * @package Acumenpopup
 */
class Category {

	/**
	 * The single instance of the class.
	 *
	 * @since  1.0.0
	 * @access private
	 * @var    Category|null
	 */
	private static $instance = null;

	/**
	 * Category slug.
	 *
	 * @since  1.0.0
	 * @access private
	 * @var    string
	 */
	private $category_slug = 'acumen-popup';

	/**
	 * Private constructor to prevent direct instantiation.
	 *
	 * @since  1.0.0
	 * @access private
	 */
	private function __construct() {
		$this->init_hooks();
	}

	/**
	 * Get the single instance of the Category class.
	 *
	 * @since  1.0.0
	 * @access public
	 *
	 * @return Category The single instance.
	 */
	public static function get_instance() {
		if ( is_null( self::$instance ) ) {
			self::$instance = new self();
		}

		return self::$instance;
	}

	/**
	 * Initialize WordPress hooks.
	 *
	 * @since  1.0.0
	 * @access private
	 *
	 * @return void
	 */
	private function init_hooks() {
		add_filter( 'block_categories_all', array( $this, 'register_category' ), 10, 2 );
	}

	/**
	 * Register the Acumenpopup block category.
	 *
	 * Adds the Acumenpopup category to the beginning of the categories list.
	 *
	 * @since  1.0.0
	 * @access public
	 *
	 * @param array                   $categories Array of existing block categories.
	 * @param \WP_Block_Editor_Context $context    The block editor context.
	 *
	 * @return array Modified array with Acumenpopup category added.
	 */
	public function register_category( $categories, $context = null ) {
		return array_merge(
			array(
				array(
					'slug'  => $this->category_slug,
					'title' => esc_html__( 'Acumenpopup Blocks', 'acumen-popup' ),
					'icon'  => null,
				),
			),
			$categories
		);
	}

	/**
	 * Get the category slug.
	 *
	 * @since  1.0.0
	 * @access public
	 *
	 * @return string The category slug.
	 */
	public function get_category_slug() {
		return $this->category_slug;
	}

	/**
	 * Prevent cloning of the instance.
	 *
	 * @since  1.0.0
	 * @access public
	 *
	 * @return void
	 */
	public function __clone() {
		_doing_it_wrong(
			__FUNCTION__,
			esc_html__( 'Cloning is forbidden.', 'acumen-popup' ),
			'1.0.0'
		);
	}

	/**
	 * Prevent unserializing of the instance.
	 *
	 * @since  1.0.0
	 * @access public
	 *
	 * @return void
	 */
	public function __wakeup() {
		_doing_it_wrong(
			__FUNCTION__,
			esc_html__( 'Unserializing is forbidden.', 'acumen-popup' ),
			'1.0.0'
		);
	}
}