[$term1, $term2], // List of WP_Term objects
* 'is_link' => true, // Whether to return links
* 'separator' => ' / ' // Separator to use between terms
* ];
* $terms_list = GetTermsListTrait::get_terms_list( $args );
* ```
*/
public static function get_terms_list( array $args ): string {
$terms = $args['terms'] ?? [];
$is_link = $args['is_link'] ?? true;
$separator = $args['separator'] ?? ' | ';
$output = [];
foreach ( $terms as $term ) {
if ( ! $term instanceof WP_Term ) {
continue;
}
$label = esc_html( $term->name );
if ( $is_link ) {
$label = sprintf(
'%2$s',
esc_url( get_term_link( $term ) ),
et_core_esc_previously( $label )
);
}
$output[] = $label;
}
return implode( esc_html( $separator ), $output );
}
/**
* Get the wrapper element that contains the option value based on the given arguments.
*
* @since ??
*
* @param array $args {
* An array of arguments.
*
* @type string $name Optional. The option name. Default empty string.
* @type int $post_id Optional. The ID of the post. Default `0`.
* @type string $value Optional. The option value. Default empty string.
* @type array $settings Optional. The option settings. Default `[]`.
* }
*
* @return string The wrapper element containing the option value.
*
* @example
* ```php
* $args = [
* 'name' => 'example_option',
* 'post_id' => 1,
* 'value' => 'Example Value',
* 'settings' => [
* 'before' => '',
* 'after' => '
',
* ],
* ];
* $result = GetWrapperElementTrait::get_wrapper_element( $args );
*
* echo $result;
* ```
* @output:
* ```html
* Example Value
* ```
*/
public static function get_wrapper_element( array $args ): string {
$name = $args['name'] ?? '';
$post_id = $args['post_id'] ?? 0;
$value = $args['value'] ?? '';
$settings = $args['settings'] ?? [];
// TODO feat(D5, Theme Builder): Replace it once the Theme Builder is implemented in D5 [https://github.com/elegantthemes/Divi/issues/25149].
$tb_post_id = \ET_Theme_Builder_Layout::get_theme_builder_layout_id();
// Get default setting value based on current post ID, option name, and setting name.
$default_setting = function ( $setting ) use ( $post_id, $name ) {
return DynamicContentUtils::get_default_setting_value(
[
'post_id' => $post_id,
'name' => $name,
'setting' => $setting,
]
);
};
$before = $settings['before'] ?? $default_setting( 'before' );
$after = $settings['after'] ?? $default_setting( 'after' );
$cap_post_id = $tb_post_id ? $tb_post_id : $post_id;
$user_id = get_post_field( 'post_author', $cap_post_id );
if ( ! user_can( $user_id, 'unfiltered_html' ) ) {
$allowlist = array_merge(
wp_kses_allowed_html( '' ),
[
'h1' => [],
'h2' => [],
'h3' => [],
'h4' => [],
'h5' => [],
'h6' => [],
'ol' => [],
'ul' => [],
'li' => [],
'span' => [],
'p' => [],
]
);
$before = wp_kses( $before, $allowlist );
$after = wp_kses( $after, $allowlist );
}
return $before . $value . $after;
}
/**
* Get wrapper Woo Module element that contains non plain text Woo Module element data.
*
* This function wraps non plain text woo data in a custom selector for styling inheritance.
* It checks if the content has an HTML tag and adds the necessary wrapper element if it does.
*
* @since ??
*
* @param array $args {
* An array of arguments.
*
* @type string $name The option name.
* @type string $value The option value.
* }
*
* @return string The wrapper element that contains the option value.
*
* @example:
* ```php
* $value = get_wrapper_woo_module_element( [
* 'name' => 'example_name',
* 'value' => 'This is a paragraph
'
* ] );
* ```
* @output:
* ```html
*
* ```
*/
public static function get_wrapper_woo_module_element( array $args ): string {
$name = $args['name'] ?? '';
$value = $args['value'] ?? '';
if ( $value && preg_match( '/<\s?[^\>]*\/?\s?>/i', $value ) ) {
$value = sprintf( '%1$s
', $value, $name );
}
return $value;
}
}