shortcode-form-grid.php — GiveWP – Donation Plugin and Fundraising Platform 2.22.1

give / templates / shortcode-form-grid.php

give / templates Last commit date

shortcode-form-grid.php

462 lines

1	<?php
2	/**
3	* This template is used to display the donation grid with [donation_grid]
4	*/
5
6	// Exit if accessed directly.
7	use Give\Helpers\Form\Template;
8	use Give\Helpers\Form\Utils as FormUtils;
9
10	if ( ! defined( 'ABSPATH' ) ) {
11	exit;
12	}
13
14	$form_id = get_the_ID(); // Form ID.
15	$give_settings = $args[0]; // Give settings.
16	$atts = $args[1]; // Shortcode attributes.
17	$raw_content = ''; // Raw form content.
18	$stripped_content = ''; // Form content stripped of HTML tags and shortcodes.
19	$excerpt = ''; // Trimmed form excerpt ready for display.
20
21	$flex_direction = $atts['columns'] === '1' ? "row" : "column";
22
23	$activeTemplate = FormUtils::isLegacyForm( $form_id ) ? 'legacy' : Template::getActiveID( $form_id );
24
25	/* @var \Give\Form\Template $formTemplate */
26	$formTemplate = Give()->templates->getTemplate( $activeTemplate );
27
28	$renderTags = static function($wrapper_class, $apply_styles = true) use($form_id , $atts ) {
29	if( !taxonomy_exists( 'give_forms_tag' ) ) {
30	return '';
31	}
32
33	$tags = wp_get_post_terms($form_id,'give_forms_tag');
34
35	$tag_bg_color = ! empty( $atts['tag_background_color'] )
36	? $atts['tag_background_color']
37	: '#69b86b';
38
39	$tag_text_color = ! empty( $atts['tag_text_color'] )
40	? $atts['tag_text_color']
41	: '#ffffff';
42
43	$tag_container_color = count($tags) >= 1
44	? 'rgba(0, 0, 0, 0.35)'
45	: 'none';
46
47	$tag_elements = array_map(
48	static function($term)use($tag_text_color,$tag_bg_color){
49	return "<span style='color: $tag_text_color; background-color: $tag_bg_color;'>$term->name</span>";
50	}, $tags
51	);
52
53	$tag_elements = implode('', $tag_elements);
54	$styles = $apply_styles ? "style='background-color: $tag_container_color;'" : '';
55
56	return "
57	<div class='$wrapper_class' $styles >
58	$tag_elements
59	</div>
60	";
61	};
62
63	?>
64
65	<div class="give-grid__item">
66	<?php
67	// Print the opening anchor tag based on display style.
68	if ( 'redirect' === $atts['display_style'] ) {
69
70	$form_grid_option = give_get_meta( $form_id, '_give_form_grid_option', true );
71	$form_grid_redirect_url = esc_url(give_get_meta( $form_id, '_give_form_grid_redirect_url', true ));
72
73	$url = ( $form_grid_option === 'custom' && filter_var($form_grid_redirect_url, FILTER_VALIDATE_URL) )
74	? $form_grid_redirect_url
75	: get_the_permalink();
76
77	printf(
78	'<a id="give-card-%1$s" onclick="return !document.body.classList.contains( \'block-editor-page\' )" class="give-card" href="%2$s">',
79	esc_attr( $form_id ),
80	esc_attr( $url )
81	);
82	} elseif ( 'modal_reveal' === $atts['display_style'] ) {
83	printf(
84	'<a id="give-card-%1$s" class="give-card js-give-grid-modal-launcher" data-effect="mfp-zoom-out" href="#give-modal-form-%1$s">',
85	esc_attr( $form_id )
86	);
87	}
88	?>
89	<div class="give-form-grid" style="flex-direction:<?php echo $flex_direction ?>">
90	<?php
91	// Maybe display the featured image.
92	if (
93	give_is_setting_enabled($give_settings['form_featured_img'])
94	&& ($imageSrc = $formTemplate->getFormFeaturedImage($form_id))
95	&& $atts['show_featured_image']
96	&& $atts['columns'] !== '1'
97	) {
98	/*
99	* Filters the image size used in card layouts.
100	*
101	* @param string The image size.
102	* @param array Form grid attributes.
103	*/
104	$image_size = apply_filters('give_form_grid_image_size', $atts['image_size'], $atts);
105	$image_attr = '';
106
107	if ('auto' !== $atts['image_height']) {
108	$image_attr = [
109	'style' => 'height: ' . $atts['image_height'],
110	];
111	}
112
113	$image = wp_get_attachment_image( attachment_url_to_postid( $imageSrc ), $image_size, false, $image_attr );
114
115
116	echo "
117	<div class='give-form-grid-media'>
118	<div class='give-card__media'> $image </div>
119
120	{$renderTags('give-form-grid-media__tags')}
121	</div>
122	";
123	} elseif(
124	give_is_setting_enabled($give_settings['form_featured_img'])
125	&& ($imageSrc = $formTemplate->getFormFeaturedImage($form_id))
126	&& $atts['show_featured_image']
127	&& $atts['columns'] === '1')
128	{
129	echo "
130	<div id='row-media' class='give-form-grid-media'>
131	<img class='give-form-grid-media' src='$imageSrc' alt='' />
132
133	{$renderTags('give-form-grid-media__tags')}
134	</div>
135	";
136	}
137	?>
138
139	<div class="give-form-grid-container">
140	<div class="give-form-grid-content">
141	<?php
142	if( !$atts['show_featured_image']){
143	echo "
144	<div class='give-form-grid-media' >
145	{$renderTags('give-form-grid-media__tags_no_image', false)}
146	</div>
147	";
148	}
149	?>
150
151	<?php
152
153	// Maybe display the form title.
154	if ( true === $atts['show_title'] ) {
155	printf(
156	'<h3 class="give-form-grid-content__title">%1$s</h3>',
157	$formTemplate->getFormHeading( $form_id )
158	);
159	}
160
161	// Maybe display the form excerpt.
162	if ( true === $atts['show_excerpt'] ) {
163	if ( $raw_content = $formTemplate->getFormExcerpt( $form_id ) ) {
164	$stripped_content = wp_strip_all_tags(
165	strip_shortcodes( $raw_content )
166	);
167	} else {
168	// Get content from the form post's content field.
169	$raw_content = give_get_meta( $form_id, '_give_form_content', true );
170
171	if ( ! empty( $raw_content ) ) {
172	$stripped_content = wp_strip_all_tags(
173	strip_shortcodes( $raw_content )
174	);
175	}
176	}
177
178	// Maybe truncate excerpt.
179	if ( 0 < $atts['excerpt_length'] ) {
180	$excerpt = wp_trim_words( $stripped_content, $atts['excerpt_length'] );
181	} else {
182	$excerpt = $stripped_content;
183	}
184
185	printf( '<p class="give-form-grid-content__text">%s</p>', $excerpt );
186	}
187
188	if ($atts['show_donate_button']):
189	$button_text = ! empty( $atts['donate_button_text'] )
190	? $atts['donate_button_text']
191	: give_get_meta( $form_id, '_give_form_grid_donate_button_text', true );
192
193	$button_text_color = ! empty( $atts['donate_button_text_color'] )
194	? $atts['donate_button_text_color']
195	: '#fff';
196	?>
197	<button style="text-decoration-color: <?php echo $button_text_color; ?>">
198	<span style="color: <?php echo $button_text_color; ?>">
199	<?php echo $button_text ?: __( 'Donate', 'give' ); ?>
200	</span>
201	</button>
202	<?php endif; ?>
203
204	</div>
205	<?php
206	$form = new Give_Donate_Form( $form_id );
207	$goal_option = give_get_meta( $form->ID, '_give_goal_option', true );
208
209	// Sanity check - ensure form has pass all condition to show goal.
210	$hide_goal = ( isset( $atts['show_goal'] ) && ! filter_var( $atts['show_goal'], FILTER_VALIDATE_BOOLEAN ) )
211	\|\| empty( $form->ID )
212	\|\| ( is_singular( 'give_forms' ) && ! give_is_setting_enabled( $goal_option ) )
213	\|\| ! give_is_setting_enabled( $goal_option ) \|\| 0 === $form->goal;
214
215	// Maybe display the goal progress bar.
216
217	if (!$hide_goal) :
218	$goal_progress_stats = give_goal_progress_stats( $form );
219	$goal_format = $goal_progress_stats['format'];
220	$color = $atts['progress_bar_color'];
221	$show_goal = isset( $atts['show_goal'] ) ? filter_var( $atts['show_goal'], FILTER_VALIDATE_BOOLEAN ) : true;
222	$shortcode_stats = apply_filters(
223	'give_goal_shortcode_stats',
224	array(
225	'income' => $form->get_earnings(),
226	'goal' => $goal_progress_stats['raw_goal'],
227	),
228	$form_id,
229	$goal_progress_stats,
230	$args
231	);
232
233	$income = $shortcode_stats['income'];
234	$goal = $shortcode_stats['goal'];
235
236	switch ( $goal_format ) {
237
238	case 'donation':
239	$progress = $goal ? round( ( $form->get_sales() / $goal ) * 100, 2 ) : 0;
240	$progress_bar_value = $form->get_sales() >= $goal ? 100 : $progress;
241	break;
242
243	case 'donors':
244	$progress = $goal ? round( ( give_get_form_donor_count( $form->ID ) / $goal ) * 100, 2 ) : 0;
245	$progress_bar_value = give_get_form_donor_count( $form->ID ) >= $goal ? 100 : $progress;
246	break;
247
248	case 'percentage':
249	$progress = $goal ? round( ( $income / $goal ) * 100, 2 ) : 0;
250	$progress_bar_value = $income >= $goal ? 100 : $progress;
251	break;
252
253	default:
254	$progress = $goal ? round( ( $income / $goal ) * 100, 2 ) : 0;
255	$progress_bar_value = $income >= $goal ? 100 : $progress;
256	break;
257
258	}
259
260	?>
261	<div class="give-form-grid-progress">
262	<?php
263	$style = "width:$progress_bar_value%;";
264	$style .= "background: linear-gradient(180deg, {$color} 0%, {$color} 100%); background-blend-mode: multiply;";
265	echo "
266	<div class='give-form-grid-progress-bar'>
267	<div class='give-progress-bar' role='progressbar' aria-valuemin='0' aria-valuemax='100' aria-valuenow='$progress_bar_value'>
268	<span style='$style'></span>
269	</div>
270	</div>
271	";
272
273	?>
274	<div class="form-grid-raised">
275	<?php
276	if ( 'amount' === $goal_format ) :
277
278	/**
279	* Filter the give currency.
280	*
281	* @since 1.8.17
282	*/
283	$form_currency = apply_filters( 'give_goal_form_currency', give_get_currency( $form_id ), $form_id );
284
285	/**
286	* Filter the income formatting arguments.
287	*
288	* @since 1.8.17
289	*/
290	$income_format_args = apply_filters(
291	'give_goal_income_format_args',
292	array(
293	'sanitize' => false,
294	'currency' => $form_currency,
295	'decimal' => false,
296	),
297	$form_id
298	);
299
300	/**
301	* Filter the goal formatting arguments.
302	*
303	* @since 1.8.17
304	*/
305	$goal_format_args = apply_filters(
306	'give_goal_amount_format_args',
307	array(
308	'sanitize' => false,
309	'currency' => $form_currency,
310	'decimal' => false,
311	),
312	$form_id
313	);
314
315	/**
316	* This filter will be used to convert the goal amounts to different currencies.
317	*
318	* @since 2.5.4
319	*
320	* @param array $amounts List of goal amounts.
321	* @param int $form_id Donation Form ID.
322	*/
323	$goal_amounts = apply_filters(
324	'give_goal_amounts',
325	array(
326	$form_currency => $goal,
327	),
328	$form_id
329	);
330
331	/**
332	* This filter will be used to convert the income amounts to different currencies.
333	*
334	* @since 2.5.4
335	*
336	* @param array $amounts List of goal amounts.
337	* @param int $form_id Donation Form ID.
338	*/
339	$income_amounts = apply_filters(
340	'give_goal_raised_amounts',
341	array(
342	$form_currency => $income,
343	),
344	$form_id
345	);
346
347	// Get human readable donation amount.
348	$income = give_human_format_large_amount( give_format_amount( $income, $income_format_args ), array( 'currency' => $form_currency ) );
349	$goal = give_human_format_large_amount( give_format_amount( $goal, $goal_format_args ), array( 'currency' => $form_currency ) );
350
351	// Format the human readable donation amount.
352	$formatted_income = give_currency_filter(
353	$income,
354	array(
355	'form_id' => $form_id,
356	)
357	);
358
359	$formatted_goal = give_currency_filter(
360	$goal,
361	array(
362	'form_id' => $form_id,
363	)
364	);
365	echo sprintf(
366	/* translators: 1: amount of income raised 2: goal target amount. */
367	__( '<div class="form-grid-raised__details">
368	<span class="amount" data-amounts="%1$s">%2$s</span>
369	<span class="goal" data-amounts="%3$s"><span>of </span>%4$s</span>
370	</div>', 'give' ),
371	esc_attr( wp_json_encode( $income_amounts, JSON_PRETTY_PRINT ) ),
372	esc_attr( $formatted_income ),
373	esc_attr( wp_json_encode( $goal_amounts, JSON_PRETTY_PRINT ) ),
374	esc_attr( $formatted_goal )
375	);
376
377	elseif ( 'percentage' === $goal_format ) :
378
379	echo sprintf( /* translators: %s: percentage of the amount raised compared to the goal target */
380	__( '<div class="form-grid-raised__details">
381	<span class="amount">%s%%</span>
382	<span class="goal"><span>of </span><span>100%</span>
383	</div>', 'give' ),
384	round( $progress )
385	);
386
387	elseif ( 'donation' === $goal_format ) :
388
389	echo sprintf( /* translators: 1: total number of donations completed 2: total number of donations set as goal */
390	_n(
391	'<div class="form-grid-raised__details">
392	<span class="amount">%1$s</span>
393	<span class="goal"><span>of</span> %2$s <span>Donation</span></span>
394	</div>',
395	'<div class="form-grid-raised__details">
396	<span class="amount">%1$s</span>
397	<span class="goal"><span>of</span> %2$s <span>Donations</span></span>
398	</div>',
399	$goal,
400	'give'
401	),
402	$form->get_sales(),
403	give_format_amount( $goal, array( 'decimal' => false ) )
404	);
405
406	elseif ( 'donors' === $goal_format ) :
407
408	echo sprintf( /* translators: 1: total number of donors completed 2: total number of donors set as goal */
409	_n(
410	'<div class="form-grid-raised__details">
411	<span class="amount">%1$s</span>
412	<span class="goal"><span>of</span> %2$s <span>Donors</span> </span>
413	</div>',
414	'<div class="form-grid-raised__details">
415	<span class="amount">%1$s</span>
416	<span class="goal"><span>of</span> %2$s <span>Donors</span></span>
417	</div>',
418	$goal,
419	'give'
420	),
421	give_get_form_donor_count( $form->ID ),
422	give_format_amount( $goal, array( 'decimal' => false ) )
423	);
424	endif;
425	?>
426
427	<div class="form-grid-raised__details">
428	<span class="amount form-grid-raised__details_donations"> <?php echo $form->get_sales(); ?></span>
429	<span class="goal">Donations</span>
430	</div>
431	</div>
432	</div>
433	<?php endif?>
434	</div>
435	</div>
436	</a>
437	<?php
438	// If modal, print form in hidden container until it is time to be revealed.
439	if ( 'modal_reveal' === $atts['display_style'] ) {
440	if (
441	! isset($_GET['context']) // check if we are in block editor
442	&& ! FormUtils::isLegacyForm( $form_id )
443	) {
444	echo give_form_shortcode(
445	[
446	'id' => $form_id,
447	'display_style' => 'button',
448	]
449	);
450
451	} else {
452	printf(
453	'<div id="give-modal-form-%1$s" class="give-donation-grid-item-form give-modal--slide mfp-hide">',
454	$form_id
455	);
456	give_get_donation_form( $form_id );
457	echo '</div>';
458	}
459	}
460	?>
461	</div>
462