.::Undergrounds v3.3 Webshells::.

: / home / sc1jaqa5103 / prod.puv-editions.fr / wp-content / plugins / pods / src / Pods / Blocks /
Filename : Blocks_Abstract.php
back
<?php

namespace Pods\Blocks;

// Don't load directly.
if ( ! defined( 'ABSPATH' ) ) {
	die( '-1' );
}

use Throwable;
use WP_Block;
use WP_Post;

/**
 * Blocks abstract.
 *
 * @credit The Events Calendar team - https://github.com/the-events-calendar/tribe-common
 *
 * @since 3.0
 */
abstract class Blocks_Abstract implements Blocks_Interface {

	/**
	 * Namespace for Blocks.
	 *
	 * @since 3.0
	 *
	 * @var string
	 */
	private $namespace = 'pods';

	/**
	 * Builds the name of the Block
	 *
	 * @since 3.0
	 *
	 * @return string
	 */
	public function name() {
		if ( false === strpos( $this->slug(), $this->namespace . '/' ) ) {
			return $this->namespace . '/' . $this->slug();
		} else {
			return $this->slug();
		}
	}

	/**
	 * Return the namespace to child or external sources
	 *
	 * @since 3.0
	 *
	 * @return string
	 */
	public function get_namespace() {
		return $this->namespace;
	}

	/**
	 * Return the block attributes
	 *
	 * @since 3.0
	 *
	 * @param array $attributes
	 *
	 * @return array
	 */
	public function attributes( $params = [] ) {

		// get the default attributes
		$default_attributes = $this->default_attributes();

		// parse the attributes with the default ones
		$attributes = wp_parse_args(
			$params,
			$default_attributes
		);

		/**
		 * Filters the default attributes for the block
		 *
		 * @since 3.0
		 *
		 * @param array $attributes The attributes
		 * @param object $pods_block The current object
		 */
		$attributes = apply_filters( 'pods_block_attributes_defaults_' . $this->slug(), $attributes, $this );

		return $attributes;
	}

	/**
	 * Return the block default attributes
	 *
	 * @since 3.0
	 *
	 * @param array $attributes
	 *
	 * @return array
	 */
	public function default_attributes() {

		$attributes = [];

		/**
		 * Filters the default attributes
		 *
		 * @param array $params The attributes
		 * @param object $pods_block The current object
		 */
		$attributes = apply_filters( 'pods_block_attributes_defaults', $attributes, $this );

		return $attributes;
	}

	/**
	 * Since we are dealing with a Dynamic type of Block we need a PHP method to render it
	 *
	 * @since 3.0
	 *
	 * @param array $attributes
	 *
	 * @return string
	 */
	public function render( $attributes = [] ) {
		$json_string = json_encode( $attributes, JSON_PRETTY_PRINT );

		return
			'<pre class="pods-placeholder-text-' . $this->name() . '">' .
			'Block Name: ' . $this->name() . "\n" .
			'Block Attributes: ' . "\n" . $json_string .
			'</pre>';
	}

	/**
	 * Safely render the block, if there are errors or exceptions, catch those and display as best as we can.
	 *
	 * @since 3.0.9
	 *
	 * @param array         $attributes The block attributes.
	 * @param string        $content    The block default content.
	 * @param WP_Block|null $block      The block instance.
	 *
	 * @return string The block content to render.
	 */
	public function safe_render( $attributes = [], $content = '', $block = null ) {
		add_filter( 'pods_shortcode_throw_errors', '__return_true' );

		try {
			$return = $this->render( $attributes, $content, $block );
		} catch ( Throwable $throwable ) {
			$return = '';

			if ( pods_is_debug_display() ) {
				$return = $this->render_placeholder(
					'<i class="pods-block-placeholder_error"></i>' . esc_html__( 'Pods Block Render Error', 'pods' ),
					esc_html__( 'There was an error with rendering this block.', 'pods' )
					. "\n\n" . '<details open>'
					. '<summary><strong>' . esc_html__( 'Error message', 'pods' ) . '</strong></summary>'
					. '<pre>' . esc_html( $throwable->getMessage() ) . '</pre>'
					. '</details>'
					. "\n\n" . '<details>'
					. '<summary><strong>' . esc_html__( 'Debug backtrace', 'pods' ) . '</strong></summary>'
					. '<pre>' . esc_html( $throwable->getTraceAsString() ) . '</pre>'
					. '</details>'
				);
			} elseif (
				is_user_logged_in()
				&& (
					is_admin()
					|| (
						wp_is_json_request()
						&& did_action( 'rest_api_init' )
					)
				)
			) {
				$return = $this->render_placeholder(
					'<i class="pods-block-placeholder_error"></i>' . esc_html__( 'Pods Block Render Error', 'pods' ),
					esc_html__( 'There was a problem displaying this content, enable WP_DEBUG in wp-config.php to show more details.', 'pods' )
				);
			}
		}

		remove_filter( 'pods_shortcode_throw_errors', '__return_true' );

		return $return;
	}

