@@ -893,7 +893,7 @@ discard block |
||
893 | 893 | } |
894 | 894 | /** |
895 | 895 | * Does the network allow admins to add new users. |
896 | - * @return boolian |
|
896 | + * @return boolean |
|
897 | 897 | */ |
898 | 898 | static function network_add_new_users( $option = null ) { |
899 | 899 | return (bool) get_site_option( 'add_new_users' ); |
@@ -998,7 +998,7 @@ discard block |
||
998 | 998 | * database which could be set to anything as opposed to what this function returns. |
999 | 999 | * @param bool $option |
1000 | 1000 | * |
1001 | - * @return boolean |
|
1001 | + * @return string |
|
1002 | 1002 | */ |
1003 | 1003 | public function is_main_network_option( $option ) { |
1004 | 1004 | // return '1' or '' |
@@ -1009,7 +1009,7 @@ discard block |
||
1009 | 1009 | * Return true if we are with multi-site or multi-network false if we are dealing with single site. |
1010 | 1010 | * |
1011 | 1011 | * @param string $option |
1012 | - * @return boolean |
|
1012 | + * @return string |
|
1013 | 1013 | */ |
1014 | 1014 | public function is_multisite( $option ) { |
1015 | 1015 | return (string) (bool) is_multisite(); |
@@ -1071,7 +1071,7 @@ discard block |
||
1071 | 1071 | |
1072 | 1072 | /** |
1073 | 1073 | * Returns true if the site has file write access false otherwise. |
1074 | - * @return string ( '1' | '0' ) |
|
1074 | + * @return integer ( '1' | '0' ) |
|
1075 | 1075 | **/ |
1076 | 1076 | public static function file_system_write_access() { |
1077 | 1077 | if ( ! function_exists( 'get_filesystem_method' ) ) { |
@@ -1280,6 +1280,7 @@ discard block |
||
1280 | 1280 | * @access public |
1281 | 1281 | * @static |
1282 | 1282 | * |
1283 | + * @param string $feature |
|
1283 | 1284 | * @return bool True if plan supports feature, false if not |
1284 | 1285 | */ |
1285 | 1286 | public static function active_plan_supports( $feature ) { |
@@ -1779,6 +1780,7 @@ discard block |
||
1779 | 1780 | * Stores two secrets and a timestamp so WordPress.com can make a request back and verify an action |
1780 | 1781 | * Does some extra verification so urls (such as those to public-api, register, etc) can't just be crafted |
1781 | 1782 | * $name must be a registered option name. |
1783 | + * @param string $name |
|
1782 | 1784 | */ |
1783 | 1785 | public static function create_nonce( $name ) { |
1784 | 1786 | $secret = wp_generate_password( 32, false ) . ':' . wp_generate_password( 32, false ) . ':' . ( time() + 600 ); |
@@ -1836,6 +1838,7 @@ discard block |
||
1836 | 1838 | * @param int $user_id |
1837 | 1839 | * @param string $token |
1838 | 1840 | * return bool |
1841 | + * @param boolean $is_master_user |
|
1839 | 1842 | */ |
1840 | 1843 | public static function update_user_token( $user_id, $token, $is_master_user ) { |
1841 | 1844 | // not designed for concurrent updates |
@@ -2230,6 +2233,7 @@ discard block |
||
2230 | 2233 | |
2231 | 2234 | /** |
2232 | 2235 | * Like core's get_file_data implementation, but caches the result. |
2236 | + * @param string $file |
|
2233 | 2237 | */ |
2234 | 2238 | public static function get_file_data( $file, $headers ) { |
2235 | 2239 | //Get just the filename from $file (i.e. exclude full path) so that a consistent hash is generated |
@@ -2258,7 +2262,7 @@ discard block |
||
2258 | 2262 | * |
2259 | 2263 | * @param string $tag Tag as it appears in each module heading. |
2260 | 2264 | * |
2261 | - * @return mixed |
|
2265 | + * @return string |
|
2262 | 2266 | */ |
2263 | 2267 | public static function translate_module_tag( $tag ) { |
2264 | 2268 | return jetpack_get_module_i18n_tag( $tag ); |
@@ -2271,7 +2275,7 @@ discard block |
||
2271 | 2275 | * |
2272 | 2276 | * @param array $modules |
2273 | 2277 | * |
2274 | - * @return string|void |
|
2278 | + * @return string |
|
2275 | 2279 | */ |
2276 | 2280 | public static function get_translated_modules( $modules ) { |
2277 | 2281 | foreach ( $modules as $index => $module ) { |
@@ -2600,6 +2604,9 @@ discard block |
||
2600 | 2604 | return self::update_active_modules( $new ); |
2601 | 2605 | } |
2602 | 2606 | |
2607 | + /** |
|
2608 | + * @param string $module |
|
2609 | + */ |
|
2603 | 2610 | public static function enable_module_configurable( $module ) { |
2604 | 2611 | $module = Jetpack::get_module_slug( $module ); |
2605 | 2612 | add_filter( 'jetpack_module_configurable_' . $module, '__return_true' ); |
@@ -2610,21 +2617,33 @@ discard block |
||
2610 | 2617 | return Jetpack::admin_url( array( 'page' => 'jetpack', 'configure' => $module ) ); |
2611 | 2618 | } |
2612 | 2619 | |
2620 | + /** |
|
2621 | + * @param string $module |
|
2622 | + */ |
|
2613 | 2623 | public static function module_configuration_load( $module, $method ) { |
2614 | 2624 | $module = Jetpack::get_module_slug( $module ); |
2615 | 2625 | add_action( 'jetpack_module_configuration_load_' . $module, $method ); |
2616 | 2626 | } |
2617 | 2627 | |
2628 | + /** |
|
2629 | + * @param string $module |
|
2630 | + */ |
|
2618 | 2631 | public static function module_configuration_head( $module, $method ) { |
2619 | 2632 | $module = Jetpack::get_module_slug( $module ); |
2620 | 2633 | add_action( 'jetpack_module_configuration_head_' . $module, $method ); |
2621 | 2634 | } |
2622 | 2635 | |
2636 | + /** |
|
2637 | + * @param string $module |
|
2638 | + */ |
|
2623 | 2639 | public static function module_configuration_screen( $module, $method ) { |
2624 | 2640 | $module = Jetpack::get_module_slug( $module ); |
2625 | 2641 | add_action( 'jetpack_module_configuration_screen_' . $module, $method ); |
2626 | 2642 | } |
2627 | 2643 | |
2644 | + /** |
|
2645 | + * @param string $module |
|
2646 | + */ |
|
2628 | 2647 | public static function module_configuration_activation_screen( $module, $method ) { |
2629 | 2648 | $module = Jetpack::get_module_slug( $module ); |
2630 | 2649 | add_action( 'display_activate_module_setting_' . $module, $method ); |
@@ -2632,6 +2651,9 @@ discard block |
||
2632 | 2651 | |
2633 | 2652 | /* Installation */ |
2634 | 2653 | |
2654 | + /** |
|
2655 | + * @param string $message |
|
2656 | + */ |
|
2635 | 2657 | public static function bail_on_activation( $message, $deactivate = true ) { |
2636 | 2658 | ?> |
2637 | 2659 | <!doctype html> |
@@ -3280,7 +3302,7 @@ discard block |
||
3280 | 3302 | * Add help to the Jetpack page |
3281 | 3303 | * |
3282 | 3304 | * @since Jetpack (1.2.3) |
3283 | - * @return false if not the Jetpack page |
|
3305 | + * @return false|null if not the Jetpack page |
|
3284 | 3306 | */ |
3285 | 3307 | function admin_help() { |
3286 | 3308 | $current_screen = get_current_screen(); |
@@ -4278,6 +4300,7 @@ discard block |
||
4278 | 4300 | /** |
4279 | 4301 | * Returns the requested Jetpack API URL |
4280 | 4302 | * |
4303 | + * @param string $relative_url |
|
4281 | 4304 | * @return string |
4282 | 4305 | */ |
4283 | 4306 | public static function api_url( $relative_url ) { |
@@ -4422,7 +4445,8 @@ discard block |
||
4422 | 4445 | * Note these tokens are unique per call, NOT static per site for connecting. |
4423 | 4446 | * |
4424 | 4447 | * @since 2.6 |
4425 | - * @return array |
|
4448 | + * @param string $action |
|
4449 | + * @return string |
|
4426 | 4450 | */ |
4427 | 4451 | public function generate_secrets( $action, $exp = 600 ) { |
4428 | 4452 | $secret = wp_generate_password( 32, false ) // secret_1 |
@@ -4849,7 +4873,6 @@ discard block |
||
4849 | 4873 | /** |
4850 | 4874 | * Report authentication status to the WP REST API. |
4851 | 4875 | * |
4852 | - * @param WP_Error|mixed $result Error from another authentication handler, null if we should handle it, or another value if not |
|
4853 | 4876 | * @return WP_Error|boolean|null {@see WP_JSON_Server::check_authentication} |
4854 | 4877 | */ |
4855 | 4878 | public function wp_rest_authentication_errors( $value ) { |
@@ -4859,6 +4882,10 @@ discard block |
||
4859 | 4882 | return $this->rest_authentication_status; |
4860 | 4883 | } |
4861 | 4884 | |
4885 | + /** |
|
4886 | + * @param integer $timestamp |
|
4887 | + * @param string $nonce |
|
4888 | + */ |
|
4862 | 4889 | function add_nonce( $timestamp, $nonce ) { |
4863 | 4890 | global $wpdb; |
4864 | 4891 | static $nonces_used_this_request = array(); |
@@ -5004,6 +5031,7 @@ discard block |
||
5004 | 5031 | * @param string $key |
5005 | 5032 | * @param string $value |
5006 | 5033 | * @param bool $restate private |
5034 | + * @return string |
|
5007 | 5035 | */ |
5008 | 5036 | public static function state( $key = null, $value = null, $restate = false ) { |
5009 | 5037 | static $state = array(); |
@@ -5060,6 +5088,9 @@ discard block |
||
5060 | 5088 | Jetpack::state( null, null, true ); |
5061 | 5089 | } |
5062 | 5090 | |
5091 | + /** |
|
5092 | + * @param string $file |
|
5093 | + */ |
|
5063 | 5094 | public static function check_privacy( $file ) { |
5064 | 5095 | static $is_site_publicly_accessible = null; |
5065 | 5096 | |
@@ -5809,8 +5840,8 @@ discard block |
||
5809 | 5840 | * - Absolute URLs `http://domain.com/feh.png` |
5810 | 5841 | * - Domain root relative URLs `/feh.png` |
5811 | 5842 | * |
5812 | - * @param $css string: The raw CSS -- should be read in directly from the file. |
|
5813 | - * @param $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
5843 | + * @param string $css string: The raw CSS -- should be read in directly from the file. |
|
5844 | + * @param string $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
5814 | 5845 | * |
5815 | 5846 | * @return mixed|string |
5816 | 5847 | */ |
@@ -6101,7 +6132,7 @@ discard block |
||
6101 | 6132 | * |
6102 | 6133 | * @param string $option_name |
6103 | 6134 | * |
6104 | - * @return bool |
|
6135 | + * @return false|null |
|
6105 | 6136 | */ |
6106 | 6137 | public static function jumpstart_has_updated_module_option( $option_name = '' ) { |
6107 | 6138 | // Bail if Jump Start has already been dismissed |
@@ -6192,7 +6223,6 @@ discard block |
||
6192 | 6223 | } |
6193 | 6224 | |
6194 | 6225 | /** |
6195 | - * @param mixed $result Value for the user's option |
|
6196 | 6226 | * @return mixed |
6197 | 6227 | */ |
6198 | 6228 | function get_user_option_meta_box_order_dashboard( $sorted ) { |