Completed
Push — fix/inline-docs-410 ( f96891...63b75c )
by
unknown
43:24 queued 33:40
created

Jetpack_SSO_Helpers   A

Complexity

Total Complexity 10

Size/Duplication

Total Lines 126
Duplicated Lines 0 %

Coupling/Cohesion

Components 0
Dependencies 0

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 126
rs 10
wmc 10
lcom 0
cbo 0

6 Methods

Rating   Name   Duplication   Size   Complexity  
A should_hide_login_form() 0 12 1
A match_by_email() 0 15 3
A new_user_override() 0 14 2
A is_two_step_required() 0 12 1
A bypass_login_forward_wpcom() 0 12 1
A show_sso_login() 0 16 2
1
<?php
2
3
if ( ! class_exists( 'Jetpack_SSO_Helpers' ) ) :
4
5
/**
6
 * A collection of helper functions used in the SSO module.
7
 *
8
 * @since 4.1.0
9
 */
10
class Jetpack_SSO_Helpers {
11
	/**
12
	 * Determine if the login form should be hidden or not
13
	 *
14
	 * @return bool
15
	 **/
16
	static function should_hide_login_form() {
17
		/**
18
		 * Remove the default log in form, only leave the WordPress.com log in button.
19
		 *
20
		 * @module sso
21
		 *
22
		 * @since 3.1.0
23
		 *
24
		 * @param bool get_option( 'jetpack_sso_remove_login_form', false ) Should the default log in form be removed. Default to false.
25
		 */
26
		return (bool) apply_filters( 'jetpack_remove_login_form', get_option( 'jetpack_sso_remove_login_form', false ) );
27
	}
28
29
	/**
30
	 * Returns a boolean value for whether logging in by matching the WordPress.com user email to a
31
	 * Jetpack site user's email is allowed.
32
	 *
33
	 * @return bool
34
	 */
35
	static function match_by_email() {
36
		$match_by_email = ( 1 == get_option( 'jetpack_sso_match_by_email', true ) ) ? true: false;
37
		$match_by_email = defined( 'WPCC_MATCH_BY_EMAIL' ) ? WPCC_MATCH_BY_EMAIL : $match_by_email;
38
39
		/**
40
		 * Link the local account to an account on WordPress.com using the same email address.
41
		 *
42
		 * @module sso
43
		 *
44
		 * @since 2.6.0
45
		 *
46
		 * @param bool $match_by_email Should we link the local account to an account on WordPress.com using the same email address. Default to false.
47
		 */
48
		return (bool) apply_filters( 'jetpack_sso_match_by_email', $match_by_email );
49
	}
50
51
	/**
52
	 * Returns a boolean for whether users are allowed to register on the Jetpack site with SSO,
53
	 * even though the site disallows normal registrations.
54
	 *
55
	 * @return bool
56
	 */
57
	static function new_user_override() {
58
		$new_user_override = defined( 'WPCC_NEW_USER_OVERRIDE' ) ? WPCC_NEW_USER_OVERRIDE : false;
59
60
		/**
61
		 * Allow users to register on your site with a WordPress.com account, even though you disallow normal registrations.
62
		 *
63
		 * @module sso
64
		 *
65
		 * @since 2.6.0
66
		 *
67
		 * @param bool $new_user_override Allow users to register on your site with a WordPress.com account. Default to false.
68
		 */
69
		return (bool) apply_filters( 'jetpack_sso_new_user_override', $new_user_override );
70
	}
71
72
	/**
73
	 * Returns a boolean value for whether two-step authentication is required for SSO.
74
	 *
75
	 * @since 4.1.0
76
	 *
77
	 * @return bool
78
	 */
79
	static function is_two_step_required() {
80
		/**
81
		 * Is it required to have 2-step authentication enabled on WordPress.com to use SSO?
82
		 *
83
		 * @module sso
84
		 *
85
		 * @since 2.8.0
86
		 *
87
		 * @param bool get_option( 'jetpack_sso_require_two_step' ) Does SSO require 2-step authentication?
88
		 */
89
		return (bool) apply_filters( 'jetpack_sso_require_two_step', get_option( 'jetpack_sso_require_two_step', false ) );
90
	}
91
92
	/**
93
	 * Returns a boolean for whether a user that is attempting to log in will be automatically
94
	 * redirected to WordPress.com to begin the SSO flow.
95
	 *
96
	 * @return bool
97
	 */
98
	static function bypass_login_forward_wpcom() {
99
		/**
100
		 * Redirect the site's log in form to WordPress.com's log in form.
101
		 *
102
		 * @module sso
103
		 *
104
		 * @since 3.1.0
105
		 *
106
		 * @param bool false Should the site's log in form be automatically forwarded to WordPress.com's log in form.
107
		 */
108
		return (bool) apply_filters( 'jetpack_sso_bypass_login_forward_wpcom', false );
109
	}
110
111
	/**
112
	 * Returns a boolean for whether the SSO login form should be displayed as the default
113
	 * when both the default and SSO login form allowed.
114
	 *
115
	 * @since 4.1.0
116
	 *
117
	 * @return bool
118
	 */
119
	static function show_sso_login() {
120
		if ( self::should_hide_login_form() ) {
121
			return true;
122
		}
123
124
		/**
125
		 * Display the SSO login form as the default when both the default and SSO login forms are enabled.
126
		 *
127
		 * @module sso
128
		 *
129
		 * @since 4.1.0
130
		 *
131
		 * @param bool true Should the SSO login form be displayed by default when the default login form is also enabled?
132
		 */
133
		return (bool) apply_filters( 'jetpack_sso_default_to_sso_login', true );
134
	}
135
}
136
137
endif;
138