<?php
/**
 * Conditions: ConditionsRenderer.
 *
 * @package Divi
 * @since ??
 */

namespace ET\Builder\Packages\Module\Options\Conditions;

if ( ! defined( 'ABSPATH' ) ) {
	die( 'Direct access forbidden.' );
}

use ET\Builder\Packages\Module\Options\Conditions\Conditions;


/**
 * Conditions option custom renderer.
 */
class ConditionsRenderer {

	/**
	 * Register the conditions option custom renderer: `render_block` filter for the `ET_Core_Portability` class.
	 *
	 * This method registers the `render_block` filter for the `ET_Core_Portability` class.
	 * The filter callback function is `should_render`.
	 *
	 * The renderer checks module's conditions option and decides if a module should be rendered or not.
	 *
	 * @since ??
	 *
	 * @return void
	 */
	public static function register(): void {
		add_filter( 'divi_module_library_register_module_render_block', [ __CLASS__, 'should_render' ], 10, 3 );
	}

	/**
	 * Determines if a module should be rendered based on its conditions.
	 *
	 * This function checks the conditions option of a module and decides whether the module should be rendered or not.
	 *
	 * @since ??
	 *
	 * @param bool      $is_displayable Check if the module is displayable.
	 * @param \WP_Block $block          The block object (required by filter signature, unused in method).
	 * @param array     $attrs          The block attributes.
	 *
	 * @return bool The original block content if the module is conditionally displayable, empty string otherwise.
	 *
	 * @example:
	 * ```php
	 * $attrs = [
	 *    'module' => [
	 *        'decoration' => [
	 *            'conditions' => [
	 *                'desktop' => [
	 *                    'value' => [
	 *                        [
	 *                            'id'                => '10ba038e-48da-487b-96e8-8d3b99b6d18a',
	 *                            'conditionName'     => 'loggedInStatus',
	 *                            'conditionSettings' => [
	 *                                'displayRule'     => 'loggedIn',
	 *                                'adminLabel'      => 'Logged In Status',
	 *                                'enableCondition' => 'on',
	 *                            ],
	 *                            'operator'          => 'OR',
	 *                        ]
	 *                    ],
	 *                ],
	 *            ],
	 *        ],
	 *    ],
	 * ];
	 * $block = new \WP_Block();
	 * $displayable = ConditionsRenderer::should_render($is_displayable, $block, $attrs);
	 *
	 * // Result: true
	 * ```
	 */
	public static function should_render( bool $is_displayable, \WP_Block $block, array $attrs ): bool {
		static $is_display_conditions_enabled = null;

		// We only need to run this filter this once,
		// especially because we dont even send params to this filter.
		if ( null === $is_display_conditions_enabled ) {
			/**
			 * Filters "Display Conditions" functionality to determine whether to enable or disable the functionality or not.
			 *
			 * Useful for disabling/enabling "Display Condition" feature site-wide.
			 *
			 * @since ??
			 *
			 * @param boolean True to enable the functionality, False to disable it.
			 */
			$is_display_conditions_enabled = apply_filters( 'et_is_display_conditions_functionality_enabled', true );
		}

		if ( ! $is_display_conditions_enabled ) {
			return true;
		}

		$is_displayable = true;

		$conditions_attrs_value = $attrs['module']['decoration']['conditions']['desktop']['value'] ?? [];
		// Check if the block has conditions and if it is displayable,
		// if this module even has conditions enabled.
		if ( ! empty( $conditions_attrs_value ) ) {
			$display_conditions = new Conditions();
			$is_displayable     = (bool) $display_conditions->is_displayable( $conditions_attrs_value );
		}

		return $is_displayable;
	}
}