H69UNtblNBNpha2dtB1Odn8qYp1Qk5NK2gi7yfceofo9N

e:/home/ajudasindico/Web/16dezoito/wp-includes/

<?php
/**
 * Block Metadata Registry
 *
 * @package WordPress
 * @subpackage Blocks
 * @since 6.7.0
 */

/**
 * Class used for managing block metadata collections.
 *
 * The WP_Block_Metadata_Registry allows plugins to register metadata for large
 * collections of blocks (e.g., 50-100+) using a single PHP file. This approach
 * reduces the need to read and decode multiple `block.json` files, enhancing
 * performance through opcode caching.
 *
 * @since 6.7.0
 */
class WP_Block_Metadata_Registry {

/**
	 * Container for storing block metadata collections.
	 *
	 * Each entry maps a base path to its corresponding metadata and callback.
	 *
	 * @since 6.7.0
	 * @var array<string, array<string, mixed>>
	 */
	private static $collections = array();

/**
	 * Caches the last matched collection path for performance optimization.
	 *
	 * @since 6.7.0
	 * @var string|null
	 */
	private static $last_matched_collection = null;

/**
	 * Stores the default allowed collection root paths.
	 *
	 * @since 6.7.2
	 * @var string[]|null
	 */
	private static $default_collection_roots = null;

/**
	 * Registers a block metadata collection.
	 *
	 * This method allows registering a collection of block metadata from a single
	 * manifest file, improving performance for large sets of blocks.
	 *
	 * The manifest file should be a PHP file that returns an associative array, where
	 * the keys are the block identifiers (without their namespace) and the values are
	 * the corresponding block metadata arrays. The block identifiers must match the
	 * parent directory name for the respective `block.json` file.
	 *
	 * Example manifest file structure:
	 * ```
	 * return array(
	 *     'example-block' => array(
	 *         'title' => 'Example Block',
	 *         'category' => 'widgets',
	 *         'icon' => 'smiley',
	 *         // ... other block metadata
	 *     ),
	 *     'another-block' => array(
	 *         'title' => 'Another Block',
	 *         'category' => 'formatting',
	 *         'icon' => 'star-filled',
	 *         // ... other block metadata
	 *     ),
	 *     // ... more block metadata entries
	 * );
	 * ```
	 *
	 * @since 6.7.0
	 *
	 * @param string $path     The absolute base path for the collection ( e.g., WP_PLUGIN_DIR . '/my-plugin/blocks/' ).
	 * @param string $manifest The absolute path to the manifest file containing the metadata collection.
	 * @return bool True if the collection was registered successfully, false otherwise.
	 */
	public static function register_collection( $path, $manifest ) {
		$path = rtrim( wp_normalize_path( $path ), '/' );

$collection_roots = self::get_default_collection_roots();

/**
		 * Filters the root directory paths for block metadata collections.
		 *
		 * Any block metadata collection that is registered must not use any of these paths, or any parent directory
		 * path of them. Most commonly, block metadata collections should reside within one of these paths, though in
		 * some scenarios they may also reside in entirely different directories (e.g. in case of symlinked plugins).
		 *
		 * Example:
		 * * It is allowed to register a collection with path `WP_PLUGIN_DIR . '/my-plugin'`.
		 * * It is not allowed to register a collection with path `WP_PLUGIN_DIR`.
		 * * It is not allowed to register a collection with path `dirname( WP_PLUGIN_DIR )`.
		 *
		 * The default list encompasses the `wp-includes` directory, as well as the root directories for plugins,
		 * must-use plugins, and themes. This filter can be used to expand the list, e.g. to custom directories that
		 * contain symlinked plugins, so that these root directories cannot be used themselves for a block metadata
		 * collection either.
		 *
		 * @since 6.7.2
		 *
		 * @param string[] $collection_roots List of allowed metadata collection root paths.
		 */
		$collection_roots = apply_filters( 'wp_allowed_block_metadata_collection_roots', $collection_roots );

$collection_roots = array_unique(
			array_map(
				static function ( $allowed_root ) {
					return rtrim( wp_normalize_path( $allowed_root ), '/' );
				},
				$collection_roots
			)
		);

// Check if the path is valid:
		if ( ! self::is_valid_collection_path( $path, $collection_roots ) ) {
			_doing_it_wrong(
				__METHOD__,
				sprintf(
					/* translators: %s: list of allowed collection roots */
					__( 'Block metadata collections cannot be registered as one of the following directories or their parent directories: %s' ),
					esc_html( implode( wp_get_list_item_separator(), $collection_roots ) )
				),
				'6.7.2'
			);
			return false;
		}

if ( ! file_exists( $manifest ) ) {
			_doing_it_wrong(
				__METHOD__,
				__( 'The specified manifest file does not exist.' ),
				'6.7.0'
			);
			return false;
		}

self::$collections[ $path ] = array(
			'manifest' => $manifest,
			'metadata' => null,
		);

return true;
	}

/**
	 * Retrieves block metadata for a given block within a specific collection.
	 *
	 * This method uses the registered collections to efficiently lookup
	 * block metadata without reading individual `block.json` files.
	 *
	 * @since 6.7.0
	 *
	 * @param string $file_or_folder The path to the file or folder containing the block.
	 * @return array|null The block metadata for the block, or null if not found.
	 */
	public static function get_metadata( $file_or_folder ) {
		$file_or_folder = wp_normalize_path( $file_or_folder );

$path = self::find_collection_path( $file_or_folder );
		if ( ! $path ) {
			return null;
		}

$collection = &self::$collections[ $path ];

if ( null === $collection['metadata'] ) {
			// Load the manifest file if not already loaded
			$collection['metadata'] = require $collection['manifest'];
		}

// Get the block name from the path.
		$block_name = self::default_identifier_callback( $file_or_folder );

return isset( $collection['metadata'][ $block_name ] ) ? $collection['metadata'][ $block_name ] : null;
	}

/**
	 * Gets the list of absolute paths to all block metadata files that are part of the given collection.
	 *
	 * For instance, if a block metadata collection is registered with path `WP_PLUGIN_DIR . '/my-plugin/blocks/'`,
	 * and the manifest file includes metadata for two blocks `'block-a'` and `'block-b'`, the result of this method
	 * will be an array containing:
	 * * `WP_PLUGIN_DIR . '/my-plugin/blocks/block-a/block.json'`
	 * * `WP_PLUGIN_DIR . '/my-plugin/blocks/block-b/block.json'`
	 *
	 * @since 6.8.0
	 *
	 * @param string $path The absolute base path for a previously registered collection.
	 * @return string[] List of block metadata file paths, or an empty array if the given `$path` is invalid.
	 */
	public static function get_collection_block_metadata_files( $path ) {
		$path = rtrim( wp_normalize_path( $path ), '/' );

if ( ! isset( self::$collections[ $path ] ) ) {
			_doing_it_wrong(
				__METHOD__,
				__( 'No registered block metadata collection was found for the provided path.' ),
				'6.8.0'
			);
			return array();
		}

$collection = &self::$collections[ $path ];

if ( null === $collection['metadata'] ) {
			// Load the manifest file if not already loaded.
			$collection['metadata'] = require $collection['manifest'];
		}

return array_map(
			// No normalization necessary since `$path` is already normalized and `$block_name` is just a folder name.
			static function ( $block_name ) use ( $path ) {
				return "{$path}/{$block_name}/block.json";
			},
			array_keys( $collection['metadata'] )
		);
	}

/**
	 * Finds the collection path for a given file or folder.
	 *
	 * @since 6.7.0
	 *
	 * @param string $file_or_folder The normalized path to the file or folder.
	 * @return string|null The normalized collection path if found, or null if not found.
	 */
	private static function find_collection_path( $file_or_folder ) {
		if ( empty( $file_or_folder ) ) {
			return null;
		}

// Check the last matched collection first, since block registration usually happens in batches per plugin or theme.
		$path = rtrim( $file_or_folder, '/' );
		if ( self::$last_matched_collection && str_starts_with( $path, self::$last_matched_collection ) ) {
			return self::$last_matched_collection;
		}

$collection_paths = array_keys( self::$collections );
		foreach ( $collection_paths as $collection_path ) {
			if ( str_starts_with( $path, $collection_path ) ) {
				self::$last_matched_collection = $collection_path;
				return $collection_path;
			}
		}
		return null;
	}

/**
	 * Checks if metadata exists for a given block name in a specific collection.
	 *
	 * @since 6.7.0
	 *
	 * @param string $file_or_folder The path to the file or folder containing the block metadata.
	 * @return bool True if metadata exists for the block, false otherwise.
	 */
	public static function has_metadata( $file_or_folder ) {
		return null !== self::get_metadata( $file_or_folder );
	}

/**
	 * Default identifier function to determine the block identifier from a given path.
	 *
	 * This function extracts the block identifier from the path:
	 * - For 'block.json' files, it uses the parent directory name.
	 * - For directories, it uses the directory name itself.
	 * - For empty paths, it returns an empty string.
	 *
	 * For example:
	 * - Path: '/wp-content/plugins/my-plugin/blocks/example/block.json'
	 *   Identifier: 'example'
	 * - Path: '/wp-content/plugins/my-plugin/blocks/another-block'
	 *   Identifier: 'another-block'
	 *
	 * This default behavior matches the standard WordPress block structure.
	 *
	 * @since 6.7.0
	 *
	 * @param string $path The normalized file or folder path to determine the block identifier from.
	 * @return string The block identifier, or an empty string if the path is empty.
	 */
	private static function default_identifier_callback( $path ) {
		// Ensure $path is not empty to prevent unexpected behavior.
		if ( empty( $path ) ) {
			return '';
		}

if ( str_ends_with( $path, 'block.json' ) ) {
			// Return the parent directory name if it's a block.json file.
			return basename( dirname( $path ) );
		}

// Otherwise, assume it's a directory and return its name.
		return basename( $path );
	}

/**
	 * Checks whether the given block metadata collection path is valid against the list of collection roots.
	 *
	 * @since 6.7.2
	 *
	 * @param string   $path             Normalized block metadata collection path, without trailing slash.
	 * @param string[] $collection_roots List of normalized collection root paths, without trailing slashes.
	 * @return bool True if the path is allowed, false otherwise.
	 */
	private static function is_valid_collection_path( $path, $collection_roots ) {
		foreach ( $collection_roots as $allowed_root ) {
			// If the path matches any root exactly, it is invalid.
			if ( $allowed_root === $path ) {
				return false;
			}

// If the path is a parent path of any of the roots, it is invalid.
			if ( str_starts_with( $allowed_root, $path ) ) {
				return false;
			}
		}

return true;
	}

/**
	 * Gets the default collection root directory paths.
	 *
	 * @since 6.7.2
	 *
	 * @return string[] List of directory paths within which metadata collections are allowed.
	 */
	private static function get_default_collection_roots() {
		if ( isset( self::$default_collection_roots ) ) {
			return self::$default_collection_roots;
		}

$collection_roots = array(
			wp_normalize_path( ABSPATH . WPINC ),
			wp_normalize_path( WP_CONTENT_DIR ),
			wp_normalize_path( WPMU_PLUGIN_DIR ),
			wp_normalize_path( WP_PLUGIN_DIR ),
		);

$theme_roots = get_theme_roots();
		if ( ! is_array( $theme_roots ) ) {
			$theme_roots = array( $theme_roots );
		}
		foreach ( $theme_roots as $theme_root ) {
			$collection_roots[] = trailingslashit( wp_normalize_path( WP_CONTENT_DIR ) ) . ltrim( wp_normalize_path( $theme_root ), '/' );
		}

self::$default_collection_roots = array_unique( $collection_roots );
		return self::$default_collection_roots;
	}
}

