issuem-shortcodes.php

<?php
/**
 * Registers IssueM class for setting up IssueM shortcodes
 *
 * @package IssueM
 * @since 1.0.0
 */
	
if ( !function_exists( 'do_issuem_articles' ) ) {
	
	/**
	 * Outputs Article HTML from shortcode call
	 *
	 * @since 1.0.0
	 *
	 * @param array $atts Arguments passed through shortcode
	 * @return string HTML output of IssueM Articles
	 */
	function do_issuem_articles( $atts, $article_format = NULL ) {
		
		global $post;
		
		$issuem_settings = get_issuem_settings();
		$results = '';
		$articles = array();
		$post__in = array();
		
		$defaults = array(
			'posts_per_page'    	=> -1,
			'offset'            	=> 0,
			'orderby'           	=> 'menu_order',
			'order'             	=> 'DESC',
			'article_format'		=> empty( $article_format ) ? $issuem_settings['article_format'] : $article_format,
			'show_featured'			=> 1,
			'issue'					=> get_active_issuem_issue(),
			'article_category'		=> 'all',
			'use_category_order'	=> 'false',
		);
	
		// Merge defaults with passed atts
		// Extract (make each array element its own PHP var
		extract( shortcode_atts( $defaults, $atts ) );
		
		$args = array(
			'posts_per_page'	=> $posts_per_page,
			'offset'			=> $offset,
			'post_type'			=> 'article',
			'orderby'			=> $orderby,
			'order'				=> $order
		);
		
		if ( !$show_featured ) {
			
			$args['meta_query'] = array(
									'relation' => 'AND',
									array(
										'key' => '_featured_rotator',
										'compare' => 'NOT EXISTS'
									),
									array(
										'key' => '_featured_thumb',
										'compare' => 'NOT EXISTS'
									)
								);
			
		}
	
		$issuem_issue = array(
			'taxonomy' 	=> 'issuem_issue',
			'field' 	=> 'slug',
			'terms' 	=> $issue
		);
		
		$args['tax_query'] = array(
			$issuem_issue
		);
		
		if ( !empty( $issuem_settings['use_wp_taxonomies'] ) ) 
			$cat_type = 'category';
		else
			$cat_type = 'issuem_issue_categories';
			
		if ( 'true' === $use_category_order && 'issuem_issue_categories' === $cat_type ) {
			
			if ( 'all' === $article_category ) {
			
				$all_terms = get_terms( 'issuem_issue_categories' );
				
				foreach( $all_terms as $term ) {
				
					$issue_cat_meta = get_option( 'issuem_issue_categories_' . $term->term_id . '_meta' );
						
					if ( !empty( $issue_cat_meta['category_order'] ) )
						$terms[ $issue_cat_meta['category_order'] ] = $term->slug;
					else
						$terms[ $issue_cat_meta['category_order'] ] = $term->slug;
						
				}
				
			} else {
			
				foreach( split( ',', $article_category ) as $term_slug ) {
					
					$term = get_term_by( 'slug', $term_slug, 'issuem_issue_categories' );
				
					$issue_cat_meta = get_option( 'issuem_issue_categories_' . $term->term_id . '_meta' );
						
					if ( !empty( $issue_cat_meta['category_order'] ) )
						$terms[ $issue_cat_meta['category_order'] ] = $term->slug;
					else
						$terms[ $issue_cat_meta['category_order'] ] = $term->slug;
						
				}
			
			}
			
			krsort( $terms );
			
			foreach( $terms as $term ) {
			
				$category = array(
					'taxonomy' 	=> $cat_type,
					'field' 	=> 'slug',
					'terms' 	=> $term,
				);	
				
				$args['tax_query'] = array(
					'relation'	=> 'AND',
					$issuem_issue,
					$category
				);
				
				$articles = array_merge( $articles, get_posts( $args ) );
				
			}
		
			if ( !empty( $articles ) ) {
				
				foreach( $articles as $article ) {
				
					$post__in[] = $article->ID;
					
				}
				
				$args['post__in']	= array_unique( $post__in );
				$args['orderby']	= 'post__in';
				unset( $args['tax_query'] );
					
				$articles = get_posts( $args );
			
			}
			
		} else {
			
			if ( !empty( $article_category ) && 'all' !== $article_category ) {
					
				$category = array(
					'taxonomy' 	=> $cat_type,
					'field' 	=> 'slug',
					'terms' 	=> split( ',', $article_category ),
				);	
				
				$args['tax_query'] = array(
					'relation'	=> 'AND',
					$issuem_issue,
					$category
				);
				
			}
				
			$articles = get_posts( $args );
			
		}
		
		$results .= '<div class="issuem_articles_shortcode">';
	
		if ( $articles ) : 
		
			$old_post = $post;
			
			foreach( $articles as $article ) {
				
				$post = $article;
				setup_postdata( $article );
				
				$results .= '<div class="issuem_article article-' . $article->ID . '">';
				$results .= "\n" . issuem_replacements_args( $article_format, $post ) . "\n";
				$results .= '</div>';
			
			}
			
			if ( get_option( 'issuem_api_error_received' ) )
				$results .= '<div class="api_error"><p><a href="http://issuem.com/" target="_blank">' . __( 'Issue Management by ', 'issuem' ) . 'IssueM</a></div>';
		
			$post = $old_post;
	
		else :
	
			$results .= '<h1 class="issuem-entry-title">' . __( 'No articles Found', 'issuem' ) . '</h1>';
	
		endif;
		
		$results .= '</div>';
		
		wp_reset_postdata();
		
		return $results;
		
	}
	add_shortcode( 'issuem_articles', 'do_issuem_articles' );

}

