ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / letacommog / Haytayan / wp-includes

<?php
/**
 * Functions related to registering and parsing blocks.
 *
 * @package WordPress
 * @subpackage Blocks
 * @since 5.0.0
 */

/**
 * Registers a block type.
 *
 * @since 5.0.0
 *
 * @param string|WP_Block_Type $name Block type name including namespace, or alternatively a
 *                                   complete WP_Block_Type instance. In case a WP_Block_Type
 *                                   is provided, the $args parameter will be ignored.
 * @param array                $args {
 *     Optional. Array of block type arguments. Any arguments may be defined, however the
 *     ones described below are supported by default. Default empty array.
 *
 *     @type callable $render_callback Callback used to render blocks of this block type.
 * }
 * @return WP_Block_Type|false The registered block type on success, or false on failure.
 */
function register_block_type( $name, $args = array() ) {
	return WP_Block_Type_Registry::get_instance()->register( $name, $args );
}

/**
 * Unregisters a block type.
 *
 * @since 5.0.0
 *
 * @param string|WP_Block_Type $name Block type name including namespace, or alternatively a
 *                                   complete WP_Block_Type instance.
 * @return WP_Block_Type|false The unregistered block type on success, or false on failure.
 */
function unregister_block_type( $name ) {
	return WP_Block_Type_Registry::get_instance()->unregister( $name );
}

/**
 * Determine whether a post or content string has blocks.
 *
 * 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 5.0.0
 * @see 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 blocks.
 */
function has_blocks( $post = null ) {
	if ( ! is_string( $post ) ) {
		$wp_post = get_post( $post );
		if ( $wp_post instanceof WP_Post ) {
			$post = $wp_post->post_content;
		}
	}

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

/**
 * Determine whether a $post or a string contains a specific block type.
 *
 * This test optimizes for performance rather than strict accuracy, detecting
 * the block type exists but not validating its structure. For strict accuracy,
 * you should use the block parser on post content.
 *
 * @since 5.0.0
 * @see parse_blocks()
 *
 * @param string                  $block_type Full Block type to look for.
 * @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post.
 * @return bool Whether the post content contains the specified block.
 */
function has_block( $block_type, $post = null ) {
	if ( ! has_blocks( $post ) ) {
		return false;
	}

if ( ! is_string( $post ) ) {
		$wp_post = get_post( $post );
		if ( $wp_post instanceof WP_Post ) {
			$post = $wp_post->post_content;
		}
	}

return false !== strpos( $post, '<!-- wp:' . $block_type . ' ' );
}

/**
 * Returns an array of the names of all registered dynamic block types.
 *
 * @since 5.0.0
 *
 * @return array Array of dynamic block names.
 */
function get_dynamic_block_names() {
	$dynamic_block_names = array();

$block_types = WP_Block_Type_Registry::get_instance()->get_all_registered();
	foreach ( $block_types as $block_type ) {
		if ( $block_type->is_dynamic() ) {
			$dynamic_block_names[] = $block_type->name;
		}
	}

return $dynamic_block_names;
}

/**
 * Parses blocks out of a content string, and renders those appropriate for the excerpt.
 *
 * As the excerpt should be a small string of text relevant to the full post content,
 * this function renders the blocks that are most likely to contain such text.
 *
 * @since 5.0.0
 *
 * @param string $content The content to parse.
 * @return string The parsed and filtered content.
 */
function excerpt_remove_blocks( $content ) {
	$allowed_inner_blocks = array(
		// Classic blocks have their blockName set to null.
		null,
		'core/freeform',
		'core/heading',
		'core/html',
		'core/list',
		'core/media-text',
		'core/paragraph',
		'core/preformatted',
		'core/pullquote',
		'core/quote',
		'core/table',
		'core/verse',
	);

$allowed_blocks = array_merge( $allowed_inner_blocks, array( 'core/columns' ) );

/**
	 * Filters the list of blocks that can contribute to the excerpt.
	 *
	 * If a dynamic block is added to this list, it must not generate another
	 * excerpt, as this will cause an infinite loop to occur.
	 *
	 * @since 5.0.0
	 *
	 * @param array $allowed_blocks The list of allowed blocks.
	 */
	$allowed_blocks = apply_filters( 'excerpt_allowed_blocks', $allowed_blocks );
	$blocks         = parse_blocks( $content );
	$output         = '';

foreach ( $blocks as $block ) {
		if ( in_array( $block['blockName'], $allowed_blocks, true ) ) {
			if ( ! empty( $block['innerBlocks'] ) ) {
				if ( 'core/columns' === $block['blockName'] ) {
					$output .= _excerpt_render_inner_columns_blocks( $block, $allowed_inner_blocks );
					continue;
				}

// Skip the block if it has disallowed or nested inner blocks.
				foreach ( $block['innerBlocks'] as $inner_block ) {
					if (
						! in_array( $inner_block['blockName'], $allowed_inner_blocks, true ) ||
						! empty( $inner_block['innerBlocks'] )
					) {
						continue 2;
					}
				}
			}

$output .= render_block( $block );
		}
	}

return $output;
}

/**
 * Render inner blocks from the `core/columns` block for generating an excerpt.
 *
 * @since 5.2.0
 * @access private
 *
 * @param array $columns        The parsed columns block.
 * @param array $allowed_blocks The list of allowed inner blocks.
 * @return string The rendered inner blocks.
 */
function _excerpt_render_inner_columns_blocks( $columns, $allowed_blocks ) {
	$output = '';

foreach ( $columns['innerBlocks'] as $column ) {
		foreach ( $column['innerBlocks'] as $inner_block ) {
			if ( in_array( $inner_block['blockName'], $allowed_blocks, true ) && empty( $inner_block['innerBlocks'] ) ) {
				$output .= render_block( $inner_block );
			}
		}
	}

return $output;
}

/**
 * Renders a single block into a HTML string.
 *
 * @since 5.0.0
 *
 * @global WP_Post $post The post to edit.
 *
 * @param array $block A single parsed block object.
 * @return string String of rendered HTML.
 */
function render_block( $block ) {
	global $post;

/**
	 * Allows render_block() to be shortcircuited, by returning a non-null value.
	 *
	 * @since 5.1.0
	 *
	 * @param string $pre_render The pre-rendered content. Default null.
	 * @param array  $block      The block being rendered.
	 */
	$pre_render = apply_filters( 'pre_render_block', null, $block );
	if ( ! is_null( $pre_render ) ) {
		return $pre_render;
	}

$source_block = $block;

/**
	 * Filters the block being rendered in render_block(), before it's processed.
	 *
	 * @since 5.1.0
	 *
	 * @param array $block        The block being rendered.
	 * @param array $source_block An un-modified copy of $block, as it appeared in the source content.
	 */
	$block = apply_filters( 'render_block_data', $block, $source_block );

$block_type    = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] );
	$is_dynamic    = $block['blockName'] && null !== $block_type && $block_type->is_dynamic();
	$block_content = '';
	$index         = 0;

