class-give-scripts.php — GiveWP – Donation Plugin and Fundraising Platform 2.2.0

give / includes / class-give-scripts.php

give / includes Last commit date

class-give-scripts.php

539 lines

1	<?php
2
3	/**
4	* Loads the plugin's scripts and styles.
5	*
6	* Registers and enqueues plugin styles and scripts. Asset versions are based
7	* on the current plugin version.
8	*
9	* All script and style handles should be registered in this class even if they
10	* are enqueued dynamically by other classes.
11	*
12	* @since 2.1.0
13	*/
14	class Give_Scripts {
15
16	/**
17	* Whether RTL or not.
18	*
19	* @since 2.1.0
20	* @var string
21	* @access private
22	*/
23	private $direction;
24
25	/**
26	* Whether scripts should be loaded in the footer or not.
27	*
28	* @since 2.1.0
29	* @var bool
30	* @access private
31	*/
32	private $scripts_footer;
33
34	/**
35	* Instantiates the Assets class.
36	*
37	* @since 2.1.0
38	*/
39	public function __construct() {
40	$this->direction = ( is_rtl() \|\| isset( $_GET['d'] ) && 'rtl' === $_GET['d'] ) ? '.rtl' : '';
41	$this->scripts_footer = give_is_setting_enabled( give_get_option( 'scripts_footer' ) ) ? true : false;
42	$this->init();
43	}
44
45	/**
46	* Fires off hooks to register assets in WordPress.
47	*
48	* @since 2.1.0
49	*/
50	public function init() {
51
52	add_action( 'admin_enqueue_scripts', array( $this, 'register_styles' ) );
53	add_action( 'admin_enqueue_scripts', array( $this, 'register_scripts' ) );
54	add_action( 'wp_enqueue_scripts', array( $this, 'register_styles' ) );
55	add_action( 'wp_enqueue_scripts', array( $this, 'register_scripts' ) );
56
57	if ( is_admin() ) {
58	add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_scripts' ) );
59	add_action( 'admin_enqueue_scripts', array( $this, 'admin_enqueue_styles' ) );
60	add_action( 'enqueue_block_editor_assets', array( $this, 'gutenberg_admin_scripts' ) );
61	add_action( 'admin_head', array( $this, 'global_admin_head' ) );
62
63	} else {
64	add_action( 'wp_enqueue_scripts', array( $this, 'public_enqueue_styles' ) );
65	add_action( 'wp_enqueue_scripts', array( $this, 'public_enqueue_scripts' ) );
66	}
67	}
68
69	/**
70	* Registers all plugin styles.
71	*
72	* @since 2.1.0
73	*/
74	public function register_styles() {
75
76	// WP-admin.
77	wp_register_style( 'give-admin-styles', GIVE_PLUGIN_URL . 'assets/dist/css/admin' . $this->direction . '.css', array(), GIVE_VERSION );
78
79	// WP-admin: plugin page.
80	wp_register_style(
81	'plugin-deactivation-survey-css',
82	GIVE_PLUGIN_URL . 'assets/dist/css/plugin-deactivation-survey.css',
83	array(),
84	GIVE_VERSION
85	);
86
87	// Frontend.
88	if ( give_is_setting_enabled( give_get_option( 'css' ) ) ) {
89	wp_register_style( 'give-styles', $this->get_frontend_stylesheet_uri(), array(), GIVE_VERSION, 'all' );
90	}
91	}
92
93	/**
94	* Registers all plugin scripts.
95	*
96	* @since 2.1.0
97	*/
98	public function register_scripts() {
99
100	// WP-Admin.
101	wp_register_script( 'give-admin-scripts', GIVE_PLUGIN_URL . 'assets/dist/js/admin.js', array(
102	'jquery',
103	'jquery-ui-datepicker',
104	'wp-color-picker',
105	'jquery-query',
106	), GIVE_VERSION );
107
108	// WP-admin: plugin page.
109	wp_register_script( 'plugin-deactivation-survey-js',
110	GIVE_PLUGIN_URL . 'assets/dist/js/plugin-deactivation-survey.js',
111	array( 'jquery' ),
112	GIVE_VERSION,
113	true
114	);
115
116	// Frontend.
117	wp_register_script( 'give', GIVE_PLUGIN_URL . 'assets/dist/js/give.js', array( 'jquery' ), GIVE_VERSION, $this->scripts_footer );
118	}
119
120	/**
121	* Enqueues admin styles.
122	*
123	* @since 2.1.0
124	*
125	* @param string $hook Page hook.
126	*/
127	public function admin_enqueue_styles( $hook ) {
128	// Give Admin Only.
129	if ( ! apply_filters( 'give_load_admin_styles', give_is_admin_page(), $hook ) ) {
130	return;
131	}
132
133	// Give enqueues.
134	wp_enqueue_style( 'give-admin-styles' );
135	wp_enqueue_style( 'give-admin-bar-notification' );
136
137	// WP Core enqueues.
138	wp_enqueue_style( 'wp-color-picker' );
139	wp_enqueue_style( 'thickbox' ); // @TODO remove once we have modal API.
140
141	}
142
143	/**
144	* Enqueues admin scripts.
145	*
146	* @since 2.1.0
147	*
148	* @param string $hook Page hook.
149	*/
150	public function admin_enqueue_scripts( $hook ) {
151	global $pagenow;
152
153	// Plugin page script
154	if ( 'plugins.php' === $pagenow ) {
155	$this->plugin_equeue_scripts();
156	}
157
158	// Give Admin Only.
159	if ( ! apply_filters( 'give_load_admin_scripts', give_is_admin_page(), $hook ) ) {
160	return;
161	}
162
163	// WP Scripts.
164	wp_enqueue_script( 'wp-color-picker' );
165	wp_enqueue_script( 'jquery-ui-datepicker' );
166	wp_enqueue_script( 'thickbox' );
167	wp_enqueue_media();
168
169	// Give admin scripts.
170	wp_enqueue_script( 'give-admin-scripts' );
171
172	// Localize admin scripts
173	$this->admin_localize_scripts();
174	}
175
176
177	/**
178	* Load admin plugin page related scripts, styles andd localize param
179	*
180	*
181	* @since 2.2.0
182	* @access private
183	*
184	*/
185	private function plugin_equeue_scripts() {
186	wp_enqueue_style( 'plugin-deactivation-survey-css' );
187	wp_enqueue_script( 'plugin-deactivation-survey-js' );
188
189	$localized_data = array(
190	'nonce' => wp_create_nonce( 'deactivation_survey_nonce' ),
191	'cancel' => __( 'Cancel', 'give' ),
192	'deactivation_no_option_selected' => __( 'Error: Please select at least one option.', 'give' ),
193	'submit_and_deactivate' => __( 'Submit and Deactivate', 'give' ),
194	'skip_and_deactivate' => __( 'Skip & Deactivate', 'give' ),
195	'please_fill_field' => __( 'Error: Please fill the field.', 'give' ),
196
197	);
198	wp_localize_script( 'plugin-deactivation-survey-js', 'give_vars', $localized_data );
199	}
200
201	/**
202	* Localize admin scripts.
203	*/
204	public function admin_localize_scripts() {
205
206	global $post, $pagenow;
207	$give_options = give_get_settings();
208
209	// Price Separators.
210	$thousand_separator = give_get_price_thousand_separator();
211	$decimal_separator = give_get_price_decimal_separator();
212
213	// Localize strings & variables for JS.
214	$localized_data = array(
215	'post_id' => isset( $post->ID ) ? $post->ID : null,
216	'give_version' => GIVE_VERSION,
217	'thousands_separator' => $thousand_separator,
218	'decimal_separator' => $decimal_separator,
219	'quick_edit_warning' => __( 'Not available for variable priced forms.', 'give' ),
220	'delete_payment' => __( 'Are you sure you want to <strong>permanently</strong> delete this donation?', 'give' ),
221	'delete_payment_note' => __( 'Are you sure you want to delete this note?', 'give' ),
222	'revoke_api_key' => __( 'Are you sure you want to revoke this API key?', 'give' ),
223	'regenerate_api_key' => __( 'Are you sure you want to regenerate this API key?', 'give' ),
224	'resend_receipt' => __( 'Are you sure you want to resend the donation receipt?', 'give' ),
225	'disconnect_user' => __( 'Are you sure you want to disconnect the user from this donor?', 'give' ),
226	'one_option' => __( 'Choose a form', 'give' ),
227	'one_or_more_option' => __( 'Choose one or more forms', 'give' ),
228	'currency_sign' => give_currency_filter( '' ),
229	'currency_pos' => isset( $give_options['currency_position'] ) ? $give_options['currency_position'] : 'before',
230	'currency_decimals' => give_get_price_decimals(),
231	'ok' => __( 'Ok', 'give' ),
232	'cancel' => __( 'Cancel', 'give' ),
233	'success' => __( 'Success', 'give' ),
234	'error' => __( 'Error', 'give' ),
235	'close' => __( 'Close', 'give' ),
236	'confirm' => __( 'Confirm', 'give' ),
237	'confirm_action' => __( 'Confirm Action', 'give' ),
238	'confirm_deletion' => __( 'Confirm Deletion', 'give' ),
239	'confirm_delete_donation' => __( 'Confirm Delete Donation', 'give' ),
240	'confirm_resend' => __( 'Confirm re-send', 'give' ),
241	'confirm_bulk_action' => __( 'Confirm bulk action', 'give' ),
242	'restart_upgrade' => __( 'Do you want to restart the update process?', 'give' ),
243	'restart_update' => __( 'It is recommended that you backup your database before proceeding. Do you want to run the update now?', 'give' ),
244	'stop_upgrade' => __( 'Do you want to stop the update process now?', 'give' ),
245	'import_failed' => __( 'Import failed', 'give' ),
246	'flush_success' => __( 'Flush success', 'give' ),
247	'flush_error' => __( 'Flush error', 'give' ),
248	'no_form_selected' => __( 'No form selected', 'give' ),
249	'batch_export_no_class' => __( 'You must choose a method.', 'give' ),
250	'batch_export_no_reqs' => __( 'Required fields not completed.', 'give' ),
251	'reset_stats_warn' => __( 'Are you sure you want to reset Give? This process is <strong><em>not reversible</em></strong> and will delete all data regardless of test or live mode. Please be sure you have a recent backup before proceeding.', 'give' ),
252	'delete_test_donor' => __( 'Are you sure you want to delete all the test donors? This process will also delete test donations as well.', 'give' ),
253	'delete_import_donor' => __( 'Are you sure you want to delete all the imported donors? This process will also delete imported donations as well.', 'give' ),
254	'price_format_guide' => sprintf( __( 'Please enter amount in monetary decimal ( %1$s ) format without thousand separator ( %2$s ) .', 'give' ), $decimal_separator, $thousand_separator ),
255	/* translators : %s: Donation form options metabox */
256	'confirm_before_remove_row_text' => __( 'Do you want to delete this item?', 'give' ),
257	'matched_success_failure_page' => __( 'You cannot set the success and failed pages to the same page', 'give' ),
258	'dismiss_notice_text' => __( 'Dismiss this notice.', 'give' ),
259	'search_placeholder' => __( 'Type to search all forms', 'give' ),
260	'search_placeholder_donor' => __( 'Type to search all donors', 'give' ),
261	'search_placeholder_country' => __( 'Type to search all countries', 'give' ),
262	'search_placeholder_state' => __( 'Type to search all states/provinces', 'give' ),
263	'unlock_donor_fields_title' => __( 'Action forbidden', 'give' ),
264	'unlock_donor_fields_message' => __( 'To edit first name and last name, please go to user profile of the donor.', 'give' ),
265	'remove_from_bulk_delete' => __( 'Remove from Bulk Delete', 'give' ),
266	'donors_bulk_action' => array(
267	'no_donor_selected' => array(
268	'title' => __( 'No donors selected', 'give' ),
269	'desc' => __( 'You must choose at least one or more donors to delete.', 'give' )
270	),
271	'no_action_selected' => array(
272	'title' => __( 'No action selected', 'give' ),
273	'desc' => __( 'You must select a bulk action to proceed.', 'give' ),
274	),
275	),
276	'donations_bulk_action' => array(
277	'titles' => array(
278	'zero' => __( 'No payments selected', 'give' ),
279	),
280	'delete' => array(
281	'zero' => __( 'You must choose at least one or more donations to delete.', 'give' ),
282	'single' => __( 'Are you sure you want to permanently delete this donation?', 'give' ),
283	'multiple' => __( 'Are you sure you want to permanently delete the selected {payment_count} donations?', 'give' ),
284	),
285	'resend-receipt' => array(
286	'zero' => __( 'You must choose at least one or more recipients to resend the email receipt.', 'give' ),
287	'single' => __( 'Are you sure you want to resend the email receipt to this recipient?', 'give' ),
288	'multiple' => __( 'Are you sure you want to resend the emails receipt to {payment_count} recipients?', 'give' ),
289	),
290	'set-to-status' => array(
291	'zero' => __( 'You must choose at least one or more donations to set status to {status}.', 'give' ),
292	'single' => __( 'Are you sure you want to set status of this donation to {status}?', 'give' ),
293	'multiple' => __( 'Are you sure you want to set status of {payment_count} donations to {status}?', 'give' ),
294	),
295	),
296	'updates' => array(
297	'ajax_error' => __( 'Please reload this page and try again', 'give' ),
298	),
299	'metabox_fields' => array(
300	'media' => array(
301	'button_title' => __( 'Choose Image', 'give' ),
302	),
303	'file' => array(
304	'button_title' => __( 'Choose File', 'give' ),
305	),
306	),
307	'chosen' => array(
308	'no_results_msg' => __( 'No results match {search_term}', 'give' ),
309	'ajax_search_msg' => __( 'Searching results for match {search_term}', 'give' ),
310	),
311	'db_update_confirmation_msg_button' => __( 'Run Updates', 'give' ),
312	'db_update_confirmation_msg' => __( 'The following process will make updates to your site\'s database. Please create a database backup before proceeding with updates.', 'give' ),
313	'error_message' => __( 'Something went wrong kindly try again!', 'give' ),
314	'give_donation_import' => 'give_donation_import',
315	'core_settings_import' => 'give_core_settings_import',
316	'setting_not_save_message' => __( 'Changes you made may not be saved.', 'give' ),
317	'give_donation_amounts' => array(
318	'minimum' => apply_filters( 'give_donation_minimum_limit', 1 ),
319	'maximum' => apply_filters( 'give_donation_maximum_limit', 999999.99 ),
320	),
321	'chosen_add_title_prefix' => __( 'No result found. Press enter to add', 'give' ),
322	'db_update_nonce' => wp_create_nonce( Give_Updates::$background_updater->get_identifier() ),
323	'ajax' => give_test_ajax_works(),
324	'date_format' => give_get_localized_date_format_to_js(),
325	);
326
327	wp_localize_script( 'give-admin-scripts', 'give_vars', $localized_data );
328	}
329
330	/**
331	* Global admin head.
332	*/
333	public function global_admin_head() {
334	?>
335	<style type="text/css" media="screen">
336	@font-face {
337	font-family: 'give-icomoon';
338	src: url('<?php echo GIVE_PLUGIN_URL . 'assets/dist/fonts/icomoon.eot?ngjl88'; ?>');
339	src: url('<?php echo GIVE_PLUGIN_URL . 'assets/dist/fonts/icomoon.eot?#iefixngjl88'?>') format('embedded-opentype'),
340	url('<?php echo GIVE_PLUGIN_URL . 'assets/dist/fonts/icomoon.woff?ngjl88'; ?>') format('woff'),
341	url('<?php echo GIVE_PLUGIN_URL . 'assets/dist/fonts/icomoon.svg?ngjl88#icomoon'; ?>') format('svg');
342	font-weight: normal;
343	font-style: normal;
344	}
345
346	.dashicons-give:before, #adminmenu div.wp-menu-image.dashicons-give:before {
347	font-family: 'give-icomoon';
348	font-size: 18px;
349	width: 18px;
350	height: 18px;
351	content: "\e800";
352	}
353	</style>
354	<?php
355
356	}
357
358	/**
359	* Enqueues public styles.
360	*
361	* @since 2.1.0
362	*/
363	public function public_enqueue_styles() {
364	wp_enqueue_style( 'give-styles' );
365	}
366
367
368	/**
369	* Enqueues public scripts.
370	*
371	* @since 2.1.0
372	*/
373	public function public_enqueue_scripts() {
374
375	// Call Babel Polyfill with common handle so that it is compatible with plugins and themes.
376	if ( ! wp_script_is( 'babel-polyfill', 'enqueued' ) ) {
377	wp_enqueue_script(
378	'babel-polyfill',
379	GIVE_PLUGIN_URL . 'assets/dist/js/babel-polyfill.js',
380	array( 'jquery' ),
381	GIVE_VERSION,
382	false
383	);
384	}
385
386	wp_enqueue_script( 'give' );
387
388	$this->public_localize_scripts();
389	}
390
391	/**
392	* Localize / PHP to AJAX vars.
393	*/
394	public function public_localize_scripts() {
395
396	/**
397	* Filter to modify access mail send notice
398	*
399	* @since 2.1.3
400	*
401	* @param string Send notice message for email access.
402	*
403	* @return string $message Send notice message for email access.
404	*/
405	$message = (string) apply_filters( 'give_email_access_mail_send_notice', __( 'Please check your email and click on the link to access your complete donation history.', 'give' ) );
406
407	$localize_give_vars = apply_filters( 'give_global_script_vars', array(
408	'ajaxurl' => give_get_ajax_url(),
409	'checkout_nonce' => wp_create_nonce( 'give_checkout_nonce' ),
410	// Do not use this nonce. Its deprecated.
411	'currency' => give_get_currency(),
412	'currency_sign' => give_currency_filter( '' ),
413	'currency_pos' => give_get_currency_position(),
414	'thousands_separator' => give_get_price_thousand_separator(),
415	'decimal_separator' => give_get_price_decimal_separator(),
416	'no_gateway' => __( 'Please select a payment method.', 'give' ),
417	'bad_minimum' => __( 'The minimum custom donation amount for this form is', 'give' ),
418	'bad_maximum' => __( 'The maximum custom donation amount for this form is', 'give' ),
419	'general_loading' => __( 'Loading...', 'give' ),
420	'purchase_loading' => __( 'Please Wait...', 'give' ),
421	'number_decimals' => give_get_price_decimals(),
422	'give_version' => GIVE_VERSION,
423	'magnific_options' => apply_filters(
424	'give_magnific_options',
425	array(
426	'main_class' => 'give-modal',
427	'close_on_bg_click' => false,
428	)
429	),
430	'form_translation' => apply_filters(
431	'give_form_translation_js',
432	array(
433	// Field name Validation message.
434	'payment-mode' => __( 'Please select payment mode.', 'give' ),
435	'give_first' => __( 'Please enter your first name.', 'give' ),
436	'give_email' => __( 'Please enter a valid email address.', 'give' ),
437	'give_user_login' => __( 'Invalid username. Only lowercase letters (a-z) and numbers are allowed.', 'give' ),
438	'give_user_pass' => __( 'Enter a password.', 'give' ),
439	'give_user_pass_confirm' => __( 'Enter the password confirmation.', 'give' ),
440	'give_agree_to_terms' => __( 'You must agree to the terms and conditions.', 'give' ),
441	)
442	),
443	'confirm_email_sent_message' => $message,
444	'ajax_vars' => apply_filters( 'give_global_ajax_vars', array(
445	'ajaxurl' => give_get_ajax_url(),
446	'ajaxNonce' => wp_create_nonce( 'give_ajax_nonce' ),
447	'loading' => __( 'Loading', 'give' ),
448	// General loading message.
449	'select_option' => __( 'Please select an option', 'give' ),
450	// Variable pricing error with multi-donation option enabled.
451	'default_gateway' => give_get_default_gateway( null ),
452	'permalinks' => get_option( 'permalink_structure' ) ? '1' : '0',
453	'number_decimals' => give_get_price_decimals(),
454	) ),
455	'cookie_hash' => COOKIEHASH,
456	'delete_session_nonce_cookie' => absint( Give()->session->is_delete_nonce_cookie() )
457	) );
458
459	wp_localize_script( 'give', 'give_global_vars', $localize_give_vars );
460
461	}
462
463	/**
464	* Get the stylesheet URI.
465	*
466	* @since 1.6
467	* @updated 2.0.1 Moved to class and renamed as method.
468	*
469	* @return string
470	*/
471	public function get_frontend_stylesheet_uri() {
472
473	$file = 'give' . $this->direction . '.css';
474	$templates_dir = give_get_theme_template_dir_name();
475
476	// Directory paths to CSS files to support checking via file_exists().
477	$child_theme_style_sheet = trailingslashit( get_stylesheet_directory() ) . $templates_dir . $file;
478	$child_theme_style_sheet_2 = trailingslashit( get_stylesheet_directory() ) . $templates_dir . 'give' . $this->direction . '.css';
479	$parent_theme_style_sheet = trailingslashit( get_template_directory() ) . $templates_dir . $file;
480	$parent_theme_style_sheet_2 = trailingslashit( get_template_directory() ) . $templates_dir . 'give' . $this->direction . '.css';
481	$give_plugin_style_sheet = trailingslashit( GIVE_PLUGIN_DIR ) . 'assets/dist/css/' . $file;
482	$uri = false;
483
484	/**
485	* Locate the Give stylesheet:
486	*
487	* a. Look in the child theme directory first, followed by the parent theme
488	* b. followed by the Give core templates directory also look for the min version first,
489	* c. followed by non minified version, even if SCRIPT_DEBUG is not enabled. This allows users to copy just give.css to their theme.
490	* d. Finally, fallback to the standard Give version. This is the default styles included within the plugin.
491	*/
492	if ( file_exists( $child_theme_style_sheet ) \|\| ( ! empty( $suffix ) && ( $nonmin = file_exists( $child_theme_style_sheet_2 ) ) ) ) {
493	if ( ! empty( $nonmin ) ) {
494	$uri = trailingslashit( get_stylesheet_directory_uri() ) . $templates_dir . 'give' . $this->direction . '.css';
495	} else {
496	$uri = trailingslashit( get_stylesheet_directory_uri() ) . $templates_dir . $file;
497	}
498	} elseif ( file_exists( $parent_theme_style_sheet ) \|\| ( ! empty( $suffix ) && ( $nonmin = file_exists( $parent_theme_style_sheet_2 ) ) ) ) {
499	if ( ! empty( $nonmin ) ) {
500	$uri = trailingslashit( get_template_directory_uri() ) . $templates_dir . 'give' . $this->direction . '.css';
501	} else {
502	$uri = trailingslashit( get_template_directory_uri() ) . $templates_dir . $file;
503	}
504	} elseif ( file_exists( $give_plugin_style_sheet ) ) {
505	$uri = trailingslashit( GIVE_PLUGIN_URL ) . 'assets/dist/css/' . $file;
506	}
507
508	return apply_filters( 'give_get_stylesheet_uri', $uri );
509
510	}
511
512	/**
513	* Gutenberg admin scripts.
514	*/
515	public function gutenberg_admin_scripts() {
516
517	// Enqueue the bundled block JS file
518	wp_enqueue_script(
519	'give-blocks-js',
520	GIVE_PLUGIN_URL . 'assets/dist/js/gutenberg.js',
521	array( 'wp-i18n', 'wp-element', 'wp-blocks', 'wp-components', 'wp-api' ),
522	GIVE_VERSION
523	);
524
525	// Enqueue public styles
526	wp_enqueue_style( 'give-styles' );
527
528	// Enqueue the bundled block css file
529	wp_enqueue_style(
530	'give-blocks-css',
531	GIVE_PLUGIN_URL . 'assets/dist/css/gutenberg.css',
532	array( 'wp-blocks' ),
533	GIVE_VERSION
534	);
535
536	}
537
538	}
539