	/**
	 * Render content for block with placeholder template.
	 *
	 * @since 2.8.0
	 *
	 * @param string $heading The heading text.
	 * @param string $content The content text.
	 * @param null|string $image The image content or null if not set.
	 *
	 * @return string The content to render.
	 */
	public function render_placeholder( $heading, $content, $image = null ) {
		ob_start();
		?>
		<div <?php echo get_block_wrapper_attributes( [ 'class' => 'pods-block-placeholder_container' ] ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>">
		<div class="pods-block-placeholder_content-container">
			<img src="<?php echo esc_url( PODS_URL . 'ui/images/pods-logo-green.svg' ); ?>" alt="<?php esc_attr_e( 'Pods logo', 'pods' ); ?>" class="pods-logo">
			<div class="pods-block-placeholder_content">
				<h2 class="pods-block-placeholder_title"><?php echo wp_kses_post( $heading ); ?></h2>
				<p><?php echo wp_kses_post( $content ); ?></p>
			</div>
		</div>
		<?php if ( $image ) : ?>
			<?php echo wp_kses_post( $image ); ?>
		<?php endif; ?>
		</div>
		<?php
		return ob_get_clean();
	}

	/**
	 * Sends a valid JSON response to the AJAX request for the block contents
	 *
	 * @since 3.0
	 *
	 * @return void
	 */
	public function ajax() {
		wp_send_json_error( esc_attr__( 'Problem loading the block, please remove this block to restart.', 'pods' ) );
	}

	/**
	 * Does the registration for PHP rendering for the Block, important due to been
	 * an dynamic Block
	 *
	 * @since 3.0
	 *
	 * @return void
	 */
	public function register() {
		$block_args = [
			'render_callback' => [ $this, 'safe_render' ],
		];

		register_block_type( $this->name(), $block_args );

		add_action( 'wp_ajax_' . $this->get_ajax_action(), [ $this, 'ajax' ] );

		$this->assets();
		$this->hook();
	}

	/**
	 * Determine whether a post or content string has this block.
	 *
	 * This test optimizes for performance rather than strict accuracy, detecting
	 * the pattern of a block but not validating its structure. For strict accuracy
	 * you should use the block parser on post content.
	 *
	 * @since 3.0
	 *
	 * @see gutenberg_parse_blocks()
	 *
	 * @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post.
	 *
	 * @return bool Whether the post has this block.
	 */
	public function has_block( $post = null ) {
		if ( ! is_numeric( $post ) ) {
			$wp_post = get_post( $post );
			if ( $wp_post instanceof WP_Post ) {
				$post = $wp_post->post_content;
			}
		}

		return false !== strpos( (string) $post, '<!-- wp:' . $this->name() );
	}

	/**
	 * Fetches the name for the block we are working with and converts it to the
	 * correct `wp_ajax_{$action}` string for us to Hook.
	 *
	 * @since 3.0
	 *
	 * @return string
	 */
	public function get_ajax_action() {
		return str_replace( 'pods/', 'pods_editor_block_', $this->name() );
	}

	/**
	 * Used to include any Assets for the Block we are registering.
	 *
	 * @since 3.0
	 *
	 * @return void
	 */
	public function assets() {
	}

	/**
	 * Attach any particular hook for the specif block.
	 *
	 * @since 3.0
	 */
	public function hook() {
	}

	/**
	 * Returns the block data for the block editor.
	 *
	 * @since 3.0
	 *
	 * @return array<string,mixed> The block editor data.
	 */
	public function block_data() {
		$block_data = [
			'id' => $this->slug(),
		];

		/**
		 * Filters the block data.
		 *
		 * @since 3.0
		 *
		 * @param array $block_data The block data.
		 * @param object $pods_block The current object.
		 */
		$block_data = apply_filters( 'pods_block_block_data', $block_data, $this );

		/**
		 * Filters the block data for the block.
		 *
		 * @since 3.0
		 *
		 * @param array $block_data The block data.
		 * @param object $pods_block The current object.
		 */
		$block_data = apply_filters( 'pods_block_block_data_' . $this->slug(), $block_data, $this );

		return $block_data;
	}
}