foreach ( $block['innerContent'] as $chunk ) {
		$block_content .= is_string( $chunk ) ? $chunk : render_block( $block['innerBlocks'][ $index++ ] );
	}

if ( ! is_array( $block['attrs'] ) ) {
		$block['attrs'] = array();
	}

if ( $is_dynamic ) {
		$global_post   = $post;
		$block_content = $block_type->render( $block['attrs'], $block_content );
		$post          = $global_post;
	}

/**
	 * Filters the content of a single block.
	 *
	 * @since 5.0.0
	 *
	 * @param string $block_content The block content about to be appended.
	 * @param array  $block         The full block, including name and attributes.
	 */
	return apply_filters( 'render_block', $block_content, $block );
}

/**
 * Parses blocks out of a content string.
 *
 * @since 5.0.0
 *
 * @param string $content Post content.
 * @return array Array of parsed block objects.
 */
function parse_blocks( $content ) {
	/**
	 * Filter to allow plugins to replace the server-side block parser
	 *
	 * @since 5.0.0
	 *
	 * @param string $parser_class Name of block parser class.
	 */
	$parser_class = apply_filters( 'block_parser_class', 'WP_Block_Parser' );

$parser = new $parser_class();
	return $parser->parse( $content );
}

/**
 * Parses dynamic blocks out of `post_content` and re-renders them.
 *
 * @since 5.0.0
 * @global WP_Post $post The post to edit.
 *
 * @param  string $content Post content.
 * @return string Updated post content.
 */
function do_blocks( $content ) {
	$blocks = parse_blocks( $content );
	$output = '';

foreach ( $blocks as $block ) {
		$output .= render_block( $block );
	}

// If there are blocks in this content, we shouldn't run wpautop() on it later.
	$priority = has_filter( 'the_content', 'wpautop' );
	if ( false !== $priority && doing_filter( 'the_content' ) && has_blocks( $content ) ) {
		remove_filter( 'the_content', 'wpautop', $priority );
		add_filter( 'the_content', '_restore_wpautop_hook', $priority + 1 );
	}

return $output;
}

