';
// Modal title
if ( $title = $this->get_modal_title() ) {
$output .= '
';
$output .= '
' . esc_html( $title ) . '
';
} else {
$output .= '';
// Modal content
if ( $content = $this->get_modal_content() ) {
$output .= $this->get_modal_content_css();
$output .= '
';
$output .= $content; // already parsed for display
$output .= '
';
}
$output .= '
';
return $output;
}
/**
* Return modal border radius class.
*/
private function get_modal_border_radius_class( string $default ): string {
$border_radius = $this->args['modal_border_radius'] ?? '';
if ( $border_radius && in_array( $border_radius, [ 'none', 'md', 'lg', 'xl' ], true ) ) {
if ( 'none' === $border_radius ) {
$border_radius = '0';
}
return "wpex-rounded-{$border_radius}";
} else {
return $default;
}
}
/**
* Return modal content css.
*/
private function get_modal_content_css(): string {
$css = '';
if ( WPEX_VC_ACTIVE ) {
$wpb_style = totaltheme_get_instance_of( 'Integration\WPBakery\Shortcode_Inline_Style' );
if ( $wpb_style ) {
if ( ! empty( $this->args['modal_template'] ) ) {
$css .= $wpb_style->get_css( $this->args['modal_template'], true );
}
/**
* This is added for extra precaution, but it can cause the same CSS to be added twice.
* Users shouldn't be using WPBakery on the post and also in the template,
* so it's a non-issue.
*/
if ( $this->post_id ) {
$css .= $wpb_style->get_css( $this->post_id );
}
}
}
if ( $css ) {
$css = '';
}
return $css;
}
/**
* Return card modal (lightbox) settings.
*/
public function get_modal_settings() {
$settings = [
'type' => 'inline',
// 'buttons' => 'false',
'small-btn' => 'true',
'auto-focus' => 'false',
'touch' => 'false',
];
/**
* Filters the card modal settings
*
* @param array $settings
* @param object $this Current WPEX_Card object.
*/
$this->modal_settings = (array) apply_filters( 'wpex_card_modal_settings', $settings, $this );
return $this->modal_settings;
}
/**
* Return card modal title.
*/
protected function get_modal_title() {
$title = '';
if ( ! empty( $this->args['modal_template'] ) ) {
if ( '1' === get_post_meta( $this->args['modal_template'], 'wpex_modal_hide_title', true ) ) {
$this->args['modal_title'] = false;
} else {
$custom_modal_title = get_post_meta( $this->args['modal_template'], 'wpex_modal_title', true );
if ( $custom_modal_title ) {
$this->args['modal_title'] = wp_strip_all_tags( do_shortcode( totaltheme_replace_vars( $custom_modal_title ) ) );
}
}
}
if ( array_key_exists( 'modal_title', $this->args )
&& ( false === $this->args['modal_title'] || 'false' === $this->args['modal_title'] )
) {
$title = '';
} elseif ( ! empty( $this->args['modal_title'] )
&& is_string( $this->args['modal_title'] )
&& 'true' !== $this->args['modal_title']
) {
$title = $this->args['modal_title'];
} elseif ( $this->post_id ) {
$post = get_post( $this->post_id );
if ( ! empty( $post ) && ! is_wp_error( $post ) ) {
$title = get_the_title( $this->post_id );
}
} elseif ( ! empty( $this->term->name ) ) {
$title = $this->term->name;
}
/**
* Filters the card modal title
*
* @param string $title
* @param object $this Current WPEX_Card object.
*/
$title = apply_filters( 'wpex_card_modal_title', $title, $this );
return $title;
}
/**
* Return card modal content.
*/
protected function get_modal_content() {
$content = '';
if ( ! empty( $this->args['modal_template'] ) && empty( $this->args['modal_content'] ) ) {
$temp_post = get_post( $this->args['modal_template'] );
if ( $temp_post ) {
$template_type = totaltheme_get_post_builder_type( $this->args['modal_template'] );
if ( 'elementor' === $template_type ) {
$this->args['modal_content'] = wpex_get_elementor_content_for_display( $this->args['modal_template'] );
} else {
$this->args['modal_content'] = $temp_post->post_content;
}
}
}
if ( ! empty( $this->args['modal_content'] ) ) {
$content = $this->args['modal_content'];
} elseif ( $this->post_id ) {
$post = get_post( $this->post_id );
if ( ! empty( $post ) && ! is_wp_error( $post ) ) {
if ( function_exists( 'wpex_get_current_post_id' ) ) {
$current_post = wpex_get_current_post_id();
} else {
$current_post = get_queried_object_id();
}
// !!! Important check to prevent infinite loops !!!!
if ( $current_post !== $this->post_id ) {
$content = $post->post_content;
}
}
} elseif ( ! empty( $this->term->description ) ) {
$content = $this->term->description;
}
/**
* Filters the card modal content.
*
* @param string $content
* @param object $this Current WPEX_Card object.
*/
$content = (string) apply_filters( 'wpex_card_modal_content', $content, $this );
// Parse content AFTER filters so that users can pass on content to the filter that contains shortcodes
if ( $content && ( empty( $template_type ) || 'elementor' !== $template_type ) ) {
if ( function_exists( 'totaltheme_render_content' ) ) {
$content = totaltheme_render_content( $content );
} else {
$content = do_shortcode( wp_kses_post( $content ) );
}
}
return $content;
}
/*-------------------------------------------------------------------------------*/
/* [ Links ]
/*-------------------------------------------------------------------------------*/
/**
* Check if a card has a link.
*/
public function has_link(): bool {
return (bool) $this->get_var( 'url' );
}
/**
* Get card url.
*/
public function get_url() {
$link = '';
$type = $this->get_var( 'link_type' );
if ( 'none' === $type ) {
return;
}
if ( ! empty( $this->args['url'] ) ) {
$url = $this->args['url'];
} elseif ( ! in_array( $type, [ 'dialog', 'modal', 'post', 'term' ] )
&& $this->is_template()
&& $custom_field = $this->get_template_meta( 'link_custom_field' )
) {
if ( $this->term ) {
$url = get_term_meta( $this->term->term_id, $custom_field, true );
} else {
$url = get_post_meta( $this->post_id, $custom_field, true );
}
if ( is_array( $url ) ) {
$url = $url['url'] ?? $url['href'] ?? $url[0];
}
} else {
$url = $this->get_card_meta( 'url' );
if ( empty( $url ) ) {
switch ( $type ) {
case 'dialog':
$url = '#';
break;
case 'modal':
$url = '#' . $this->get_modal_id();
break;
case 'lightbox':
$url = $this->get_var( 'lightbox_url' );
break;
case 'post': // legacy
case 'term': // legacy
default:
// @note we don't use is_post_publicly_viewable because we still want
// to link to posts that may be privatized.
if ( $this->post_id ) {
if ( is_post_type_viewable( $this->get_post_type() ) ) {
if ( function_exists( 'wpex_get_permalink' ) ) {
$url = wpex_get_permalink( $this->post_id );
} else {
$url = get_permalink( $this->post_id );
}
}
} elseif ( $this->term ) {
if ( is_term_publicly_viewable( $this->term ) ) {
$url = get_term_link( $this->term );
}
}
break;
}
}
}
/**
* Filters the card URL.
*
* @param string $url The URL.
* @param object $this Current WPEX_Card object.
*/
$url = (string) apply_filters( 'wpex_card_url', $url, $this );
if ( $url ) {
$url = esc_url( $url );
}
$this->url = $url;
return $this->url;
}
/**
* Get card link type.
*/
public function get_link_type() {
$type = '';
// Check custom template first as this is the "default" value
if ( $this->is_template() ) {
$meta_type = $this->get_template_meta( 'link_type' );
if ( $meta_type ) {
$type = $meta_type;
}
}
// Card specific link type should override the default
if ( ! empty( $this->args['link_type'] ) ) {
$type = $this->args['link_type'];
}
// Last we check the post meta which should override the template and card args
if ( $this->post_id ) {
$meta_type = get_post_meta( $this->post_id, 'wpex_card_link_type', true );
if ( $meta_type ) {
$type = $meta_type;
}
}
/**
* Filters the card link type.
*
* @param string $type Link type.
* @param object $this Current WPEX_Card object.
*/
$this->link_type = (string) apply_filters( 'wpex_card_link_type', $type, $this );
if ( 'lightbox_group' === $this->link_type ) {
$this->link_type = 'lightbox';
$this->has_lightbox_group = true;
}
return $this->link_type;
}
/**
* Get card link target.
*/
public function get_link_target() {
$target = '_self';
if ( ! empty( $this->args['link_target'] ) ) {
$target = $this->args['link_target'];
} elseif ( $this->post_id ) {
$target = get_post_meta( $this->post_id, 'wpex_card_link_target', true ) ?: $target;
}
/**
* Filters the card link target.
*
* @param string $target The link target.
* @param object $this Current WPEX_Card object.
*/
$this->link_target = (string) apply_filters( 'wpex_card_link_target', $target, $this );
return $this->link_target;
}
/**
* Get card link title.
*/
public function get_link_title() {
$link_title = '';
if ( ! empty( $this->args['link_title'] ) ) {
$link_title = $this->args['link_title'];
}
/**
* Filters the card link title.
*
* @param string $title The link title.
* @param object $this Current WPEX_Card object.
*/
$this->link_title = (string) apply_filters( 'wpex_card_link_title', $link_title, $this );
return $this->link_title;
}
/**
* Get card link rel attribute.
*/
public function get_link_rel() {
$rel = '';
if ( ! empty( $this->args['link_rel'] ) ) {
$rel = $this->args['link_rel'];
} elseif( $this->post_id ) {
$rel = get_post_meta( $this->post_id, 'wpex_card_link_rel', true );
}
/**
* Filters the card link rel.
*
* @param string $rel The link rel.
* @param object $this Current WPEX_Card object.
*/
$this->link_rel = (string) apply_filters( 'wpex_card_link_rel', $rel, $this );
return $this->link_rel;
}
/**
* Get custom card link data attributes.
*/
public function get_link_data() {
$data = [];
if ( ! empty( $this->args['link_data'] ) ) {
$data = $this->args['link_data'];
if ( function_exists( 'wp_parse_list' ) ) {
$data = wp_parse_list( $data );
}
}
/**
* Filters the card link data.
*
* @param array $data The link data.
* @param object $this Current WPEX_Card object.
*/
$this->link_data = (array) apply_filters( 'wpex_card_link_data', $data, $this );
return $this->link_data;
}
/**
* Get link attributes.
*/
public function get_link_attributes( $attributes = [] ) {
$defaults_attributes = [
'href' => $this->get_var( 'url' ),
];
$attrs = wp_parse_args( $attributes, $defaults_attributes );
$type = $this->get_var( 'link_type' );
$target = $this->get_var( 'link_target' );
$title = $this->get_var( 'link_title' );
$rel = $this->get_var( 'link_rel' );
$data = $this->get_var( 'link_data' );
$class = [];
switch ( $type ) {
case 'local':
$class[] = 'local-scroll-link';
break;
case 'dialog':
$attrs['role'] = 'button';
$attrs['aria-controls'] = $this->get_modal_id();
$attrs['aria-expanded'] = 'false';
$class[] = 'wpex-open-modal';
break;
case 'modal':
case 'lightbox':
$lightbox_type = $this->get_var( 'lightbox_type' );
$class[] = $this->get_var( 'lightbox_class' );
$lightbox_data = $this->get_var( 'lightbox_data' );
if ( ! empty( $lightbox_data ) && is_array( $lightbox_data ) ) {
foreach ( $lightbox_data as $data_key => $data_val ) {
$data[ $data_key ] = $data_val;
}
}
$attrs['role'] = 'button';
$this->enqueue_lightbox();
break;
default:
break;
}
switch ( $target ) {
case 'blank':
case '_blank':
$attrs['target'] = '_blank';
$targeted_rel = apply_filters( 'wpex_targeted_link_rel', 'noopener noreferrer', $attrs['href'] );
if ( $rel ) {
$attrs['rel'] = $rel . ' ' . $targeted_rel;
} else {
$attrs['rel'] = $targeted_rel;
}
break;
default:
if ( $rel ) {
$attrs['rel'] = $rel;
}
break;
}
if ( $data && is_array( $data ) ) {
foreach ( $data as $datak => $datav ) {
$attrs['data-' . $datak] = $datav;
}
}
if ( $class ) {
$attrs['class'] = implode( ' ', $class );
}
if ( $title ) {
$attrs['title'] = esc_attr( $title );
}
/**
* Filters the card link attributes.
*
* @param array $attributes The link attributes.
* @param object $this Current WPEX_Card object.
*/
$this->link_attributes = (array) apply_filters( 'wpex_card_link_attributes', $attrs, $this );
return $this->link_attributes;
}
/**
* Get card link open tag.
*/
public function get_link_open( $args = [] ) {
if ( ! $this->has_link() ) {
return;
}
$default_args = [
'class' => '',
'attributes' => [],
];
$args = wp_parse_args( $args, $default_args );
if ( ! empty( $args['attributes'] ) ) {
$attrs = $this->get_link_attributes( $args['attributes'] );
} else {
$attrs = $this->get_var( 'link_attributes' );
}
if ( $args['class'] ) {
if ( empty( $attrs['class'] ) ) {
$attrs['class'] = $args['class'];
} else {
$attrs['class'] .= ' ' . trim( (string) $args['class'] );
}
}
$attrs = array_map( 'esc_attr', $attrs ); // escape attribute values.
$html = '
$value ) {
if ( ! empty( $value ) ) {
$html .= ' ' . $name . '="' . $value . '"'; // note $value already escaped
} elseif ( 'download' === $name ) {
$html .= ' ' . $name;
}
}
$html .= '>';
$this->link_open = $html;
return $this->link_open;
}
/**
* Get card link close tag.
*/
public function get_link_close() {
if ( $this->has_link() ) {
return '';
}
}
/**
* Check if it's possible to add a link around the whole card.
*/
public function has_link_wrap(): bool {
return ( $this->has_link() && ! $this->has_thumbnail_overlay() && 'video' !== $this->get_var( 'media_type' ) );
}
/*-------------------------------------------------------------------------------*/
/* [ Lightbox ]
/*-------------------------------------------------------------------------------*/
/**
* Get card lightbox url.
*/
public function get_lightbox_url() {
$lightbox_url = '';
if ( isset( $this->args['lightbox_url'] ) ) {
$lightbox_url = $this->args['lightbox_url'];
} elseif ( isset( $this->args['url'] ) ) {
$lightbox_url = $this->args['url'];
} else {
if ( $this->post_id || $this->term ) {
$lightbox_type = $this->get_var( 'lightbox_type' );
switch ( $lightbox_type ) {
case 'video':
$lightbox_url = $this->get_var( 'lightbox_video' );
break;
case 'gallery':
$lightbox_url = '#';
break;
case 'thumbnail':
default:
$thumbnail_id = $this->get_var( 'thumbnail_id' );
if ( $thumbnail_id ) {
$lightbox_url = wpex_get_lightbox_image( $thumbnail_id );
}
break;
}
} else {
$lightbox_url = $this->get_var( 'thumbnail_url' );
}
}
/**
* Filters the card lightbox url.
*
* @param string $lightbox_url The lightbox url.
* @param object $this Current WPEX_Card object.
*/
$this->lightbox_url = (string) apply_filters( 'wpex_card_lightbox_url', $lightbox_url, $this );
return $this->lightbox_url;
}
/**
* Get card lightbox type.
*/
public function get_lightbox_type() {
$lightbox_type = 'thumbnail';
if ( isset( $this->args['lightbox_type'] ) ) {
$lightbox_type = $this->args['lightbox_type'];
} elseif ( $this->post_id ) {
$link_type = $this->get_var( 'link_type' );
switch ( $link_type ) {
case 'modal':
if ( $this->get_card_meta( 'url' ) ) {
$lightbox_type = 'iframe';
} else {
$lightbox_type = 'modal';
}
break;
default:
$video_check = true;
if ( 'post' === $this->get_post_type() && 'video' !== $this->get_post_format() ) {
$video_check = false;
}
if ( $video_check && $this->get_var( 'lightbox_video' ) ) {
$lightbox_type = 'video';
} elseif ( empty( $this->has_lightbox_group ) && wpex_has_post_gallery( $this->post_id ) ) {
$lightbox_type = 'gallery';
}
break;
}
}
/**
* Filters the card lightbox type.
*
* @param string $lightbox_type The lightbox type.
* @param object $this Current WPEX_Card object.
*/
$this->lightbox_type = (string) apply_filters( 'wpex_card_lightbox_type', $lightbox_type, $this );
return $this->lightbox_type;
}
/**
* Get lightbox video.
*/
public function get_lightbox_video() {
$video = wpex_get_post_video_oembed_url( $this->post_id );
if ( $video ) {
$video = wpex_get_video_embed_url( $video );
}
/**
* Filters the card lightbox video.
*
* @param string $video The lightbox video.
* @param object $this Current WPEX_Card object.
*/
$this->lightbox_video = (string) apply_filters( 'wpex_card_lightbox_video', $video, $this );
return $this->lightbox_video;
}
/**
* Get lightbox class.
*/
public function get_lightbox_class() {
$lightbox_class = '';
$lightbox_type = $this->get_var( 'lightbox_type' );
switch ( $lightbox_type ) {
case 'gallery':
$lightbox_class = 'wpex-lightbox-gallery';
$supports_group = false;
break;
case 'modal':
case 'iframe':
default:
if ( isset( $this->has_lightbox_group ) && true === $this->has_lightbox_group ) {
$lightbox_class = 'wpex-lightbox-group-item';
} else {
$lightbox_class = 'wpex-lightbox';
}
break;
}
/**
* Filters the card lightbox class.
*
* @param string $lightbox_class The lightbox class.
* @param object $this Current WPEX_Card object.
*/
$this->lightbox_class = (string) apply_filters( 'wpex_card_lightbox_class', $lightbox_class, $this );
return $this->lightbox_class;
}
/**
* Get lightbox data.
*/
public function get_lightbox_data() {
$lightbox_data = [];
$lightbox_type = $this->get_var( 'lightbox_type' );
switch ( $lightbox_type ) {
case 'modal':
$modal_settings = $this->get_var( 'modal_settings' );
foreach ( $modal_settings as $msk => $msv ) {
$lightbox_data[ $msk ] = $msv;
}
break;
case 'gallery':
$lightbox_data['gallery'] = $this->get_var( 'lightbox_gallery_data' );
break;
case 'iframe':
$lightbox_data['type'] = 'iframe';
break;
default:
// No data needed here.
break;
}
/**
* Filters the card lightbox data attributes.
*
* @param array $lightbox_data The lightbox data attributes.
* @param object $this Current WPEX_Card object.
*/
$this->lightbox_data = (array) apply_filters( 'wpex_card_lightbox_data', $lightbox_data, $this );
return $this->lightbox_data;
}
/**
* Get lightbox gallery data.
*/
public function get_lightbox_gallery_data() {
$this->lightbox_gallery_data = wpex_parse_inline_lightbox_gallery( wpex_get_gallery_ids( $this->post_id ) );
return $this->lightbox_gallery_data;
}
/*-------------------------------------------------------------------------------*/
/* [ Element ]
/*-------------------------------------------------------------------------------*/
/**
* Get card element.
*/
public function get_element( $args = [] ) {
$default_args = [
'name' => '',
'class' => '',
'link' => false,
'link_class' => '',
'link_rel' => '', // used for custom links only
'link_target' => '', // used for custom links only
'content' => '',
'screen_reader_text' => '',
'sanitize_content' => true,
'html_tag' => 'div',
'before' => '',
'after' => '',
'icon' => '',
'icon_class' => '',
'icon_bidi' => false,
'svg' => '',
'prefix' => '',
'suffix' => '',
'css' => '',
'data' => '',
'overlay' => false,
'attributes' => [],
'link_attributes' => [],
'strip_overlay_links' => false,
];
$args = wp_parse_args( $args, $default_args );
$this->el_args = $args;
$content = $this->parse_element_content( $args['name'] );
if ( empty( $content ) && '0' !== $content ) {
return;
}
$class = $this->parse_element_class();
$content_out = '';
if ( true === $args['link'] ) {
$content_out .= $this->get_link_open( [
'class' => $args['link_class'],
'attributes' => $args['link_attributes'] ?? null,
] );
} elseif ( ! empty( $args['link'] ) ) {
$link_attrs = [
'href' => esc_url( $args['link'] ),
'class' => esc_attr( $args['link_class'] ),
'rel' => esc_attr( $args['link_rel'] ),
'target' => esc_attr( $args['link_target'] ),
];
$link_attrs = wp_parse_args( $args['link_attributes'], $link_attrs );
$content_out .= '';
}
if ( ! empty( $args['icon'] ) && is_string( $args['icon'] ) ) {
$icon_class = $args['icon_class'] ?? '';
if ( str_contains( $args['icon'], 'ticon' ) ) {
$icon_class_array = explode( ' ', str_replace( 'ticon ', '', $args['icon'] ) );
if ( $icon_class_array ) {
foreach ( $icon_class_array as $icon_class_array_v ) {
if ( empty( $icon_name ) && str_starts_with( $icon_class_array_v, 'ticon-' ) ) {
$icon_name = str_replace( 'ticon-', '', $icon_class_array_v );
} else {
$icon_class .= " {$icon_class_array_v}";
}
}
$icon_class = trim( $icon_class );
}
}
if ( $icon_html = totaltheme_get_icon( $icon_name ?? $args['icon'], $icon_class, '', $args['icon_bidi'] ) ) {
$content_out .= $icon_html;
} else {
$content_out .= '';
}
}
if ( ! empty( $args['svg'] ) ) {
$content_out .= $args['svg'];
}
if ( $content && ! empty( $args['screen_reader_text'] ) ) {
$content = $content . '' . esc_html( $args['screen_reader_text'] ) . '';
}
$content_out .= $args['prefix'] . $content . $args['suffix'];
$content_out .= $this->get_overlay( $args['overlay'], 'inside_link', $args['strip_overlay_links'] );
if ( true === $args['link'] ) {
$content_out .= $this->get_link_close();
} elseif ( ! empty( $args['link'] ) ) {
$content_out .= '';
}
$content_out .= $this->get_overlay( $args['overlay'], 'outside_link', $args['strip_overlay_links'] );
if ( ! empty( $content_out ) ) {
$el_css = $this->parse_element_css( $args );
$output = $args['before'];
$attributes = [
'class' => $class,
'style' => $el_css,
];
$attributes = wp_parse_args( $args['attributes'], $attributes );
$output .= wpex_parse_html( $this->parse_element_html_tag(), $attributes, $content_out );
$output .= $args['after'];
$this->el_args = null;
return $output;
}
$this->el_args = null;
}
/**
* Get card empty element..4
*/
public function get_empty_element( $args = [] ) {
$args = wp_parse_args( $args, [
'html_tag' => 'div',
'class' => '',
'css' => '',
] );
return wpex_parse_html( $args['html_tag'], [
'class' => $args['class'],
'style' => $args['css'],
], '' );
}
/**
* Get current element name.
*/
protected function get_element_name() {
if ( ! empty( $this->el_args['name'] ) ) {
return $this->el_args['name'];
}
return '';
}
/**
* Parse element html tag.
*/
protected function parse_element_html_tag() {
$html_tag = 'div';
if ( ! empty( $this->el_args['html_tag'] ) ) {
$html_tag = tag_escape( $this->el_args['html_tag'] );
}
if ( 'title' === $this->get_element_name() ) {
$html_tag = $this->get_var( 'title_tag' );
}
return $html_tag;
}
/**
* Parse element class.
*/
protected function parse_element_class( $args = [] ) {
if ( ! empty( $args ) ) {
$this->el_args = $args;
}
$args = $this->el_args;
$element_name = $this->get_element_name();
$class = [];
if ( $element_name ) {
$class[] = "wpex-card-{$element_name}";
} else {
$class[] = 'wpex-card-element';
}
switch ( $element_name ) {
case 'excerpt':
$class[] = 'wpex-last-mb-0';
break;
case 'icon':
// @todo create new utility class for icon size!
if ( ! empty( $args['size'] ) ) {
$class[] = 'wpex-icon-' . sanitize_html_class( $args['size'] );
}
break;
case 'thumbnail':
$class[] = 'wpex-relative';
if ( $this->get_var( 'thumbnail_hover' ) ) {
$class[] = wpex_image_hover_classes( $this->get_var( 'thumbnail_hover' ) );
}
if ( $this->get_var( 'thumbnail_filter' ) ) {
$class[] = wpex_image_filter_class( $this->get_var( 'thumbnail_filter' ) );
}
break;
}
if ( ! empty( $args['class'] ) ) {
$class_vals = wp_parse_list( $args['class'] );
if ( ! empty( $class_vals ) && is_array( $class_vals ) ) {
foreach ( $class_vals as $val ) {
$class[] = $val;
}
}
}
if ( isset( $args['line_clamp'] ) ) {
$line_clamp = absint( $args['line_clamp'] );
if ( $line_clamp && in_array( $line_clamp, [ 1, 2 , 3 , 4 , 5 ], true ) ) {
$class[] = "wpex-line-clamp-{$line_clamp}";
}
}
if ( $args['overlay'] && 'none' !== $args['overlay'] ) {
$overlay_class = (string) totaltheme_call_static(
'Overlays',
'get_parent_class',
(string) $args['overlay']
);
if ( $overlay_class ) {
$class[] = trim( (string) $overlay_class );
}
}
if ( $element_name && ! empty( $this->args[$element_name . '_class'] ) ) {
$custom_class = $this->args[$element_name . '_class'];
if ( is_array( $custom_class ) ) {
foreach ( $custom_class as $val ) {
$class[] = $val;
}
} else {
$class[] = $custom_class;
}
}
if ( ! empty( $this->args['media_el_class'] )
&& ( 'thumbnail' === $element_name || 'video' === $element_name ) // can't target "media" as it can cause duplicate issues.
) {
$class[] = $this->args['media_el_class'];
}
if ( $element_name && ! empty( $this->args[ "{$element_name}_font_size" ] ) ) {
$custom_font_size = $this->args[ "{$element_name}_font_size" ];
if ( $custom_font_size ) {
$class = $this->modify_element_font_size( $custom_font_size, $class );
}
}
if ( ! empty( $this->args['media_width'] )
&& ( 'media' === $element_name || 'thumbnail' === $element_name )
) {
$media_width = $this->args['media_width'];
if ( $media_width && 'custom' !== $media_width ) {
$class = $this->modify_element_width( $media_width, $class );
}
}
$class = array_map( 'esc_attr', $class );
return $class;
}
/**
* Parse element content.
*/
protected function parse_element_content( $element = '' ) {
$content = $this->el_args['content'] ?? '';
if ( $content && $this->el_args['sanitize_content'] ) {
if ( isset( $this->el_args['name'] ) && in_array( $this->el_args['name'], [ 'excerpt' ], true ) ) {
if ( function_exists( 'totaltheme_render_content' ) ) {
$content = totaltheme_render_content( $content );
} else {
$content = do_shortcode( wp_kses_post( $content ) );
}
} else {
$content = do_shortcode( wp_kses_post( $content ) );
$content = totaltheme_replace_vars( $content );
}
}
return $content;
}
/**
* Parse element css.
*/
protected function parse_element_css() {
$css = '';
$args = $this->el_args;
if ( ! empty( $args['css'] ) ) {
$css = $args['css'];
}
if ( ! empty( $args['name'] ) && ! empty( $this->args[ "{$args['name']}_css" ] ) ) {
$custom_css = $this->args[ "{$args['name']}_css" ];
if ( is_array( $custom_css ) ) {
$custom_css = implode( ' ', $custom_css );
}
$css .= ' ' . $custom_css;
}
if ( $css && is_string( $css ) ) {
$css = ' style="' . esc_attr( trim( $css ) ) . '"';
}
return $css;
}
/**
* Modifies an element font size.
*
* @todo deprecate
*/
protected function modify_element_font_size( $custom_font_size = '', $classes = [] ) {
if ( empty( $classes ) ) {
return $classes;
}
$custom_font_size = wpex_sanitize_utl_font_size( $custom_font_size );
if ( ! $custom_font_size ) {
return $classes;
}
$get_font_sizes = wpex_utl_font_sizes();
$font_sizes = [];
$custom_size_added = false;
if ( $get_font_sizes ) {
foreach ( $get_font_sizes as $key => $value ) {
if ( $key ) {
$font_sizes[ $key ] = "wpex-text-{$key}";
}
}
foreach ( $classes as $key => $val ) {
if ( in_array( $val, $font_sizes ) ) {
$classes[ $key ] = $custom_font_size;
$custom_size_added = true;
break; // no need to check multiple, each element should only have 1 font size defined.
}
}
if ( ! $custom_size_added ) {
$classes[] = $custom_font_size;
}
}
return $classes;
}
/**
* Modifies an element width.
*
* @todo update to use preg_match
*/
protected function modify_element_width( $custom_width = '', $classes = [] ) {
if ( empty( $classes ) || empty( $custom_width ) ) {
return $classes;
}
$custom_width_safe = absint( $custom_width );
if ( $custom_width_safe ) {
$widths = wpex_utl_percent_widths();
if ( $widths ) {
$breakpoint = $this->get_breakpoint();
// Loop through element classes
foreach ( $classes as $key => $val ) {
if ( 'wpex-w-100' === $val ) {
continue; // don't modify elements intended to be 100% wide
}
// Alter width classes
$class = str_replace( 'wpex-w-', '', $val );
if ( ! empty( $class ) && array_key_exists( $class, $widths ) ) {
$classes[ $key ] = "wpex-w-{$custom_width_safe}";
continue;
}
// Alter responsive width classes
if ( $breakpoint ) {
$bk_class = str_replace( 'wpex-' . $breakpoint . '-w-', '', $val );
if ( ! empty( $bk_class ) && array_key_exists( $bk_class, $widths ) ) {
$classes[ $key ] = "wpex-{$breakpoint}-w-{$custom_width_safe}";
}
}
}
}
}
return $classes;
}
/*-------------------------------------------------------------------------------*/
/* [ Media ]
/*-------------------------------------------------------------------------------*/
/**
* Get card media.
*/
public function get_media( $args = [] ) {
$default_args = [
'class' => '',
'before' => '',
'after' => '',
'link' => true,
'overlay' => true, // overlays can be enabled to check for overlay style or a string.
'class' => '',
'css' => '',
'image_class' => '',
'image_size' => '',
'thumbnail_args' => [],
];
/**
* Filters the card media element arguments.
*
* @param array $args The arguments.
* @param object $this Current WPEX_Card object.
*/
$args = (array) apply_filters( 'wpex_card_media_args', wp_parse_args( $args, $default_args ), $this );
if ( ! empty( $args['image_class'] ) ) {
$args['thumbnail_args']['image_class'] = $args['image_class'];
}
if ( ! empty( $args['image_size'] ) ) {
$args['thumbnail_args']['size'] = $args['image_size'];
}
if ( false === $args['link'] ) {
$args['thumbnail_args']['link'] = false;
}
if ( false === $args['overlay'] ) {
$args['thumbnail_args']['overlay'] = false;
}
if ( isset( $args['strip_overlay_links'] ) && true === $args['strip_overlay_links'] ) {
$args['thumbnail_args']['strip_overlay_links'] = true;
}
$media_type = $this->get_var( 'media_type' );
switch ( $media_type ) {
case 'video':
$media = $this->get_video();
break;
case 'audio':
$media = $this->get_audio();
break;
case 'gallery':
$media = $this->get_gallery_slider( [
'thumbnail_args' => $args['thumbnail_args'],
] );
break;
case 'thumbnail':
$media = $this->get_thumbnail( $args['thumbnail_args'] );
break;
default:
$media = '';
break;
}
/**
* Filters the card media html.
*
* @param string $media The card media html.
* @param object $this Current WPEX_Card object.
* @param array $args The media element arguments.
*/
$media = (string) apply_filters( 'wpex_card_media', $media, $this, $args );
if ( empty( $media ) ) {
return;
}
$args['name'] = 'media';
$class = $this->parse_element_class( $args );
$el_css = $this->parse_element_css( $args );
// Important - this is a wrapper element, don't use $this->get_element
$output = $args['before'];
$output .= wpex_parse_html( 'div', [
'class' => $class,
'style' => $el_css,
], $media );
$output .= $args['after'];
return $output;
}
/**
* Card allowed media types.
*/
public function get_allowed_media() {
if ( array_key_exists( 'allowed_media', $this->args ) ) {
$allowed_media = (array) $this->args['allowed_media'];
} else {
$allowed_media = [ 'thumbnail' ];
}
if ( ! empty( $this->args['display_video'] ) && true === $this->args['display_video'] ) {
$allowed_media[] = 'video';
}
if ( ! empty( $this->args['display_audio'] ) && true === $this->args['display_audio'] ) {
$allowed_media[] = 'audio';
}
if ( ! empty( $this->args['display_gallery'] ) && true === $this->args['display_gallery'] ) {
$allowed_media[] = 'gallery';
}
if ( $this->post_id && post_password_required( $this->post_id ) ) {
$allowed_media = array_combine( $allowed_media, $allowed_media );
unset( $allowed_media['video'] );
unset( $allowed_media['audio'] );
}
/**
* Filters the card allowed media types.
*
* @param array $allowed_media The media types.
* @param object $this Current WPEX_Card object.
*/
$this->allowed_media = (array) apply_filters( 'wpex_card_allowed_media', $allowed_media, $this );
return array_filter( $this->allowed_media );
}
/**
* Card media type.
*/
public function get_media_type() {
$type = '';
$allowed_media = $this->get_var( 'allowed_media' );
if ( $this->post_id ) {
if ( in_array( 'video', $allowed_media ) && $this->get_var( 'post_video' ) ) {
$type = 'video';
} elseif ( in_array( 'audio', $allowed_media ) && wpex_has_post_audio( $this->post_id ) ) {
$type = 'audio';
} elseif ( in_array( 'gallery', $allowed_media ) && wpex_has_post_gallery( $this->post_id ) ) {
$type = 'gallery';
} elseif ( in_array( 'thumbnail', $allowed_media ) ) {
$type = 'thumbnail'; // don't bother with the has_post_thumbnail check.
}
} elseif ( $this->term ) {
$type = 'thumbnail';
}
/**
* Filters the card media type
*
* @param string $type The media type.
* @param object $this Current WPEX_Card object.
*/
$this->media_type = (string) apply_filters( 'wpex_card_media_type', $type, $this );
return $this->media_type;
}
/*-------------------------------------------------------------------------------*/
/* [ Thumbnail ]
/*-------------------------------------------------------------------------------*/
/**
* Get card thumbnail ID.
*/
public function get_thumbnail_id() {
$attachment = '';
if ( ! empty( $this->args['thumbnail_id'] ) ) {
$attachment = $this->args['thumbnail_id'];
} elseif ( $this->post_id ) {
$attachment = absint( $this->get_card_meta( 'thumbnail' ) );
if ( empty( $attachment ) ) {
if ( 'attachment' === $this->get_post_type() ) {
$attachment = $this->post_id;
} else {
$attachment = get_post_thumbnail_id( $this->post_id );
}
}
} elseif( $this->term ) {
$attachment = wpex_get_term_thumbnail_id( $this->term );
}
/**
* Filters the card thumbnail id.
*
* @param string|int $attachment The thumbnail attachment id.
* @param object $this Current WPEX_Card object.
*/
$this->thumbnail_id = apply_filters( 'wpex_card_thumbnail_id', $attachment, $this );
return $this->thumbnail_id;
}
/**
* Get card thumbnail url.
*/
public function get_thumbnail_url( $size = '' ) {
$attachment = $this->get_var( 'thumbnail_id' );
if ( ! $attachment ) {
return false;
}
$thumbnail_url = '';
if ( ! $size ) {
$size = $this->get_var( 'thumbnail_size', $size );
}
$thumbnail_args = array(
'attachment' => $attachment,
);
if ( is_array( $size ) ) {
$thumbnail_args['width'] = $size[0] ?? '';
$thumbnail_args['height'] = $size[1] ?? '';
$thumbnail_args['crop'] = $size[2] ?? '';
} else {
$thumbnail_args['size'] = $size;
}
if ( function_exists( 'wpex_get_post_thumbnail_url' ) ) {
$thumbnail_url = wpex_get_post_thumbnail_url( $thumbnail_args );
} else {
$thumbnail_url = wp_get_attachment_url( $attachment );
}
/**
* Filters the card thumbnail url.
*
* @param string $thumbnail_url The thumbnail url.
* @param object $this Current WPEX_Card object.
*/
$this->thumbnail_url = (string) apply_filters( 'wpex_card_thumbnail_url', $thumbnail_url, $this );
return $this->thumbnail_url;
}
/**
* Get card thumbnail.
*/
public function get_thumbnail( $args = [] ) {
$allowed_media = $this->get_var( 'allowed_media' );
if ( $this->is_mock() ) {
return $this->get_mock_thumbnail( $args );
}
if ( ! is_array( $allowed_media ) || ! in_array( 'thumbnail', $allowed_media ) ) {
return;
}
$default_args = [
'overlay' => true,
'link' => true,
'class' => '',
'image_class' => '',
'size' => 'full',
'strip_overlay_links' => false,
];
$args = (array) apply_filters( 'wpex_card_thumbnail_args', wp_parse_args( $args, $default_args ), $this );
$size = $this->get_var( 'thumbnail_size', $args['size'] );
$alt = $this->get_thumbnail_alt();
$attachment = $this->get_var( 'thumbnail_id' );
if ( empty( $attachment ) ) {
return;
}
$image_class = 'wpex-align-middle';
if ( ! empty( $args['image_class'] ) && is_string( $args['image_class'] ) ) {
$image_class .= ' ' . trim( $args['image_class'] );
}
if ( function_exists( 'wpex_get_post_thumbnail' ) ) {
$thumbnail_args = [
'attachment' => $attachment,
'alt' => $alt,
'class' => $image_class,
];
if ( isset( $args['lazy'] ) || isset( $this->args['thumbnail_lazy'] ) ) {
$thumbnail_args['lazy'] = $args['lazy'] ?? $this->args['thumbnail_lazy'];
}
if ( is_array( $size ) ) {
$thumbnail_args['width'] = $size[0] ?? '';
$thumbnail_args['height'] = $size[1] ?? '';
$thumbnail_args['crop'] = $size[2] ?? '';
} else {
$thumbnail_args['size'] = $size;
}
$thumbnail = wpex_get_post_thumbnail( $thumbnail_args );
} else {
$thumbnail = wp_get_attachment_image( $attachment, $size, array(
'alt' => $alt,
'class' => $image_class,
) );
}
/**
* Filters the card thumbnail html.
*
* @param string $thumbnail
* @param object $this WPEX_Card object
* @param array $args
*/
$thumbnail = apply_filters( 'wpex_card_thumbnail', $thumbnail, $this, $args );
if ( empty( $thumbnail ) ) {
return;
}
if ( $this->post_id
&& function_exists( 'wpex_get_entry_media_after' )
&& 'post' === $this->get_post_type()
) {
$thumbnail .= wpex_get_entry_media_after( 'card' );
}
$args['name'] = 'thumbnail';
$args['content'] = $thumbnail;
$args['sanitize_content'] = false;
if ( ! empty( $args['overlay'] ) ) {
if ( is_string( $args['overlay'] ) ) {
$args['overlay'] = $args['overlay'];
} else {
$args['overlay'] = $this->get_var( 'thumbnail_overlay_style' );
}
}
return $this->get_element( $args );
}
/**
* Get card thumbnail alt.
*/
public function get_thumbnail_alt() {
if ( isset( $this->thumbnail_alt ) ) {
return $this->thumbnail_alt;
}
$attachment = $this->get_var( 'thumbnail_id' );
if ( ! $attachment ) {
return;
}
$alt = (string) get_post_meta( $attachment, '_wp_attachment_image_alt', true );
if ( ! $alt ) {
if ( ! empty( $this->args['title'] ) ) {
$alt = (string) $this->args['title'];
} elseif ( $this->post_id ) {
$alt = (string) get_the_title( $this->post_id );
} elseif ( ! empty( $this->term->name ) ) {
$alt = $this->term->name;
}
}
if ( $alt ) {
return sanitize_text_field( $alt );
}
}
/**
* Get card thumbnail size.
*/
public function get_thumbnail_size( $default_size = '' ) {
$size = '';
if ( isset( $this->args['thumbnail_size'] ) ) {
$size = $this->args['thumbnail_size'];
} else {
$size = $default_size;
}
$this->thumbnail_size = apply_filters( 'wpex_card_thumbnail_size', $size, $this );
return $this->thumbnail_size;
}
/**
* Get card thumbnail hover.
*/
public function get_thumbnail_hover() {
$hover = '';
if ( isset( $this->args['thumbnail_hover'] ) ) {
$hover = (string) $this->args['thumbnail_hover'];
}
/**
* Filters the thumbnail hover style.
*
* @param string $hover The hover style name.
* @param object $this Current WPEX_Card object.
*/
$this->thumbnail_hover = (string) apply_filters( 'wpex_card_thumbnail_hover', $hover, $this );
return $this->thumbnail_hover;
}
/**
* Get card thumbnail filter.
*/
public function get_thumbnail_filter() {
$filter = '';
if ( isset( $this->args['thumbnail_filter'] ) ) {
$filter = $this->args['thumbnail_filter'];
}
/**
* Filters the thumbnail filter style.
*
* @param string $filter The filter style name.
* @param object $this Current WPEX_Card object.
*/
$this->thumbnail_filter = apply_filters( 'wpex_card_thumbnail_size', $filter, $this );
return $this->thumbnail_filter;
}
/*-------------------------------------------------------------------------------*/
/* [ Overlay ]
/*-------------------------------------------------------------------------------*/
/**
* Get card thumbnail overlay.
*/
public function get_thumbnail_overlay_style(): string {
$style = '';
if ( ! empty( $this->args['thumbnail_overlay_style'] ) ) {
$style = $this->args['thumbnail_overlay_style'];
} elseif ( $this->post_id ) {
$style = $this->get_card_meta( 'thumbnail_overlay_style', true );
}
/**
* Filters the thumbnail overlay style.
*
* @param string $style The overlay style name.
* @param object $this Current WPEX_Card object.
*/
$style = (string) apply_filters( 'wpex_card_thumbnail_overlay_style', $style, $this );
if ( 'none' === $style ) {
$style = '';
}
$this->thumbnail_overlay_style = $style;
return $this->thumbnail_overlay_style;
}
/**
* Check if a card has an overlay.
*/
public function has_thumbnail_overlay(): bool {
$overlay = $this->get_var( 'thumbnail_overlay_style' );
return ( $overlay && 'none' !== $overlay && function_exists( 'wpex_overlay' ) );
}
/**
* Get card overlay.
*/
public function get_overlay( $style = '', $position = 'inside', $strip_links = false ) {
if ( empty( $style ) || ! function_exists( 'wpex_overlay' ) ) {
return;
}
$args = [];
if ( ! empty( $this->args['thumbnail_overlay_button_text'] ) ) {
$args['overlay_button_text'] = $this->args['thumbnail_overlay_button_text'];
}
$link_type = $this->get_var( 'link_type' );
switch ( $link_type ) {
case 'modal':
case 'lightbox':
$args['lightbox_class'] = $this->get_var( 'lightbox_class' );
$args['lightbox_link'] = $this->get_var( 'url' );
$lightbox_data = $this->get_var( 'lightbox_data' );
if ( ! empty( $lightbox_data ) && is_array( $lightbox_data ) ) {
$args['lightbox_data'] = '';
foreach ( $lightbox_data as $data_key => $data_val ) {
$args['lightbox_data'] .= 'data-' . sanitize_key( $data_key ) . '="' . esc_attr( $data_val ) . '" ';
}
$args['lightbox_data'] = trim( $args['lightbox_data'] );
}
break;
default:
if ( 'dialog' !== $link_type ) {
$args['post_permalink'] = $this->get_var( 'url' );
}
if ( ! empty( $this->args['link_target'] ) ) {
$args['link_target'] = $this->args['link_target'];
}
break;
}
if ( $this->term ) {
$args['post_title'] = $this->term->name ?? '';
$args['taxonomy'] = '';
if ( empty( $args['overlay_button_text'] ) ) {
$args['overlay_button_text'] = esc_html__( 'View Archive', 'total' );
}
}
ob_start();
totaltheme_render_overlay( $position, $style, $args );
$html = ob_get_clean();
if ( $strip_links ) {
$html = str_replace( '', '', $html );
}
return $html;
}
/*-------------------------------------------------------------------------------*/
/* [ Gallery Slider ]
/*-------------------------------------------------------------------------------*/
/**
* Get card gallery slider.
*/
public function get_gallery_slider( $args = [] ) {
if ( ! $this->post_id || ! function_exists( 'wpex_get_post_media_gallery_slider' ) ) {
return;
}
$default_args = [
'before' => '',
'after' => '',
'thumbnail_args' => [],
'slider_args' => [
'lightbox' => false,
'captions' => false,
'slider_data' => [
'thumbnails' => 'false',
'buttons' => 'true',
'fade' => 'true',
],
],
];
$args = wp_parse_args( $args, $default_args );
extract( $args );
if ( empty( $thumbnail_args['size'] ) ) {
$thumb_size = $this->thumbnail_size ?? 'full';
if ( is_array( $thumb_size ) ) {
$thumbnail_args['width'] = $thumb_size[0] ?? '';
$thumbnail_args['height'] = $thumb_size[1] ?? '';
$thumbnail_args['crop'] = $thumb_size[2] ?? '';
} else {
$thumbnail_args['size'] = $thumb_size;
}
}
$slider_args['thumbnail_args'] = $thumbnail_args;
$slider = wpex_get_post_media_gallery_slider( $this->post_id, $slider_args );
/**
* Filters the card gallery slider html.
*
* @param string $html The slider html.
* @param object $this Current WPEX_Card object.
*/
$slider = (string) apply_filters( 'wpex_card_gallery_slider', $slider, $this, $args );
if ( $slider ) {
return $before . $slider . $after;
}
}
/*-------------------------------------------------------------------------------*/
/* [ Video ]
/*-------------------------------------------------------------------------------*/
/**
* Get card video.
*/
public function get_video( $args = [] ) {
$default_args = [
'class' => '',
];
$args = wp_parse_args( $args, $default_args );
$video = $this->get_post_video_html();
/**
* Filters the card video html.
*
* @param string $html The video html.
* @param object $this Current WPEX_Card object.
*/
$video = (string) apply_filters( 'wpex_card_video', $video, $this, $args );
if ( empty( $video ) ) {
return;
}
$args['name'] = 'video';
$args['content'] = $video;
$args['sanitize_content'] = false;
$args['link'] = false;
return $this->get_element( $args );
}
/**
* Get post video.
*/
public function get_post_video() {
if ( ! $this->post_id ) {
return;
}
$this->post_video = wpex_get_post_video( $this->post_id );
return $this->post_video;
}
/**
* Get post video html.
*/
public function get_post_video_html(): string {
return ( $video = $this->get_var( 'post_video' ) ) ? (string) wpex_get_post_video_html( $video ) : '';
}
/**
* Check if a card has a video.
*/
public function has_video(): bool {
return (bool) $this->get_var( 'post_video' );
}
/*-------------------------------------------------------------------------------*/
/* [ Audio ]
/*-------------------------------------------------------------------------------*/
/**
* Get card audio.
*/
public function get_audio( $args = [] ) {
$default_args = array(
'class' => '',
);
$args = wp_parse_args( $args, $default_args );
if ( $this->post_id ) {
$audio = wpex_get_post_audio( $this->post_id );
if ( $audio ) {
$audio = wpex_get_post_audio_html( $audio );
}
}
/**
* Filters the card audio html.
*
* @param string $html The audio html.
* @param object $this Current WPEX_Card object.
*/
$audio = (string) apply_filters( 'wpex_card_audio', $audio, $this, $args );
if ( empty( $audio ) ) {
return;
}
$args['name'] = 'audio';
$args['content'] = $audio;
$args['sanitize_content'] = false;
$args['link'] = false;
return $this->get_element( $args );
}
/*-------------------------------------------------------------------------------*/
/* [ Title ]
/*-------------------------------------------------------------------------------*/
/**
* Returns the title text.
*/
public function get_the_title( $args = [] ) {
$title = '';
if ( ! empty( $this->args['title'] ) ) {
$title = $this->args['title'];
} elseif ( ! empty( $args['content'] ) ) {
$title = $args['content'];
} elseif ( $this->post_id ) {
$title = get_the_title( $this->post_id );
} elseif ( ! empty( $this->term->name ) ) {
$title = $this->term->name;
}
/**
* Filters the card title.
*
* @param string $title The title.
* @param object $this Current WPEX_Card object.
*/
$title = (string) apply_filters( 'wpex_card_title', $title, $this, $args );
return $title;
}
/**
* Returns the card title element.
*/
public function get_title( $args = [] ) {
$default_args = [
'content' => '',
'link' => true,
'class' => '',
'show_count' => false,
];
/**
* Filters the card title element arguments.
*
* @param array $args The arguments.
* @param object $this Current WPEX_Card object.
*/
$args = (array) apply_filters( 'wpex_card_title_args', wp_parse_args( $args, $default_args ), $this );
$title = $this->get_the_title( $args );
if ( empty( $title ) ) {
return;
}
if ( true === $args['show_count'] ) {
$running_count = $this->get_var( 'running_count' );
$title = "{$running_count}. {$title}";
}
$args['name'] = 'title';
$args['content'] = $title;
return $this->get_element( $args );
}
/**
* Get card title tag.
*/
public function get_title_tag() {
if ( ! empty( $this->args['title_tag'] ) ) {
$tag = $this->args['title_tag'];
} else {
$tag = ( 'related' === wpex_get_loop_instance() ) ? 'h4' : 'h2';
}
/**
* Filters the card title html tag.
*
* @param string $tag The title tag.
* @param object $this Current WPEX_Card object.
*/
$tag = (string) apply_filters( 'wpex_card_title_tag', $tag, $this );
$this->title_tag = tag_escape( $tag );
return $this->title_tag;
}
/*-------------------------------------------------------------------------------*/
/* [ Subheading ]
/*-------------------------------------------------------------------------------*/
/**
* Returns the title text.
*/
public function get_the_subheading( array $args ): string {
$subheading = '';
if ( ! empty( $this->args['subheading'] ) ) {
$subheading = $this->args['subheading'];
} elseif ( ! empty( $args['content'] ) ) {
$subheading = $args['content'];
} elseif ( $this->post_id ) {
$post_type = $this->get_post_type();
switch ( $post_type ) {
case 'staff':
$subheading = wpex_get_staff_member_position( $this->post_id );
break;
case 'portfolio':
$subheading = get_post_meta( $this->post_id, 'wpex_portfolio_company', true );
break;
}
if ( $meta = get_post_meta( $this->post_id, 'wpex_post_subheading', true ) ) {
$subheading = $meta;
}
if ( ! $subheading ) {
$subheading = get_post_meta( $this->post_id, 'subheading', true );
}
}
/**
* Filters the card sub heading text.
*
* @param string $subheading The subheading.
* @param object $this Current WPEX_Card object.
*/
$subheading = (string) apply_filters( 'wpex_card_subheading', $subheading, $this, $args );
return $subheading;
}
/**
* Returns the card subheading.
*/
public function get_subheading( $args = [] ) {
$default_args = [
'content' => '',
'class' => '',
];
/**
* Filters the card sub heading args.
*
* @param array $args The subheading args.
* @param object $this Current WPEX_Card object.
*/
$args = (array) apply_filters( 'wpex_card_subheading_args', wp_parse_args( $args, $default_args ), $this );
$subheading = $this->get_the_subheading( $args );
if ( empty( $subheading ) ) {
return;
}
$args['name'] = 'subheading';
$args['content'] = $subheading;
return $this->get_element( $args );
}
/*-------------------------------------------------------------------------------*/
/* [ Excerpt ]
/*-------------------------------------------------------------------------------*/
/**
* Returns the default excerpt length.
*/
protected function get_default_excerpt_length(): int {
return $this->is_featured() ? 40 : 20;
}
/**
* Get card excerpt.
*/
public function get_the_excerpt( $args = [] ) {
$excerpt = '';
if ( isset( $this->args['excerpt_length'] ) ) {
$excerpt_length = $this->args['excerpt_length'];
} else {
$excerpt_length = $args['length'] ?? $this->get_default_excerpt_length();
}
$excerpt = '';
if ( $excerpt_length && '0' !== $excerpt_length ) {
if ( ! empty( $this->args['excerpt'] ) ) {
$excerpt = $this->args['excerpt'];
} elseif ( $this->post_id ) {
$excerpt = get_post_meta( $this->post_id, 'wpex_card_excerpt', true );
if ( empty( $excerpt ) ) {
if ( function_exists( 'totaltheme_get_post_excerpt' ) ) {
$excerpt_args = apply_filters( 'wpex_card_excerpt_args', [
'post_id' => $this->post_id,
'length' => $excerpt_length,
], $this );
$excerpt = totaltheme_get_post_excerpt( $excerpt_args );
} else {
$excerpt = get_the_excerpt( $this->post_id );
}
}
} elseif ( ! empty( $this->term->description ) ) {
$excerpt = $this->term->description;
}
}
/**
* Filters the card excerpt.
*
* @param string $excerpt The excerpt.
* @param object $this Current WPEX_Card object.
*/
$excerpt = (string) apply_filters( 'wpex_card_excerpt', $excerpt, $this, $args );
return $excerpt;
}
/**
* Get card excerpt.
*/
public function get_excerpt( $args = [] ) {
$default_args = [
'link' => false, // disabled by default but it's possible to add.
'class' => '',
'length' => $this->get_default_excerpt_length(),
];
/**
* Filters the card excerpt args.
*
* @param array $args The excerpt args.
* @param object $this Current WPEX_Card object.
*/
$args = (array) apply_filters( 'wpex_card_excerpt_args', wp_parse_args( $args, $default_args ), $this );
$excerpt = $this->get_the_excerpt( $args );
if ( empty( $excerpt ) ) {
return;
}
if ( isset( $this->args['excerpt_length'] ) ) {
$args['length'] = $this->args['excerpt_length'];
}
if ( isset( $this->args['excerpt_max_lines'] ) ) {
$args['line_clamp'] = $this->args['excerpt_max_lines'];
}
$args['name'] = 'excerpt';
$args['content'] = $excerpt;
if ( '-1' === $args['length'] || '9999' === $args['length'] ) {
$args['sanitize_content'] = false; // important because the content has already been sanitized and if we do it again things get stripped out such as