Automattic /
jetpack
@@ -294,7 +294,7 @@ |
||
| 294 | 294 | /** |
| 295 | 295 | * Mock $wpdb->get_var() and make it return a certain value. |
| 296 | 296 | * |
| 297 | - * @param mixed $return_value Return value of the function. |
|
| 297 | + * @param integer $return_value Return value of the function. |
|
| 298 | 298 | * |
| 299 | 299 | * PHPUnit\Framework\MockObject\MockObject The mock object. |
| 300 | 300 | */ |
@@ -956,7 +956,7 @@ discard block |
||
| 956 | 956 | * This is ported over from the manage module, which has been deprecated and baked in here. |
| 957 | 957 | * |
| 958 | 958 | * @param $domains |
| 959 | - * @return array |
|
| 959 | + * @return string[] |
|
| 960 | 960 | */ |
| 961 | 961 | function allow_wpcom_domain( $domains ) { |
| 962 | 962 | if ( empty( $domains ) ) { |
@@ -1324,7 +1324,7 @@ discard block |
||
| 1324 | 1324 | /** |
| 1325 | 1325 | * Does the network allow admins to add new users. |
| 1326 | 1326 | * |
| 1327 | - * @return boolian |
|
| 1327 | + * @return boolean |
|
| 1328 | 1328 | */ |
| 1329 | 1329 | static function network_add_new_users( $option = null ) { |
| 1330 | 1330 | return (bool) get_site_option( 'add_new_users' ); |
@@ -1434,7 +1434,7 @@ discard block |
||
| 1434 | 1434 | * |
| 1435 | 1435 | * @param bool $option |
| 1436 | 1436 | * |
| 1437 | - * @return boolean |
|
| 1437 | + * @return string |
|
| 1438 | 1438 | */ |
| 1439 | 1439 | public function is_main_network_option( $option ) { |
| 1440 | 1440 | // return '1' or '' |
@@ -1445,7 +1445,7 @@ discard block |
||
| 1445 | 1445 | * Return true if we are with multi-site or multi-network false if we are dealing with single site. |
| 1446 | 1446 | * |
| 1447 | 1447 | * @param string $option |
| 1448 | - * @return boolean |
|
| 1448 | + * @return string |
|
| 1449 | 1449 | */ |
| 1450 | 1450 | public function is_multisite( $option ) { |
| 1451 | 1451 | return (string) (bool) is_multisite(); |
@@ -1508,7 +1508,7 @@ discard block |
||
| 1508 | 1508 | /** |
| 1509 | 1509 | * Returns true if the site has file write access false otherwise. |
| 1510 | 1510 | * |
| 1511 | - * @return string ( '1' | '0' ) |
|
| 1511 | + * @return integer ( '1' | '0' ) |
|
| 1512 | 1512 | **/ |
| 1513 | 1513 | public static function file_system_write_access() { |
| 1514 | 1514 | if ( ! function_exists( 'get_filesystem_method' ) ) { |
@@ -2237,7 +2237,7 @@ discard block |
||
| 2237 | 2237 | * @param int $user_id The user id. |
| 2238 | 2238 | * @param string $token The user token. |
| 2239 | 2239 | * @param bool $is_master_user Whether the user is the master user. |
| 2240 | - * @return bool |
|
| 2240 | + * @return boolean|null |
|
| 2241 | 2241 | */ |
| 2242 | 2242 | public static function update_user_token( $user_id, $token, $is_master_user ) { |
| 2243 | 2243 | _deprecated_function( __METHOD__, 'jetpack-8.0', 'Automattic\\Jetpack\\Connection\\Utils::update_user_token' ); |
@@ -2681,7 +2681,7 @@ discard block |
||
| 2681 | 2681 | * |
| 2682 | 2682 | * @param string $tag Tag as it appears in each module heading. |
| 2683 | 2683 | * |
| 2684 | - * @return mixed |
|
| 2684 | + * @return string |
|
| 2685 | 2685 | */ |
| 2686 | 2686 | public static function translate_module_tag( $tag ) { |
| 2687 | 2687 | return jetpack_get_module_i18n_tag( $tag ); |
@@ -2796,8 +2796,8 @@ discard block |
||
| 2796 | 2796 | * Rewrites ABSPATH (eg `/home/jetpack/wordpress/`) to ABSPATH, and if WP_CONTENT_DIR |
| 2797 | 2797 | * is located outside of ABSPATH, rewrites that to WP_CONTENT_DIR. |
| 2798 | 2798 | * |
| 2799 | - * @param $string |
|
| 2800 | - * @return mixed |
|
| 2799 | + * @param string $string |
|
| 2800 | + * @return string|null |
|
| 2801 | 2801 | */ |
| 2802 | 2802 | public static function alias_directories( $string ) { |
| 2803 | 2803 | // ABSPATH has a trailing slash. |
@@ -2808,6 +2808,10 @@ discard block |
||
| 2808 | 2808 | return $string; |
| 2809 | 2809 | } |
| 2810 | 2810 | |
| 2811 | + /** |
|
| 2812 | + * @param boolean $redirect |
|
| 2813 | + * @param boolean $send_state_messages |
|
| 2814 | + */ |
|
| 2811 | 2815 | public static function activate_default_modules( |
| 2812 | 2816 | $min_version = false, |
| 2813 | 2817 | $max_version = false, |
@@ -3091,6 +3095,9 @@ discard block |
||
| 3091 | 3095 | return self::update_active_modules( $new ); |
| 3092 | 3096 | } |
| 3093 | 3097 | |
| 3098 | + /** |
|
| 3099 | + * @param string $module |
|
| 3100 | + */ |
|
| 3094 | 3101 | public static function enable_module_configurable( $module ) { |
| 3095 | 3102 | $module = self::get_module_slug( $module ); |
| 3096 | 3103 | add_filter( 'jetpack_module_configurable_' . $module, '__return_true' ); |
@@ -3119,6 +3126,10 @@ discard block |
||
| 3119 | 3126 | } |
| 3120 | 3127 | |
| 3121 | 3128 | /* Installation */ |
| 3129 | + |
|
| 3130 | + /** |
|
| 3131 | + * @param string $message |
|
| 3132 | + */ |
|
| 3122 | 3133 | public static function bail_on_activation( $message, $deactivate = true ) { |
| 3123 | 3134 | ?> |
| 3124 | 3135 | <!doctype html> |
@@ -3884,7 +3895,7 @@ discard block |
||
| 3884 | 3895 | * Add help to the Jetpack page |
| 3885 | 3896 | * |
| 3886 | 3897 | * @since Jetpack (1.2.3) |
| 3887 | - * @return false if not the Jetpack page |
|
| 3898 | + * @return false|null if not the Jetpack page |
|
| 3888 | 3899 | */ |
| 3889 | 3900 | function admin_help() { |
| 3890 | 3901 | $current_screen = get_current_screen(); |
@@ -4588,6 +4599,7 @@ discard block |
||
| 4588 | 4599 | |
| 4589 | 4600 | /** |
| 4590 | 4601 | * Record a stat for later output. This will only currently output in the admin_footer. |
| 4602 | + * @param string $group |
|
| 4591 | 4603 | */ |
| 4592 | 4604 | function stat( $group, $detail ) { |
| 4593 | 4605 | $this->initialize_stats(); |
@@ -5001,6 +5013,9 @@ discard block |
||
| 5001 | 5013 | return $url; |
| 5002 | 5014 | } |
| 5003 | 5015 | |
| 5016 | + /** |
|
| 5017 | + * @param string $actionurl |
|
| 5018 | + */ |
|
| 5004 | 5019 | public static function nonce_url_no_esc( $actionurl, $action = -1, $name = '_wpnonce' ) { |
| 5005 | 5020 | $actionurl = str_replace( '&', '&', $actionurl ); |
| 5006 | 5021 | return add_query_arg( $name, wp_create_nonce( $action ), $actionurl ); |
@@ -5291,7 +5306,7 @@ discard block |
||
| 5291 | 5306 | * @param String $action The action name. |
| 5292 | 5307 | * @param Integer $user_id The user identifier. |
| 5293 | 5308 | * @param Integer $exp Expiration time in seconds. |
| 5294 | - * @return array |
|
| 5309 | + * @return boolean |
|
| 5295 | 5310 | */ |
| 5296 | 5311 | public static function generate_secrets( $action, $user_id = false, $exp = 600 ) { |
| 5297 | 5312 | return self::connection()->generate_secrets( $action, $user_id, $exp ); |
@@ -5547,7 +5562,6 @@ discard block |
||
| 5547 | 5562 | * @deprecated since 8.9.0 |
| 5548 | 5563 | * @see Automattic\Jetpack\Connection\Rest_Authentication::wp_rest_authentication_errors() |
| 5549 | 5564 | * |
| 5550 | - * @param WP_Error|mixed $result Error from another authentication handler, null if we should handle it, or another value if not |
|
| 5551 | 5565 | * @return WP_Error|boolean|null {@see WP_JSON_Server::check_authentication} |
| 5552 | 5566 | */ |
| 5553 | 5567 | public function wp_rest_authentication_errors( $value ) { |
@@ -5640,6 +5654,7 @@ discard block |
||
| 5640 | 5654 | * @param string $key |
| 5641 | 5655 | * @param string $value |
| 5642 | 5656 | * @param bool $restate private |
| 5657 | + * @return string |
|
| 5643 | 5658 | */ |
| 5644 | 5659 | public static function state( $key = null, $value = null, $restate = false ) { |
| 5645 | 5660 | static $state = array(); |
@@ -5721,6 +5736,9 @@ discard block |
||
| 5721 | 5736 | return true; |
| 5722 | 5737 | } |
| 5723 | 5738 | |
| 5739 | + /** |
|
| 5740 | + * @param string $file |
|
| 5741 | + */ |
|
| 5724 | 5742 | public static function check_privacy( $file ) { |
| 5725 | 5743 | static $is_site_publicly_accessible = null; |
| 5726 | 5744 | |
@@ -6293,9 +6311,7 @@ discard block |
||
| 6293 | 6311 | * |
| 6294 | 6312 | * Attached to `style_loader_src` filter. |
| 6295 | 6313 | * |
| 6296 | - * @param string $tag The tag that would link to the external asset. |
|
| 6297 | 6314 | * @param string $handle The registered handle of the script in question. |
| 6298 | - * @param string $href The url of the asset in question. |
|
| 6299 | 6315 | */ |
| 6300 | 6316 | public static function set_suffix_on_min( $src, $handle ) { |
| 6301 | 6317 | if ( false === strpos( $src, '.min.css' ) ) { |
@@ -6671,8 +6687,8 @@ discard block |
||
| 6671 | 6687 | * - Absolute URLs `http://domain.com/feh.png` |
| 6672 | 6688 | * - Domain root relative URLs `/feh.png` |
| 6673 | 6689 | * |
| 6674 | - * @param $css string: The raw CSS -- should be read in directly from the file. |
|
| 6675 | - * @param $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
| 6690 | + * @param string $css string: The raw CSS -- should be read in directly from the file. |
|
| 6691 | + * @param string $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
| 6676 | 6692 | * |
| 6677 | 6693 | * @return mixed|string |
| 6678 | 6694 | */ |
@@ -6971,7 +6987,6 @@ discard block |
||
| 6971 | 6987 | } |
| 6972 | 6988 | |
| 6973 | 6989 | /** |
| 6974 | - * @param mixed $result Value for the user's option |
|
| 6975 | 6990 | * @return mixed |
| 6976 | 6991 | */ |
| 6977 | 6992 | function get_user_option_meta_box_order_dashboard( $sorted ) { |