/**
 * If do_blocks() needs to remove wpautop() from the `the_content` filter, this re-adds it afterwards,
 * for subsequent `the_content` usage.
 *
 * @access private
 *
 * @since 5.0.0
 *
 * @param string $content The post content running through this filter.
 * @return string The unmodified content.
 */
function _restore_wpautop_hook( $content ) {
	$current_priority = has_filter( 'the_content', '_restore_wpautop_hook' );

add_filter( 'the_content', 'wpautop', $current_priority - 1 );
	remove_filter( 'the_content', '_restore_wpautop_hook', $current_priority );

return $content;
}

/**
 * Returns the current version of the block format that the content string is using.
 *
 * If the string doesn't contain blocks, it returns 0.
 *
 * @since 5.0.0
 *
 * @param string $content Content to test.
 * @return int The block format version is 1 if the content contains one or more blocks, 0 otherwise.
 */
function block_version( $content ) {
	return has_blocks( $content ) ? 1 : 0;
}

[+] ..
[-] cron.php [edit]
[-] class-wp-text-diff-renderer-table.php [edit]
[-] ms-files.php [edit]
[-] version.php [edit]
[-] class-wp-walker.php [edit]
[-] class-wp-simplepie-sanitize-kses.php [edit]
[-] class-wp-recovery-mode-cookie-service.php [edit]
[-] class-wp-widget-factory.php [edit]
[-] class-wp-oembed-controller.php [edit]
[-] meta.php [edit]
[-] blocks.php [edit]
[-] post-formats.php [edit]
[-] class-walker-nav-menu.php [edit]
[-] bookmark-template.php [edit]
[-] bookmark.php [edit]
[-] embed.php [edit]
[-] kses.php [edit]
[-] ms-default-constants.php [edit]
[-] class-wp-recovery-mode-email-service.php [edit]
[-] user.php [edit]
[-] class-wp-customize-panel.php [edit]
[-] link-template.php [edit]
[-] class-wp-xmlrpc-server.php [edit]
[-] class-wp-http-encoding.php [edit]
[-] class-wp-editor.php [edit]
[-] ms-site.php [edit]
[-] class-wp-admin-bar.php [edit]
[-] class-wp-image-editor.php [edit]
[-] class-walker-page.php [edit]
[-] locale.php [edit]
[-] class-wp-user.php [edit]
[-] script-loader.php [edit]
[-] category.php [edit]
[-] revision.php [edit]
[-] pluggable-deprecated.php [edit]
[-] ms-deprecated.php [edit]
[-] feed-atom-comments.php [edit]
[-] class-wp-customize-section.php [edit]
[-] date.php [edit]
[+] SimplePie
[-] cache.php [edit]
[-] ms-load.php [edit]
[-] class-wp-feed-cache.php [edit]
[-] class.wp-styles.php [edit]
[-] class-wp-http-curl.php [edit]
[-] ms-blogs.php [edit]
[-] class-wp-term-query.php [edit]
[-] ms-settings.php [edit]
[-] default-constants.php [edit]
[-] canonical.php [edit]
[+] pomo
[-] class-wp-session-tokens.php [edit]
[-] rss-functions.php [edit]
[-] class-wp-meta-query.php [edit]
[-] taxonomy.php [edit]
[-] nav-menu-template.php [edit]
[+] IXR
[-] wp-diff.php [edit]
[-] class-walker-comment.php [edit]
[-] class-wp-ajax-response.php [edit]
[-] session.php [edit]
[-] formatting.php [edit]
[-] comment-template.php [edit]
[-] widgets.php [edit]
[-] class-wp-locale.php [edit]
[-] post-thumbnail-template.php [edit]
[-] capabilities.php [edit]
[-] category-template.php [edit]
[-] feed-rss2.php [edit]
[-] class-wp-http-response.php [edit]
[-] class-wp.php [edit]
[-] class-http.php [edit]
[-] atomlib.php [edit]
[-] class-phpass.php [edit]
[-] class-wp-hook.php [edit]
[-] class-wp-metadata-lazyloader.php [edit]
[-] class-wp-user-meta-session-tokens.php [edit]
[+] images
[-] query.php [edit]
[-] feed-rdf.php [edit]
[-] update.php [edit]
[-] class-wp-http-cookie.php [edit]
[+] random_compat
[-] class-feed.php [edit]
[-] class-wp-http-proxy.php [edit]
[-] class-wp-comment.php [edit]
[-] registration.php [edit]
[-] registration-functions.php [edit]
[+] fonts
[-] class-wp-network-query.php [edit]
[-] class-wp-image-editor-imagick.php [edit]
[-] class-wp-rewrite.php [edit]
[-] class-wp-site-query.php [edit]
[-] template.php [edit]
[-] class-wp-text-diff-renderer-inline.php [edit]
[-] theme.php [edit]
[-] class-walker-page-dropdown.php [edit]
[-] class-phpmailer.php [edit]
[-] feed-atom.php [edit]
[-] class.wp-dependencies.php [edit]
[+] theme-compat
[-] class-wp-matchesmapregex.php [edit]
[-] author-template.php [edit]
[-] embed-template.php [edit]
[-] class-oembed.php [edit]
[-] class-wp-block-parser.php [edit]
[-] class-wp-fatal-error-handler.php [edit]
[-] class-wp-locale-switcher.php [edit]
[-] l10n.php [edit]
[-] class-wp-customize-nav-menus.php [edit]
[-] class-wp-site.php [edit]
[-] class-wp-recovery-mode.php [edit]
[-] load.php [edit]
[+] css
[-] class-wp-post-type.php [edit]
[-] vars.php [edit]
[-] functions.wp-scripts.php [edit]
[-] feed-rss.php [edit]
[-] class-wp-customize-control.php [edit]
[+] blocks
[-] class-wp-taxonomy.php [edit]
[-] shortcodes.php [edit]
[-] class-wp-customize-widgets.php [edit]
[+] widgets
[-] functions.php [edit]
[-] class-wp-list-util.php [edit]
[-] error-protection.php [edit]
[-] class-wp-http-requests-hooks.php [edit]
[+] ID3
[-] class-wp-comment-query.php [edit]
[-] class-wp-roles.php [edit]
[-] media-template.php [edit]
[-] class-wp-theme.php [edit]
[-] class-smtp.php [edit]
[-] post-template.php [edit]
[-] class-wp-user-query.php [edit]
[-] wlwmanifest.xml [edit]
[-] class-wp-network.php [edit]
[-] class-wp-http-requests-response.php [edit]
[-] class-wp-block-type-registry.php [edit]
[-] class-IXR.php [edit]
[-] class-wp-query.php [edit]
[-] class-wp-term.php [edit]
[-] functions.wp-styles.php [edit]
[-] ms-functions.php [edit]
[+] Text
[-] class-wp-recovery-mode-key-service.php [edit]
[-] class-wp-tax-query.php [edit]
[-] pluggable.php [edit]
[-] class-wp-error.php [edit]
[-] compat.php [edit]
[-] media.php [edit]
[-] class-wp-feed-cache-transient.php [edit]
[-] class-wp-embed.php [edit]
[-] class-wp-widget.php [edit]
[-] post.php [edit]
[-] admin-bar.php [edit]
[-] class-requests.php [edit]
[-] template-loader.php [edit]
[-] rss.php [edit]
[-] ms-default-filters.php [edit]
[-] class-walker-category-dropdown.php [edit]
[-] http.php [edit]
[-] nav-menu.php [edit]
[-] class-simplepie.php [edit]
[-] rest-api.php [edit]
[-] class-wp-dependency.php [edit]
[-] class-wp-image-editor-gd.php [edit]
[-] default-filters.php [edit]
[+] Requests
[-] class-wp-http-ixr-client.php [edit]
[-] deprecated.php [edit]
[-] class.wp-scripts.php [edit]
[-] feed-rss2-comments.php [edit]
[-] feed.php [edit]
[-] class-json.php [edit]
[-] class-wp-recovery-mode-link-service.php [edit]
[-] class-snoopy.php [edit]
[+] sodium_compat
[-] plugin.php [edit]
[-] class-wp-role.php [edit]
[-] class-wp-block-type.php [edit]
[+] customize
[+] rest-api
[-] comment.php [edit]
[-] class-pop3.php [edit]
[-] class-wp-http-streams.php [edit]
[-] class-wp-customize-setting.php [edit]
[+] js
[-] default-widgets.php [edit]
[-] class-wp-paused-extensions-storage.php [edit]
[-] rewrite.php [edit]
[-] wp-db.php [edit]
[-] ms-network.php [edit]
[-] general-template.php [edit]
[-] spl-autoload-compat.php [edit]
[-] class-walker-category.php [edit]
[-] option.php [edit]
[-] class-wp-customize-manager.php [edit]
[-] class-wp-post.php [edit]
[-] class-wp-simplepie-file.php [edit]
[+] certificates