Nama File / Folder	Size	Action
ID3	--	NONE
IXR	--	NONE
PHPMailer	--	NONE
Requests	--	NONE
SimplePie	--	NONE
Text	--	NONE
assets	--	NONE
block-bindings	--	NONE
block-patterns	--	NONE
block-supports	--	NONE
blocks	--	NONE
certificates	--	NONE
css	--	NONE
customize	--	NONE
fonts	--	NONE
html-api	--	NONE
images	--	NONE
interactivity-api	--	NONE
js	--	NONE
l10n	--	NONE
php-compat	--	NONE
pomo	--	NONE
rest-api	--	NONE
sitemaps	--	NONE
sodium_compat	--	NONE
style-engine	--	NONE
theme-compat	--	NONE
widgets	--	NONE
admin-bar.php	36.086KB	Hapus Edit Rename
atomlib.php	11.795KB	Hapus Edit Rename
author-template.php	18.507KB	Hapus Edit Rename
block-bindings.php	5.463KB	Hapus Edit Rename
block-patterns.php	12.903KB	Hapus Edit Rename
block-template-utils.php	60.456KB	Hapus Edit Rename
block-template.php	14.996KB	Hapus Edit Rename
blocks.php	108.295KB	Hapus Edit Rename
bookmark-template.php	12.469KB	Hapus Edit Rename
cache-compat.php	5.829KB	Hapus Edit Rename
cache.php	13.158KB	Hapus Edit Rename
canonical.php	33.714KB	Hapus Edit Rename
capabilities.php	41.717KB	Hapus Edit Rename
class-IXR.php	2.555KB	Hapus Edit Rename
class-avif-info.php	28.921KB	Hapus Edit Rename
class-feed.php	0.526KB	Hapus Edit Rename
class-json.php	42.66KB	Hapus Edit Rename
class-phpass.php	6.612KB	Hapus Edit Rename
class-phpmailer.php	0.648KB	Hapus Edit Rename
class-pop3.php	20.626KB	Hapus Edit Rename
class-requests.php	2.185KB	Hapus Edit Rename
class-simplepie.php	0.442KB	Hapus Edit Rename
class-smtp.php	0.446KB	Hapus Edit Rename
class-walker-category-dropdown.php	2.411KB	Hapus Edit Rename
class-walker-category.php	8.278KB	Hapus Edit Rename
class-walker-nav-menu.php	11.762KB	Hapus Edit Rename
class-wp-admin-bar.php	17.455KB	Hapus Edit Rename
class-wp-ajax-response.php	5.143KB	Hapus Edit Rename
class-wp-application-passwords.php	16.698KB	Hapus Edit Rename
class-wp-block-bindings-registry.php	8.265KB	Hapus Edit Rename
class-wp-block-bindings-source.php	2.922KB	Hapus Edit Rename
class-wp-block-list.php	4.646KB	Hapus Edit Rename
class-wp-block-metadata-registry.php	11.616KB	Hapus Edit Rename
class-wp-block-parser-block.php	2.495KB	Hapus Edit Rename
class-wp-block-pattern-categories-registry.php	5.245KB	Hapus Edit Rename
class-wp-block-styles-registry.php	6.253KB	Hapus Edit Rename
class-wp-block-template.php	1.985KB	Hapus Edit Rename
class-wp-block-templates-registry.php	7.062KB	Hapus Edit Rename
class-wp-block-type-registry.php	4.896KB	Hapus Edit Rename
class-wp-block-type.php	16.86KB	Hapus Edit Rename
class-wp-block.php	22.501KB	Hapus Edit Rename
class-wp-classic-to-block-menu-converter.php	3.992KB	Hapus Edit Rename
class-wp-customize-nav-menus.php	56.066KB	Hapus Edit Rename
class-wp-customize-section.php	10.946KB	Hapus Edit Rename
class-wp-customize-setting.php	29.26KB	Hapus Edit Rename
class-wp-customize-widgets.php	70.518KB	Hapus Edit Rename
class-wp-dependencies.php	14.784KB	Hapus Edit Rename
class-wp-dependency.php	2.565KB	Hapus Edit Rename
class-wp-duotone.php	39.827KB	Hapus Edit Rename
class-wp-editor.php	70.64KB	Hapus Edit Rename
class-wp-exception.php	0.247KB	Hapus Edit Rename
class-wp-http-curl.php	12.247KB	Hapus Edit Rename
class-wp-http-encoding.php	6.532KB	Hapus Edit Rename
class-wp-http-ixr-client.php	3.419KB	Hapus Edit Rename
class-wp-http-requests-response.php	4.297KB	Hapus Edit Rename
class-wp-http-streams.php	16.464KB	Hapus Edit Rename
class-wp-image-editor-gd.php	19.689KB	Hapus Edit Rename
class-wp-image-editor-imagick.php	33.921KB	Hapus Edit Rename
class-wp-image-editor.php	17.116KB	Hapus Edit Rename
class-wp-list-util.php	7.269KB	Hapus Edit Rename
class-wp-locale-switcher.php	6.617KB	Hapus Edit Rename
class-wp-locale.php	16.487KB	Hapus Edit Rename
class-wp-matchesmapregex.php	1.785KB	Hapus Edit Rename
class-wp-meta-query.php	29.815KB	Hapus Edit Rename
class-wp-metadata-lazyloader.php	6.673KB	Hapus Edit Rename
class-wp-network-query.php	19.392KB	Hapus Edit Rename
class-wp-object-cache.php	17.113KB	Hapus Edit Rename
class-wp-oembed-controller.php	6.743KB	Hapus Edit Rename
class-wp-paused-extensions-storage.php	4.991KB	Hapus Edit Rename
class-wp-phpmailer.php	3.713KB	Hapus Edit Rename
class-wp-plugin-dependencies.php	24.722KB	Hapus Edit Rename
class-wp-post-type.php	29.961KB	Hapus Edit Rename
class-wp-post.php	6.336KB	Hapus Edit Rename
class-wp-query.php	154.319KB	Hapus Edit Rename
class-wp-recovery-mode-cookie-service.php	6.716KB	Hapus Edit Rename
class-wp-recovery-mode-email-service.php	10.921KB	Hapus Edit Rename
class-wp-recovery-mode-key-service.php	4.77KB	Hapus Edit Rename
class-wp-recovery-mode-link-service.php	3.382KB	Hapus Edit Rename
class-wp-recovery-mode.php	11.185KB	Hapus Edit Rename
class-wp-rewrite.php	62.195KB	Hapus Edit Rename
class-wp-role.php	2.464KB	Hapus Edit Rename
class-wp-roles.php	8.385KB	Hapus Edit Rename
class-wp-script-modules.php	19.007KB	Hapus Edit Rename
class-wp-scripts.php	27.68KB	Hapus Edit Rename
class-wp-simplepie-file.php	3.328KB	Hapus Edit Rename
class-wp-simplepie-sanitize-kses.php	1.865KB	Hapus Edit Rename
class-wp-site-query.php	30.884KB	Hapus Edit Rename
class-wp-site.php	7.279KB	Hapus Edit Rename
class-wp-styles.php	10.752KB	Hapus Edit Rename
class-wp-tax-query.php	19.097KB	Hapus Edit Rename
class-wp-term-query.php	39.911KB	Hapus Edit Rename
class-wp-term.php	5.174KB	Hapus Edit Rename
class-wp-text-diff-renderer-inline.php	0.956KB	Hapus Edit Rename
class-wp-textdomain-registry.php	10.235KB	Hapus Edit Rename
class-wp-theme-json-data.php	1.767KB	Hapus Edit Rename
class-wp-theme.php	64.268KB	Hapus Edit Rename
class-wp-token-map.php	27.947KB	Hapus Edit Rename
class-wp-url-pattern-prefixer.php	4.689KB	Hapus Edit Rename
class-wp-user-meta-session-tokens.php	2.92KB	Hapus Edit Rename
class-wp-user-query.php	42.632KB	Hapus Edit Rename
class-wp-user-request.php	2.251KB	Hapus Edit Rename
class-wp-walker.php	13.01KB	Hapus Edit Rename
class-wp-widget-factory.php	3.269KB	Hapus Edit Rename
class-wp.php	25.701KB	Hapus Edit Rename
class.wp-dependencies.php	0.364KB	Hapus Edit Rename
class.wp-scripts.php	0.335KB	Hapus Edit Rename
class.wp-styles.php	0.33KB	Hapus Edit Rename
comment-template.php	100.471KB	Hapus Edit Rename
comment.php	128.464KB	Hapus Edit Rename
compat.php	15.992KB	Hapus Edit Rename
cron.php	41.658KB	Hapus Edit Rename
date.php	0.391KB	Hapus Edit Rename
default-constants.php	11.099KB	Hapus Edit Rename
default-widgets.php	2.241KB	Hapus Edit Rename
deprecated.php	187.073KB	Hapus Edit Rename
embed-template.php	0.33KB	Hapus Edit Rename
error-protection.php	4.024KB	Hapus Edit Rename
feed-atom-comments.php	5.375KB	Hapus Edit Rename
feed-atom.php	3.048KB	Hapus Edit Rename
feed-rdf.php	2.605KB	Hapus Edit Rename
feed-rss.php	1.161KB	Hapus Edit Rename
feed-rss2.php	3.71KB	Hapus Edit Rename
feed.php	22.862KB	Hapus Edit Rename
formatting.php	334.239KB	Hapus Edit Rename
functions.php	280.807KB	Hapus Edit Rename
functions.wp-scripts.php	14.217KB	Hapus Edit Rename
functions.wp-styles.php	8.382KB	Hapus Edit Rename
global-styles-and-settings.php	20.763KB	Hapus Edit Rename
https-detection.php	5.72KB	Hapus Edit Rename
https-migration.php	4.63KB	Hapus Edit Rename
l10n.php	66.812KB	Hapus Edit Rename
load.php	54.354KB	Hapus Edit Rename
media-template.php	61.565KB	Hapus Edit Rename
media.php	213.305KB	Hapus Edit Rename
ms-default-constants.php	4.806KB	Hapus Edit Rename
ms-default-filters.php	6.48KB	Hapus Edit Rename
ms-deprecated.php	21.249KB	Hapus Edit Rename
ms-files.php	2.647KB	Hapus Edit Rename
ms-functions.php	89.11KB	Hapus Edit Rename
ms-load.php	19.417KB	Hapus Edit Rename
ms-network.php	3.693KB	Hapus Edit Rename
ms-settings.php	4.027KB	Hapus Edit Rename
ms-site.php	39.541KB	Hapus Edit Rename
nav-menu-template.php	25.31KB	Hapus Edit Rename
nav-menu.php	43.333KB	Hapus Edit Rename
option.php	99.374KB	Hapus Edit Rename
pluggable-deprecated.php	6.116KB	Hapus Edit Rename
pluggable.php	113.252KB	Hapus Edit Rename
plugin.php	34.634KB	Hapus Edit Rename
post-formats.php	6.936KB	Hapus Edit Rename
post-template.php	65.313KB	Hapus Edit Rename
post-thumbnail-template.php	10.572KB	Hapus Edit Rename
registration.php	0.195KB	Hapus Edit Rename
rest-api.php	97.259KB	Hapus Edit Rename
revision.php	30.166KB	Hapus Edit Rename
robots-template.php	5.063KB	Hapus Edit Rename
rss-functions.php	0.249KB	Hapus Edit Rename
rss.php	22.571KB	Hapus Edit Rename
script-loader.php	127.671KB	Hapus Edit Rename
script-modules.php	7.531KB	Hapus Edit Rename
session.php	0.252KB	Hapus Edit Rename
sitemaps.php	3.162KB	Hapus Edit Rename
style-engine.php	7.386KB	Hapus Edit Rename
taxonomy.php	171.326KB	Hapus Edit Rename
template-canvas.php	0.531KB	Hapus Edit Rename
template.php	23.588KB	Hapus Edit Rename
theme-i18n.json	1.262KB	Hapus Edit Rename
theme-previews.php	2.766KB	Hapus Edit Rename
theme.json	8.5KB	Hapus Edit Rename
theme.php	130.845KB	Hapus Edit Rename
update.php	35.926KB	Hapus Edit Rename
user.php	170.322KB	Hapus Edit Rename
version.php	0.938KB	Hapus Edit Rename
widgets.php	69.025KB	Hapus Edit Rename
wp-diff.php	0.709KB	Hapus Edit Rename

wordpress – Só mais um site WordPress

wordpress

Olá, mundo!

Boas-vindas ao WordPress. Esse é o seu primeiro post. Edite-o ou exclua-o, e então comece a escrever!

fevereiro 25, 2026

H69UNtblNBNpha2dtB1Odn8qYp1Qk5NK2gi7yfceofo9N

Olá, mundo!