summaryrefslogtreecommitdiffstats
path: root/wp-includes/block-supports/settings.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
commita415c29efee45520ae252d2aa28f1083a521cd7b (patch)
treef4ade4b6668ecc0765de7e1424f7c1427ad433ff /wp-includes/block-supports/settings.php
parentInitial commit. (diff)
downloadwordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.tar.xz
wordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.zip
Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-includes/block-supports/settings.php')
-rw-r--r--wp-includes/block-supports/settings.php152
1 files changed, 152 insertions, 0 deletions
diff --git a/wp-includes/block-supports/settings.php b/wp-includes/block-supports/settings.php
new file mode 100644
index 0000000..ca3ba13
--- /dev/null
+++ b/wp-includes/block-supports/settings.php
@@ -0,0 +1,152 @@
+<?php
+/**
+ * Block level presets support.
+ *
+ * @package WordPress
+ * @since 6.2.0
+ */
+
+/**
+ * Get the class name used on block level presets.
+ *
+ * @internal
+ *
+ * @since 6.2.0
+ * @access private
+ *
+ * @param array $block Block object.
+ * @return string The unique class name.
+ */
+function _wp_get_presets_class_name( $block ) {
+ return 'wp-settings-' . md5( serialize( $block ) );
+}
+
+/**
+ * Update the block content with block level presets class name.
+ *
+ * @internal
+ *
+ * @since 6.2.0
+ * @access private
+ *
+ * @param string $block_content Rendered block content.
+ * @param array $block Block object.
+ * @return string Filtered block content.
+ */
+function _wp_add_block_level_presets_class( $block_content, $block ) {
+ if ( ! $block_content ) {
+ return $block_content;
+ }
+
+ // return early if the block doesn't have support for settings.
+ $block_type = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] );
+ if ( ! block_has_support( $block_type, '__experimentalSettings', false ) ) {
+ return $block_content;
+ }
+
+ // return early if no settings are found on the block attributes.
+ $block_settings = isset( $block['attrs']['settings'] ) ? $block['attrs']['settings'] : null;
+ if ( empty( $block_settings ) ) {
+ return $block_content;
+ }
+
+ // Like the layout hook this assumes the hook only applies to blocks with a single wrapper.
+ // Add the class name to the first element, presuming it's the wrapper, if it exists.
+ $tags = new WP_HTML_Tag_Processor( $block_content );
+ if ( $tags->next_tag() ) {
+ $tags->add_class( _wp_get_presets_class_name( $block ) );
+ }
+
+ return $tags->get_updated_html();
+}
+
+/**
+ * Render the block level presets stylesheet.
+ *
+ * @internal
+ *
+ * @since 6.2.0
+ * @since 6.3.0 Updated preset styles to use Selectors API.
+ * @access private
+ *
+ * @param string|null $pre_render The pre-rendered content. Default null.
+ * @param array $block The block being rendered.
+ *
+ * @return null
+ */
+function _wp_add_block_level_preset_styles( $pre_render, $block ) {
+ // Return early if the block has not support for descendent block styles.
+ $block_type = WP_Block_Type_Registry::get_instance()->get_registered( $block['blockName'] );
+ if ( ! block_has_support( $block_type, '__experimentalSettings', false ) ) {
+ return null;
+ }
+
+ // return early if no settings are found on the block attributes.
+ $block_settings = isset( $block['attrs']['settings'] ) ? $block['attrs']['settings'] : null;
+ if ( empty( $block_settings ) ) {
+ return null;
+ }
+
+ $class_name = '.' . _wp_get_presets_class_name( $block );
+
+ // the root selector for preset variables needs to target every possible block selector
+ // in order for the general setting to override any bock specific setting of a parent block or
+ // the site root.
+ $variables_root_selector = '*,[class*="wp-block"]';
+ $registry = WP_Block_Type_Registry::get_instance();
+ $blocks = $registry->get_all_registered();
+ foreach ( $blocks as $block_type ) {
+ /*
+ * We only want to append selectors for blocks using custom selectors
+ * i.e. not `wp-block-<name>`.
+ */
+ $has_custom_selector =
+ ( isset( $block_type->supports['__experimentalSelector'] ) && is_string( $block_type->supports['__experimentalSelector'] ) ) ||
+ ( isset( $block_type->selectors['root'] ) && is_string( $block_type->selectors['root'] ) );
+
+ if ( $has_custom_selector ) {
+ $variables_root_selector .= ',' . wp_get_block_css_selector( $block_type );
+ }
+ }
+ $variables_root_selector = WP_Theme_JSON::scope_selector( $class_name, $variables_root_selector );
+
+ // Remove any potentially unsafe styles.
+ $theme_json_shape = WP_Theme_JSON::remove_insecure_properties(
+ array(
+ 'version' => WP_Theme_JSON::LATEST_SCHEMA,
+ 'settings' => $block_settings,
+ )
+ );
+ $theme_json_object = new WP_Theme_JSON( $theme_json_shape );
+
+ $styles = '';
+
+ // include preset css variables declaration on the stylesheet.
+ $styles .= $theme_json_object->get_stylesheet(
+ array( 'variables' ),
+ null,
+ array(
+ 'root_selector' => $variables_root_selector,
+ 'scope' => $class_name,
+ )
+ );
+
+ // include preset css classes on the the stylesheet.
+ $styles .= $theme_json_object->get_stylesheet(
+ array( 'presets' ),
+ null,
+ array(
+ 'root_selector' => $class_name . ',' . $class_name . ' *',
+ 'scope' => $class_name,
+ )
+ );
+
+ if ( ! empty( $styles ) ) {
+ wp_enqueue_block_support_styles( $styles );
+ }
+
+ return null;
+}
+
+add_filter( 'render_block', '_wp_add_block_level_presets_class', 10, 2 );
+add_filter( 'pre_render_block', '_wp_add_block_level_preset_styles', 10, 2 );