| 1 |
<?php |
| 2 |
/** |
| 3 |
* The [give_totals] 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_Totals |
| 18 |
*/ |
| 19 |
class Give_Shortcode_Totals extends Give_Shortcode_Generator { |
| 20 |
|
| 21 |
/** |
| 22 |
* Class constructor |
| 23 |
*/ |
| 24 |
public function __construct() { |
| 25 |
|
| 26 |
$this->shortcode['title'] = __( 'GiveWP Totals', 'give' ); |
| 27 |
$this->shortcode['label'] = __( 'GiveWP Totals', 'give' ); |
| 28 |
|
| 29 |
parent::__construct( 'give_totals' ); |
| 30 |
} |
| 31 |
|
| 32 |
/** |
| 33 |
* Define the shortcode attribute fields |
| 34 |
* |
| 35 |
* @since 2.1 |
| 36 |
* @return array |
| 37 |
*/ |
| 38 |
public function define_fields() { |
| 39 |
|
| 40 |
$category_options = array(); |
| 41 |
$category_lists = array(); |
| 42 |
$categories = get_terms( 'give_forms_category', apply_filters( 'give_forms_category_dropdown', array() ) ); |
| 43 |
if ( give_is_setting_enabled( give_get_option( 'categories' ) ) && ! is_wp_error( $categories ) ) { |
| 44 |
foreach ( $categories as $category ) { |
| 45 |
$category_options[ absint( $category->term_id ) ] = esc_html( $category->name ); |
| 46 |
} |
| 47 |
|
| 48 |
$category_lists['type'] = 'listbox'; |
| 49 |
$category_lists['name'] = 'cats'; |
| 50 |
$category_lists['label'] = __( 'Select a Donation Form Category:', 'give' ); |
| 51 |
$category_lists['tooltip'] = __( 'Select a Donation Form Category', 'give' ); |
| 52 |
$category_lists['options'] = $category_options; |
| 53 |
} |
| 54 |
|
| 55 |
$tag_options = array(); |
| 56 |
$tag_lists = array(); |
| 57 |
$tags = get_terms( 'give_forms_tag', apply_filters( 'give_forms_tag_dropdown', array() ) ); |
| 58 |
if ( give_is_setting_enabled( give_get_option( 'tags' ) ) && ! is_wp_error( $tags ) ) { |
| 59 |
$tags = get_terms( 'give_forms_tag', apply_filters( 'give_forms_tag_dropdown', array() ) ); |
| 60 |
foreach ( $tags as $tag ) { |
| 61 |
$tag_options[ absint( $tag->term_id ) ] = esc_html( $tag->name ); |
| 62 |
} |
| 63 |
|
| 64 |
$tag_lists['type'] = 'listbox'; |
| 65 |
$tag_lists['name'] = 'tags'; |
| 66 |
$tag_lists['label'] = __( 'Select a Donation Form Tag:', 'give' ); |
| 67 |
$tag_lists['tooltip'] = __( 'Select a Donation Form Tag', 'give' ); |
| 68 |
$tag_lists['options'] = $tag_options; |
| 69 |
} |
| 70 |
|
| 71 |
return array( |
| 72 |
array( |
| 73 |
'type' => 'container', |
| 74 |
'html' => sprintf( |
| 75 |
'<p class="give-totals-shortcode-container-message">%s</p>', |
| 76 |
__( 'This shortcode shows the total amount raised towards a custom goal for one or several forms regardless of whether they have goals enabled or not.', 'give' ) |
| 77 |
), |
| 78 |
), |
| 79 |
array( |
| 80 |
'type' => 'container', |
| 81 |
'html' => sprintf( '<p class="strong margin-top">%s</p>', __( 'Shortcode Configuration', 'give' ) ), |
| 82 |
), |
| 83 |
array( |
| 84 |
'type' => 'textbox', |
| 85 |
'name' => 'ids', |
| 86 |
'label' => __( 'Donation Form IDs:', 'give' ), |
| 87 |
'tooltip' => __( 'Enter the IDs separated by commas for the donation forms you would like to combine within the totals.', 'give' ), |
| 88 |
), |
| 89 |
$category_lists, |
| 90 |
$tag_lists, |
| 91 |
array( |
| 92 |
'type' => 'textbox', |
| 93 |
'name' => 'total_goal', |
| 94 |
'label' => __( 'Total Goal:', 'give' ), |
| 95 |
'tooltip' => __( 'Enter the total goal amount that you would like to display.', 'give' ), |
| 96 |
'required' => array( |
| 97 |
'alert' => esc_html__( 'Please enter a valid total goal amount.', 'give' ), |
| 98 |
), |
| 99 |
), |
| 100 |
array( |
| 101 |
'type' => 'textbox', |
| 102 |
'name' => 'message', |
| 103 |
'label' => __( 'Message:', 'give' ), |
| 104 |
'tooltip' => __( 'Enter a message to display encouraging donors to support the goal.', 'give' ), |
| 105 |
'value' => apply_filters( 'give_totals_message', __( 'Hey! We\'ve raised {total} of the {total_goal} we are trying to raise for this campaign!', 'give' ) ), |
| 106 |
'multiline' => true, |
| 107 |
'minWidth' => 300, |
| 108 |
'minHeight' => 60, |
| 109 |
), |
| 110 |
array( |
| 111 |
'type' => 'textbox', |
| 112 |
'name' => 'link', |
| 113 |
'label' => __( 'Link:', 'give' ), |
| 114 |
'tooltip' => __( 'Enter a link to the main campaign donation form.', 'give' ), |
| 115 |
), |
| 116 |
array( |
| 117 |
'type' => 'textbox', |
| 118 |
'name' => 'link_text', |
| 119 |
'label' => __( 'Link Text:', 'give' ), |
| 120 |
'tooltip' => __( 'Enter hyperlink text for the link to the main campaign donation form.', 'give' ), |
| 121 |
'value' => __( 'Donate!', 'give' ), |
| 122 |
), |
| 123 |
array( |
| 124 |
'type' => 'listbox', |
| 125 |
'name' => 'progress_bar', |
| 126 |
'label' => __( 'Show Progress Bar:', 'give' ), |
| 127 |
'tooltip' => __( 'Select whether you would like to show a goal progress bar.', 'give' ), |
| 128 |
'options' => array( |
| 129 |
'true' => __( 'Show', 'give' ), |
| 130 |
'false' => __( 'Hide', 'give' ), |
| 131 |
), |
| 132 |
'value' => 'true', |
| 133 |
), |
| 134 |
array( |
| 135 |
'type' => 'docs_link', |
| 136 |
'text' => esc_html__( 'Learn more about the Donation Totals Shortcode', 'give' ), |
| 137 |
'link' => 'http://docs.givewp.com/shortcode-donation-totals', |
| 138 |
), |
| 139 |
); |
| 140 |
} |
| 141 |
} |
| 142 |
|
| 143 |
/** |
| 144 |
* @since 4.3.0 use init action |
| 145 |
*/ |
| 146 |
add_action( 'init', static function () { |
| 147 |
new Give_Shortcode_Totals(); |
| 148 |
}); |
| 149 |
|
| 150 |
|