if ( !function_exists( 'do_issuem_title' ) ) {
	
	/**
	 * Outputs Issue Title HTML from shortcode call
	 *
	 * @since 1.1.8
	 *
	 * @param array $atts Arguments passed through shortcode
	 * @return string HTML output of Issue Title
	 */
	function do_issuem_title( $atts ) {
		
		$issuem_settings = get_issuem_settings();
		
		$defaults = array(
			'issue' => get_active_issuem_issue(),
			'field'	=> 'slug'
		);
	
		// Merge defaults with passed atts
		// Extract (make each array element its own PHP var
		extract( shortcode_atts( $defaults, $atts ) );
		
		$term = get_term_by( $field, $issue, 'issuem_issue' );
		
		return '<div class="issuem_title">' . $term->name . '</div>';
		
	}
	add_shortcode( 'issuem_issue_title', 'do_issuem_title' );

}
	
if ( !function_exists( 'do_issuem_archives' ) ) {
	
	/**
	 * Outputs Issue Archives HTML from shortcode call
	 *
	 * @since 1.0.0
	 *
	 * @param array $atts Arguments passed through shortcode
	 * @return string HTML output of Issue Archives
	 */
	function do_issuem_archives( $atts ) {
		
		$issuem_settings = get_issuem_settings();
		
		$defaults = array(
							'orderby' 		=> 'issue_order',
							'order'			=> 'DESC',
							'limit'			=> 0,
							'pdf_title'		=> $issuem_settings['pdf_title'],
							'default_image'	=> $issuem_settings['default_issue_image']
						);
		extract( shortcode_atts( $defaults, $atts ) );
		
		$args = array( 'hide_empty' => 0 );
		
		$issuem_issues = get_terms( 'issuem_issue', $args );
		$archives = array();
		$archives_no_issue_order = array();
		
		foreach ( $issuem_issues as $issue ) {
		
			$issue_meta = get_option( 'issuem_issue_' . $issue->term_id . '_meta' );
			
			// If issue is not a Draft, add it to the archive array;
			if ( !empty( $issue_meta['issue_status'] ) && ( 'Draft' !== $issue_meta['issue_status'] || current_user_can( apply_filters( 'see_issuem_draft_issues', 'manage_issues' ) ) ) ) {
			
				switch( $orderby ) {
					
					case "issue_order":
						if ( !empty( $issue_meta['issue_order'] ) )
							$archives[ $issue_meta['issue_order'] ] = array( $issue, $issue_meta );
						else 
							$archives_no_issue_order[] = array( $issue, $issue_meta );
						break;
						
					case "name":
						$archives[ $issue_meta['name'] ] = array( $issue, $issue_meta );
						break;
					
					case "term_id":
						$archives[ $issue->term_id ] = array( $issue, $issue_meta );
						break;
					
				}
			
			}
			
		}
		
		if ( 'issue_order' == $orderby && !empty( $archives_no_issue_order ) )
			$archives = array_merge( $archives_no_issue_order, $archives );
		
		if ( "DESC" == $order )
			krsort( $archives );
		else
			ksort( $archives );
			
		$results = '<div class="issuem_archives_shortcode">';
		
		$count = 0;
		foreach ( $archives as $archive => $issue_array ) {
		
			$issue_meta = get_option( 'issuem_issue_' . $issue_array[0]->term_id . '_meta' );
				
			$class = '';
			if ( 'Draft' === $issue_meta['issue_status'] )
				$class = 'issuem_issue_draft';
			
			$results .= '<div id="issue-' . $issue_array[0]->term_id . '" class="issuem_archive ' . $class . '">';
			
			if ( 0 == $issuem_settings['page_for_articles'] )
				$article_page = get_bloginfo( 'wpurl' ) . '/' . apply_filters( 'issuem_page_for_articles', 'article/' );
			else
				$article_page = get_page_link( $issuem_settings['page_for_articles'] );
		
			$issue_url = get_term_link( $issue_array[0], 'issuem_issue' );
            if ( $issuem_settings['use_issue_tax_links'] == '' or is_wp_error( $issue_url ) ) {
                $issue_url = add_query_arg( 'issue', $issue_array[0]->slug, $article_page );
            }
				
			if ( !empty( $issue_array[1]['pdf_version'] ) || !empty( $issue_meta['external_pdf_link'] ) ) {
				
				$pdf_url = empty( $issue_meta['external_pdf_link'] ) ? wp_get_attachment_url( $issue_array[1]['pdf_version'] ) : $issue_meta['external_pdf_link'];
				
				$pdf_line = '<a href="' . $pdf_url . '" target="' . $issuem_settings['pdf_open_target'] . '">';
				
				if ( 'PDF Archive' == $issue_array[1]['issue_status'] ) {
					
					$issue_url = $pdf_url;
					$pdf_line .= empty( $pdf_only_title ) ? $issuem_settings['pdf_only_title'] : $pdf_only_title;
					
				} else {
					
					$pdf_line .= empty( $pdf_title ) ? $issuem_settings['pdf_title'] : $pdf_title;
				
				}
				
				$pdf_line .= '</a>';
				
			} else {
			
				$pdf_line = apply_filters( 'issuem_pdf_version', '&nbsp;', $pdf_title, $issue_array[0] );
				
			}
						
			if ( !empty( $issue_meta['external_link'] ) )
				$issue_url = apply_filters( 'archive_issue_url_external_link', $issue_meta['external_link'], $issue_url );
	
			if ( !empty( $issue_array[1]['cover_image'] ) )
				$image_line = wp_get_attachment_image( $issue_array[1]['cover_image'], 'issuem-cover-image' );
			else
				$image_line = '<img src="' . $default_image . '" />';
				
			$results .= '<p><a class="featured_archives_cover" style="width: ' . apply_filters( 'issuem-cover-image-width', $issuem_settings['cover_image_width'] ) . 'px; height: ' . apply_filters( 'issuem-cover-image-height', $issuem_settings['cover_image_height'] ) . 'px;" href="' . $issue_url . '">' . $image_line . '</a>';
			$results .= '<br /><a href="' . $issue_url . '">' . $issue_array[0]->name . '</a>';
			$results .= '<br />' . $pdf_line;
		
			$results .= '</div>';
			
			$count++;
			if ( 0 != $limit && $count >= $limit )
				break;
			
		}
		
		if ( get_option( 'issuem_api_error_received' ) )
			$results .= '<div class="api_error"><p><a href="http://issuem.com/" target="_blank">' . __( 'Issue Management by ', 'issuem' ) . 'IssueM</a></div>';
			
		$results .= '</div>';
		
		return $results;
		
	}
	add_shortcode( 'issuem_archives', 'do_issuem_archives' );
	
}

