Source: mt-templating.php

  1. <?php
  2. /**
  3.  * Ticket display template tags.
  4.  *
  5.  * @category Display
  6.  * @package  My Tickets
  7.  * @author   Joe Dolson
  8.  * @license  GPLv2 or later
  9.  * @link     https://www.joedolson.com/my-tickets/
  10.  */
  12. if ( ! defined( 'ABSPATH' ) ) {
  13. 	exit;
  14. } // Exit if accessed directly.
  16. require_once 'vendor/autoload.php';
  17. use chillerlan\QRCode\QRCode;
  18. use chillerlan\QRCode\QROptions;
  20. /**
  21.  * Get logo for display on receipts and tickets.
  22.  *
  23.  * @param array $args Custom arguments.
  24.  * @param int   $post_ID Post ID.
  25.  *
  26.  * @return string
  27.  */
  28. function mt_get_logo( $args = array(), $post_ID = false ) {
  29. 	$options = mt_get_settings();
  30. 	$ticket  = mt_get_ticket();
  31. 	if ( isset( $options['mt_ticket_image'] ) && 'event' === $options['mt_ticket_image'] && $ticket ) {
  32. 		// if event has post thumbnail, use that.
  33. 		if ( has_post_thumbnail( $ticket->ID ) ) {
  34. 			return get_the_post_thumbnail( $ticket->ID );
  35. 		}
  36. 	}
  37. 	if ( $post_ID && has_post_thumbnail( $post_ID ) ) {
  38. 		return get_the_post_thumbnail( $post_ID, 'my-tickets-logo' );
  39. 	}
  40. 	$args = array_merge(
  41. 		array(
  42. 			'alt'    => 'My Tickets',
  43. 			'class'  => 'default',
  44. 			'width'  => '',
  45. 			'height' => '',
  46. 		),
  47. 		$args
  48. 	);
  49. 	$atts = '';
  50. 	foreach ( $args as $att => $value ) {
  51. 		if ( '' !== trim( $value ) ) {
  52. 			$atts .= ' ' . esc_attr( $att ) . '=' . '"' . esc_attr( $value ) . '"';
  53. 		}
  54. 	}
  55. 	$img = "<img src='" . plugins_url( '/images/logo.png', __FILE__ ) . "' $atts />";
  57. 	return $img;
  58. }
  60. /**
  61.  * Get logo for display on receipts and tickets.
  62.  *
  63.  * @param array $args Custom arguments.
  64.  * @param int   $post_ID Post ID.
  65.  *
  66.  * @return void
  67.  */
  68. function mt_logo( $args = array(), $post_ID = false ) {
  69. 	echo wp_kses_post( mt_get_logo( $args, $post_ID ) );
  70. }
  72. // Template Functions for Receipts.
  73. /**
  74.  * Return formatted order data for receipt template.
  75.  *
  76.  * @return string
  77.  */
  78. function mt_get_cart_order() {
  79. 	$receipt = mt_get_receipt();
  80. 	if ( $receipt ) {
  81. 		$purchase = get_post_meta( $receipt->ID, '_purchased' );
  82. 		$data     = mt_format_purchase( $purchase, 'html', $receipt->ID );
  84. 		return $data;
  85. 	}
  87. 	return '';
  88. }
  90. /**
  91.  * Return formatted order data for receipt template.
  92.  *
  93.  * @return void
  94.  */
  95. function mt_cart_order() {
  96. 	echo wp_kses_post( mt_get_cart_order() );
  97. }
  99. /**
  100.  * Get ticket information for a given purchase as data.
  101.  *
  102.  * @return mixed bool/array Ticket IDs.
  103.  */
  104. function mt_get_payment_tickets() {
  105. 	$receipt = mt_get_receipt();
  106. 	if ( $receipt ) {
  107. 		$purchase = get_post_meta( $receipt->ID, '_purchased' );
  108. 		$id       = $receipt->ID;
  110. 		return mt_setup_tickets( $purchase, $id, 'ids' );
  111. 	}
  113. 	return false;
  114. }
  116. /**
  117.  * Return receipt ID.
  118.  *
  119.  * @return string
  120.  */
  121. function mt_get_receipt_id() {
  122. 	if ( isset( $_GET['receipt_id'] ) ) {
  123. 		$receipt_id = sanitize_text_field( $_GET['receipt_id'] );
  125. 		return $receipt_id;
  126. 	}
  127. }
  129. /**
  130.  * Return receipt ID.
  131.  *
  132.  * @return void
  133.  */
  134. function mt_receipt_id() {
  135. 	echo esc_html( mt_get_receipt_id() );
  136. }
  138. /**
  139.  * Get receipt's purchase ID
  140.  *
  141.  * @return integer
  142.  */
  143. function mt_get_receipt_purchase_id() {
  144. 	$purchase    = mt_get_receipt();
  145. 	$purchase_id = $purchase->ID;
  147. 	return $purchase_id;
  148. }
  150. /**
  151.  * Get receipt's purchase ID
  152.  *
  153.  * @return void
  154.  */
  155. function mt_receipt_purchase_id() {
  156. 	echo esc_html( mt_get_receipt_purchase_id() );
  157. }
  159. /**
  160.  * Get provided purchaser name from payment.
  161.  *
  162.  * @return string
  163.  */
  164. function mt_get_cart_purchaser() {
  165. 	$receipt = mt_get_receipt();
  166. 	if ( $receipt ) {
  167. 		$purchaser = get_the_title( $receipt->ID );
  169. 		return $purchaser;
  170. 	}
  172. 	return '';
  173. }
  175. /**
  176.  * Get provided purchaser name from payment.
  177.  *
  178.  * @return void
  179.  */
  180. function mt_cart_purchaser() {
  181. 	echo esc_html( mt_get_cart_purchaser() );
  182. }
  184. /**
  185.  * Get formatted date/time of purchase.
  186.  *
  187.  * @return string
  188.  */
  189. function mt_get_cart_purchase_date() {
  190. 	$receipt = mt_get_receipt();
  191. 	if ( $receipt ) {
  192. 		/**
  193. 		 * HTML formatting of purchase date on receipts.
  194. 		 *
  195. 		 * @hook mt_cart_purchase_date
  196. 		 *
  197. 		 * @param {string} $format HTML formatted string with date format placeholders.
  198. 		 *
  199. 		 * @return {string}
  200. 		 */
  201. 		$format = apply_filters( 'mt_cart_purchase_date', '<span class="mt-cart-date">' . get_option( 'date_format' ) . '</span><span class="mt-date-separator"> @ </span><span class="mt-cart-time">' . get_option( 'time_format' ) . '</span>' );
  202. 		$date   = date_i18n( $format, strtotime( $receipt->post_date ) );
  204. 		return $date;
  205. 	}
  207. 	return '';
  208. }
  210. /**
  211.  * Get formatted date/time of purchase.
  212.  *
  213.  * @return void
  214.  */
  215. function mt_cart_purchase_date() {
  216. 	echo wp_kses_post( mt_get_cart_purchase_date() );
  217. }
  219. /**
  220.  * Get payment gateway data from payment.
  221.  *
  222.  * @return string
  223.  */
  224. function mt_get_payment_details() {
  225. 	$receipt = mt_get_receipt();
  226. 	if ( $receipt ) {
  227. 		$paid = get_post_meta( $receipt->ID, '_is_paid', true );
  228. 		if ( 'Completed' === $paid ) {
  229. 			$gateway       = get_post_meta( $receipt->ID, '_gateway', true );
  230. 			$gateways      = mt_setup_gateways();
  231. 			$gateway_label = isset( $gateways[ $gateway ] ) ? $gateways[ $gateway ]['label'] : $gateway;
  232. 			$transaction   = get_post_meta( $receipt->ID, '_transaction_id', true );
  233. 			$total         = get_post_meta( $receipt->ID, '_total_paid', true );
  234. 			$hand_total    = get_post_meta( $receipt->ID, '_mt_handling', true );
  235. 			$handling      = ( $hand_total ) ? '<li>' . __( 'Handling:', 'my-tickets' ) . ' ' . apply_filters( 'mt_money_format', $hand_total ) . '</li>' : '';
  236. 			$ship_total    = get_post_meta( $receipt->ID, '_mt_shipping', true );
  237. 			$shipping      = ( $ship_total ) ? '<li>' . __( 'Shipping:', 'my-tickets' ) . ' ' . apply_filters( 'mt_money_format', $ship_total ) . '</li>' : '';
  238. 			$vat           = get_post_meta( $receipt->ID, '_vat', true );
  239. 			// Translators: VAT ID.
  240. 			$vat     = ( $vat ) ? '<li>' . sprintf( __( 'VAT Number: %s', 'my-tickets' ), '<code>' . $vat . '</code>' ) . '</li>' : '';
  241. 			$return  = __( 'This receipt is paid in full.', 'my-tickets' );
  242. 			$return .= '
  243. 		<ul>
  244. 			<li>' . __( 'Payment through:', 'my-tickets' ) . " $gateway_label</li>
  245. 			<li>" . __( 'Transaction ID:', 'my-tickets' ) . " <code>$transaction</code></li>
  246. 			$handling
  247. 			$shipping
  248. 			<li>" . __( 'Amount Paid:', 'my-tickets' ) . ' ' . apply_filters( 'mt_money_format', $total ) . "</li>
  249. 			$vat
  250. 		</ul>";
  252. 			return $return;
  253. 		} elseif ( 'Refunded' === $paid ) {
  254. 			return __( 'This payment has been refunded.', 'my-tickets' );
  255. 		} elseif ( 'Failed' === $paid ) {
  256. 			return __( 'Payment on this order failed.', 'my-tickets' );
  257. 		} elseif ( 'Turned Back' === $paid ) {
  258. 			return __( 'This purchase was cancelled and the tickets were returned to the seller.', 'my-tickets' );
  259. 		} else {
  260. 			$due = get_post_meta( $receipt->ID, '_total_paid', true );
  261. 			$due = apply_filters( 'mt_money_format', $due );
  262. 			// Translators: Amount due on this payment.
  263. 			return __( 'Payment on this purchase is not completed. The receipt will be updated with payment details when payment is completed.', 'my-tickets' ) . ' ' . sprintf( __( 'Amount due: %s', 'my-tickets' ), '<strong>' . $due . '</strong>' );
  264. 		}
  265. 	}
  267. 	return '';
  268. }
  270. /**
  271.  * Get payment gateway data from payment.
  272.  *
  273.  * @return void
  274.  */
  275. function mt_payment_details() {
  276. 	echo wp_kses_post( mt_get_payment_details() );
  277. }
  279. /**
  280.  * Get ticket ID (must be used in ticket template.)
  281.  *
  282.  * @return string
  283.  */
  284. function mt_get_ticket_id() {
  285. 	$ticket_id = ( isset( $_GET['ticket_id'] ) ) ? sanitize_text_field( $_GET['ticket_id'] ) : false;
  287. 	return $ticket_id;
  288. }
  290. /**
  291.  * Get ticket ID (must be used in ticket template.)
  292.  *
  293.  * @return void
  294.  */
  295. function mt_ticket_id() {
  296. 	echo esc_html( mt_get_ticket_id() );
  297. }
  299. /**
  300.  * Get sequential ticket ID for display purposes.
  301.  *
  302.  * @param string $ticket_id Unique ticket ID.
  303.  *
  304.  * @return string sequential ID
  305.  */
  306. function mt_get_sequential_id( $ticket_id = false ) {
  307. 	$ticket_id  = ( $ticket_id ) ? $ticket_id : mt_get_ticket_id();
  308. 	$ticket     = mt_get_ticket( $ticket_id );
  309. 	$sequential = get_post_meta( $ticket->ID, '_' . $ticket_id . '_seq_id', true );
  310. 	if ( ! $sequential ) {
  311. 		$sequential = mt_generate_sequential_id( $ticket_id, array( 'event_id' => $ticket->ID ) );
  312. 	}
  314. 	return zeroise( $sequential, 6 );
  315. }
  317. /**
  318.  * Echo sequential ticket ID (must be used in ticket template.)
  319.  *
  320.  * @return void
  321.  */
  322. function mt_sequential_id() {
  323. 	echo esc_html( mt_get_sequential_id() );
  324. }
  326. /**
  327.  * Get ticket method (willcall, postal, eticket, printable)
  328.  *
  329.  * @param bool|int $ticket_id Ticket ID.
  330.  *
  331.  * @return mixed|string
  332.  */
  333. function mt_get_ticket_method( $ticket_id = false ) {
  334. 	if ( ! $ticket_id ) {
  335. 		$ticket_id = mt_get_ticket_id();
  336. 	}
  337. 	$purchase    = get_post_meta( mt_get_ticket( $ticket_id )->ID, '_' . $ticket_id, true );
  338. 	$purchase_id = $purchase['purchase_id'];
  339. 	$ticket_type = get_post_meta( $purchase_id, '_ticketing_method', true );
  340. 	$ticket_type = ( $ticket_type ) ? $ticket_type : 'willcall';
  342. 	return $ticket_type;
  343. }
  345. /**
  346.  * Get ticket method (willcall, postal, eticket, printable)
  347.  *
  348.  * @param bool|int $ticket_id Ticket ID.
  349.  *
  350.  * @return void
  351.  */
  352. function mt_ticket_method( $ticket_id = false ) {
  353. 	echo esc_html( mt_get_ticket_method( $ticket_id ) );
  354. }
  356. /**
  357.  * Get ticket's parent purchase ID
  358.  *
  359.  * @param bool|int $ticket_id Ticket ID.
  360.  *
  361.  * @return integer
  362.  */
  363. function mt_get_ticket_purchase_id( $ticket_id = false ) {
  364. 	if ( ! $ticket_id ) {
  365. 		$ticket_id = mt_get_ticket_id();
  366. 	}
  367. 	$purchase    = get_post_meta( mt_get_ticket( $ticket_id )->ID, '_' . $ticket_id, true );
  368. 	$purchase_id = $purchase['purchase_id'];
  370. 	return $purchase_id;
  371. }
  373. /**
  374.  * Get ticket's parent purchase ID
  375.  *
  376.  * @param bool|int $ticket_id Ticket ID.
  377.  *
  378.  * @return void
  379.  */
  380. function mt_ticket_purchase_id( $ticket_id = false ) {
  381. 	echo esc_html( mt_get_ticket_purchase_id( $ticket_id ) );
  382. }
  384. /**
  385.  * Get ticket purchaser name
  386.  *
  387.  * @param bool|int $ticket_id Ticket ID.
  388.  *
  389.  * @return mixed|string
  390.  */
  391. function mt_get_ticket_purchaser( $ticket_id = false ) {
  392. 	if ( ! $ticket_id ) {
  393. 		$ticket_id = mt_get_ticket_id();
  394. 	}
  395. 	$purchase    = get_post_meta( mt_get_ticket( $ticket_id )->ID, '_' . $ticket_id, true );
  396. 	$purchase_id = $purchase['purchase_id'];
  397. 	$purchaser   = get_post_field( 'post_title', $purchase_id );
  399. 	return $purchaser;
  400. }
  402. /**
  403.  * Get ticket purchaser name
  404.  *
  405.  * @param bool|int $ticket_id Ticket ID.
  406.  *
  407.  * @return void
  408.  */
  409. function mt_ticket_purchaser( $ticket_id = false ) {
  410. 	echo esc_html( mt_get_ticket_purchaser( $ticket_id ) );
  411. }
  413. /**
  414.  * Get custom field data; all by default, or only a specific field. Display in tickets.
  415.  *
  416.  * @param bool|string $custom_field Custom Field Name.
  417.  * @param bool|string $ticket_id Ticket ID.
  418.  *
  419.  * @return string
  420.  */
  421. function mt_get_ticket_custom_fields( $custom_field = false, $ticket_id = false ) {
  422. 	if ( ! $ticket_id ) {
  423. 		$ticket_id = mt_get_ticket_id();
  424. 	}
  425. 	$purchase    = get_post_meta( mt_get_ticket( $ticket_id )->ID, '_' . $ticket_id, true );
  426. 	$purchase_id = $purchase['purchase_id'];
  428. 	return mt_show_custom_data( $purchase_id, $custom_field );
  429. }
  431. /**
  432.  * Get custom field data; all by default, or only a specific field. Display in tickets.
  433.  *
  434.  * @param bool|string $custom_field Custom Field Name.
  435.  * @param bool|string $ticket_id Ticket ID.
  436.  *
  437.  * @return void
  438.  */
  439. function mt_ticket_custom_fields( $custom_field = false, $ticket_id = false ) {
  440. 	echo wp_kses_post( mt_get_ticket_custom_fields( $custom_field, $ticket_id ) );
  441. }
  443. /**
  444.  * Get date & time of event this ticket is for.
  445.  *
  446.  * @param bool|string $ticket_id Ticket ID.
  447.  *
  448.  * @return string
  449.  */
  450. function mt_get_event_date_time( $ticket_id = false ) {
  451. 	if ( ! $ticket_id ) {
  452. 		$ticket = mt_get_ticket();
  453. 	} else {
  454. 		$ticket = mt_get_ticket( $ticket_id );
  455. 	}
  456. 	if ( $ticket ) {
  457. 		$event_type = mt_get_event_type( $ticket_id );
  458. 		if ( 'event' === $event_type ) {
  459. 			return '';
  460. 		}
  461. 		$event = get_post_meta( $ticket->ID, '_mc_event_data', true );
  462. 		$date  = isset( $event['event_begin'] ) ? $event['event_begin'] : '';
  463. 		$date  = date_i18n( get_option( 'date_format' ), strtotime( $date ) );
  464. 		$time  = mt_get_event_time( $ticket_id );
  466. 		return ( $time ) ? $date . ' @ <span class="time">' . $time . '</span>' : $date;
  467. 	}
  469. 	return '';
  470. }
  472. /**
  473.  * Get date and time of event this ticket is for.
  474.  *
  475.  * @param bool|string $ticket_id Ticket ID.
  476.  *
  477.  * @return void
  478.  */
  479. function mt_event_date_time( $ticket_id = false ) {
  480. 	echo wp_kses_post( mt_get_event_date_time( $ticket_id ) );
  481. }
  483. /**
  484.  * Get date of event this ticket is for.
  485.  *
  486.  * @param bool|string $ticket_id Ticket ID.
  487.  *
  488.  * @return string
  489.  */
  490. function mt_get_event_date( $ticket_id = false ) {
  491. 	if ( ! $ticket_id ) {
  492. 		$ticket = mt_get_ticket();
  493. 	} else {
  494. 		$ticket = mt_get_ticket( $ticket_id );
  495. 	}
  496. 	if ( $ticket ) {
  497. 		$event_type = mt_get_event_type( $ticket_id );
  498. 		if ( 'event' === $event_type ) {
  499. 			return '';
  500. 		}
  501. 		$event = get_post_meta( $ticket->ID, '_mc_event_data', true );
  502. 		$date  = isset( $event['event_begin'] ) ? $event['event_begin'] : '';
  503. 		$date  = date_i18n( get_option( 'date_format' ), strtotime( $date ) );
  505. 		return $date;
  506. 	}
  508. 	return '';
  509. }
  511. /**
  512.  * Get date of event this ticket is for.
  513.  *
  514.  * @param bool|string $ticket_id Ticket ID.
  515.  *
  516.  * @return void
  517.  */
  518. function mt_event_date( $ticket_id = false ) {
  519. 	echo wp_kses_post( mt_get_event_date( $ticket_id ) );
  520. }
  522. /**
  523.  *  Get event notes.
  524.  *
  525.  * @param bool|string $ticket_id Ticket ID.
  526.  *
  527.  * @return string
  528.  */
  529. function mt_get_ticket_event_notes( $ticket_id = false ) {
  530. 	if ( ! $ticket_id ) {
  531. 		$ticket = mt_get_ticket();
  532. 	} else {
  533. 		$ticket = mt_get_ticket( $ticket_id );
  534. 	}
  535. 	$notes = wpautop( get_post_meta( $ticket->ID, '_mt_event_notes', true ) );
  537. 	return $notes;
  538. }
  540. /**
  541.  * Echo event notes.
  542.  *
  543.  * @param bool|string $ticket_id Ticket ID.
  544.  */
  545. function mt_ticket_event_notes( $ticket_id = false ) {
  546. 	echo wp_kses_post( mt_get_ticket_event_notes( $ticket_id ) );
  547. }
  549. /**
  550.  * Get title of event this ticket is for.
  551.  *
  552.  * @param bool|string $ticket_id Ticket ID.
  553.  *
  554.  * @return string
  555.  */
  556. function mt_get_event_title( $ticket_id = false ) {
  557. 	if ( ! $ticket_id ) {
  558. 		$ticket = mt_get_ticket();
  559. 	} else {
  560. 		$ticket = mt_get_ticket( $ticket_id );
  561. 	}
  562. 	if ( $ticket ) {
  563. 		/**
  564. 		 * Filter the event title as shown on tickets.
  565. 		 *
  566. 		 * @hook mt_the_title
  567. 		 *
  568. 		 * @param {string} $post_title The event title.
  569. 		 * @param {object} $ticket The ticket object.
  570. 		 *
  571. 		 * @return {string}
  572. 		 */
  573. 		$title = apply_filters( 'the_title', apply_filters( 'mt_the_title', $ticket->post_title, $ticket ), $ticket_id );
  575. 		return $title;
  576. 	}
  578. 	return '';
  579. }
  581. /**
  582.  * Get title of event this ticket is for.
  583.  *
  584.  * @param bool|string $ticket_id Ticket ID.
  585.  *
  586.  * @return void
  587.  */
  588. function mt_event_title( $ticket_id = false ) {
  589. 	echo wp_kses_post( mt_get_event_title( $ticket_id ) );
  590. }
  592. /**
  593.  * Get time of event this ticket is for.
  594.  *
  595.  * @param bool|string $ticket_id Ticket ID.
  596.  *
  597.  * @return string
  598.  */
  599. function mt_get_event_time( $ticket_id = false ) {
  600. 	if ( ! $ticket_id ) {
  601. 		$ticket = mt_get_ticket();
  602. 	} else {
  603. 		$ticket = mt_get_ticket( $ticket_id );
  604. 	}
  605. 	if ( $ticket ) {
  606. 		$event_type = mt_get_event_type( $ticket_id );
  607. 		if ( 'event' === $event_type ) {
  608. 			return '';
  609. 		}
  610. 		$event  = get_post_meta( $ticket->ID, '_mc_event_data', true );
  611. 		$time   = isset( $event['event_time'] ) ? $event['event_time'] : '';
  612. 		$allday = ( isset( $event['event_endtime'] ) && '23:59:59' === $event['event_endtime'] || '23:59:59' === $time ) ? true : false;
  613. 		$time   = ( $allday ) ? false : $time;
  614. 		if ( $time ) {
  615. 			$time = date_i18n( get_option( 'time_format' ), strtotime( $time ) );
  616. 		}
  618. 		return $time;
  619. 	}
  621. 	return '';
  622. }
  624. /**
  625.  * Get time of event this ticket is for.
  626.  *
  627.  * @param bool|string $ticket_id Ticket ID.
  628.  *
  629.  * @return void
  630.  */
  631. function mt_event_time( $ticket_id = false ) {
  632. 	echo esc_html( mt_get_event_time( $ticket_id ) );
  633. }
  636. /**
  637.  * Get type of event tickets. (discrete, continuous, event).
  638.  *
  639.  * @param bool|string $ticket_id Ticket ID.
  640.  *
  641.  * @return mixed|string
  642.  */
  643. function mt_get_event_type( $ticket_id = false ) {
  644. 	if ( ! $ticket_id ) {
  645. 		$ticket    = mt_get_ticket();
  646. 		$ticket_id = mt_get_ticket_id();
  647. 	} else {
  648. 		$ticket = mt_get_ticket( $ticket_id );
  649. 	}
  650. 	if ( $ticket ) {
  651. 		$options = get_post_meta( $ticket->ID, '_mt_registration_options', true );
  652. 		$method  = ( ! empty( $options ) && is_array( $options ) ) ? $options['counting_method'] : '';
  654. 		return $method;
  655. 	}
  657. 	return '';
  658. }
  660. /**
  661.  * Get type of event tickets. (discrete, continuous, event).
  662.  *
  663.  * @param bool|string $ticket_id Ticket ID.
  664.  *
  665.  * @return void
  666.  */
  667. function mt_event_type( $ticket_id = false ) {
  668. 	echo esc_html( mt_get_event_type( $ticket_id ) );
  669. }
  671. /**
  672.  * Get type of ticket. (Adult, child, section 1, section 2, etc.)
  673.  *
  674.  * @param bool|string $ticket_id Ticket ID.
  675.  *
  676.  * @return mixed|string
  677.  */
  678. function mt_get_ticket_type( $ticket_id = false ) {
  679. 	if ( ! $ticket_id ) {
  680. 		$ticket    = mt_get_ticket();
  681. 		$ticket_id = mt_get_ticket_id();
  682. 	} else {
  683. 		$ticket = mt_get_ticket( $ticket_id );
  684. 	}
  685. 	if ( $ticket ) {
  686. 		$type  = get_post_meta( $ticket->ID, '_' . $ticket_id, true );
  687. 		$type  = isset( $type['type'] ) ? $type['type'] : '';
  688. 		$label = mt_get_label( $type, $ticket->ID );
  690. 		$event_type = mt_get_event_type( $ticket_id );
  691. 		if ( 'event' === $event_type ) {
  692. 			$date = get_option( 'date_format', 'Y-m-d' );
  693. 			$time = get_option( 'time_format', 'H:i' );
  694. 			if ( $label === $type ) {
  695. 				// convert to a proper timestamp.
  696. 				$label = substr_replace( $type, ' ', 10, 1 );
  697. 			}
  698. 			return date_i18n( $date . ' @ ' . $time, strtotime( $label ) );
  699. 		}
  700. 		/**
  701. 		 * Filter the ticket type label shown on tickets.
  702. 		 *
  703. 		 * @hook mt_ticket_type
  704. 		 *
  705. 		 * @param {string} $label Label defined from settings.
  706. 		 * @param {string} $type Ticket type key.
  707. 		 *
  708. 		 * @return {string}
  709. 		 */
  710. 		return apply_filters( 'mt_ticket_type', $label, $type );
  711. 	}
  713. 	return '';
  714. }
  716. /**
  717.  * Get type of ticket. (Adult, child, section 1, section 2, etc.)
  718.  *
  719.  * @param bool|string $ticket_id Ticket ID.
  720.  *
  721.  * @return void
  722.  */
  723. function mt_ticket_type( $ticket_id = false ) {
  724. 	echo esc_html( mt_get_ticket_type( $ticket_id ) );
  725. }
  727. /**
  728.  * Get ticket price for ticket.
  729.  *
  730.  * @param bool|string $ticket_id Ticket ID.
  731.  *
  732.  * @return string
  733.  */
  734. function mt_get_ticket_price( $ticket_id = false ) {
  735. 	if ( ! $ticket_id ) {
  736. 		$ticket    = mt_get_ticket();
  737. 		$ticket_id = mt_get_ticket_id();
  738. 	} else {
  739. 		$ticket = mt_get_ticket( $ticket_id );
  740. 	}
  741. 	$append = ': <em>' . __( 'Paid', 'my-tickets' ) . '</em>';
  742. 	if ( $ticket ) {
  743. 		$data    = get_post_meta( $ticket->ID, '_' . $ticket_id, true );
  744. 		$receipt = $data['purchase_id'];
  745. 		$paid    = get_post_meta( $receipt, '_is_paid', true );
  746. 		if ( 'Completed' !== $paid ) {
  747. 			$append = ': <em>' . __( 'Payment Due', 'my-tickets' ) . '</em>';
  748. 		}
  750. 		$type = apply_filters( 'mt_money_format', $data['price'] );
  752. 		return $type . $append;
  753. 	}
  755. 	return '';
  756. }
  758. /**
  759.  * Get ticket price for ticket.
  760.  *
  761.  * @param bool|string $ticket_id Ticket ID.
  762.  *
  763.  * @return void
  764.  */
  765. function mt_ticket_price( $ticket_id = false ) {
  766. 	echo wp_kses_post( mt_get_ticket_price( $ticket_id ) );
  767. }
  769. /**
  770.  * Return image URL for printable/eticket QR codes.
  771.  *
  772.  * @param bool|string $ticket_id Ticket ID.
  773.  */
  774. function mt_get_ticket_qrcode( $ticket_id = false ) {
  775. 	$options   = mt_get_settings();
  776. 	$id        = ( '' !== $options['mt_purchase_page'] && is_numeric( $options['mt_purchase_page'] ) ) ? absint( $options['mt_purchase_page'] ) : false;
  777. 	$ticket_id = ( $ticket_id ) ? $ticket_id : mt_get_ticket_id();
  778. 	$url       = esc_url_raw(
  779. 		add_query_arg(
  780. 			array(
  781. 				'ticket_id' => $ticket_id,
  782. 				'action'    => 'mt-verify',
  783. 			),
  784. 			get_permalink( $id )
  785. 		)
  786. 	);
  787. 	$qrcode    = array(
  788. 		'version'    => 9,
  789. 		'outputType' => QRCODE::OUTPUT_IMAGE_PNG,
  790. 		'eccLevel'   => QRCODE::ECC_M,
  791. 	);
  792. 	/**
  793. 	 * Filter QRCode configuration options passed to QROptions. See https://github.com/chillerlan/php-qrcode/wiki/Advanced-usage.
  794. 	 *
  795. 	 * @hook mt_qrcode_options
  796. 	 *
  797. 	 * @param {array} $qrcode Array of configuration options.
  798. 	 * @param {string} $ticket_id ID of the current ticket.
  799. 	 *
  800. 	 * @return {array}
  801. 	 */
  802. 	$qrcode  = apply_filters( 'mt_qrcode_options', $qrcode, $ticket_id );
  803. 	$options = new QROptions( $qrcode );
  804. 	$code    = new QRCode( $options );
  805. 	return $code->render( esc_url_raw( $url ) );
  806. }
  808. /**
  809.  * Return image URL for printable/eticket QR codes.
  810.  *
  811.  * @param bool|string $ticket_id Ticket ID.
  812.  */
  813. function mt_ticket_qrcode( $ticket_id = false ) {
  814. 	echo esc_attr( mt_get_ticket_qrcode( $ticket_id ) );
  815. }
  817. /**
  818.  * Return image URL for printable/eticket QR codes.
  819.  *
  820.  * @param bool|string $receipt_id Receipt ID.
  821.  */
  822. function mt_get_purchase_qrcode( $receipt_id = false ) {
  823. 	$options    = mt_get_settings();
  824. 	$id         = ( '' !== $options['mt_purchase_page'] && is_numeric( $options['mt_purchase_page'] ) ) ? absint( $options['mt_purchase_page'] ) : false;
  825. 	$receipt_id = ( $receipt_id ) ? $receipt_id : mt_get_receipt_id();
  826. 	$url        = esc_url_raw(
  827. 		add_query_arg(
  828. 			array(
  829. 				'receipt_id' => $receipt_id,
  830. 				'action'     => 'mt-verify',
  831. 			),
  832. 			get_permalink( $id )
  833. 		)
  834. 	);
  835. 	$qrcode     = array(
  836. 		'version'    => 9,
  837. 		'outputType' => QRCODE::OUTPUT_IMAGE_PNG,
  838. 		'eccLevel'   => QRCODE::ECC_M,
  839. 	);
  840. 	/**
  841. 	 * Filter QRCode configuration options passed to QROptions. See https://github.com/chillerlan/php-qrcode/wiki/Advanced-usage.
  842. 	 *
  843. 	 * @hook mt_qrcode_options
  844. 	 *
  845. 	 * @param {array} $qrcode Array of configuration options.
  846. 	 * @param {string} $ticket_id ID of the current ticket.
  847. 	 *
  848. 	 * @return {array}
  849. 	 */
  850. 	$qrcode  = apply_filters( 'mt_qrcode_options', $qrcode, $receipt_id );
  851. 	$options = new QROptions( $qrcode );
  852. 	$code    = new QRCode( $options );
  853. 	return $code->render( esc_url_raw( $url ) );
  854. }
  856. /**
  857.  * Return image URL for printable/eticket QR codes.
  858.  *
  859.  * @param bool|string $receipt_id Receipt ID.
  860.  */
  861. function mt_purchase_qrcode( $receipt_id = false ) {
  862. 	echo esc_attr( mt_get_purchase_qrcode( $receipt_id ) );
  863. }
  865. /**
  866.  * Get ticket venue location data.
  867.  *
  868.  * @param bool|string $ticket_id Ticket ID.
  869.  * @param bool|int    $event_id Event ID.
  870.  *
  871.  * @uses filter mt_create_location_object
  872.  *
  873.  * @return string
  874.  */
  875. function mt_get_ticket_venue( $ticket_id = false, $event_id = false ) {
  876. 	if ( ! $ticket_id ) {
  877. 		$ticket = mt_get_ticket();
  878. 	} else {
  879. 		$ticket = mt_get_ticket( $ticket_id );
  880. 	}
  881. 	$event_id = ( $ticket ) ? $ticket->ID : $event_id;
  882. 	if ( $event_id ) {
  883. 		$location_id = get_post_meta( $event_id, '_mc_event_location', true );
  884. 		$html        = false;
  885. 		if ( $location_id ) {
  886. 			/**
  887. 			 * Filter location objects saved with events. Expects a My Calendar structured location object.
  888. 			 *
  889. 			 * @hook mt_create_location_object
  890. 			 *
  891. 			 * @param {false} $location Default location object.
  892. 			 * @param {int}   $location_id ID value saved in post meta _mc_event_location.
  893. 			 *
  894. 			 * @return {object|false}
  895. 			 */
  896. 			$location = apply_filters( 'mt_create_location_object', false, $location_id );
  897. 			if ( ! $location ) {
  898. 				return '';
  899. 			} else {
  900. 				$html = mt_hcard( $location, true );
  901. 			}
  902. 		}
  903. 		/**
  904. 		 * Filter the hcard output in My Tickets.
  905. 		 *
  906. 		 * @hook mt_hcard
  907. 		 *
  908. 		 * @param {string} $html HTML output of an hCard.
  909. 		 * @param {int}    $location_id Location ID.
  910. 		 * @param {object} $ticket Ticket object.
  911. 		 * @param {int}    $event_id Event ID.
  912. 		 *
  913. 		 * @return {string}
  914. 		 */
  915. 		$html = apply_filters( 'mt_hcard', $html, $location_id, $ticket, $event_id );
  916. 		if ( $html ) {
  917. 			return $html;
  918. 		}
  919. 	}
  921. 	return '';
  922. }
  924. add_filter( 'mt_create_location_object', 'mt_get_mc_location', 10, 2 );
  925. /**
  926.  * If My Calendar installed, return My Calendar location object.
  927.  *
  928.  * @param Object $location Location object.
  929.  * @param int    $location_id Location ID.
  930.  *
  931.  * @return mixed
  932.  */
  933. function mt_get_mc_location( $location, $location_id ) {
  934. 	if ( function_exists( 'mc_hcard' ) ) {
  935. 		global $wpdb;
  936. 		$location = $wpdb->get_row( $wpdb->prepare( 'SELECT * FROM ' . my_calendar_locations_table() . ' WHERE location_id = %d', $location_id ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
  937. 	}
  939. 	return $location;
  940. }
  942. // set up hCard formatted address.
  943. /**
  944.  * Produce HTML for My Tickets hCard.
  945.  *
  946.  * @param object $location Location object.
  947.  *
  948.  * @return string
  949.  */
  950. function mt_hcard( $location ) {
  951. 	$url     = trim( $location->location_url );
  952. 	$label   = trim( stripslashes( $location->location_label ) );
  953. 	$street  = trim( stripslashes( $location->location_street ) );
  954. 	$street2 = trim( stripslashes( $location->location_street2 ) );
  955. 	$city    = trim( stripslashes( $location->location_city ) );
  956. 	$state   = trim( stripslashes( $location->location_state ) );
  957. 	$zip     = trim( stripslashes( $location->location_postcode ) );
  958. 	$country = trim( stripslashes( $location->location_country ) );
  959. 	$phone   = trim( stripslashes( $location->location_phone ) );
  960. 	if ( ! $url && ! $label && ! $street && ! $street2 && ! $city && ! $state && ! $zip && ! $country && ! $phone ) {
  961. 		return '';
  962. 	}
  963. 	$link   = ( '' !== $url ) ? "<a href='$url' class='location-link external'>$label</a>" : $label;
  964. 	$hcard  = '<div class="address vcard">';
  965. 	$hcard .= '<div class="adr">';
  966. 	$hcard .= ( '' !== $label ) ? '<strong class="org">' . $link . '</strong><br />' : '';
  967. 	$hcard .= ( '' === $street . $street2 . $city . $state . $zip . $country . $phone ) ? '' : "<div class='sub-address'>";
  968. 	$hcard .= ( '' !== $street ) ? '<div class="street-address">' . $street . '</div>' : '';
  969. 	$hcard .= ( '' !== $street2 ) ? '<div class="street-address">' . $street2 . '</div>' : '';
  970. 	$hcard .= ( '' !== $city . $state . $zip ) ? '<div>' : '';
  971. 	$hcard .= ( '' !== $city ) ? '<span class="locality">' . $city . "</span><span class='sep'>, </span>" : '';
  972. 	$hcard .= ( '' !== $state ) ? '<span class="region">' . $state . '</span> ' : '';
  973. 	$hcard .= ( '' !== $zip ) ? ' <span class="postal-code">' . $zip . '</span>' : '';
  974. 	$hcard .= ( '' !== $city . $state . $zip ) ? '</div>' : '';
  975. 	$hcard .= ( '' !== $country ) ? '<div class="country-name">' . $country . '</div>' : '';
  976. 	$hcard .= ( '' !== $phone ) ? '<div class="tel">' . $phone . '</div>' : '';
  977. 	$hcard .= ( '' === $street . $street2 . $city . $state . $zip . $country . $phone ) ? '' : '</div>';
  978. 	$hcard .= '</div>';
  979. 	$hcard .= '</div>';
  981. 	return $hcard;
  982. }
  984. /**
  985.  * Get ticket venue location data.
  986.  *
  987.  * @param bool|string $ticket_id Ticket ID.
  988.  *
  989.  * @return void
  990.  */
  991. function mt_ticket_venue( $ticket_id = false ) {
  992. 	echo wp_kses_post( mt_get_ticket_venue( $ticket_id ) );
  993. }
  995. /**
  996.  * Verify that a ticket is valid, paid for, and which event it's for.
  997.  *
  998.  * @param bool|string $ticket_id Ticket ID.
  999.  *
  1000.  * @return string
  1001.  */
  1002. function mt_get_verification( $ticket_id = false ) {
  1003. 	$ticket_id = ( ! $ticket_id ) ? mt_get_ticket_id() : $ticket_id;
  1004. 	$verified  = mt_verify_ticket( $ticket_id );
  1005. 	$ticket    = mt_get_ticket( $ticket_id );
  1006. 	if ( $ticket ) {
  1007. 		$data        = get_post_meta( $ticket->ID, '_' . $ticket_id, true );
  1008. 		$purchase_id = $data['purchase_id'];
  1009. 		$status      = get_post_meta( $purchase_id, '_is_paid', true );
  1010. 		$due         = get_post_meta( $purchase_id, '_total_paid', true );
  1011. 		$due         = apply_filters( 'mt_money_format', $due );
  1012. 		$text        = ( $verified ) ? __( 'Ticket Verified', 'my-tickets' ) : __( 'Invalid Ticket ID', 'my-tickets' );
  1013. 		// Translators: Amount due on account.
  1014. 		$text        .= ( 'Pending' === $status ) ? ' - ' . sprintf( __( 'Payment pending: %s', 'my-tickets' ), $due ) : '';
  1015. 		$status_class = sanitize_title( $status );
  1016. 		$used         = get_post_meta( $purchase_id, '_tickets_used' );
  1017. 		if ( ! is_array( $used ) ) {
  1018. 			$used = array();
  1019. 		}
  1020. 		$is_used = false;
  1021. 		if ( in_array( $ticket_id, $used, true ) ) {
  1022. 			$is_used       = true;
  1023. 			$status_class .= ' used';
  1024. 			$text         .= ' (' . __( 'Ticket has been used.', 'my-tickets' ) . ')';
  1025. 		}
  1027. 		$text .= wpautop( mt_get_ticket_validity( $ticket ) );
  1028. 		if ( ( current_user_can( 'mt-verify-ticket' ) || current_user_can( 'manage_options' ) ) && ! $is_used ) {
  1029. 			$text .= wpautop( __( 'Ticket usage recorded', 'my-tickets' ) );
  1030. 			add_post_meta( $purchase_id, '_tickets_used', $ticket_id );
  1031. 		}
  1033. 		do_action( 'mt_ticket_verified', $verified, $is_used, $purchase_id, $ticket_id );
  1034. 		$ticket_info  = "<ul><li class='ticket-type'>" . mt_get_ticket_type( $ticket_id ) . '</li>';
  1035. 		$ticket_info .= "<li class='ticket-price'>" . mt_get_ticket_price( $ticket_id ) . '</li></ul>';
  1037. 		return "<div class='$status_class'>" . $text . '</div>' . $ticket_info;
  1038. 	}
  1040. 	return '<div class="invalid">' . __( 'Not a valid ticket ID', 'my-tickets' ) . '</div>';
  1041. }
  1043. /**
  1044.  * Get the validity for a general admission ticket.
  1045.  *
  1046.  * @param int|object $ticket Ticket object or ID.
  1047.  * @param string     $format Full validity statement or expiration only.
  1048.  *
  1049.  * @return string
  1050.  */
  1051. function mt_get_ticket_validity( $ticket = false, $format = 'full' ) {
  1052. 	if ( ! $ticket ) {
  1053. 		$ticket = mt_get_ticket();
  1054. 	}
  1055. 	if ( ! is_int( $ticket ) ) {
  1056. 		$ticket = $ticket->ID;
  1057. 	}
  1058. 	$ticket_id  = mt_get_ticket_id();
  1059. 	$text       = '';
  1060. 	$expires    = '';
  1061. 	$event_data = get_post_meta( $ticket, '_mc_event_data', true );
  1062. 	if ( $event_data ) {
  1063. 		$general  = ( isset( $event_data['general_admission'] ) && ! empty( $event_data['general_admission'] ) ) ? true : false;
  1064. 		$validity = ( isset( $event_data['event_valid'] ) && $general ) ? trim( $event_data['event_valid'] ) : false;
  1065. 		if ( $validity ) {
  1066. 			$data    = get_post_meta( $ticket, '_' . $ticket_id, true );
  1067. 			$sale_id = $data['purchase_id'];
  1068. 			$format  = ( '' === get_option( 'date_format' ) ) ? 'Y-m-d' : get_option( 'date_format' );
  1069. 			/**
  1070. 			 * PHP Date format string used for the date general admission tickets are valid until.
  1071. 			 *
  1072. 			 * @hook mt_validity_date_format
  1073. 			 *
  1074. 			 * @param {string} $format Default format from WordPress date_format option.
  1075. 			 * @param {array}  $event_data Saved data about this event.
  1076. 			 *
  1077. 			 * @return {string}
  1078. 			 */
  1079. 			$format       = apply_filters( 'mt_validity_date_format', $format, $event_data );
  1080. 			$date_of_sale = get_the_date( $format, $sale_id );
  1081. 			if ( 'expire' === $validity && isset( $event_data['expire_date'] ) && ! empty( $event_data['expire_date'] ) ) {
  1082. 				$valid_dt = $event_data['expire_date'];
  1083. 			} else {
  1084. 				$valid_dt = ( 'infinite' === $validity ) ? strtotime( $date_of_sale . ' + ' . $validity ) : '';
  1085. 			}
  1086. 			if ( 'infinite' === $validity ) {
  1087. 				$status = __( 'Ticket does not expire', 'my-tickets' );
  1088. 			} else {
  1089. 				$status = mt_date( $format, $valid_dt );
  1090. 			}
  1091. 			// Translators: Purchase date.
  1092. 			$text .= wpautop( sprintf( apply_filters( 'mt_ticket_validity_sale_date', __( '<strong>Purchased:</strong> %s', 'my-tickets' ), $event_data ), '<span class="mt-date-of-sale">' . $date_of_sale . '</span>' ) );
  1093. 			// Translators: Expiration date.
  1094. 			$expires = wpautop( sprintf( apply_filters( 'mt_ticket_validity_expiration_date', __( '<strong>Expires:</strong> %s', 'my-tickets' ), $event_data ), '<span class="mt-date-of-validity">' . $status . '</span>' ) );
  1095. 			$text   .= $expires;
  1096. 			if ( strtotime( $date_of_sale . ' + ' . $validity ) < time() ) {
  1097. 				$text .= '<p class="mt-expired">' . __( 'Ticket has expired', 'my-tickets' ) . '</p>';
  1098. 			}
  1099. 		}
  1100. 	}
  1102. 	return ( 'full' === $format ) ? $text : $expires;
  1103. }
  1105. /**
  1106.  * Echo ticket validity.
  1107.  *
  1108.  * @param int|object $ticket Ticket object or ID.
  1109.  * @param string     $format Full validity statement or expiration only.
  1110.  */
  1111. function mt_ticket_validity( $ticket = false, $format = 'full' ) {
  1112. 	echo mt_get_ticket_validity( $ticket, $format );
  1113. }
  1115. /**
  1116.  * Verify that a ticket is valid, paid for, and which event it's for.
  1117.  *
  1118.  * @param bool|string $ticket_id Ticket ID.
  1119.  *
  1120.  * @return void
  1121.  */
  1122. function mt_verification( $ticket_id = false ) {
  1123. 	echo wp_kses_post( mt_get_verification( $ticket_id ) );
  1124. }
  1126. /**
  1127.  * Fetch custom fields set up using the custom fields API
  1128.  * This function only pulls single values; if you need arrays, you'll need to write your own custom handler.
  1129.  *
  1130.  * @param bool|false  $field name of field as defined in custom code.
  1131.  * @param string      $callback name of function to call and process output.
  1132.  * @param bool|string $ticket_id Ticket ID.
  1133.  *
  1134.  * @return string
  1135.  */
  1136. function mt_get_ticket_custom_field( $field = false, $callback = false, $ticket_id = false ) {
  1137. 	if ( ! $ticket_id ) {
  1138. 		$ticket = mt_get_ticket();
  1139. 	} else {
  1140. 		$ticket = mt_get_ticket( $ticket_id );
  1141. 	}
  1142. 	if ( $field ) {
  1143. 		$purchase    = get_post_meta( $ticket->ID, '_' . $ticket_id, true );
  1144. 		$purchase_id = $purchase['purchase_id'];
  1145. 		$meta        = get_post_meta( $purchase_id, $field, true );
  1146. 		if ( $meta && isset( $meta[ $field ] ) ) {
  1147. 			if ( $callback ) {
  1148. 				return call_user_func( $callback, $meta );
  1149. 			} else {
  1150. 				return $meta[ $field ];
  1151. 			}
  1152. 		}
  1153. 	}
  1155. 	return '';
  1156. }
  1158. /**
  1159.  * Fetch custom fields set up using the custom fields API
  1160.  * This function only pulls single values; if you need arrays, you'll need to write your own custom handler.
  1161.  *
  1162.  * @param bool|false  $field name of field as defined in custom code.
  1163.  * @param bool|string $ticket_id Ticket ID.
  1164.  *
  1165.  * @return void
  1166.  */
  1167. function mt_ticket_custom_field( $field = false, $ticket_id = false ) {
  1168. 	echo wp_kses_post( mt_get_ticket_custom_field( $field, false, $ticket_id ) );
  1169. }