shortcode-give-donation-grid.php — GiveWP – Donation Plugin and Fundraising Platform trunk

give / includes / admin / shortcodes / shortcode-give-donation-grid.php

give / includes / admin / shortcodes Last commit date

shortcode-give-donation-grid.php

160 lines

1	<?php
2	/**
3	* The [give_donation_grid] Shortcode Generator class
4	*
5	* @package Give/Admin/Shortcodes
6	* @copyright Copyright (c) 2016, GiveWP
7	* @license https://opensource.org/licenses/gpl-license GNU Public License
8	* @since 2.1
9	*/
10
11	// Exit if accessed directly.
12	if ( ! defined( 'ABSPATH' ) ) {
13	exit;
14	}
15
16	/**
17	* Class Give_Shortcode_Donation_Form_Goal
18	*/
19	class Give_Shortcode_Donation_Grid extends Give_Shortcode_Generator {
20
21	/**
22	* Class constructor
23	*/
24	public function __construct() {
25
26	$this->shortcode['title'] = esc_html__( 'Donation Form Grid', 'give' );
27	$this->shortcode['label'] = esc_html__( 'Donation Form Grid', 'give' );
28
29	parent::__construct( 'give_form_grid' );
30	}
31
32	/**
33	* Define the shortcode attribute fields
34	*
35	* @return array
36	*/
37	public function define_fields() {
38
39	return array(
40	array(
41	'type' => 'container',
42	'html' => sprintf( '<p class="strong margin-top">%s</p>', esc_html__( 'Optional settings', 'give' ) ),
43	),
44	array(
45	'type' => 'textbox',
46	'name' => 'ids',
47	'label' => esc_attr__( 'Form IDs:', 'give' ),
48	'tooltip' => esc_attr__( 'Enter a comma-separated list of form IDs. If empty, all published forms are displayed.', 'give' ),
49	'placeholder' => esc_html__( 'All Forms', 'give' ),
50	),
51	array(
52	'type' => 'textbox',
53	'name' => 'exclude',
54	'label' => esc_attr__( 'Excluded Form IDs:', 'give' ),
55	'tooltip' => esc_attr__( 'Enter a comma-separated list of form IDs to exclude those from the grid.', 'give' ),
56	'placeholder' => esc_html__( 'Excluded Forms', 'give' ),
57	),
58	array(
59	'type' => 'listbox',
60	'name' => 'orderby',
61	'label' => esc_attr__( 'Order By:', 'give' ),
62	'tooltip' => esc_attr__( 'Different parameter to set the order for the forms display in the form grid.', 'give' ),
63	'options' => array(
64	'title' => esc_html__( 'Form Name', 'give' ),
65	'amount_donated' => esc_html__( 'Amount Donated', 'give' ),
66	'number_donations' => esc_html__( 'Number of Donations', 'give' ),
67	'menu_order' => esc_html__( 'Menu Order', 'give' ),
68	'post__in' => esc_html__( 'Provided Form IDs', 'give' ),
69	'closest_to_goal' => esc_html__( 'Closest To Goal', 'give' ),
70	'random' => esc_html__( 'Random', 'give' ),
71	),
72	'placeholder' => esc_html__( 'Date Created', 'give' ),
73	),
74	array(
75	'type' => 'listbox',
76	'name' => 'order',
77	'label' => esc_attr__( 'Order:', 'give' ),
78	'tooltip' => esc_attr__( 'Display forms based on order.', 'give' ),
79	'options' => array(
80	'ASC' => esc_html__( 'Ascending', 'give' ),
81	),
82	'placeholder' => esc_html__( 'Descending', 'give' ),
83	),
84	array(
85	'type' => 'listbox',
86	'name' => 'columns',
87	'label' => esc_attr__( 'Columns:', 'give' ),
88	'tooltip' => esc_attr__( 'Sets the number of forms per row.', 'give' ),
89	'options' => array(
90	'1' => esc_html__( '1', 'give' ),
91	'2' => esc_html__( '2', 'give' ),
92	'3' => esc_html__( '3', 'give' ),
93	'4' => esc_html__( '4', 'give' ),
94	),
95	'placeholder' => esc_html__( 'Best Fit', 'give' ),
96	),
97	array(
98	'type' => 'listbox',
99	'name' => 'show_goal',
100	'label' => esc_attr__( 'Show Goal:', 'give' ),
101	'tooltip' => __( 'Do you want to display the goal\'s progress bar?', 'give' ),
102	'options' => array(
103	'false' => esc_html__( 'Hide', 'give' ),
104	),
105	'placeholder' => esc_html__( 'Show', 'give' ),
106	),
107	array(
108	'type' => 'listbox',
109	'name' => 'show_excerpt',
110	'label' => esc_attr__( 'Show Excerpt:', 'give' ),
111	'tooltip' => esc_attr__( 'Do you want to display the excerpt?', 'give' ),
112	'options' => array(
113	'false' => esc_html__( 'Hide', 'give' ),
114	),
115	'placeholder' => esc_html__( 'Show', 'give' ),
116	),
117	array(
118	'type' => 'listbox',
119	'name' => 'show_featured_image',
120	'label' => esc_attr__( 'Show Featured Image:', 'give' ),
121	'tooltip' => esc_attr__( 'Do you want to display the featured image?', 'give' ),
122	'options' => array(
123	'false' => esc_html__( 'Hide', 'give' ),
124	),
125	'placeholder' => esc_html__( 'Show', 'give' ),
126	),
127	array(
128	'type' => 'listbox',
129	'name' => 'display_style',
130	'label' => esc_attr__( 'Display Style:', 'give' ),
131	'tooltip' => esc_attr__( 'Show form as modal window or redirect to a new page?', 'give' ),
132	'options' => array(
133	'redirect' => esc_html__( 'Redirect', 'give' ),
134	),
135	'placeholder' => esc_html__( 'Modal', 'give' ),
136	),
137	array(
138	'type' => 'textbox',
139	'name' => 'forms_per_page',
140	'label' => esc_attr__( 'Forms Per Page:', 'give' ),
141	'tooltip' => esc_attr__( 'Sets the number of forms to display per page.', 'give' ),
142	'value' => 12,
143	),
144	array(
145	'type' => 'docs_link',
146	'text' => esc_html__( 'Learn more about the Donation Form Grid Shortcode', 'give' ),
147	'link' => 'http://docs.givewp.com/shortcode-form-grid',
148	),
149	);
150	}
151	}
152
153	/**
154	* @since 4.3.0 use init action
155	*/
156	add_action( 'init', static function () {
157	new Give_Shortcode_Donation_Grid();
158	});
159
160