Source: mt-shortcodes.php

  1. <?php
  2. /**
  3.  * Shortcodes
  4.  *
  5.  * @category Display
  6.  * @package  My Tickets
  7.  * @author   Joe Dolson
  8.  * @license  GPLv3
  9.  * @link     https://www.joedolson.com/my-tickets/
  10.  */
  12. if ( ! defined( 'ABSPATH' ) ) {
  13. 	exit;
  14. } // Exit if accessed directly.
  16. add_shortcode( 'quick-cart', 'my_tickets_short_cart' );
  17. add_filter( 'universal_top_of_header', 'my_tickets_short_cart', 10, 1 );
  18. add_filter( 'milky_way_top_of_header', 'my_tickets_short_cart', 10, 1 );
  20. /**
  21.  * Shortcode to add quick cart to site. Shows current number of tickets and total value plus link to checkout.
  22.  *
  23.  * @return string
  24.  */
  25. function my_tickets_short_cart() {
  26. 	$options = mt_get_settings();
  27. 	$cart    = mt_get_cart();
  28. 	$total   = mt_total_cart( $cart );
  29. 	$tickets = mt_count_cart( $cart );
  30. 	// Translators: Number of tickets.
  31. 	$ticket_text  = apply_filters( 'mt_quick_cart_ticket_text', sprintf( _n( '%s ticket', '%s tickets', $tickets, 'my-tickets' ), "<span class='mt_qc_tickets'>$tickets</span>" ) );
  32. 	$url          = mt_get_cart_url();
  33. 	$symbol_order = $options['symbol_order'];
  34. 	if ( 'symbol-first' === $symbol_order ) {
  35. 		$currency = "<span class='mt_currency'>" . mt_symbols( $options['mt_currency'] ) . "</span><span class='mt_qc_total'>" . number_format( $total, 2 ) . '</span>';
  36. 	} else {
  37. 		$currency = "<span class='mt_qc_total'>" . number_format( $total, 2 ) . "</span> <span class='mt_currency'>" . mt_symbols( $options['mt_currency'] ) . '</span>';
  38. 	}
  39. 	// Translators: Checkout URL.
  40. 	$checkout = apply_filters( 'mt_quick_cart_checkout', sprintf( __( '<a href="%s">Checkout</a>', 'my-tickets' ), esc_url( $url ) ) );
  41. 	if ( $tickets < 1 && 'true' === $options['mt_hide_empty_short_cart'] ) {
  42. 		return '';
  43. 	}
  44. 	return "
  45. 		<div class='my-tickets mt-quick-cart' aria-live='polite'>" . __( 'In your cart: ', 'my-tickets' ) . "$ticket_text
  46. 			<span class='divider'>|</span> 
  47. 			$currency
  48. 			<span class='divider'>|</span> 
  49. 			$checkout
  50. 		</div>";
  51. }
  53. /**
  54.  * Shortcode to generate ticketing form. Required attribute: event="event_id"
  55.  *
  56.  * @param array  $atts Shortcode attributes.
  57.  * @param string $content Contained content.
  58.  *
  59.  * @return string
  60.  */
  61. function mt_add_to_cart_form_shortcode( $atts, $content = '' ) {
  62. 	$atts = shortcode_atts(
  63. 		array(
  64. 			'event'    => false,
  65. 			'view'     => 'calendar',
  66. 			'time'     => 'month',
  67. 			'location' => 'false',
  68. 		),
  69. 		$atts
  70. 	);
  72. 	$post_id  = mt_get_current_event();
  73. 	$event_id = ( isset( $atts['event'] ) && ! empty( $atts['event'] ) ) ? absint( $atts['event'] ) : $post_id;
  74. 	$return   = '';
  75. 	$location = '';
  76. 	if ( $event_id ) {
  77. 		$return = mt_add_to_cart_form( $content, $event_id, $atts['view'], $atts['time'], true );
  78. 		if ( 'false' !== $atts['location'] ) {
  79. 			$location = mt_get_ticket_venue( false, $event_id );
  80. 		}
  81. 		if ( 'before' === $atts['location'] || 'true' === $atts['location'] ) {
  82. 			$return = $location . $return;
  83. 		}
  84. 		if ( 'after' === $atts['location'] ) {
  85. 			$return = $return . $location;
  86. 		}
  88. 		return $return;
  89. 	}
  91. 	return $content;
  92. }
  93. add_shortcode( 'ticket', 'mt_add_to_cart_form_shortcode' );
  96. /**
  97.  * Shortcode to display event venue.
  98.  *
  99.  * @param array  $atts Shortcode attributes.
  100.  * @param string $content Contained content.
  101.  *
  102.  * @return string
  103.  */
  104. function mt_ticket_venue_shortcode( $atts, $content = '' ) {
  105. 	$atts = shortcode_atts(
  106. 		array(
  107. 			'event' => false,
  108. 		),
  109. 		$atts
  110. 	);
  112. 	$post_id  = mt_get_current_event();
  113. 	$event_id = isset( $atts['event'] ) ? absint( $atts['event'] ) : $post_id;
  114. 	if ( $event_id ) {
  115. 		$venue = mt_get_ticket_venue( false, $event_id );
  116. 	} else {
  117. 		$venue = $content;
  118. 	}
  120. 	return $venue;
  121. }
  122. add_shortcode( 'ticket_venue', 'mt_ticket_venue_shortcode' );
  124. /**
  125.  * Produce a list of featured tickets with a custom template and registration forms.
  126.  *
  127.  * @param array  $atts Shortcode attributes.
  128.  * @param string $content Contained content.
  129.  *
  130.  * @return string
  131.  */
  132. function mt_featured_tickets( $atts, $content = '' ) {
  133. 	$grouped = false;
  134. 	$atts    = shortcode_atts(
  135. 		array(
  136. 			'events'   => false,
  137. 			'group'    => false,
  138. 			'taxonomy' => 'mt-event-group',
  139. 			'view'     => 'calendar',
  140. 			'time'     => 'month',
  141. 			'template' => '<h3>{post_title}: {event_begin format="l, F d"}</h3><p>{post_excerpt}</p>',
  142. 		),
  143. 		$atts
  144. 	);
  145. 	if ( $atts['events'] ) {
  146. 		$events = explode( ',', $atts['events'] );
  147. 	} elseif ( $atts['group'] ) {
  148. 		if ( is_string( $atts['group'] ) ) {
  149. 			// Gets a group of events by taxonomy term.
  150. 			$events = mt_get_events_by_term( $atts['group'], $atts['taxonomy'] );
  151. 		}
  152. 		if ( is_numeric( $atts['group'] ) ) {
  153. 			// Gets a group of events by My Calendar event group ID.
  154. 			$events = mt_get_events_by_group_id( $atts['group'] );
  155. 		}
  156. 		$grouped = true;
  157. 	} else {
  158. 		/**
  159. 		 * Set an array of default event IDs to show in the [tickets] shortcode. Only runs if the 'events' shortcode attribute is false.
  160. 		 *
  161. 		 * @hook mt_default_ticketed_events
  162. 		 *
  163. 		 * @param {array} $events Array of event IDs.
  164. 		 * @param {array} $atts Shortcode attributes.
  165. 		 * @param {string} $content Shortcode contents.
  166. 		 *
  167. 		 * @return {array}
  168. 		 */
  169. 		$events = apply_filters( 'mt_default_ticketed_events', array(), $atts, $content );
  170. 	}
  171. 	$content = '';
  172. 	if ( is_array( $events ) && ! empty( $events ) ) {
  173. 		$group = false;
  174. 		if ( $grouped ) {
  175. 			$count = count( $events );
  176. 			$last  = $events[ $count - 1 ];
  177. 			$first = $events[0];
  178. 			$group = array(
  179. 				'first' => $first,
  180. 				'last'  => $last,
  181. 			);
  182. 		}
  183. 		foreach ( $events as $event ) {
  184. 			$event_data = get_post_meta( $event, '_mc_event_data', true );
  185. 			$post       = get_post( $event, ARRAY_A );
  186. 			if ( is_array( $post ) && is_array( $event_data ) ) {
  187. 				/**
  188. 				 * Filter the data used to draw event templates in the [tickets] shortcode.
  189. 				 *
  190. 				 * @hook mt_ticket_template_array
  191. 				 *
  192. 				 * @param {array} $data Merged array of stored event data and post object as array.
  193. 				 *
  194. 				 * @return {array}
  195. 				 */
  196. 				$data       = apply_filters( 'mt_ticket_template_array', array_merge( $event_data, $post ) );
  197. 				$event_data = "<div class='mt-event-details'>" . mt_draw_template( $data, $atts['template'] ) . '</div>';
  198. 				$content   .= "<div class='mt-event-item'>" . $event_data . mt_add_to_cart_form( '', $event, $atts['view'], $atts['time'], true, $group ) . '</div>';
  199. 			}
  200. 		}
  201. 	}
  203. 	return "<div class='mt-event-list'>" . $content . '</div>';
  204. }
  205. add_shortcode( 'tickets', 'mt_featured_tickets' );
  207. /**
  208.  * Display the number of tickets remaining for an event.
  209.  *
  210.  * @param array  $atts Shortcode attributes.
  211.  * @param string $content Contained content.
  212.  *
  213.  * @return string
  214.  */
  215. function mt_remaining_tickets( $atts, $content = '' ) {
  216. 	$atts     = shortcode_atts(
  217. 		array(
  218. 			'event'    => false,
  219. 			'template' => '<p>{remain} tickets left of {total}</p>',
  220. 		),
  221. 		$atts
  222. 	);
  223. 	$template = $atts['template'];
  225. 	if ( ! is_numeric( $atts['event'] ) ) {
  226. 		global $post;
  227. 		if ( is_object( $post ) ) {
  228. 			$event_id = $post->ID;
  229. 		} else {
  230. 			return $content;
  231. 		}
  232. 	} else {
  233. 		$event_id = (int) $atts['event'];
  234. 	}
  235. 	$registration = get_post_meta( $event_id, '_mt_registration_options', true );
  236. 	if ( is_array( $registration ) ) {
  237. 		$pricing      = $registration['prices'];
  238. 		$available    = $registration['total'];
  239. 		$tickets_data = mt_tickets_left( $pricing, $available );
  241. 		return '<div class="mt-remaining-tickets">' . mt_draw_template( $tickets_data, $template ) . '</div>';
  242. 	} else {
  243. 		return $content;
  244. 	}
  246. 	return $content;
  247. }
  248. add_shortcode( 'remaining', 'mt_remaining_tickets' );
  250. /**
  251.  * Add My Tickets data into the My Calendar templating array.
  252.  * Currently: `register` => Add to cart form;
  253.  *            `ticket_status` => Show if the event is sold out.
  254.  *            `tickets_available` => Show total number of tickets available.
  255.  *
  256.  * @param array  $e Array of My Calendar template values.
  257.  * @param object $event My Calendar event object.
  258.  *
  259.  * @return array
  260.  */
  261. function mt_add_shortcode( $e, $event ) {
  262. 	$e['register']          = mt_add_to_cart_form( '', $event->event_post );
  263. 	$e['ticket_status']     = mt_event_status( $event->event_post );
  264. 	$tickets_available      = mt_check_inventory( $event->event_post );
  265. 	$e['tickets_available'] = ( isset( $tickets_available['available'] ) ) ? '<span class="mc-tickets-available">' . $tickets_available['available'] . '</span>' : '';
  267. 	return $e;
  268. }
  269. // Add My Tickets tags into My Calendar templating for upcoming events lists, etc.
  270. add_filter( 'mc_filter_shortcodes', 'mt_add_shortcode', 5, 2 );
  272. /**
  273.  * Shortcode to output a user's purchases and tickets.
  274.  *
  275.  * @param array  $atts Array of shortcode attributes.
  276.  * @param string $content Contained content.
  277.  *
  278.  * @return string
  279.  */
  280. function mt_user_purchases( $atts, $content ) {
  281. 	$atts   = shortcode_atts(
  282. 		array(
  283. 			'user_id'    => false,
  284. 			'count'      => 10,
  285. 			'user_email' => '',
  286. 		),
  287. 		$atts
  288. 	);
  289. 	$output = mt_display_payments( $atts['user_id'], $atts['count'], $atts['user_email'] );
  291. 	return $output;
  292. }
  293. add_shortcode( 'my-payments', 'mt_user_purchases' );
  295. /**
  296.  * Fetch a user's payment history and output on the front-end.
  297.  *
  298.  * @param int    $user_id User ID.
  299.  * @param int    $count Number of payments to display by default.
  300.  * @param string $user_email User email. If provided, fetch payments by email supplied rather than user ID. Ignores User ID.
  301.  *
  302.  * @return string
  303.  */
  304. function mt_display_payments( $user_id = false, $count = 10, $user_email = '' ) {
  305. 	$output = '';
  306. 	if ( is_user_logged_in() ) {
  307. 		$user  = ( ! $user_id ) ? wp_get_current_user()->ID : $user_id;
  308. 		$count = ( ! $count ) ? 10 : absint( $count );
  309. 		if ( $user && ! $user_email ) {
  310. 			$payments = get_posts(
  311. 				array(
  312. 					'post_type'   => 'mt-payments',
  313. 					'post_status' => array( 'draft, publish' ),
  314. 					'author'      => $user,
  315. 					'numberposts' => $count,
  316. 				)
  317. 			);
  318. 		} elseif ( $user_email && is_email( $user_email ) ) {
  319. 			$payments = get_posts(
  320. 				array(
  321. 					'post_type'   => 'mt-payments',
  322. 					'post_status' => array( 'draft', 'publish' ),
  323. 					'numberposts' => $count,
  324. 					'meta_query'  => array(
  325. 						array(
  326. 							'key'     => 'email',
  327. 							'value'   => $user_email,
  328. 							'compare' => '=',
  329. 						),
  330. 					),
  331. 				)
  332. 			);
  333. 		} else {
  334. 			$payments = array();
  335. 		}
  336. 		if ( ! empty( $payments ) ) {
  337. 			$thead = '<table class="widefat mt-payments striped">
  338. 						<caption>' . __( 'Your Payments', 'my-tickets' ) . '</caption>
  339. 						<thead>
  340. 							<tr>
  341. 								<th scope="col">' . __( 'ID', 'my-tickets' ) . '</th>
  342. 								<th scope="col">' . __( 'Name', 'my-tickets' ) . '</th>
  343. 								<th scope="col">' . __( 'Date', 'my-tickets' ) . '</th>
  344. 								<th scope="col">' . __( 'Status', 'my-tickets' ) . '</th>
  345. 								<th scope="col">' . __( 'Details', 'my-tickets' ) . '</th>
  346. 							</tr>
  347. 						</thead>
  348. 						<tbody>';
  349. 			$tfoot = '</tbody>
  350. 				</table>';
  351. 			foreach ( $payments as $payment ) {
  352. 				$details  = '<div class="mt-payment-details">';
  353. 				$details .= mt_payment_data( $payment->ID, array( 'dispute', 'other', 'purchase', 'ticket' ) );
  354. 				$details .= '</div>';
  355. 				$classes  = implode( ' ', array( $payment->post_status, sanitize_title( get_post_meta( $payment->ID, '_is_paid', true ) ) ) );
  356. 				$output  .= '<tr class="' . $classes . '">
  357. 					<td>' . $payment->ID . '</td>
  358. 					<td>' . esc_html( get_the_title( $payment->ID ) ) . '</td>
  359. 					<td>' . get_the_date( 'Y-m-d H:i', $payment->ID ) . '</td>
  360. 					<td>' . mt_get_payment_status( $payment->ID ) . '</td>
  361. 					<td><button type="button" class="mt-show-payment-details" aria-expanded="false">' . __( 'Payment Details', 'my-tickets' ) . '</button>' . $details . '</td>
  362. 				</tr>';
  363. 			}
  364. 			$output = $thead . $output . $tfoot;
  365. 		}
  366. 	}
  368. 	return $output;
  369. }