PluginProbe
Kit (formerly ConvertKit) – Email Newsletter, Email Marketing, Membership, Subscribers and Landing Pages / 2.0.3
Kit (formerly ConvertKit) – Email Newsletter, Email Marketing, Membership, Subscribers and Landing Pages v2.0.3
3.4.3 3.4.2 3.4.1 3.4.0 3.3.9 3.3.8 3.3.7 3.3.6 3.3.5 3.3.4 3.3.3 3.3.2 3.3.1 2.2.0 2.2.1 2.2.2 2.2.3 2.2.4 2.2.5 2.2.6 2.2.7 2.2.8 2.2.9 2.3.0 2.3.1 All 196 releases
← All changes | includes/class-convertkit-settings.php +8 -520 3.3.72.0.3 View file →
@@ -158,105 +158,13 @@
158 158 * @return bool
159 159 */
160 160 public function has_api_key_and_secret() {
161 161
162 - _deprecated_function( __FUNCTION__, '2.6.3', 'has_access_and_refresh_token()' );
162 + return $this->has_api_key() && $this->has_api_secret();
163 163
164 - // Use check for access and refresh token.
165 - return $this->has_access_and_refresh_token();
166 -
167 164 }
168 165
169 166 /**
170 - * Returns the Access Token Plugin setting.
171 - *
172 - * @since 2.5.0
173 - *
174 - * @return string
175 - */
176 - public function get_access_token() {
177 -
178 - // Reload settings from options table, to ensure we have the latest tokens.
179 - $this->refresh_settings();
180 -
181 - // Return Access Token from settings.
182 - return $this->settings['access_token'];
183 -
184 - }
185 -
186 - /**
187 - * Returns whether the Access Token has been set in the Plugin settings.
188 - *
189 - * @since 2.5.0
190 - *
191 - * @return bool
192 - */
193 - public function has_access_token() {
194 -
195 - return ( ! empty( $this->get_access_token() ) ? true : false );
196 -
197 - }
198 -
199 - /**
200 - * Returns the Refresh Token Plugin setting.
201 - *
202 - * @since 2.5.0
203 - *
204 - * @return string
205 - */
206 - public function get_refresh_token() {
207 -
208 - // Reload settings from options table, to ensure we have the latest tokens.
209 - $this->refresh_settings();
210 -
211 - // Return Refresh Token from settings.
212 - return $this->settings['refresh_token'];
213 -
214 - }
215 -
216 - /**
217 - * Returns whether the Refresh Token has been set in the Plugin settings.
218 - *
219 - * @since 2.5.0
220 - *
221 - * @return bool
222 - */
223 - public function has_refresh_token() {
224 -
225 - return ( ! empty( $this->get_refresh_token() ) ? true : false );
226 -
227 - }
228 -
229 - /**
230 - * Returns whether to use Access and Refresh Tokens for API requests,
231 - * based on whether an Access Token and Refresh Token have been saved
232 - * in the Plugin settings.
233 - *
234 - * @since 2.5.0
235 - *
236 - * @return bool
237 - */
238 - public function has_access_and_refresh_token() {
239 -
240 - return $this->has_access_token() && $this->has_refresh_token();
241 -
242 - }
243 -
244 - /**
245 - * Returns the Access Token expiry timestamp.
246 - *
247 - * @since 2.5.0
248 - *
249 - * @return int
250 - */
251 - public function get_token_expiry() {
252 -
253 - // Return Token Expiry from settings.
254 - return $this->settings['token_expires'];
255 -
256 - }
257 -
258 - /**
259 167 * Returns the Default Form Plugin setting.
260 168 *
261 169 * @since 1.9.6
262 170 *
@@ -294,296 +202,8 @@
294 202
295 203 }
296 204
297 205 /**
298 - * Returns the Default Form Position Plugin setting.
299 - *
300 - * @since 2.5.8
301 - *
302 - * @param string $post_type Post Type.
303 - * @return string|int Default Form (default|form id)
304 - */
305 - public function get_default_form_position( $post_type ) {
306 -
307 - // Return after_content if this Post Type's position doesn't exist as a setting.
308 - if ( ! array_key_exists( $post_type . '_form_position', $this->settings ) ) {
309 - return 'after_content';
310 - }
311 -
312 - return $this->settings[ $post_type . '_form_position' ];
313 -
314 - }
315 -
316 - /**
317 - * Returns the Default Form Position Element Plugin setting.
318 - *
319 - * @since 2.6.1
320 - *
321 - * @param string $post_type Post Type.
322 - * @return string Element to insert form after
323 - */
324 - public function get_default_form_position_element( $post_type ) {
325 -
326 - // Return after_content if this Post Type's position doesn't exist as a setting.
327 - if ( ! array_key_exists( $post_type . '_form_position_element', $this->settings ) ) {
328 - return 'p';
329 - }
330 -
331 - return $this->settings[ $post_type . '_form_position_element' ];
332 -
333 - }
334 -
335 - /**
336 - * Returns the Default Form Position Index Plugin setting.
337 - *
338 - * @since 2.6.1
339 - *
340 - * @param string $post_type Post Type.
341 - * @return int Number of elements before inserting form
342 - */
343 - public function get_default_form_position_element_index( $post_type ) {
344 -
345 - // Return 1 if this Post Type's position index doesn't exist as a setting.
346 - if ( ! array_key_exists( $post_type . '_form_position_element_index', $this->settings ) ) {
347 - return 1;
348 - }
349 -
350 - return (int) $this->settings[ $post_type . '_form_position_element_index' ];
351 -
352 - }
353 -
354 - /**
355 - * Returns the Global non-inline Form Plugin setting.
356 - *
357 - * @since 2.3.3
358 - *
359 - * @return array
360 - */
361 - public function get_non_inline_form() {
362 -
363 - // Return blank array if no inline form is specified.
364 - if ( ! $this->has_non_inline_form() ) {
365 - return array();
366 - }
367 -
368 - // 2.6.8 and earlier stored a single Form ID in a string.
369 - if ( is_string( $this->settings['non_inline_form'] ) ) {
370 - return array( (int) $this->settings['non_inline_form'] );
371 - }
372 -
373 - // Cast values to integers and return.
374 - return array_map( 'intval', $this->settings['non_inline_form'] );
375 -
376 - }
377 -
378 - /**
379 - * Returns whether the Global non-inline Form has been set in the Plugin settings.
380 - *
381 - * @since 2.3.3
382 - *
383 - * @return bool Global non-inline Form setting specified in Plugin Settings.
384 - */
385 - public function has_non_inline_form() {
386 -
387 - // 2.6.8 and earlier stored a single Form ID in a string.
388 - if ( is_string( $this->settings['non_inline_form'] ) ) {
389 - if ( ! empty( $this->settings['non_inline_form'] ) ) {
390 - return true;
391 - }
392 -
393 - return false;
394 - }
395 -
396 - return ( count( $this->settings['non_inline_form'] ) > 0 ? true : false );
397 -
398 - }
399 -
400 - /**
401 - * Returns whether the Global non-inline Form setting should honor the Page / Post
402 - * None setting.
403 - *
404 - * @since 2.7.3
405 - *
406 - * @return bool
407 - */
408 - public function non_inline_form_honor_none_setting() {
409 -
410 - return ( $this->settings['non_inline_form_honor_none_setting'] === 'on' ? true : false );
411 -
412 - }
413 -
414 - /**
415 - * Returns whether the Non-inline Form Limit per Session setting has been set in the Plugin settings.
416 - *
417 - * @since 3.0.0
418 - *
419 - * @return bool
420 - */
421 - public function non_inline_form_limit_per_session() {
422 -
423 - return ( $this->settings['non_inline_form_limit_per_session'] === 'on' ? true : false );
424 -
425 - }
426 -
427 - /**
428 - * Returns the active spam protection provider Plugin setting.
429 - *
430 - * @since 3.3.7
431 - *
432 - * @return string none|recaptcha|turnstile
433 - */
434 - public function spam_protection_provider() {
435 -
436 - return $this->settings['spam_protection_provider'];
437 -
438 - }
439 -
440 - /**
441 - * Returns the reCAPTCHA Site Key Plugin setting.
442 - *
443 - * @since 3.0.0
444 - *
445 - * @return string
446 - */
447 - public function recaptcha_site_key() {
448 -
449 - return $this->settings['recaptcha_site_key'];
450 -
451 - }
452 -
453 - /**
454 - * Returns whether the reCAPTCHA Site Key has been set in the Plugin settings.
455 - *
456 - * @since 3.0.0
457 - *
458 - * @return bool
459 - */
460 - public function has_recaptcha_site_key() {
461 -
462 - return ! empty( $this->recaptcha_site_key() );
463 -
464 - }
465 -
466 - /**
467 - * Returns the reCAPTCHA Secret Key Plugin setting.
468 - *
469 - * @since 3.0.0
470 - *
471 - * @return string
472 - */
473 - public function recaptcha_secret_key() {
474 -
475 - return $this->settings['recaptcha_secret_key'];
476 -
477 - }
478 -
479 - /**
480 - * Returns whether the reCAPTCHA Secret Key has been set in the Plugin settings.
481 - *
482 - * @since 3.0.0
483 - *
484 - * @return bool
485 - */
486 - public function has_recaptcha_secret_key() {
487 -
488 - return ! empty( $this->recaptcha_secret_key() );
489 -
490 - }
491 -
492 - /**
493 - * Returns whether the reCAPTCH Site Key and Secret Key are defined
494 - * in the Plugin settings.
495 - *
496 - * @since 3.0.0
497 - *
498 - * @return bool
499 - */
500 - public function has_recaptcha_site_and_secret_keys() {
501 -
502 - return $this->has_recaptcha_site_key() && $this->has_recaptcha_secret_key();
503 -
504 - }
505 -
506 - /**
507 - * Returns the reCAPTCHA minimum score Plugin setting.
508 - *
509 - * @since 3.0.0
510 - *
511 - * @return float
512 - */
513 - public function recaptcha_minimum_score() {
514 -
515 - return (float) $this->settings['recaptcha_minimum_score'];
516 -
517 - }
518 -
519 - /**
520 - * Returns the Cloudflare Turnstile Site Key Plugin setting.
521 - *
522 - * @since 3.3.7
523 - *
524 - * @return string
525 - */
526 - public function cloudflare_turnstile_site_key() {
527 -
528 - return $this->settings['cloudflare_turnstile_site_key'];
529 -
530 - }
531 -
532 - /**
533 - * Returns whether the Cloudflare Turnstile Site Key has been set in the Plugin settings.
534 - *
535 - * @since 3.3.7
536 - *
537 - * @return bool
538 - */
539 - public function has_cloudflare_turnstile_site_key() {
540 -
541 - return ! empty( $this->cloudflare_turnstile_site_key() );
542 -
543 - }
544 -
545 - /**
546 - * Returns the Cloudflare Turnstile Secret Key Plugin setting.
547 - *
548 - * @since 3.3.7
549 - *
550 - * @return string
551 - */
552 - public function cloudflare_turnstile_secret_key() {
553 -
554 - return $this->settings['cloudflare_turnstile_secret_key'];
555 -
556 - }
557 -
558 - /**
559 - * Returns whether the Cloudflare Turnstile Secret Key has been set in the Plugin settings.
560 - *
561 - * @since 3.3.7
562 - *
563 - * @return bool
564 - */
565 - public function has_cloudflare_turnstile_secret_key() {
566 -
567 - return ! empty( $this->cloudflare_turnstile_secret_key() );
568 -
569 - }
570 -
571 - /**
572 - * Returns whether the Cloudflare Turnstile Site Key and Secret Key are defined
573 - * in the Plugin settings.
574 - *
575 - * @since 3.3.7
576 - *
577 - * @return bool
578 - */
579 - public function has_cloudflare_turnstile_site_and_secret_keys() {
580 -
581 - return $this->has_cloudflare_turnstile_site_key() && $this->has_cloudflare_turnstile_secret_key();
582 -
583 - }
584 -
585 - /**
586 206 * Returns whether debugging is enabled in the Plugin settings.
587 207 *
588 208 * @since 1.9.6
589 209 *
@@ -621,34 +241,8 @@
621 241
622 242 }
623 243
624 244 /**
625 - * Returns whether the Add New Landing Page / Member Content button is disabled in the Plugin settings.
626 - *
627 - * @since 3.2.0
628 - *
629 - * @return bool
630 - */
631 - public function add_new_button_disabled() {
632 -
633 - return ( $this->settings['no_add_new_button'] === 'on' ? true : false );
634 -
635 - }
636 -
637 - /**
638 - * Returns whether usage tracking is enabled in the Plugin settings.
639 - *
640 - * @since 3.0.4
641 - *
642 - * @return bool
643 - */
644 - public function usage_tracking() {
645 -
646 - return ( $this->settings['usage_tracking'] === 'on' ? true : false );
647 -
648 - }
649 -
650 - /**
651 245 * The default settings, used when the ConvertKit Plugin Settings haven't been saved
652 246 * e.g. on a new installation.
653 247 *
654 248 * @since 1.9.6
@@ -657,48 +251,18 @@
657 251 */
658 252 public function get_defaults() {
659 253
660 254 $defaults = array(
661 - // OAuth.
662 - 'access_token' => '', // string.
663 - 'refresh_token' => '', // string.
664 - 'token_expires' => '', // integer.
665 -
666 - // API Key. Retained if needed for backward compat.
667 - 'api_key' => '', // string.
668 - 'api_secret' => '', // string.
669 -
670 - // Site Wide.
671 - 'non_inline_form' => array(), // array.
672 - 'non_inline_form_honor_none_setting' => '', // blank|on.
673 - 'non_inline_form_limit_per_session' => '', // blank|on.
674 -
675 - // Spam Protection.
676 - 'spam_protection_provider' => 'recaptcha', // recaptcha|turnstile.
677 -
678 - // reCAPTCHA.
679 - 'recaptcha_site_key' => '', // string.
680 - 'recaptcha_secret_key' => '', // string.
681 - 'recaptcha_minimum_score' => 0.5, // float.
682 -
683 - // Cloudflare Turnstile.
684 - 'cloudflare_turnstile_site_key' => '', // string.
685 - 'cloudflare_turnstile_secret_key' => '', // string.
686 -
687 - // Advanced.
688 - 'debug' => '', // blank|on.
689 - 'no_scripts' => '', // blank|on.
690 - 'no_css' => '', // blank|on.
691 - 'no_add_new_button' => '', // blank|on.
692 - 'usage_tracking' => '', // blank|on.
255 + 'api_key' => '', // string.
256 + 'api_secret' => '', // string.
257 + 'debug' => '', // blank|on.
258 + 'no_scripts' => '', // blank|on.
259 + 'no_css' => '', // blank|on.
693 260 );
694 261
695 262 // Add Post Type Default Forms.
696 263 foreach ( convertkit_get_supported_post_types() as $post_type ) {
697 - $defaults[ $post_type . '_form' ] = 0; // -1, 0 or Form ID.
698 - $defaults[ $post_type . '_form_position' ] = 'after_content'; // before_content,after_content,before_after_content,element.
699 - $defaults[ $post_type . '_form_position_element' ] = 'p';
700 - $defaults[ $post_type . '_form_position_element_index' ] = 1;
264 + $defaults[ $post_type . '_form' ] = 0; // -1, 0 or Form ID.
701 265 }
702 266
703 267 /**
704 268 * The default settings, used when the ConvertKit Plugin Settings haven't been saved
@@ -705,9 +269,9 @@
705 269 * e.g. on a new installation.
706 270 *
707 271 * @since 1.9.6
708 272 *
709 - * @param array $defaults Default Settings.
273 + * @param array $defaults
710 274 */
711 275 $defaults = apply_filters( 'convertkit_settings_get_defaults', $defaults );
712 276
713 277 return $defaults;
@@ -714,63 +278,8 @@
714 278
715 279 }
716 280
717 281 /**
718 - * Saves the new access token, refresh token and its expiry, and schedules
719 - * a WordPress Cron event to refresh the token on expiry.
720 - *
721 - * @since 2.8.3
722 - *
723 - * @param array $result New Access Token, Refresh Token and Expiry.
724 - */
725 - public function update_credentials( $result ) {
726 -
727 - // Remove any existing persistent notice.
728 - WP_ConvertKit()->get_class( 'admin_notices' )->delete( 'authorization_failed' );
729 -
730 - $this->save(
731 - array(
732 - 'access_token' => $result['access_token'],
733 - 'refresh_token' => $result['refresh_token'],
734 - 'token_expires' => ( time() + $result['expires_in'] ),
735 - )
736 - );
737 -
738 - // Clear any existing scheduled WordPress Cron event.
739 - wp_clear_scheduled_hook( 'convertkit_refresh_token' );
740 -
741 - // Schedule a WordPress Cron event to refresh the token on expiry.
742 - wp_schedule_single_event( ( time() + $result['expires_in'] ), 'convertkit_refresh_token' );
743 -
744 - }
745 -
746 - /**
747 - * Deletes any existing access token, refresh token and its expiry from the Plugin settings,
748 - * and clears any existing scheduled WordPress Cron event to refresh the token on expiry.
749 - *
750 - * @since 2.5.0
751 - */
752 - public function delete_credentials() {
753 -
754 - $this->save(
755 - array(
756 - // OAuth.
757 - 'access_token' => '',
758 - 'refresh_token' => '',
759 - 'token_expires' => '',
760 -
761 - // API Key.
762 - 'api_key' => '',
763 - 'api_secret' => '',
764 - )
765 - );
766 -
767 - // Clear any existing scheduled WordPress Cron event.
768 - wp_clear_scheduled_hook( 'convertkit_refresh_token' );
769 -
770 - }
771 -
772 - /**
773 282 * Saves the given array of settings to the WordPress options table.
774 283 *
775 284 * @since 1.9.8.4
776 285 *
@@ -778,29 +287,8 @@
778 287 */
779 288 public function save( $settings ) {
780 289
781 290 update_option( self::SETTINGS_NAME, array_merge( $this->get(), $settings ) );
782 -
783 - // Reload settings in class, to reflect changes.
784 - $this->refresh_settings();
785 -
786 - }
787 -
788 - /**
789 - * Reloads settings from the options table so this instance has the latest values.
790 - *
791 - * @since 3.1.1
792 - */
793 - private function refresh_settings() {
794 -
795 - $settings = get_option( self::SETTINGS_NAME );
796 -
797 - if ( ! $settings ) {
798 - $this->settings = $this->get_defaults();
799 - return;
800 - }
801 -
802 - $this->settings = array_merge( $this->get_defaults(), $settings );
803 291
804 292 }
805 293
806 294 }