*/ private static $stack = array(); /** * Count of decisions made this request (tests and bench). * * @var int */ public static $evaluations = 0; /** * Hook in. pre_render_block runs late so it sees another plugin's pre-render. */ public static function register() { add_filter( 'pre_render_block', array( __CLASS__, 'pre' ), PHP_INT_MAX - 10, 2 ); add_filter( 'render_block', array( __CLASS__, 'backstop' ), 999, 2 ); } /** * Reset per-request state. */ public static function reset() { self::$stack = array(); self::$evaluations = 0; } /** * The pre_render_block callback. * * @param string|null $pre Pre-rendered content from earlier callbacks. * @param array $parsed Parsed block. * @return string|null */ public static function pre( $pre, $parsed ) { if ( ! isset( $parsed['attrs']['metadata']['gateforgeRule'] ) ) { return $pre; } $mode = Request_Guard::blocks(); if ( Request_Guard::SKIP === $mode ) { return $pre; } $d = self::decide( $parsed, $mode ); if ( Explain_Mode::active() ) { if ( ! $d->visible ) { return Explain_Mode::block_card_html( $parsed, $d ); } if ( null !== $pre ) { return $pre . Explain_Mode::block_card_html( $parsed, $d ); } self::push( $parsed, $d ); return $pre; } if ( ! $d->visible ) { return ''; } if ( null === $pre ) { self::push( $parsed, $d ); } return $pre; } /** * The render_block backstop. * * @param string $content Rendered content. * @param array $parsed Parsed block. * @return string */ public static function backstop( $content, $parsed ) { if ( ! isset( $parsed['attrs']['metadata']['gateforgeRule'] ) ) { return $content; } $key = self::key( $parsed ); $top = end( self::$stack ); if ( false !== $top && $top['key'] === $key ) { array_pop( self::$stack ); return Explain_Mode::active() ? $content . Explain_Mode::block_card_html( $parsed, $top['d'] ) : $content; } $mode = Request_Guard::blocks(); if ( Request_Guard::SKIP === $mode ) { return $content; } $d = self::decide( $parsed, $mode ); if ( Explain_Mode::active() ) { return $d->visible ? $content . Explain_Mode::block_card_html( $parsed, $d ) : Explain_Mode::block_card_html( $parsed, $d ); } return $d->visible ? $content : ''; } /** * Decide one block in its render context. * * @param array $parsed Parsed block. * @param string $mode Guard mode. * @return Decision */ public static function decide( array $parsed, $mode ) { ++self::$evaluations; if ( Request_Guard::DEFER === $mode ) { $d = new Decision(); $d->visible = false; $d->tree_result = Decision::U; $d->fallback_applied = 'default_hide'; $d->unknowns[] = array( 'path' => 'tree', 'reason' => 'condition_unavailable', 'text' => 'main_query_not_ready', ); return $d; } $raw = $parsed['attrs']['metadata']['gateforgeRule']; return Explain_Mode::with_visitor( static function () use ( $raw ) { $e = new Evaluator(); return $e->evaluate( Rule::from_stored( $raw, 'block' ), array( 'simulated_visitor' => Explain_Mode::simulating() ) ); } ); } /** * Push a decision for a shown block. * * @param array $parsed Parsed block. * @param Decision $d Decision. */ private static function push( array $parsed, Decision $d ) { self::$stack[] = array( 'key' => self::key( $parsed ), 'd' => $d, ); } /** * Identity of one parsed block for the stack. * * @param array $parsed Parsed block. * @return string */ private static function key( array $parsed ) { $name = isset( $parsed['blockName'] ) ? (string) $parsed['blockName'] : ''; $html = isset( $parsed['innerHTML'] ) ? (string) $parsed['innerHTML'] : ''; return md5( $name . '|' . wp_json_encode( $parsed['attrs'] ) . '|' . $html ); } }