first commit
This commit is contained in:
Rachit Bhargava
@@ -0,0 +1,678 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Blocks\Utils;
|
||||
|
||||
use Automattic\WooCommerce\Blocks\Templates\ProductAttributeTemplate;
|
||||
use Automattic\WooCommerce\Blocks\Templates\ProductSearchResultsTemplate;
|
||||
use Automattic\WooCommerce\Blocks\Domain\Services\FeatureGating;
|
||||
use Automattic\WooCommerce\Blocks\Options;
|
||||
use Automattic\WooCommerce\Blocks\Templates\MiniCartTemplate;
|
||||
|
||||
/**
|
||||
* Utility methods used for serving block templates from WooCommerce Blocks.
|
||||
* {@internal This class and its methods should only be used within the BlockTemplateController.php and is not intended for public use.}
|
||||
*/
|
||||
class BlockTemplateUtils {
|
||||
const ELIGIBLE_FOR_ARCHIVE_PRODUCT_FALLBACK = array( 'taxonomy-product_cat', 'taxonomy-product_tag', ProductAttributeTemplate::SLUG );
|
||||
/**
|
||||
* Directory names for block templates
|
||||
*
|
||||
* Directory names conventions for block templates have changed with Gutenberg 12.1.0,
|
||||
* however, for backwards-compatibility, we also keep the older conventions, prefixed
|
||||
* with `DEPRECATED_`.
|
||||
*
|
||||
* @var array {
|
||||
* @var string DEPRECATED_TEMPLATES Old directory name of the block templates directory.
|
||||
* @var string DEPRECATED_TEMPLATE_PARTS Old directory name of the block template parts directory.
|
||||
* @var string TEMPLATES_DIR_NAME Directory name of the block templates directory.
|
||||
* @var string TEMPLATE_PARTS_DIR_NAME Directory name of the block template parts directory.
|
||||
* }
|
||||
*/
|
||||
const DIRECTORY_NAMES = array(
|
||||
'DEPRECATED_TEMPLATES' => 'block-templates',
|
||||
'DEPRECATED_TEMPLATE_PARTS' => 'block-template-parts',
|
||||
'TEMPLATES' => 'templates',
|
||||
'TEMPLATE_PARTS' => 'parts',
|
||||
);
|
||||
|
||||
/**
|
||||
* WooCommerce plugin slug
|
||||
*
|
||||
* This is used to save templates to the DB which are stored against this value in the wp_terms table.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const PLUGIN_SLUG = 'woocommerce/woocommerce';
|
||||
|
||||
/**
|
||||
* Deprecated WooCommerce plugin slug
|
||||
*
|
||||
* For supporting users who have customized templates under the incorrect plugin slug during the first release.
|
||||
* More context found here: https://github.com/woocommerce/woocommerce-gutenberg-products-block/issues/5423.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const DEPRECATED_PLUGIN_SLUG = 'woocommerce';
|
||||
|
||||
/**
|
||||
* Returns an array containing the references of
|
||||
* the passed blocks and their inner blocks.
|
||||
*
|
||||
* @param array $blocks array of blocks.
|
||||
*
|
||||
* @return array block references to the passed blocks and their inner blocks.
|
||||
*/
|
||||
public static function flatten_blocks( &$blocks ) {
|
||||
$all_blocks = array();
|
||||
$queue = array();
|
||||
foreach ( $blocks as &$block ) {
|
||||
$queue[] = &$block;
|
||||
}
|
||||
$queue_count = count( $queue );
|
||||
|
||||
while ( $queue_count > 0 ) {
|
||||
$block = &$queue[0];
|
||||
array_shift( $queue );
|
||||
$all_blocks[] = &$block;
|
||||
|
||||
if ( ! empty( $block['innerBlocks'] ) ) {
|
||||
foreach ( $block['innerBlocks'] as &$inner_block ) {
|
||||
$queue[] = &$inner_block;
|
||||
}
|
||||
}
|
||||
|
||||
$queue_count = count( $queue );
|
||||
}
|
||||
|
||||
return $all_blocks;
|
||||
}
|
||||
|
||||
/**
|
||||
* Parses wp_template content and injects the current theme's
|
||||
* stylesheet as a theme attribute into each wp_template_part
|
||||
*
|
||||
* @param string $template_content serialized wp_template content.
|
||||
*
|
||||
* @return string Updated wp_template content.
|
||||
*/
|
||||
public static function inject_theme_attribute_in_content( $template_content ) {
|
||||
$has_updated_content = false;
|
||||
$new_content = '';
|
||||
$template_blocks = parse_blocks( $template_content );
|
||||
|
||||
$blocks = self::flatten_blocks( $template_blocks );
|
||||
foreach ( $blocks as &$block ) {
|
||||
if (
|
||||
'core/template-part' === $block['blockName'] &&
|
||||
! isset( $block['attrs']['theme'] )
|
||||
) {
|
||||
$block['attrs']['theme'] = wp_get_theme()->get_stylesheet();
|
||||
$has_updated_content = true;
|
||||
}
|
||||
}
|
||||
|
||||
if ( $has_updated_content ) {
|
||||
foreach ( $template_blocks as &$block ) {
|
||||
$new_content .= serialize_block( $block );
|
||||
}
|
||||
|
||||
return $new_content;
|
||||
}
|
||||
|
||||
return $template_content;
|
||||
}
|
||||
|
||||
/**
|
||||
* Build a unified template object based a post Object.
|
||||
* Important: This method is an almost identical duplicate from wp-includes/block-template-utils.php as it was not intended for public use. It has been modified to build templates from plugins rather than themes.
|
||||
*
|
||||
* @param \WP_Post $post Template post.
|
||||
*
|
||||
* @return \WP_Block_Template|\WP_Error Template.
|
||||
*/
|
||||
public static function build_template_result_from_post( $post ) {
|
||||
$terms = get_the_terms( $post, 'wp_theme' );
|
||||
|
||||
if ( is_wp_error( $terms ) ) {
|
||||
return $terms;
|
||||
}
|
||||
|
||||
if ( ! $terms ) {
|
||||
return new \WP_Error( 'template_missing_theme', __( 'No theme is defined for this template.', 'woocommerce' ) );
|
||||
}
|
||||
|
||||
$theme = $terms[0]->name;
|
||||
$has_theme_file = true;
|
||||
|
||||
$template = new \WP_Block_Template();
|
||||
$template->wp_id = $post->ID;
|
||||
$template->id = $theme . '//' . $post->post_name;
|
||||
$template->theme = $theme;
|
||||
$template->content = $post->post_content;
|
||||
$template->slug = $post->post_name;
|
||||
$template->source = 'custom';
|
||||
$template->type = $post->post_type;
|
||||
$template->description = $post->post_excerpt;
|
||||
$template->title = $post->post_title;
|
||||
$template->status = $post->post_status;
|
||||
$template->has_theme_file = $has_theme_file;
|
||||
$template->is_custom = false;
|
||||
$template->post_types = array(); // Don't appear in any Edit Post template selector dropdown.
|
||||
|
||||
if ( 'wp_template_part' === $post->post_type ) {
|
||||
$type_terms = get_the_terms( $post, 'wp_template_part_area' );
|
||||
if ( ! is_wp_error( $type_terms ) && false !== $type_terms ) {
|
||||
$template->area = $type_terms[0]->name;
|
||||
}
|
||||
}
|
||||
|
||||
// We are checking 'woocommerce' to maintain classic templates which are saved to the DB,
|
||||
// prior to updating to use the correct slug.
|
||||
// More information found here: https://github.com/woocommerce/woocommerce-gutenberg-products-block/issues/5423.
|
||||
if ( self::PLUGIN_SLUG === $theme || self::DEPRECATED_PLUGIN_SLUG === strtolower( $theme ) ) {
|
||||
$template->origin = 'plugin';
|
||||
}
|
||||
|
||||
return $template;
|
||||
}
|
||||
|
||||
/**
|
||||
* Build a unified template object based on a theme file.
|
||||
* Important: This method is an almost identical duplicate from wp-includes/block-template-utils.php as it was not intended for public use. It has been modified to build templates from plugins rather than themes.
|
||||
*
|
||||
* @param array|object $template_file Theme file.
|
||||
* @param string $template_type wp_template or wp_template_part.
|
||||
*
|
||||
* @return \WP_Block_Template Template.
|
||||
*/
|
||||
public static function build_template_result_from_file( $template_file, $template_type ) {
|
||||
$template_file = (object) $template_file;
|
||||
|
||||
// If the theme has an archive-products.html template but does not have product taxonomy templates
|
||||
// then we will load in the archive-product.html template from the theme to use for product taxonomies on the frontend.
|
||||
$template_is_from_theme = 'theme' === $template_file->source;
|
||||
$theme_name = wp_get_theme()->get( 'TextDomain' );
|
||||
|
||||
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
|
||||
$template_content = file_get_contents( $template_file->path );
|
||||
$template = new \WP_Block_Template();
|
||||
$template->id = $template_is_from_theme ? $theme_name . '//' . $template_file->slug : self::PLUGIN_SLUG . '//' . $template_file->slug;
|
||||
$template->theme = $template_is_from_theme ? $theme_name : self::PLUGIN_SLUG;
|
||||
$template->content = self::inject_theme_attribute_in_content( $template_content );
|
||||
// Remove the term description block from the archive-product template
|
||||
// as the Product Catalog/Shop page doesn't have a description.
|
||||
if ( 'archive-product' === $template_file->slug ) {
|
||||
$template->content = str_replace( '<!-- wp:term-description {"align":"wide"} /-->', '', $template->content );
|
||||
}
|
||||
// Plugin was agreed as a valid source value despite existing inline docs at the time of creating: https://github.com/WordPress/gutenberg/issues/36597#issuecomment-976232909.
|
||||
$template->source = $template_file->source ? $template_file->source : 'plugin';
|
||||
$template->slug = $template_file->slug;
|
||||
$template->type = $template_type;
|
||||
$template->title = ! empty( $template_file->title ) ? $template_file->title : self::get_block_template_title( $template_file->slug );
|
||||
$template->description = ! empty( $template_file->description ) ? $template_file->description : self::get_block_template_description( $template_file->slug );
|
||||
$template->status = 'publish';
|
||||
$template->has_theme_file = true;
|
||||
$template->origin = $template_file->source;
|
||||
$template->is_custom = false; // Templates loaded from the filesystem aren't custom, ones that have been edited and loaded from the DB are.
|
||||
$template->post_types = array(); // Don't appear in any Edit Post template selector dropdown.
|
||||
$template->area = 'uncategorized';
|
||||
return $template;
|
||||
}
|
||||
|
||||
/**
|
||||
* Build a new template object so that we can make Woo Blocks default templates available in the current theme should they not have any.
|
||||
*
|
||||
* @param string $template_file Block template file path.
|
||||
* @param string $template_type wp_template or wp_template_part.
|
||||
* @param string $template_slug Block template slug e.g. single-product.
|
||||
* @param bool $template_is_from_theme If the block template file is being loaded from the current theme instead of Woo Blocks.
|
||||
*
|
||||
* @return object Block template object.
|
||||
*/
|
||||
public static function create_new_block_template_object( $template_file, $template_type, $template_slug, $template_is_from_theme = false ) {
|
||||
$theme_name = wp_get_theme()->get( 'TextDomain' );
|
||||
|
||||
$new_template_item = array(
|
||||
'slug' => $template_slug,
|
||||
'id' => $template_is_from_theme ? $theme_name . '//' . $template_slug : self::PLUGIN_SLUG . '//' . $template_slug,
|
||||
'path' => $template_file,
|
||||
'type' => $template_type,
|
||||
'theme' => $template_is_from_theme ? $theme_name : self::PLUGIN_SLUG,
|
||||
// Plugin was agreed as a valid source value despite existing inline docs at the time of creating: https://github.com/WordPress/gutenberg/issues/36597#issuecomment-976232909.
|
||||
'source' => $template_is_from_theme ? 'theme' : 'plugin',
|
||||
'title' => self::get_block_template_title( $template_slug ),
|
||||
'description' => self::get_block_template_description( $template_slug ),
|
||||
'post_types' => array(), // Don't appear in any Edit Post template selector dropdown.
|
||||
);
|
||||
|
||||
return (object) $new_template_item;
|
||||
}
|
||||
|
||||
/**
|
||||
* Finds all nested template part file paths in a theme's directory.
|
||||
*
|
||||
* @param string $base_directory The theme's file path.
|
||||
* @return array $path_list A list of paths to all template part files.
|
||||
*/
|
||||
public static function get_template_paths( $base_directory ) {
|
||||
$path_list = array();
|
||||
if ( file_exists( $base_directory ) ) {
|
||||
$nested_files = new \RecursiveIteratorIterator( new \RecursiveDirectoryIterator( $base_directory ) );
|
||||
$nested_html_files = new \RegexIterator( $nested_files, '/^.+\.html$/i', \RecursiveRegexIterator::GET_MATCH );
|
||||
foreach ( $nested_html_files as $path => $file ) {
|
||||
$path_list[] = $path;
|
||||
}
|
||||
}
|
||||
return $path_list;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns template titles.
|
||||
*
|
||||
* @param string $template_slug The templates slug (e.g. single-product).
|
||||
* @return string Human friendly title.
|
||||
*/
|
||||
public static function get_block_template_title( $template_slug ) {
|
||||
$plugin_template_types = self::get_plugin_block_template_types();
|
||||
if ( isset( $plugin_template_types[ $template_slug ] ) ) {
|
||||
return $plugin_template_types[ $template_slug ]['title'];
|
||||
} else {
|
||||
// Human friendly title converted from the slug.
|
||||
return ucwords( preg_replace( '/[\-_]/', ' ', $template_slug ) );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns template descriptions.
|
||||
*
|
||||
* @param string $template_slug The templates slug (e.g. single-product).
|
||||
* @return string Template description.
|
||||
*/
|
||||
public static function get_block_template_description( $template_slug ) {
|
||||
$plugin_template_types = self::get_plugin_block_template_types();
|
||||
if ( isset( $plugin_template_types[ $template_slug ] ) ) {
|
||||
return $plugin_template_types[ $template_slug ]['description'];
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a filtered list of plugin template types, containing their
|
||||
* localized titles and descriptions.
|
||||
*
|
||||
* @return array The plugin template types.
|
||||
*/
|
||||
public static function get_plugin_block_template_types() {
|
||||
$plugin_template_types = array(
|
||||
'single-product' => array(
|
||||
'title' => _x( 'Single Product', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Displays a single product.', 'woocommerce' ),
|
||||
),
|
||||
'archive-product' => array(
|
||||
'title' => _x( 'Product Catalog', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Displays your products.', 'woocommerce' ),
|
||||
),
|
||||
'taxonomy-product_cat' => array(
|
||||
'title' => _x( 'Products by Category', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Displays products filtered by a category.', 'woocommerce' ),
|
||||
),
|
||||
'taxonomy-product_tag' => array(
|
||||
'title' => _x( 'Products by Tag', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Displays products filtered by a tag.', 'woocommerce' ),
|
||||
),
|
||||
ProductAttributeTemplate::SLUG => array(
|
||||
'title' => _x( 'Products by Attribute', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Displays products filtered by an attribute.', 'woocommerce' ),
|
||||
),
|
||||
ProductSearchResultsTemplate::SLUG => array(
|
||||
'title' => _x( 'Product Search Results', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Displays search results for your store.', 'woocommerce' ),
|
||||
),
|
||||
MiniCartTemplate::SLUG => array(
|
||||
'title' => _x( 'Mini Cart', 'Template name', 'woocommerce' ),
|
||||
'description' => __( 'Template used to display the Mini Cart drawer.', 'woocommerce' ),
|
||||
),
|
||||
);
|
||||
|
||||
return $plugin_template_types;
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts template paths into a slug
|
||||
*
|
||||
* @param string $path The template's path.
|
||||
* @return string slug
|
||||
*/
|
||||
public static function generate_template_slug_from_path( $path ) {
|
||||
$template_extension = '.html';
|
||||
|
||||
return basename( $path, $template_extension );
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the first matching template part within themes directories
|
||||
*
|
||||
* Since [Gutenberg 12.1.0](https://github.com/WordPress/gutenberg/releases/tag/v12.1.0), the conventions for
|
||||
* block templates and parts directory has changed from `block-templates` and `block-templates-parts`
|
||||
* to `templates` and `parts` respectively.
|
||||
*
|
||||
* This function traverses all possible combinations of directory paths where a template or part
|
||||
* could be located and returns the first one which is readable, prioritizing the new convention
|
||||
* over the deprecated one, but maintaining that one for backwards compatibility.
|
||||
*
|
||||
* @param string $template_slug The slug of the template (i.e. without the file extension).
|
||||
* @param string $template_type Either `wp_template` or `wp_template_part`.
|
||||
*
|
||||
* @return string|null The matched path or `null` if no match was found.
|
||||
*/
|
||||
public static function get_theme_template_path( $template_slug, $template_type = 'wp_template' ) {
|
||||
$template_filename = $template_slug . '.html';
|
||||
$possible_templates_dir = 'wp_template' === $template_type ? array(
|
||||
self::DIRECTORY_NAMES['TEMPLATES'],
|
||||
self::DIRECTORY_NAMES['DEPRECATED_TEMPLATES'],
|
||||
) : array(
|
||||
self::DIRECTORY_NAMES['TEMPLATE_PARTS'],
|
||||
self::DIRECTORY_NAMES['DEPRECATED_TEMPLATE_PARTS'],
|
||||
);
|
||||
|
||||
// Combine the possible root directory names with either the template directory
|
||||
// or the stylesheet directory for child themes.
|
||||
$possible_paths = array_reduce(
|
||||
$possible_templates_dir,
|
||||
function( $carry, $item ) use ( $template_filename ) {
|
||||
$filepath = DIRECTORY_SEPARATOR . $item . DIRECTORY_SEPARATOR . $template_filename;
|
||||
|
||||
$carry[] = get_stylesheet_directory() . $filepath;
|
||||
$carry[] = get_template_directory() . $filepath;
|
||||
|
||||
return $carry;
|
||||
},
|
||||
array()
|
||||
);
|
||||
|
||||
// Return the first matching.
|
||||
foreach ( $possible_paths as $path ) {
|
||||
if ( is_readable( $path ) ) {
|
||||
return $path;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the theme has a template. So we know if to load our own in or not.
|
||||
*
|
||||
* @param string $template_name name of the template file without .html extension e.g. 'single-product'.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function theme_has_template( $template_name ) {
|
||||
return ! ! self::get_theme_template_path( $template_name, 'wp_template' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the theme has a template. So we know if to load our own in or not.
|
||||
*
|
||||
* @param string $template_name name of the template file without .html extension e.g. 'single-product'.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function theme_has_template_part( $template_name ) {
|
||||
return ! ! self::get_theme_template_path( $template_name, 'wp_template_part' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks to see if they are using a compatible version of WP, or if not they have a compatible version of the Gutenberg plugin installed.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function supports_block_templates() {
|
||||
if (
|
||||
! wc_current_theme_is_fse_theme() &&
|
||||
( ! function_exists( 'gutenberg_supports_block_templates' ) || ! gutenberg_supports_block_templates() )
|
||||
) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieves a single unified template object using its id.
|
||||
*
|
||||
* @param string $id Template unique identifier (example: theme_slug//template_slug).
|
||||
* @param string $template_type Optional. Template type: `'wp_template'` or '`wp_template_part'`.
|
||||
* Default `'wp_template'`.
|
||||
*
|
||||
* @return WP_Block_Template|null Template.
|
||||
*/
|
||||
public static function get_block_template( $id, $template_type ) {
|
||||
if ( function_exists( 'get_block_template' ) ) {
|
||||
return get_block_template( $id, $template_type );
|
||||
}
|
||||
|
||||
if ( function_exists( 'gutenberg_get_block_template' ) ) {
|
||||
return gutenberg_get_block_template( $id, $template_type );
|
||||
}
|
||||
|
||||
return null;
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if we can fall back to the `archive-product` template for a given slug.
|
||||
*
|
||||
* `taxonomy-product_cat`, `taxonomy-product_tag`, `taxonomy-product_attribute` templates can
|
||||
* generally use the `archive-product` as a fallback if there are no specific overrides.
|
||||
*
|
||||
* @param string $template_slug Slug to check for fallbacks.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function template_is_eligible_for_product_archive_fallback( $template_slug ) {
|
||||
return in_array( $template_slug, self::ELIGIBLE_FOR_ARCHIVE_PRODUCT_FALLBACK, true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if we can fall back to an `archive-product` template stored on the db for a given slug.
|
||||
*
|
||||
* @param string $template_slug Slug to check for fallbacks.
|
||||
* @param array $db_templates Templates that have already been found on the db.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function template_is_eligible_for_product_archive_fallback_from_db( $template_slug, $db_templates ) {
|
||||
$eligible_for_fallback = self::template_is_eligible_for_product_archive_fallback( $template_slug );
|
||||
if ( ! $eligible_for_fallback ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$array_filter = array_filter(
|
||||
$db_templates,
|
||||
function ( $template ) use ( $template_slug ) {
|
||||
return 'archive-product' === $template->slug;
|
||||
}
|
||||
);
|
||||
|
||||
return count( $array_filter ) > 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the `archive-product` fallback template stored on the db for a given slug.
|
||||
*
|
||||
* @param string $template_slug Slug to check for fallbacks.
|
||||
* @param array $db_templates Templates that have already been found on the db.
|
||||
* @return boolean|object
|
||||
*/
|
||||
public static function get_fallback_template_from_db( $template_slug, $db_templates ) {
|
||||
$eligible_for_fallback = self::template_is_eligible_for_product_archive_fallback( $template_slug );
|
||||
if ( ! $eligible_for_fallback ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
foreach ( $db_templates as $template ) {
|
||||
if ( 'archive-product' === $template->slug ) {
|
||||
return $template;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if we can fall back to the `archive-product` file template for a given slug in the current theme.
|
||||
*
|
||||
* `taxonomy-product_cat`, `taxonomy-product_tag`, `taxonomy-attribute` templates can
|
||||
* generally use the `archive-product` as a fallback if there are no specific overrides.
|
||||
*
|
||||
* @param string $template_slug Slug to check for fallbacks.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function template_is_eligible_for_product_archive_fallback_from_theme( $template_slug ) {
|
||||
return self::template_is_eligible_for_product_archive_fallback( $template_slug )
|
||||
&& ! self::theme_has_template( $template_slug )
|
||||
&& self::theme_has_template( 'archive-product' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the `has_theme_file` to `true` for templates with fallbacks
|
||||
*
|
||||
* There are cases (such as tags, categories and attributes) in which fallback templates
|
||||
* can be used; so, while *technically* the theme doesn't have a specific file
|
||||
* for them, it is important that we tell Gutenberg that we do, in fact,
|
||||
* have a theme file (i.e. the fallback one).
|
||||
*
|
||||
* **Note:** this function changes the array that has been passed.
|
||||
*
|
||||
* It returns `true` if anything was changed, `false` otherwise.
|
||||
*
|
||||
* @param array $query_result Array of template objects.
|
||||
* @param object $template A specific template object which could have a fallback.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function set_has_theme_file_if_fallback_is_available( $query_result, $template ) {
|
||||
foreach ( $query_result as &$query_result_template ) {
|
||||
if (
|
||||
$query_result_template->slug === $template->slug
|
||||
&& $query_result_template->theme === $template->theme
|
||||
) {
|
||||
if ( self::template_is_eligible_for_product_archive_fallback_from_theme( $template->slug ) ) {
|
||||
$query_result_template->has_theme_file = true;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filter block templates by feature flag.
|
||||
*
|
||||
* @param WP_Block_Template[] $block_templates An array of block template objects.
|
||||
*
|
||||
* @return WP_Block_Template[] An array of block template objects.
|
||||
*/
|
||||
public static function filter_block_templates_by_feature_flag( $block_templates ) {
|
||||
$feature_gating = new FeatureGating();
|
||||
$flag = $feature_gating->get_flag();
|
||||
|
||||
/**
|
||||
* An array of block templates with slug as key and flag as value.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
$block_templates_with_feature_gate = array();
|
||||
|
||||
return array_filter(
|
||||
$block_templates,
|
||||
function( $block_template ) use ( $flag, $block_templates_with_feature_gate ) {
|
||||
if ( isset( $block_templates_with_feature_gate[ $block_template->slug ] ) ) {
|
||||
return $block_templates_with_feature_gate[ $block_template->slug ] <= $flag;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Removes templates that were added to a theme's block-templates directory, but already had a customised version saved in the database.
|
||||
*
|
||||
* @param \WP_Block_Template[]|\stdClass[] $templates List of templates to run the filter on.
|
||||
*
|
||||
* @return array List of templates with duplicates removed. The customised alternative is preferred over the theme default.
|
||||
*/
|
||||
public static function remove_theme_templates_with_custom_alternative( $templates ) {
|
||||
|
||||
// Get the slugs of all templates that have been customised and saved in the database.
|
||||
$customised_template_slugs = array_map(
|
||||
function( $template ) {
|
||||
return $template->slug;
|
||||
},
|
||||
array_values(
|
||||
array_filter(
|
||||
$templates,
|
||||
function( $template ) {
|
||||
// This template has been customised and saved as a post.
|
||||
return 'custom' === $template->source;
|
||||
}
|
||||
)
|
||||
)
|
||||
);
|
||||
|
||||
// Remove theme (i.e. filesystem) templates that have the same slug as a customised one. We don't need to check
|
||||
// for `woocommerce` in $template->source here because woocommerce templates won't have been added to $templates
|
||||
// if a saved version was found in the db. This only affects saved templates that were saved BEFORE a theme
|
||||
// template with the same slug was added.
|
||||
return array_values(
|
||||
array_filter(
|
||||
$templates,
|
||||
function( $template ) use ( $customised_template_slugs ) {
|
||||
// This template has been customised and saved as a post, so return it.
|
||||
return ! ( 'theme' === $template->source && in_array( $template->slug, $customised_template_slugs, true ) );
|
||||
}
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns whether the blockified templates should be used or not.
|
||||
* First, we need to make sure WordPress version is higher than 6.1 (lowest that supports Products block).
|
||||
* Then, if the option is not stored on the db, we need to check if the current theme is a block one or not.
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public static function should_use_blockified_product_grid_templates() {
|
||||
$minimum_wp_version = '6.1';
|
||||
|
||||
if ( version_compare( $GLOBALS['wp_version'], $minimum_wp_version, '<' ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$use_blockified_templates = get_option( Options::WC_BLOCK_USE_BLOCKIFIED_PRODUCT_GRID_BLOCK_AS_TEMPLATE );
|
||||
|
||||
if ( false === $use_blockified_templates ) {
|
||||
return wc_current_theme_is_fse_theme();
|
||||
}
|
||||
|
||||
return wc_string_to_bool( $use_blockified_templates );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns whether the passed `$template` has a title, and it's different from the slug.
|
||||
*
|
||||
* @param object $template The template object.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function template_has_title( $template ) {
|
||||
return ! empty( $template->title ) && $template->title !== $template->slug;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns whether the passed `$template` has the legacy template block.
|
||||
*
|
||||
* @param object $template The template object.
|
||||
* @return boolean
|
||||
*/
|
||||
public static function template_has_legacy_template_block( $template ) {
|
||||
return has_block( 'woocommerce/legacy-template', $template->content );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Blocks\Utils;
|
||||
|
||||
use WP_Query;
|
||||
|
||||
/**
|
||||
* BlocksWpQuery query.
|
||||
*
|
||||
* Wrapper for WP Query with additional helper methods.
|
||||
* Allows query args to be set and parsed without doing running it, so that a cache can be used.
|
||||
*
|
||||
* @deprecated 2.5.0
|
||||
*/
|
||||
class BlocksWpQuery extends WP_Query {
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* Sets up the WordPress query, if parameter is not empty.
|
||||
*
|
||||
* Unlike the constructor in WP_Query, this does not RUN the query.
|
||||
*
|
||||
* @param string|array $query URL query string or array of vars.
|
||||
*/
|
||||
public function __construct( $query = '' ) {
|
||||
if ( ! empty( $query ) ) {
|
||||
$this->init();
|
||||
$this->query = wp_parse_args( $query );
|
||||
$this->query_vars = $this->query;
|
||||
$this->parse_query_vars();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get cached posts, if a cache exists.
|
||||
*
|
||||
* A hash is generated using the array of query_vars. If doing custom queries via filters such as posts_where
|
||||
* (where the SQL query is manipulated directly) you can still ensure there is a unique hash by injecting custom
|
||||
* query vars via the parse_query filter. For example:
|
||||
*
|
||||
* add_filter( 'parse_query', function( $wp_query ) {
|
||||
* $wp_query->query_vars['my_custom_query_var'] = true;
|
||||
* } );
|
||||
*
|
||||
* Doing so won't have any negative effect on the query itself, and it will cause the hash to change.
|
||||
*
|
||||
* @param string $transient_version Transient version to allow for invalidation.
|
||||
* @return WP_Post[]|int[] Array of post objects or post IDs.
|
||||
*/
|
||||
public function get_cached_posts( $transient_version = '' ) {
|
||||
$hash = md5( wp_json_encode( $this->query_vars ) );
|
||||
$transient_name = 'wc_blocks_query_' . $hash;
|
||||
$transient_value = get_transient( $transient_name );
|
||||
|
||||
if ( isset( $transient_value, $transient_value['version'], $transient_value['value'] ) && $transient_value['version'] === $transient_version ) {
|
||||
return $transient_value['value'];
|
||||
}
|
||||
|
||||
$results = $this->get_posts();
|
||||
|
||||
set_transient(
|
||||
$transient_name,
|
||||
array(
|
||||
'version' => $transient_version,
|
||||
'value' => $results,
|
||||
),
|
||||
DAY_IN_SECONDS * 30
|
||||
);
|
||||
|
||||
return $results;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Blocks\Utils;
|
||||
|
||||
/**
|
||||
* Class containing utility methods for dealing with the Cart and Checkout blocks.
|
||||
*/
|
||||
class CartCheckoutUtils {
|
||||
|
||||
/**
|
||||
* Checks if the default cart page is using the Cart block.
|
||||
*
|
||||
* @return bool true if the WC cart page is using the Cart block.
|
||||
*/
|
||||
public static function is_cart_block_default() {
|
||||
$cart_page_id = wc_get_page_id( 'cart' );
|
||||
return $cart_page_id && has_block( 'woocommerce/cart', $cart_page_id );
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the default checkout page is using the Checkout block.
|
||||
*
|
||||
* @return bool true if the WC checkout page is using the Checkout block.
|
||||
*/
|
||||
public static function is_checkout_block_default() {
|
||||
$checkout_page_id = wc_get_page_id( 'checkout' );
|
||||
return $checkout_page_id && has_block( 'woocommerce/checkout', $checkout_page_id );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,673 @@
|
||||
<?php
|
||||
namespace Automattic\WooCommerce\Blocks\Utils;
|
||||
|
||||
/**
|
||||
* StyleAttributesUtils class used for getting class and style from attributes.
|
||||
*/
|
||||
class StyleAttributesUtils {
|
||||
|
||||
/**
|
||||
* If color value is in preset format, convert it to a CSS var. Else return same value
|
||||
* For example:
|
||||
* "var:preset|color|pale-pink" -> "var(--wp--preset--color--pale-pink)"
|
||||
* "#98b66e" -> "#98b66e"
|
||||
*
|
||||
* @param string $color_value value to be processed.
|
||||
*
|
||||
* @return (string)
|
||||
*/
|
||||
public static function get_color_value( $color_value ) {
|
||||
if ( is_string( $color_value ) && str_contains( $color_value, 'var:preset|color|' ) ) {
|
||||
$color_value = str_replace( 'var:preset|color|', '', $color_value );
|
||||
return sprintf( 'var(--wp--preset--color--%s)', $color_value );
|
||||
}
|
||||
|
||||
return $color_value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get CSS value for color preset.
|
||||
*
|
||||
* @param string $preset_name Preset name.
|
||||
*
|
||||
* @return string CSS value for color preset.
|
||||
*/
|
||||
public static function get_preset_value( $preset_name ) {
|
||||
return "var(--wp--preset--color--$preset_name)";
|
||||
}
|
||||
|
||||
/**
|
||||
* If spacing value is in preset format, convert it to a CSS var. Else return same value
|
||||
* For example:
|
||||
* "var:preset|spacing|50" -> "var(--wp--preset--spacing--50)"
|
||||
* "50px" -> "50px"
|
||||
*
|
||||
* @param string $spacing_value value to be processed.
|
||||
*
|
||||
* @return (string)
|
||||
*/
|
||||
public static function get_spacing_value( $spacing_value ) {
|
||||
// Used following code as reference: https://github.com/WordPress/gutenberg/blob/cff6d70d6ff5a26e212958623dc3130569f95685/lib/block-supports/layout.php/#L219-L225.
|
||||
if ( is_string( $spacing_value ) && str_contains( $spacing_value, 'var:preset|spacing|' ) ) {
|
||||
$spacing_value = str_replace( 'var:preset|spacing|', '', $spacing_value );
|
||||
return sprintf( 'var(--wp--preset--spacing--%s)', $spacing_value );
|
||||
}
|
||||
|
||||
return $spacing_value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for align from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_align_class_and_style( $attributes ) {
|
||||
|
||||
$align_attribute = $attributes['align'] ?? null;
|
||||
|
||||
if ( ! $align_attribute ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
if ( 'wide' === $align_attribute ) {
|
||||
return array(
|
||||
'class' => 'alignwide',
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
|
||||
if ( 'full' === $align_attribute ) {
|
||||
return array(
|
||||
'class' => 'alignfull',
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
|
||||
if ( 'left' === $align_attribute ) {
|
||||
return array(
|
||||
'class' => 'alignleft',
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
|
||||
if ( 'right' === $align_attribute ) {
|
||||
return array(
|
||||
'class' => 'alignright',
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
|
||||
if ( 'center' === $align_attribute ) {
|
||||
return array(
|
||||
'class' => 'aligncenter',
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for background-color from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_background_color_class_and_style( $attributes ) {
|
||||
|
||||
$background_color = $attributes['backgroundColor'] ?? '';
|
||||
|
||||
$custom_background_color = $attributes['style']['color']['background'] ?? '';
|
||||
|
||||
if ( ! $background_color && '' === $custom_background_color ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
if ( $background_color ) {
|
||||
return array(
|
||||
'class' => sprintf( 'has-background has-%s-background-color', $background_color ),
|
||||
'style' => null,
|
||||
'value' => self::get_preset_value( $background_color ),
|
||||
);
|
||||
} elseif ( '' !== $custom_background_color ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'background-color: %s;', $custom_background_color ),
|
||||
'value' => $custom_background_color,
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for border-color from attributes.
|
||||
*
|
||||
* Data passed to this function is not always consistent. It can be:
|
||||
* Linked - preset color: $attributes['borderColor'] => 'luminous-vivid-orange'.
|
||||
* Linked - custom color: $attributes['style']['border']['color'] => '#681228'.
|
||||
* Unlinked - preset color: $attributes['style']['border']['top']['color'] => 'var:preset|color|luminous-vivid-orange'
|
||||
* Unlinked - custom color: $attributes['style']['border']['top']['color'] => '#681228'.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_border_color_class_and_style( $attributes ) {
|
||||
|
||||
$border_color_linked_preset = $attributes['borderColor'] ?? '';
|
||||
$border_color_linked_custom = $attributes['style']['border']['color'] ?? '';
|
||||
$custom_border = $attributes['style']['border'] ?? '';
|
||||
|
||||
$border_color_class = '';
|
||||
$border_color_css = '';
|
||||
|
||||
if ( $border_color_linked_preset ) {
|
||||
// Linked preset color.
|
||||
$border_color_class = sprintf( 'has-border-color has-%s-border-color', $border_color_linked_preset );
|
||||
} elseif ( $border_color_linked_custom ) {
|
||||
// Linked custom color.
|
||||
$border_color_css .= 'border-color:' . $border_color_linked_custom . ';';
|
||||
} else {
|
||||
// Unlinked.
|
||||
if ( is_array( $custom_border ) ) {
|
||||
foreach ( $custom_border as $border_color_key => $border_color_value ) {
|
||||
if ( is_array( $border_color_value ) && array_key_exists( 'color', ( $border_color_value ) ) ) {
|
||||
$border_color_css .= 'border-' . $border_color_key . '-color:' . self::get_color_value( $border_color_value['color'] ) . ';';
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! $border_color_class && ! $border_color_css ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return array(
|
||||
'class' => $border_color_class,
|
||||
'style' => $border_color_css,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for border-radius from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_border_radius_class_and_style( $attributes ) {
|
||||
|
||||
$custom_border_radius = $attributes['style']['border']['radius'] ?? '';
|
||||
|
||||
if ( '' === $custom_border_radius ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$border_radius_css = '';
|
||||
|
||||
if ( is_string( $custom_border_radius ) ) {
|
||||
// Linked sides.
|
||||
$border_radius_css = 'border-radius:' . $custom_border_radius . ';';
|
||||
} else {
|
||||
// Unlinked sides.
|
||||
$border_radius = array();
|
||||
|
||||
$border_radius['border-top-left-radius'] = $custom_border_radius['topLeft'] ?? '';
|
||||
$border_radius['border-top-right-radius'] = $custom_border_radius['topRight'] ?? '';
|
||||
$border_radius['border-bottom-right-radius'] = $custom_border_radius['bottomRight'] ?? '';
|
||||
$border_radius['border-bottom-left-radius'] = $custom_border_radius['bottomLeft'] ?? '';
|
||||
|
||||
foreach ( $border_radius as $border_radius_side => $border_radius_value ) {
|
||||
if ( '' !== $border_radius_value ) {
|
||||
$border_radius_css .= $border_radius_side . ':' . $border_radius_value . ';';
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => $border_radius_css,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for border width from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_border_width_class_and_style( $attributes ) {
|
||||
|
||||
$custom_border = $attributes['style']['border'] ?? '';
|
||||
|
||||
if ( '' === $custom_border ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$border_width_css = '';
|
||||
|
||||
if ( array_key_exists( 'width', ( $custom_border ) ) && ! empty( $custom_border['width'] ) ) {
|
||||
// Linked sides.
|
||||
$border_width_css = 'border-width:' . $custom_border['width'] . ';';
|
||||
} else {
|
||||
// Unlinked sides.
|
||||
foreach ( $custom_border as $border_width_side => $border_width_value ) {
|
||||
if ( isset( $border_width_value['width'] ) ) {
|
||||
$border_width_css .= 'border-' . $border_width_side . '-width:' . $border_width_value['width'] . ';';
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => $border_width_css,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get space-separated classes from block attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
* @param array $properties Properties to get classes from.
|
||||
*
|
||||
* @return string Space-separated classes.
|
||||
*/
|
||||
public static function get_classes_by_attributes( $attributes, $properties = array() ) {
|
||||
$classes_and_styles = self::get_classes_and_styles_by_attributes( $attributes, $properties );
|
||||
|
||||
return $classes_and_styles['classes'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for font-family from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_font_family_class_and_style( $attributes ) {
|
||||
|
||||
$font_family = $attributes['fontFamily'] ?? '';
|
||||
|
||||
if ( $font_family ) {
|
||||
return array(
|
||||
'class' => sprintf( 'has-%s-font-family', $font_family ),
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for font-size from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_font_size_class_and_style( $attributes ) {
|
||||
|
||||
$font_size = $attributes['fontSize'] ?? '';
|
||||
|
||||
$custom_font_size = $attributes['style']['typography']['fontSize'] ?? '';
|
||||
|
||||
if ( ! $font_size && '' === $custom_font_size ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
if ( $font_size ) {
|
||||
return array(
|
||||
'class' => sprintf( 'has-font-size has-%s-font-size', $font_size ),
|
||||
'style' => null,
|
||||
);
|
||||
} elseif ( '' !== $custom_font_size ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'font-size: %s;', $custom_font_size ),
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for font-style from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_font_style_class_and_style( $attributes ) {
|
||||
|
||||
$custom_font_style = $attributes['style']['typography']['fontStyle'] ?? '';
|
||||
|
||||
if ( '' !== $custom_font_style ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'font-style: %s;', $custom_font_style ),
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for font-weight from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_font_weight_class_and_style( $attributes ) {
|
||||
|
||||
$custom_font_weight = $attributes['style']['typography']['fontWeight'] ?? '';
|
||||
|
||||
if ( '' !== $custom_font_weight ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'font-weight: %s;', $custom_font_weight ),
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for letter-spacing from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_letter_spacing_class_and_style( $attributes ) {
|
||||
|
||||
$custom_letter_spacing = $attributes['style']['typography']['letterSpacing'] ?? '';
|
||||
|
||||
if ( '' !== $custom_letter_spacing ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'letter-spacing: %s;', $custom_letter_spacing ),
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for line height from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_line_height_class_and_style( $attributes ) {
|
||||
|
||||
$line_height = $attributes['style']['typography']['lineHeight'] ?? '';
|
||||
|
||||
if ( ! $line_height ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'line-height: %s;', $line_height ),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for link-color from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_link_color_class_and_style( $attributes ) {
|
||||
|
||||
if ( ! isset( $attributes['style']['elements']['link']['color']['text'] ) ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$link_color = $attributes['style']['elements']['link']['color']['text'];
|
||||
|
||||
// If the link color is selected from the theme color picker, the value of $link_color is var:preset|color|slug.
|
||||
// If the link color is selected from the core color picker, the value of $link_color is an hex value.
|
||||
// When the link color is a string var:preset|color|slug we parsed it for get the slug, otherwise we use the hex value.
|
||||
$index_named_link_color = strrpos( $link_color, '|' );
|
||||
|
||||
if ( ! empty( $index_named_link_color ) ) {
|
||||
$parsed_named_link_color = substr( $link_color, $index_named_link_color + 1 );
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'color: %s;', self::get_preset_value( $parsed_named_link_color ) ),
|
||||
'value' => self::get_preset_value( $parsed_named_link_color ),
|
||||
);
|
||||
} else {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'color: %s;', $link_color ),
|
||||
'value' => $link_color,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for margin from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_margin_class_and_style( $attributes ) {
|
||||
$margin = $attributes['style']['spacing']['margin'] ?? null;
|
||||
|
||||
if ( ! $margin ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$spacing_values_css = '';
|
||||
|
||||
foreach ( $margin as $margin_side => $margin_value ) {
|
||||
$spacing_values_css .= 'margin-' . $margin_side . ':' . self::get_spacing_value( $margin_value ) . ';';
|
||||
}
|
||||
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => $spacing_values_css,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for padding from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_padding_class_and_style( $attributes ) {
|
||||
$padding = $attributes['style']['spacing']['padding'] ?? null;
|
||||
|
||||
if ( ! $padding ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$spacing_values_css = '';
|
||||
|
||||
foreach ( $padding as $padding_side => $padding_value ) {
|
||||
$spacing_values_css .= 'padding-' . $padding_side . ':' . self::get_spacing_value( $padding_value ) . ';';
|
||||
}
|
||||
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => $spacing_values_css,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get space-separated style rules from block attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
* @param array $properties Properties to get styles from.
|
||||
*
|
||||
* @return string Space-separated style rules.
|
||||
*/
|
||||
public static function get_styles_by_attributes( $attributes, $properties = array() ) {
|
||||
$classes_and_styles = self::get_classes_and_styles_by_attributes( $attributes, $properties );
|
||||
|
||||
return $classes_and_styles['styles'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for text align from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_text_align_class_and_style( $attributes ) {
|
||||
|
||||
if ( isset( $attributes['textAlign'] ) ) {
|
||||
return array(
|
||||
'class' => 'has-text-align-' . $attributes['textAlign'],
|
||||
'style' => null,
|
||||
);
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for text-color from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_text_color_class_and_style( $attributes ) {
|
||||
|
||||
$text_color = $attributes['textColor'] ?? '';
|
||||
|
||||
$custom_text_color = $attributes['style']['color']['text'] ?? '';
|
||||
|
||||
if ( ! $text_color && ! $custom_text_color ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
if ( $text_color ) {
|
||||
return array(
|
||||
'class' => sprintf( 'has-text-color has-%s-color', $text_color ),
|
||||
'style' => null,
|
||||
'value' => self::get_preset_value( $text_color ),
|
||||
);
|
||||
} elseif ( $custom_text_color ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'color: %s;', $custom_text_color ),
|
||||
'value' => $custom_text_color,
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for text-decoration from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_text_decoration_class_and_style( $attributes ) {
|
||||
|
||||
$custom_text_decoration = $attributes['style']['typography']['textDecoration'] ?? '';
|
||||
|
||||
if ( '' !== $custom_text_decoration ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'text-decoration: %s;', $custom_text_decoration ),
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get class and style for text-transform from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
*
|
||||
* @return (array | null)
|
||||
*/
|
||||
public static function get_text_transform_class_and_style( $attributes ) {
|
||||
|
||||
$custom_text_transform = $attributes['style']['typography']['textTransform'] ?? '';
|
||||
|
||||
if ( '' !== $custom_text_transform ) {
|
||||
return array(
|
||||
'class' => null,
|
||||
'style' => sprintf( 'text-transform: %s;', $custom_text_transform ),
|
||||
);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get classes and styles from attributes.
|
||||
*
|
||||
* @param array $attributes Block attributes.
|
||||
* @param array $properties Properties to get classes/styles from.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_classes_and_styles_by_attributes( $attributes, $properties = array() ) {
|
||||
$classes_and_styles = array(
|
||||
'align' => self::get_align_class_and_style( $attributes ),
|
||||
'background_color' => self::get_background_color_class_and_style( $attributes ),
|
||||
'border_color' => self::get_border_color_class_and_style( $attributes ),
|
||||
'border_radius' => self::get_border_radius_class_and_style( $attributes ),
|
||||
'border_width' => self::get_border_width_class_and_style( $attributes ),
|
||||
'font_family' => self::get_font_family_class_and_style( $attributes ),
|
||||
'font_size' => self::get_font_size_class_and_style( $attributes ),
|
||||
'font_style' => self::get_font_style_class_and_style( $attributes ),
|
||||
'font_weight' => self::get_font_weight_class_and_style( $attributes ),
|
||||
'letter_spacing' => self::get_letter_spacing_class_and_style( $attributes ),
|
||||
'line_height' => self::get_line_height_class_and_style( $attributes ),
|
||||
'link_color' => self::get_link_color_class_and_style( $attributes ),
|
||||
'margin' => self::get_margin_class_and_style( $attributes ),
|
||||
'padding' => self::get_padding_class_and_style( $attributes ),
|
||||
'text_align' => self::get_text_align_class_and_style( $attributes ),
|
||||
'text_color' => self::get_text_color_class_and_style( $attributes ),
|
||||
'text_decoration' => self::get_text_decoration_class_and_style( $attributes ),
|
||||
'text_transform' => self::get_text_transform_class_and_style( $attributes ),
|
||||
);
|
||||
|
||||
if ( ! empty( $properties ) ) {
|
||||
foreach ( $classes_and_styles as $key => $value ) {
|
||||
if ( ! in_array( $key, $properties, true ) ) {
|
||||
unset( $classes_and_styles[ $key ] );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$classes_and_styles = array_filter( $classes_and_styles );
|
||||
|
||||
$classes = array_map(
|
||||
function( $item ) {
|
||||
return $item['class'];
|
||||
},
|
||||
$classes_and_styles
|
||||
);
|
||||
|
||||
$styles = array_map(
|
||||
function( $item ) {
|
||||
return $item['style'];
|
||||
},
|
||||
$classes_and_styles
|
||||
);
|
||||
|
||||
$classes = array_filter( $classes );
|
||||
$styles = array_filter( $styles );
|
||||
|
||||
return array(
|
||||
'classes' => implode( ' ', $classes ),
|
||||
'styles' => implode( ' ', $styles ),
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user