<?php
/**
* Retrieves all portfolio media for provided project post. 
* @param $post_id int (optional) the project post id, if null pull from global $post
* @param $type string (optional) filter on type. possible values are: 'image', 'youtube', 'snippet' or 'text'
* @return array
*
* Example retrieve all project media:
* (usage in the loop @see http://codex.wordpress.org/The_Loop)
*
*		<?php while (have_posts()) : the_post(); ?>
*			<h1>Media</h1>
*			<ul>
*			<?php foreach (simple_portfolio_media() as $media): ?>
*				<li><?php print_r($media); ?></li>
*			<?php endforeach; ?>
*			</ul>
*		<?php endwhile; ?>
*
* Example retrieve typed media like Images and display them:
* (usage in the loop @see http://codex.wordpress.org/The_Loop)
*
*		<?php while (have_posts()) : the_post(); ?>
*			<?php foreach (simple_portfolio_media('image') as $image): ?>
*				<?php 
*					$src = wp_get_attachment_image_src($image['value'], 'full');
*					echo "<a href=\"$src[0]\">" . wp_get_attachment_image($image['value']) . "</a>";
*				?>
*			<?php endforeach; ?>
*		<?php endwhile; ?>
*
*/
function simple_portfolio_media(  $post_id = null, $type = null  ); 
 
/**
* Retrieves all portfolio general information for provided project post
* @param $post_id int (optional) the project post id, if null pull from global $post
* @return array
*
* Example: (usage in the loop @see http://codex.wordpress.org/The_Loop)
*		<?php while (have_posts()) : the_post(); ?>
*			<h1>Project Information</h1>
*			<ul>
*			<?php foreach (simple_portfolio_info() as $info): ?>
*				<li><?php echo $info; ?></li>
*			<?php endforeach; ?>
*			</ul>
*		<?php endwhile; ?>
*/
function simple_portfolio_info( $post_id = null ); 
 
/**
* Query projects. @see http://codex.wordpress.org/Function_Reference/query_posts
* You can use the loop from wordpress @see http://codex.wordpress.org/The_Loop after calling this method.
* @param $taxonomy string/array name of the taxonomy, possible values are: 'portfolio-clients', 'portfolio-categories' or 'portfolio-tags' (or combine multiple combinations in an array)
* @param $slug string slug of the taxonomy for filtering projects on taxonomy slug name.
* @return array
*
* Example:
* 		<?php simple_portfolio_query_projects(); ?>
*		<?php while (have_posts()) : the_post(); ?>
*			<h1><?php echo the_title(); ?></h1>
*			<?php the_content('Read more &raquo;'); ?>
*		<?php endwhile; ?>
*/
function simple_portfolio_query_projects( $taxonomy = null, $slug = null ); 
 
/**
* Retrieve projects in an array. When no arguments are applied, all projects will be returned. @see http://codex.wordpress.org/Function_Reference/get_posts
* @param $taxonomy string/array name of the taxonomy, possible values are: 'portfolio-clients', 'portfolio-categories' or 'portfolio-tags' (or combine multiple combinations in an array)
* @param $slug string slug of the taxonomy for filtering projects on taxonomy slug name.
* @return array
*
* Example:
*		<?php $commercial_projects = simple_portfolio_get_projects('portfolio-categories', 'commercial'); ?>
*
*		<ul>
*		<?php foreach ($commercial_projects as $post): ?>
*			<?php setup_postdata($post); ?>
*			<li>
*				<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
*				<?php the_content(); ?>
*			</li>
*		<?php endforeach; ?>
*		</ul>
*/
function simple_portfolio_get_projects( $taxonomy = null, $slug = null ); 
 
/**
* Is xml enabled? This way you can check easily if xml is enabled
* @return Boolean
* 
* Example check and show link to xml:
*		<?php if (simple_portfolio_xml_enabled()): ?>
*			<h1>You have enabled XML output</h1>
*			<?php $xml_url = get_site_url() . '/' . get_post_type_object('portfolio')->rewrite['slug'] . '.xml';
*			<a href="<?php echo $xml_url; ?>">View XML</a>
*		<?php endif; ?>
*/
function simple_portfolio_xml_enabled(); 
 
/**
* List clients. Echo the output directly.
* @param $post_id int (optional) the project post id. (default null which list all clients unrelated to a project post)
* @param $args array @see http://codex.wordpress.org/Template_Tags/wp_list_categories
*
* Example list all clients (even those who have no project posts):
*		<h1>Clients</h1>
*		<?php simple_portfolio_list_clients(null, array('hide_empty' => 0)); ?>
*
* Example usage in the loop @see http://codex.wordpress.org/The_Loop 
*		<?php while (have_posts()) : the_post(); ?>
*			<h1>Client(s)</h1>
*			<?php simple_portfolio_list_clients($post->ID); ?>
*		<?php endwhile; ?>	
*/
function simple_portfolio_list_clients( $post_id = null, $args = null ); 
 
/**
* Retrieve the clients as an array.
* @param $post_id int (optional) the project post id. (default null which list all clients unrelated to a project post)
* @param $args array @see http://codex.wordpress.org/Template_Tags/wp_list_categories
* @return array
*
* Example:
*		<?php $clients = simple_portfolio_get_clients($post->ID); ?>
*		There are <?php echo count($clients); ?> clients
*		<ul>
*			<?php foreach ($clients as $client): ?>
*				<li><a href="<?php echo $client->link; ?>"><?php echo $client->name; ?></a></li>
*			<?php endforeach; ?>
*		</ul>
*/
function simple_portfolio_get_clients( $post_id = null, $args = null ); 
 
/**
* List categories. Echo the output directly.
* @param $post_id int (optional) the project post id. (default null which list all categories unrelated to a project post)
* @param $args array @see http://codex.wordpress.org/Template_Tags/wp_list_categories
*
* Usage @see simple_portfolio_list_clients()
*/
function simple_portfolio_list_categories( $post_id = null, $args = null ); 
 
/**
* Retrieve the categories.
* @param $post_id int (optional) the project post id. (default null which list all categories unrelated to a project post)
* @param $args array @see http://codex.wordpress.org/Template_Tags/wp_list_categories
* @return array
*
* Usage @see simple_portfolio_get_clients()
*/
function simple_portfolio_get_categories( $post_id = null, $args = null ); 
 
/**
* List tags. Echo the output directly.
* @param $post_id int (optional) the project post id. (default null which list all tags unrelated to a project post)
* @param $args array @see http://codex.wordpress.org/Template_Tags/wp_list_categories
*
* Usage @see simple_portfolio_list_clients()
*/
function simple_portfolio_list_tags( $post_id = null, $args = null ); 
 
/**
* Retrieve the tags.
* @param $post_id int (optional) the project post id. (default null which list all tags unrelated to a project post)
* @param $args array @see http://codex.wordpress.org/Template_Tags/wp_list_categories
* @return array
*
* Usage @see simple_portfolio_get_clients()
*/
function simple_portfolio_get_tags( $post_id = null, $args = null ); 
?>