/**
* Define General Settings Metabox and field configurations.
*
* Filters are provided for each settings section to allow add-ons and other plugins to add their own settings
*
* @param $active_tab active tab settings; null returns full array
*
* @return array
*/
public function give_settings($active_tab)
{
$give_settings = array('general' => array('id' => 'options_page', 'give_title' => __('General Settings', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_general', array(array('name' => __('General Settings', 'give'), 'desc' => '<hr>', 'type' => 'give_title', 'id' => 'give_title_general_settings_1'), array('name' => __('Success Page', 'give'), 'desc' => __('This is the page donators are sent to after completing their donations. The <code>[give_receipt]</code> shortcode should be on this page.', 'give'), 'id' => 'success_page', 'type' => 'select', 'options' => give_cmb2_get_post_options(array('post_type' => 'page', 'numberposts' => -1))), array('name' => __('Failed Transaction Page', 'give'), 'desc' => __('This is the page donors are sent to if their transaction is cancelled or fails.', 'give'), 'id' => 'failure_page', 'type' => 'select', 'options' => give_cmb2_get_post_options(array('post_type' => 'page', 'numberposts' => -1))), array('name' => __('Donation History Page', 'give'), 'desc' => __('This page shows a complete donation history for the current user. The <code>[donation_history]</code> shortcode should be on this page.', 'give'), 'id' => 'history_page', 'type' => 'select', 'options' => give_cmb2_get_post_options(array('post_type' => 'page', 'numberposts' => -1))), array('name' => __('Base Country', 'give'), 'desc' => __('Where does your site operate from?', 'give'), 'id' => 'base_country', 'type' => 'select', 'options' => give_get_country_list()), array('name' => __('Currency Settings', 'give'), 'desc' => '<hr>', 'type' => 'give_title', 'id' => 'give_title_general_settings_2'), array('name' => __('Currency', 'cmb'), 'desc' => 'Choose your currency. Note that some payment gateways have currency restrictions.', 'id' => 'currency', 'type' => 'select', 'options' => give_get_currencies(), 'default' => 'USD'), array('name' => __('Currency Position', 'cmb'), 'desc' => 'Choose the position of the currency sign.', 'id' => 'currency_position', 'type' => 'select', 'options' => array('before' => __('Before - $10', 'give'), 'after' => __('After - 10$', 'give')), 'default' => 'before'), array('name' => __('Thousands Separator', 'give'), 'desc' => __('The symbol (typically , or .) to separate thousands', 'give'), 'id' => 'thousands_separator', 'type' => 'text_small', 'default' => ','), array('name' => __('Decimal Separator', 'give'), 'desc' => __('The symbol (usually , or .) to separate decimal points', 'give'), 'id' => 'decimal_separator', 'type' => 'text_small', 'default' => '.')))), 'gateways' => array('id' => 'options_page', 'give_title' => __('Payment Gateways', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_gateways', array(array('name' => __('Gateways Settings', 'give'), 'desc' => '<hr>', 'id' => 'give_title_gateway_settings_1', 'type' => 'give_title'), array('name' => __('Test Mode', 'give'), 'desc' => __('While in test mode no live transactions are processed. To fully use test mode, you must have a sandbox (test) account for the payment gateway you are testing.', 'give'), 'id' => 'test_mode', 'type' => 'checkbox'), array('name' => __('Enabled Gateways', 'give'), 'desc' => __('Choose the payment gateways you would like enabled.', 'give'), 'id' => 'gateways', 'type' => 'enabled_gateways'), array('name' => __('Default Gateway', 'give'), 'desc' => __('This is the gateway that will be selected by default.', 'give'), 'id' => 'default_gateway', 'type' => 'default_gateway'), array('name' => __('PayPal Standard', 'give'), 'desc' => '<hr>', 'type' => 'give_title', 'id' => 'give_title_gateway_settings_2'), array('name' => __('PayPal Email', 'give'), 'desc' => __('Enter your PayPal account\'s email', 'give'), 'id' => 'paypal_email', 'type' => 'text_email'), array('name' => __('PayPal Page Style', 'give'), 'desc' => __('Enter the name of the page style to use, or leave blank to use the default', 'give'), 'id' => 'paypal_page_style', 'type' => 'text'), array('name' => __('PayPal ', 'give'), 'desc' => __('Nonprofits must verify their status to withdraw donations they receive via PayPal. PayPal users that are not verified nonprofits must demonstrate how their donations will be used, once they raise more than $10,000. By default, Give transactions are sent to PayPal as donations. You may change the transaction type using this option if you feel you may not meet PayPal\'s donation requirements.', 'give'), 'id' => 'paypal_button_type', 'type' => 'radio_inline', 'options' => array('donation' => __('Donation', 'give'), 'standard' => __('Standard Transaction', 'give')), 'default' => 'donation'), array('name' => __('Disable PayPal IPN Verification', 'give'), 'desc' => __('If donations are not getting marked as complete, then check this box. This forces the site to use a slightly less secure method of verifying donations.', 'give'), 'id' => 'disable_paypal_verification', 'type' => 'checkbox'), array('name' => __('Offline Donations', 'give'), 'desc' => '<hr>', 'type' => 'give_title', 'id' => 'give_title_gateway_settings_3'), array('name' => __('Collect Billing Details', 'give'), 'desc' => __('This option will enable the billing details section for offline donations. The fieldset will appear above the offline donation instructions. Note: You may customize this option per form as needed.', 'give'), 'id' => 'give_offline_donation_enable_billing_fields', 'type' => 'checkbox'), array('name' => __('Offline Donation Instructions', 'give'), 'desc' => __('The following content will appear for all forms when the user selects the offline donation payment option. Note: You may customize the content per form as needed.', 'give'), 'id' => 'global_offline_donation_content', 'default' => give_get_default_offline_donation_content(), 'type' => 'wysiwyg', 'options' => array('textarea_rows' => 6)), array('name' => __('Offline Donation Email Instructions Subject', 'give'), 'desc' => __('Enter the subject line for the donation receipt email.', 'give'), 'id' => 'offline_donation_subject', 'default' => __('{donation} - Offline Donation Instructions', 'give'), 'type' => 'text'), array('name' => __('Offline Donation Email Instructions', 'give'), 'desc' => __('Enter the instructions you want emailed to the donor after they have submitted the donation form. Most likely this would include important information like mailing address and who to make the check out to.', 'give'), 'id' => 'global_offline_donation_email', 'default' => give_get_default_offline_donation_email_content(), 'type' => 'wysiwyg', 'options' => array('textarea_rows' => 6))))), 'display' => array('id' => 'options_page', 'give_title' => __('Display Settings', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_display', array(array('name' => __('Display Settings', 'give'), 'desc' => '<hr>', 'id' => 'give_title_display_settings_1', 'type' => 'give_title'), array('name' => __('Disable CSS', 'give'), 'desc' => __('Enable this option if you would like to disable all of Give\'s included CSS stylesheets.', 'give'), 'id' => 'disable_css', 'type' => 'checkbox'), array('name' => __('Enable Floating Labels', 'give'), 'desc' => sprintf(__('Enable this option if you would like to enable <a href="%s" target="_blank">floating labels</a> in Give\'s donation forms.<br>Be aware that if you have the "Disable CSS" option enabled, you will need to style the floating labels yourself.', 'give'), esc_url("http://bradfrost.com/blog/post/float-label-pattern/")), 'id' => 'enable_floatlabels', 'type' => 'checkbox'), array('name' => __('Disable Welcome Screen', 'give'), 'desc' => sprintf(__('Enable this option if you would like to disable the Give Welcome screen every time Give is activated and/or updated. You can always access the Welcome Screen <a href="%s">here</a> if you want in the future.', 'give'), esc_url(admin_url('index.php?page=give-about'))), 'id' => 'disable_welcome', 'type' => 'checkbox'), array('name' => __('Post Types', 'give'), 'desc' => '<hr>', 'id' => 'give_title_display_settings_2', 'type' => 'give_title'), array('name' => __('Disable Form Single Views', 'give'), 'desc' => __('By default, all forms have single views enabled which create a specific URL on your website for that form. This option disables the singular and archive views from being publicly viewable. Note: you will need to embed forms using a shortcode or widget if enabled.', 'give'), 'id' => 'disable_forms_singular', 'type' => 'checkbox'), array('name' => __('Disable Form Archives', 'give'), 'desc' => __('Archives pages list all the forms you have created. This option will disable only the form\'s archive page(s). The single form\'s view will remain in place. Note: you will need to refresh your permalinks after this option has been enabled.', 'give'), 'id' => 'disable_forms_archives', 'type' => 'checkbox'), array('name' => __('Disable Form Excerpts', 'give'), 'desc' => __('The excerpt is an optional summary or description of a donation form; in short, a summary as to why the user should give.', 'give'), 'id' => 'disable_forms_excerpt', 'type' => 'checkbox'), array('name' => __('Disable Form Featured Image', 'give'), 'desc' => __('The Featured Image is an image that is chosen as the representative image for donation form. The display of this image is largely up to the theme. If you do not wish to use the featured image you can disable it using this option.', 'give'), 'id' => 'disable_form_featured_img', 'type' => 'checkbox'), array('name' => __('Disable Single Form Sidebar', 'give'), 'desc' => __('The sidebar allows you to add additional widget to the Give single form view. If you don\'t plan on using the sidebar you may disable it with this option.', 'give'), 'id' => 'disable_form_sidebar', 'type' => 'checkbox'), array('name' => __('Taxonomies', 'give'), 'desc' => '<hr>', 'id' => 'give_title_display_settings_3', 'type' => 'give_title'), array('name' => __('Enable Form Categories', 'give'), 'desc' => __('Check this option if you would like to categorize your donation forms. This option enables the form\'s category taxonomy.', 'give'), 'id' => 'enable_categories', 'type' => 'checkbox'), array('name' => __('Enable Form Tags', 'give'), 'desc' => __('Check this option if you would like to tag your donation forms. This option enables the form\'s tag taxonomy.', 'give'), 'id' => 'enable_tags', 'type' => 'checkbox')))), 'emails' => array('id' => 'options_page', 'give_title' => __('Give Email Settings', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_emails', array(array('name' => __('Email Settings', 'give'), 'desc' => '<hr>', 'id' => 'give_title_email_settings_1', 'type' => 'give_title'), array('id' => 'email_template', 'name' => __('Email Template', 'give'), 'desc' => __('Choose a template. Click "Save Changes" then "Preview Donation Receipt" to see the new template.', 'give'), 'type' => 'select', 'options' => give_get_email_templates()), array('id' => 'email_logo', 'name' => __('Logo', 'give'), 'desc' => __('Upload or choose a logo to be displayed at the top of the donation receipt emails. Displayed on HTML emails only.', 'give'), 'type' => 'file'), array('id' => 'from_name', 'name' => __('From Name', 'give'), 'desc' => __('The name donation receipts are said to come from. This should probably be your site or shop name.', 'give'), 'default' => get_bloginfo('name'), 'type' => 'text'), array('id' => 'from_email', 'name' => __('From Email', 'give'), 'desc' => __('Email to send donation receipts from. This will act as the "from" and "reply-to" address.', 'give'), 'default' => get_bloginfo('admin_email'), 'type' => 'text'), array('name' => __('Donation Receipt', 'give'), 'desc' => '<hr>', 'id' => 'give_title_email_settings_2', 'type' => 'give_title'), array('id' => 'donation_subject', 'name' => __('Donation Email Subject', 'give'), 'desc' => __('Enter the subject line for the donation receipt email', 'give'), 'default' => __('Donation Receipt', 'give'), 'type' => 'text'), array('id' => 'donation_receipt', 'name' => __('Donation Receipt', 'give'), 'desc' => __('Enter the email that is sent to users after completing a successful donation. HTML is accepted. Available template tags:', 'give') . '<br/>' . give_get_emails_tags_list(), 'type' => 'wysiwyg', 'default' => __("Dear", "give") . " {name},\n\n" . __("Thank you for your donation. Your generosity is appreciated! Please click on the link below to view your receipt.", "give") . "\n\n{receipt_link}\n\nSincerely,\n{sitename}"), array('name' => __('New Donation Notification', 'give'), 'desc' => '<hr>', 'id' => 'give_title_email_settings_3', 'type' => 'give_title'), array('id' => 'donation_notification_subject', 'name' => __('Donation Notification Subject', 'give'), 'desc' => __('Enter the subject line for the donation notification email', 'give'), 'type' => 'text', 'default' => __('New Donation - #{payment_id}', 'give')), array('id' => 'donation_notification', 'name' => __('Donation Notification', 'give'), 'desc' => __('Enter the email that is sent to donation notification emails after completion of a donation. HTML is accepted. Available template tags:', 'give') . '<br/>' . give_get_emails_tags_list(), 'type' => 'wysiwyg', 'default' => give_get_default_donation_notification_email()), array('id' => 'admin_notice_emails', 'name' => __('Donation Notification Emails', 'give'), 'desc' => __('Enter the email address(es) that should receive a notification anytime a donation is made, one per line', 'give'), 'type' => 'textarea', 'default' => get_bloginfo('admin_email')), array('id' => 'disable_admin_notices', 'name' => __('Disable Admin Notifications', 'give'), 'desc' => __('Check this box if you do not want to receive emails when new donations are made.', 'give'), 'type' => 'checkbox')))), 'addons' => array('id' => 'options_page', 'give_title' => __('Give Add-ons Settings', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_addons', array())), 'licenses' => array('id' => 'options_page', 'give_title' => __('Give Licenses', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_licenses', array())), 'advanced' => array('id' => 'options_page', 'give_title' => __('Advanced Options', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_advanced', array(array('name' => __('Session Control', 'give'), 'desc' => '<hr>', 'id' => 'give_title_session_control_1', 'type' => 'give_title'), array('id' => 'session_lifetime', 'name' => __('Session Lifetime', 'give'), 'desc' => __('Give will start a new session per user once they have donated. This option controls the lifetime a user\'s session is kept alive. An active session allows users to view donation receipts on your site without having to be logged in.', 'give'), 'type' => 'select', 'options' => array('86400' => __('24 Hours', 'give'), '172800' => __('48 Hours', 'give'), '259200' => __('72 Hours', 'give'), '604800' => __('1 Week', 'give'))), array('name' => __('Data Control', 'give'), 'desc' => '<hr>', 'id' => 'give_title_data_control_2', 'type' => 'give_title'), array('name' => __('Remove All Data on Uninstall?', 'give'), 'desc' => __('Check this box if you would like Give to completely remove all of its data when the plugin is deleted.', 'give'), 'id' => 'uninstall_on_delete', 'type' => 'checkbox'), array('name' => __('Filter Control', 'give'), 'desc' => '<hr>', 'id' => 'give_title_filter_control', 'type' => 'give_title'), array('name' => __('Disable <code>the_content</code> filter', 'give'), 'desc' => sprintf(__('If you are seeing extra social buttons, related posts, or other unwanted elements appearing within your forms then you can disable WordPress\' content filter. <a href="%s" target="_blank">Learn more</a> about the_content filter.', 'give'), esc_url('https://codex.wordpress.org/Plugin_API/Filter_Reference/the_content')), 'id' => 'disable_the_content_filter', 'type' => 'checkbox'), array('name' => __('Script Loading', 'give'), 'desc' => '<hr>', 'id' => 'give_title_script_control', 'type' => 'give_title'), array('name' => __('Load Scripts in Footer?', 'give'), 'desc' => __('Check this box if you would like Give to load all frontend JavaScript files in the footer.', 'give'), 'id' => 'scripts_footer', 'type' => 'checkbox')))), 'api' => array('id' => 'options_page', 'give_title' => __('API', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'show_names' => false, 'fields' => apply_filters('give_settings_system', array(array('id' => 'api', 'name' => __('API', 'give'), 'type' => 'api')))), 'system_info' => array('id' => 'options_page', 'give_title' => __('System Info', 'give'), 'show_on' => array('key' => 'options-page', 'value' => array($this->key)), 'fields' => apply_filters('give_settings_system', array(array('id' => 'system_info', 'name' => __('System Info', 'give'), 'desc' => __('Please copy and paste this information in your ticket when contacting support.', 'give'), 'type' => 'system_info')))));
//Return all settings array if necessary
if ($active_tab === null || !isset($give_settings[$active_tab])) {
return apply_filters('give_registered_settings', $give_settings);
}
// Add other tabs and settings fields as needed
return apply_filters('give_registered_settings', $give_settings[$active_tab]);
}
/**
* Register gateway settings
*
* @since 1.0
* @return array
*/
function give_offline_add_settings($settings)
{
//Vars
$prefix = '_give_';
$is_gateway_active = give_is_gateway_active('offline');
//this gateway isn't active
if (!$is_gateway_active) {
//return settings and bounce
return $settings;
}
//Fields
$check_settings = array(array('name' => __('Customize Offline Donations', 'give'), 'desc' => __('If you would like to customize the donation instructions for this specific forms check this option.', 'give'), 'id' => $prefix . 'customize_offline_donations', 'type' => 'radio_inline', 'default' => 'no', 'options' => array('yes' => __('Yes', 'give'), 'no' => __('No', 'give'))), array('name' => __('Request Billing Information', 'give'), 'desc' => __('This option will enable the billing details section for this form\'s offline donation payment gateway. The fieldset will appear above the offline donation instructions.', 'give'), 'id' => $prefix . 'offline_donation_enable_billing_fields_single', 'row_classes' => 'give-subfield', 'type' => 'checkbox'), array('id' => $prefix . 'offline_checkout_notes', 'name' => __('Offline Donation Instructions', 'give'), 'desc' => __('Enter the instructions you want to display to the donor during the donation process. Most likely this would include important information like mailing address and who to make the check out to.', 'give'), 'default' => give_get_default_offline_donation_content(), 'type' => 'wysiwyg', 'row_classes' => 'give-subfield', 'options' => array('textarea_rows' => 6)), array('id' => $prefix . 'offline_donation_subject', 'name' => __('Offline Donation Email Instructions Subject', 'give'), 'desc' => __('Enter the subject line for the donation receipt email.', 'give'), 'default' => __('{donation} - Offline Donation Instructions', 'give'), 'row_classes' => 'give-subfield', 'type' => 'text'), array('id' => $prefix . 'offline_donation_email', 'name' => __('Offline Donation Email Instructions', 'give'), 'desc' => __('Enter the instructions you want emailed to the donor after they have submitted the donation form. Most likely this would include important information like mailing address and who to make the check out to.', 'give'), 'default' => give_get_default_offline_donation_email_content(), 'type' => 'wysiwyg', 'row_classes' => 'give-subfield', 'options' => array('textarea_rows' => 6)));
return array_merge($settings, $check_settings);
}
