$video
";
$output .= '
";
}
// Add a wrapper div around just the portfolio item details (excluding the thumbnail)
$output .= isset( $args['show_title'] ) && $args['show_title'] ? "';
if( $args[ 'lightbox' ] ) {
// Add the lightbox icon
$output .= '';
$output .= "
";
$output .= '';
};
$output .= '';
$output .= "
";
$output .= "" : "
' . esc_html__( 'All', 'wpzoom-portfolio' ) . '
';
// Filter the HTML output by the walk_category_tree() function to add needed CSS classes
add_filter( 'category_list_link_attributes', array( $this, 'category_list_link_attributes' ), 10, 5 );
add_filter( 'category_css_class', array( $this, 'category_css_class' ), 10, 4 );
// Build the HTML for the categories list
$output .= walk_category_tree( $categories, -1, $args );
// Remove the filters added above
remove_filter( 'category_list_link_attributes', array( $this, 'category_list_link_attributes' ) );
remove_filter( 'category_css_class', array( $this, 'category_css_class' ) );
}
// Return the final output
return $output;
}
/**
* Returns an HTML embed code for a given video URL.
*
* @access public
* @param string $url The URL to a video to get the embed code for.
* @param bool $library Whether the URL points to a video in the local media library.
* @return string
* @since 1.0.0
* @see wp_video_shortcode()
* @see WP_oEmbed
* @see _wp_oembed_get_object()
*/
public function get_video_embed_code( $url, $library = true, $autoplay = true, $loop = false ) {
// The result that will be returned
$result = '';
// As long as the passed url is not empty...
if ( ! empty( $url ) ) {
// If the url should be treated as a media library url...
if ( true === $library ) {
// Get the embed code for the given url
$embed = wp_video_shortcode( array( 'src' => $url, 'autoplay' => $autoplay, 'loop' => $loop ) );
// As long as there is an embed code...
if ( ! empty( $embed ) ) {
// Filter the embed code and use it as the result
$result = preg_replace( '/\]+)controls="controls"\>/i', '', $embed );
}
}
// Otherwise it is a url from an external service...
else {
// Try to get the video data for the given url
$data = _wp_oembed_get_object()->get_data( $url );
// As long as we got back valid data...
if ( false !== $data && isset( $data->provider_name ) ) {
// Determine the service the video is from and the html embed code
$service = strtolower( trim( $data->provider_name ) );
$html = isset( $data->html ) ? $data->html : '';
// As long as there is an embed code...
if ( ! empty( $html ) ) {
// Setup some variables
$autoplay = intval( $autoplay );
$loop = intval( $loop );
$args = '';
// If the service is YouTube...
if ( 'youtube' == $service ) {
// Setup the proper arguments
$args = "&controls=0&modestbranding=1&mute=1&autoplay=$autoplay&loop=$loop";
}
// If the service is Vimeo...
elseif ( 'vimeo' == $service ) {
// Setup the proper arguments
$args = "&controls=0&background=1&muted=1&autoplay=$autoplay&loop=$loop";
}
// Filter the embed code to add extra needed arguments and use it as the result
$result = preg_replace( '/\]+)src="([^"]+)"/i', ' WP_REST_Server::READABLE,
'callback' => array( $this, 'get_rest_portfolio_posts' ),
'permission_callback' => function() { return ''; }
)
);
}
/**
* Returns a REST response containing portfolio items' details for a given set of portfolio items.
*
* @access public
* @param WP_REST_Request $request Full details about the request.
* @return array
* @since 1.0.0
*/
public function get_rest_portfolio_posts( $request ) {
// The results that will be returned in the REST response
$result = array();
// As long as it is a valid request...
if ( ! is_null( $request ) && $request instanceof WP_REST_Request ) {
// Get the request parameters
$params = $request->get_params();
// As long as the parameters are not empty...
if ( ! empty( $params ) ) {
// Parse the parameters into variables to use for building the HTML to return
$layout = isset( $params[ 'layout' ] ) ? $params[ 'layout' ] : 'grid';
$order = isset( $params[ 'order' ] ) ? $params[ 'order' ] : 'desc';
$order_by = isset( $params[ 'order_by' ] ) ? $params[ 'order_by' ] : 'date';
$per_page = isset( $params[ 'per_page' ] ) ? intval( $params[ 'per_page' ] ) : 6;
$page = isset( $params[ 'page' ] ) ? intval( $params[ 'page' ] ) : 1;
$categories = isset( $params[ 'cats' ] ) && !empty( $params[ 'cats' ] ) ? explode( ',', $params[ 'cats' ] ) : array();
$show_thumbnail = isset( $params[ 'show_thumbnail' ] ) ? boolval( $params[ 'show_thumbnail' ] ) : true;
$thumbnail_size = isset( $params[ 'thumbnail_size' ] ) ? $params[ 'thumbnail_size' ] : 'portfolio_item-thumbnail';
$show_background_video = isset( $params[ 'show_background_video' ] ) ? boolval( $params[ 'show_background_video' ] ) : true;
$show_author = isset( $params[ 'show_author' ] ) ? boolval( $params[ 'show_author' ] ) : true;
$show_date = isset( $params[ 'show_date' ] ) ? boolval( $params[ 'show_date' ] ) : true;
$show_excerpt = isset( $params[ 'show_excerpt' ] ) ? boolval( $params[ 'show_excerpt' ] ) : true;
$show_read_more = isset( $params[ 'show_read_more' ] ) ? boolval( $params[ 'show_read_more' ] ) : true;
$source = isset( $params[ 'source' ] ) ? $params[ 'source' ] : 'portfolio_item';
$exclude_posts = isset( $params['exclude'] ) && ! empty( $params['exclude'] ) ? explode( ',', $params[ 'exclude' ] ) : array();
// Build the HTML to return
$items = $this->items_html( array(
'class' => 'wpzoom-blocks_portfolio-block',
'layout' => $layout,
'order' => $order,
'order_by' => $order_by,
'per_page' => $per_page,
'page' => $page,
'categories' => $categories,
'exclude_posts' => $exclude_posts,
'show_thumbnail' => $show_thumbnail,
'thumbnail_size' => $thumbnail_size,
'show_background_video' => $show_background_video,
'show_author' => $show_author,
'show_date' => $show_date,
'show_excerpt' => $show_excerpt,
'show_read_more' => $show_read_more,
'source' => $source
) );
// Assign the results to return
$result = array(
'items' => $items,
'has_more' => $page < $this->result_pages,
'new_posts' => $this->posts_ids
);
}
}
// Return the portfolio items array properly formatted for a rest response
return rest_ensure_response( $result );
}
/**
* Filters the HTML attributes applied to a category list item's anchor element.
*
* @access public
* @param array $atts The HTML attributes applied to the list item's element, empty strings are ignored.
* @param WP_Term $category Term data object.
* @param int $depth Depth of category, used for padding.
* @param array $args An array of arguments.
* @param int $id ID of the current category.
* @return array
* @since 1.0.0
*/
public function category_list_link_attributes( $atts, $category, $depth, $args, $id ) {
$atts[ 'class' ] = 'wpz-portfolio-filter__link';
return $atts;
}
/**
* Filters the list of CSS classes to include with each category in the list.
*
* @access public
* @param array $css_classes An array of CSS classes to be applied to each list item.
* @param WP_Term $category Term data object.
* @param int $depth Depth of category, used for padding.
* @param array $args An array of wp_list_categories() arguments.
* @return array
* @since 1.0.0
*/
public function category_css_class( $css_classes, $category, $depth, $args ) {
$css_classes[] = 'cat-posts-total-' . $category->category_count;
$css_classes[] = 'wpz-block-button';
return $css_classes;
}
/**
* Filters the post type link for portfolio posts to properly include the category.
* Called during the WordPress `post_type_link` filter.
*
* @access public
* @param string $post_link The post's permalink.
* @param WP_Post $post A WP_Post object representing the post related to the post type link.
* @return string
* @since 1.0.0
* @see get_the_terms()
*/
public function post_type_link_replace( $post_link, $post ) {
// If the post type is our portfolio type and the link includes the replacement string...
if ( 'portfolio_item' == get_post_type( $post ) && false !== stripos( $post_link, '%category%' ) ) {
// Get the categories for the given post
$cats = get_the_terms( $post, 'portfolio' );
// As long as there are some categories...
if ( false !== $cats && !is_wp_error( $cats ) ) {
// Return the link with the replacement string replaced with the first category
return str_ireplace( '%category%', $cats[0]->slug, $post_link );
}
}
return $post_link;
}
/**
* Sets a portfolio posts' category to "Uncategorized" if no category was set on it.
* Called during the WordPress `save_post` hook.
*
* @access public
* @param string $post_id The post's ID.
* @param WP_Post $post A WP_Post object representing the post in question.
* @param boolean $update Whether the post is being updated (instead of added).
* @return void
* @since 1.0.0
* @see get_the_terms()
* @see wp_set_object_terms()
*/
public function set_default_object_terms( $post_id, $post, $update ) {
// As long as the post status is Publish and the post type is our portfolio type...
if ( 'publish' == $post->post_status && 'portfolio_item' == $post->post_type ) {
// Get the categories for the given post
$cats = get_the_terms( $post, 'portfolio' );
// As long as there are no categories...
if ( false === $cats || is_wp_error( $cats ) ) {
// Set the category for the given post to Uncategorized
wp_set_object_terms( $post_id, 'uncategorized', 'portfolio' );
}
}
}
}
";
// Add the portfolio item title to the output
$output .= "
';
// Close the portfolio item wrapper article
$output .= '';
// Close the list item for this portfolio item
$output .= '';
}
// Reset the WordPress post data so this block doesn't mess up the main query
wp_reset_postdata();
}
$this->posts_ids = $posts_ids;
// Return the final HTML string
return $output;
}
/**
* Retrieve an HTML list of categories.
*
* @access public
* @param array $only Only show category items for categories included in this array.
* @return string
* @since 1.0.0
* @see get_categories()
*/
public function list_categories( $only = array(), $post_type = 'post' ) {
// Setup the basic query arguments
$args = array(
'child_of' => 0,
'depth' => 0,
'echo' => 1,
'exclude' => '',
'exclude_tree' => '',
'feed' => '',
'feed_image' => '',
'feed_type' => '',
'hide_empty' => true,
'hide_title_if_empty' => false,
'hierarchical' => true,
'order' => 'ASC',
'orderby' => 'name',
'separator' => '',
'show_count' => 0,
'show_option_all' => esc_html__( 'All', 'wpzoom-portfolio' ),
'style' => 'list',
'use_desc_for_title' => 1,
);
// If the passed $only argument is not empty...
if ( ! empty( $only ) ) {
// Include it in the arguments for the query
$args[ 'include' ] = $only;
}
// If a portfolio taxonomy exists...
if ( taxonomy_exists( 'portfolio' ) && 'portfolio_item' == $post_type ) {
// Add it to the query arguments
$args[ 'taxonomy' ][] = 'portfolio';
}
// Attempt to get all the categories using the above parameters
$categories = get_categories( $args );
// The string that will be output
$output = '';
// As long as some categories were returned...
if ( ! empty( $categories ) ) {
// Add in the All link
$posts_page = esc_url( str_ireplace( '%category%/', '', get_post_type_archive_link( 'portfolio_item' ) ) );
$output .= '$title
"; // If the layout type is set to list... if ( 'list' == $args[ 'layout' ] ) { // Add a wrapper div around just the portfolio item meta if needed if ( $args[ 'show_author' ] || $args[ 'show_date' ] ) { $output .= "'; } // If the excerpt should be shown... if ( $args[ 'show_excerpt' ] ) { // Get the excerpt $raw_cont = get_the_excerpt( $post ); // Add the excerpt to the output $output .= "$raw_cont
";
}
// If the Read More button should be shown...
if ( $args[ 'show_read_more' ] ) {
// Get the label for the button
$readmore = $args[ 'read_more_label' ] ? esc_html( $args[ 'read_more_label' ] ) : esc_html__( 'Read More', 'wpzoom-portfolio' );
$readmore_title = esc_attr__( 'Continue reading this post...', 'wpzoom-portfolio' );
// Add the button to the output
$output .= "";
}
}
// Close the portfolio item details wrapper div
$output .= '