WP_Block_Metadata_Registry::register_collection( string $path, string $manifest ): bool

84	public static function register_collection( $path, $manifest ) {85		$path = rtrim( wp_normalize_path( $path ), '/' );86 87		$collection_roots = self::get_default_collection_roots();88 89		/**90		 * Filters the root directory paths for block metadata collections.91		 *92		 * Any block metadata collection that is registered must not use any of these paths, or any parent directory93		 * path of them. Most commonly, block metadata collections should reside within one of these paths, though in94		 * some scenarios they may also reside in entirely different directories (e.g. in case of symlinked plugins).95		 *96		 * Example:97		 * * It is allowed to register a collection with path `WP_PLUGIN_DIR . '/my-plugin'`.98		 * * It is not allowed to register a collection with path `WP_PLUGIN_DIR`.99		 * * It is not allowed to register a collection with path `dirname( WP_PLUGIN_DIR )`.100		 *101		 * The default list encompasses the `wp-includes` directory, as well as the root directories for plugins,102		 * must-use plugins, and themes. This filter can be used to expand the list, e.g. to custom directories that103		 * contain symlinked plugins, so that these root directories cannot be used themselves for a block metadata104		 * collection either.105		 *106		 * @since 6.7.2107		 *108		 * @param string[] $collection_roots List of allowed metadata collection root paths.109		 */110		$collection_roots = apply_filters( 'wp_allowed_block_metadata_collection_roots', $collection_roots );111 112		$collection_roots = array_unique(113			array_map(114				static function ( $allowed_root ) {115					return rtrim( wp_normalize_path( $allowed_root ), '/' );116				},117				$collection_roots118			)119		);120 121		// Check if the path is valid:122		if ( ! self::is_valid_collection_path( $path, $collection_roots ) ) {123			_doing_it_wrong(124				__METHOD__,125				sprintf(126					/* translators: %s: list of allowed collection roots */127					__( 'Block metadata collections cannot be registered as one of the following directories or their parent directories: %s' ),128					esc_html( implode( wp_get_list_item_separator(), $collection_roots ) )129				),130				'6.7.2'131			);132			return false;133		}134 135		if ( ! file_exists( $manifest ) ) {136			_doing_it_wrong(137				__METHOD__,138				__( 'The specified manifest file does not exist.' ),139				'6.7.0'140			);141			return false;142		}143 144		self::$collections[ $path ] = array(145			'manifest' => $manifest,146			'metadata' => null,147		);148 149		return true;150	}