if ( !function_exists( 'do_issuem_featured_rotator' ) ) {
	
	/**
	 * Outputs Issue Featured Rotator Images HTML from shortcode call
	 *
	 * @since 1.0.0
	 *
	 * @param array $atts Arguments passed through shortcode
	 * @return string HTML output of Issue Featured Rotator Images
	 */
	function do_issuem_featured_rotator( $atts ) {
		global $post;
		$results = '';
		
		$issuem_settings = get_issuem_settings();
		
		$defaults = array(
			'posts_per_page'    => -1,
			'offset'            => 0,
			'orderby'           => 'menu_order',
			'order'             => 'DESC',
			'issue'				=> get_active_issuem_issue(),
			'show_title'		=> true,
			'show_teaser'		=> true,
			'show_byline'		=> false,
		);
		
		// Merge defaults with passed atts
		// Extract (make each array element its own PHP var
		extract( shortcode_atts( $defaults, $atts ) );
		
		$args = array(
			'posts_per_page'	=> $posts_per_page,
			'offset'			=> $offset,
			'post_type'			=> 'article',
			'orderby'			=> $orderby,
			'order'				=> $order,
			'meta_key'			=> '_featured_rotator',
			'issuem_issue' 		=> $issue,
		);
		
		$featured_articles = get_posts( $args );
		
		if ( $featured_articles ) {
			$articles = array();
			foreach ( $featured_articles as $article ) {
				$articles[] = IssuemArticle::from_object( $article );
			}
			return issuem_render(
				'featured-rotator-shortcode.php',
				array(
					'articles' => $articles,
					'show_title' => $show_title,
					'show_teaser' => $show_teaser,
					'show_byline' => $show_byline,
					'settings' => $issuem_settings,
				)
			);
		}

		return '';

	}
	add_shortcode( 'issuem_featured_rotator', 'do_issuem_featured_rotator' );

}

if ( !function_exists( 'do_issuem_featured_thumbs' ) ) {

	/**
	 * Outputs Issue Featured Thumbnail Images HTML from shortcode call
	 *
	 * @since 1.0.0
	 *
	 * @param array $atts Arguments passed through shortcode
	 * @return string HTML output of Issue Featured Rotator Thumbnails
	 */
	function do_issuem_featured_thumbs( $atts ) {
		
		global $post;
		$results = '';
		
		$issuem_settings = get_issuem_settings();
		
		$defaults = array(
			'content_type'		=> 'teaser',
			'posts_per_page'    => -1,
			'offset'            => 0,
			'orderby'           => 'menu_order',
			'order'             => 'DESC',
			'max_images'		=> 0,
			'issue'				=> get_active_issuem_issue(),
		);
		
		// Merge defaults with passed atts
		// Extract (make each array element its own PHP var
		extract( shortcode_atts( $defaults, $atts ) );
		
		$args = array(
			'posts_per_page'	=> $posts_per_page,
			'offset'			=> $offset,
			'post_type'			=> 'article',
			'orderby'			=> $orderby,
			'order'				=> $order,
			'meta_key'			=> '_featured_thumb',
			'issuem_issue' 		=> $issue,
		);
		
		$featured_articles = get_posts( $args );
		
		if ( $featured_articles ) : 
			
			$results .= '<div id="issuem-featured-article-thumbs-imageholder">';
		
			$count = 1;
			/* start the loop */
			foreach( $featured_articles as $article ) {
				
				if ( has_post_thumbnail( $article->ID ) ) {
					
					$image = wp_get_attachment_image_src( get_post_thumbnail_id( $article->ID ), 'issuem-featured-thumb-image' );
					
					$results .= '<div class="issuem-featured-article-thumbs-image" style="width: ' . $image[1] .'px">';
					
						$results .= '<a href="' . get_permalink( $article->ID ) . '"><img src="' . $image[0] . '" width="' . $image[1] . '" height="' . $image[2] . '" alt="' . get_post_meta( $article->ID, '_teaser_text', true ) . '" /></a><br />';
						
						$results .= '<h3 class="featured-thumb-title"><a href="' . get_permalink( $article->ID ) . '">' . get_the_title( $article->ID ) . '</a></h3>';
	
						switch ( $content_type ) {
									
								case 'excerpt':
									$results .= '<span class="featured-thumb-content">' . get_the_excerpt() . '</span>';	
									break;
									
								case 'teaser':	
								default:					
									$results .= '<span class="featured-thumb-content">' . get_post_meta( $article->ID, '_teaser_text', true ) . '</span>';
									break;
									
						}
						
						if ( $issuem_settings['show_thumbnail_byline'] ) {
							
							$author_name = get_issuem_author_name( $article );
							
							$results .= '<span class="featured-thumb-byline">' . sprintf( __( 'By %s', 'issuem' ), apply_filters( 'issuem_author_name', $author_name, $article->ID ) ) . '</span>';
							
						}
						
					$results .= '</div>';
					
					if ( 0 != $max_images && $max_images <= $count )
						break;
						
					$count++;
					
				}
				
			}
			
			$results .= '</div>';
			
		endif;
		
		return $results;
		
	}
	add_shortcode( 'issuem_featured_thumbnails', 'do_issuem_featured_thumbs' );

}