Automattic /
jetpack
@@ -905,7 +905,7 @@ discard block |
||
| 905 | 905 | * This is ported over from the manage module, which has been deprecated and baked in here. |
| 906 | 906 | * |
| 907 | 907 | * @param $domains |
| 908 | - * @return array |
|
| 908 | + * @return string[] |
|
| 909 | 909 | */ |
| 910 | 910 | function allow_wpcom_domain( $domains ) { |
| 911 | 911 | if ( empty( $domains ) ) { |
@@ -1331,7 +1331,7 @@ discard block |
||
| 1331 | 1331 | /** |
| 1332 | 1332 | * Does the network allow admins to add new users. |
| 1333 | 1333 | * |
| 1334 | - * @return boolian |
|
| 1334 | + * @return boolean |
|
| 1335 | 1335 | */ |
| 1336 | 1336 | static function network_add_new_users( $option = null ) { |
| 1337 | 1337 | return (bool) get_site_option( 'add_new_users' ); |
@@ -1441,7 +1441,7 @@ discard block |
||
| 1441 | 1441 | * |
| 1442 | 1442 | * @param bool $option |
| 1443 | 1443 | * |
| 1444 | - * @return boolean |
|
| 1444 | + * @return string |
|
| 1445 | 1445 | */ |
| 1446 | 1446 | public function is_main_network_option( $option ) { |
| 1447 | 1447 | // return '1' or '' |
@@ -1452,7 +1452,7 @@ discard block |
||
| 1452 | 1452 | * Return true if we are with multi-site or multi-network false if we are dealing with single site. |
| 1453 | 1453 | * |
| 1454 | 1454 | * @param string $option |
| 1455 | - * @return boolean |
|
| 1455 | + * @return string |
|
| 1456 | 1456 | */ |
| 1457 | 1457 | public function is_multisite( $option ) { |
| 1458 | 1458 | return (string) (bool) is_multisite(); |
@@ -1515,7 +1515,7 @@ discard block |
||
| 1515 | 1515 | /** |
| 1516 | 1516 | * Returns true if the site has file write access false otherwise. |
| 1517 | 1517 | * |
| 1518 | - * @return string ( '1' | '0' ) |
|
| 1518 | + * @return integer ( '1' | '0' ) |
|
| 1519 | 1519 | **/ |
| 1520 | 1520 | public static function file_system_write_access() { |
| 1521 | 1521 | if ( ! function_exists( 'get_filesystem_method' ) ) { |
@@ -2233,7 +2233,7 @@ discard block |
||
| 2233 | 2233 | * @param int $user_id The user id. |
| 2234 | 2234 | * @param string $token The user token. |
| 2235 | 2235 | * @param bool $is_master_user Whether the user is the master user. |
| 2236 | - * @return bool |
|
| 2236 | + * @return boolean|null |
|
| 2237 | 2237 | */ |
| 2238 | 2238 | public static function update_user_token( $user_id, $token, $is_master_user ) { |
| 2239 | 2239 | _deprecated_function( __METHOD__, 'jetpack-8.0', 'Automattic\\Jetpack\\Connection\\Utils::update_user_token' ); |
@@ -2677,7 +2677,7 @@ discard block |
||
| 2677 | 2677 | * |
| 2678 | 2678 | * @param string $tag Tag as it appears in each module heading. |
| 2679 | 2679 | * |
| 2680 | - * @return mixed |
|
| 2680 | + * @return string |
|
| 2681 | 2681 | */ |
| 2682 | 2682 | public static function translate_module_tag( $tag ) { |
| 2683 | 2683 | return jetpack_get_module_i18n_tag( $tag ); |
@@ -2849,8 +2849,8 @@ discard block |
||
| 2849 | 2849 | * Rewrites ABSPATH (eg `/home/jetpack/wordpress/`) to ABSPATH, and if WP_CONTENT_DIR |
| 2850 | 2850 | * is located outside of ABSPATH, rewrites that to WP_CONTENT_DIR. |
| 2851 | 2851 | * |
| 2852 | - * @param $string |
|
| 2853 | - * @return mixed |
|
| 2852 | + * @param string $string |
|
| 2853 | + * @return string|null |
|
| 2854 | 2854 | */ |
| 2855 | 2855 | public static function alias_directories( $string ) { |
| 2856 | 2856 | // ABSPATH has a trailing slash. |
@@ -2861,6 +2861,10 @@ discard block |
||
| 2861 | 2861 | return $string; |
| 2862 | 2862 | } |
| 2863 | 2863 | |
| 2864 | + /** |
|
| 2865 | + * @param boolean $redirect |
|
| 2866 | + * @param boolean $send_state_messages |
|
| 2867 | + */ |
|
| 2864 | 2868 | public static function activate_default_modules( |
| 2865 | 2869 | $min_version = false, |
| 2866 | 2870 | $max_version = false, |
@@ -3144,6 +3148,9 @@ discard block |
||
| 3144 | 3148 | return self::update_active_modules( $new ); |
| 3145 | 3149 | } |
| 3146 | 3150 | |
| 3151 | + /** |
|
| 3152 | + * @param string $module |
|
| 3153 | + */ |
|
| 3147 | 3154 | public static function enable_module_configurable( $module ) { |
| 3148 | 3155 | $module = self::get_module_slug( $module ); |
| 3149 | 3156 | add_filter( 'jetpack_module_configurable_' . $module, '__return_true' ); |
@@ -3172,6 +3179,10 @@ discard block |
||
| 3172 | 3179 | } |
| 3173 | 3180 | |
| 3174 | 3181 | /* Installation */ |
| 3182 | + |
|
| 3183 | + /** |
|
| 3184 | + * @param string $message |
|
| 3185 | + */ |
|
| 3175 | 3186 | public static function bail_on_activation( $message, $deactivate = true ) { |
| 3176 | 3187 | ?> |
| 3177 | 3188 | <!doctype html> |
@@ -3927,7 +3938,7 @@ discard block |
||
| 3927 | 3938 | * Add help to the Jetpack page |
| 3928 | 3939 | * |
| 3929 | 3940 | * @since Jetpack (1.2.3) |
| 3930 | - * @return false if not the Jetpack page |
|
| 3941 | + * @return false|null if not the Jetpack page |
|
| 3931 | 3942 | */ |
| 3932 | 3943 | function admin_help() { |
| 3933 | 3944 | $current_screen = get_current_screen(); |
@@ -4965,6 +4976,9 @@ discard block |
||
| 4965 | 4976 | return $url; |
| 4966 | 4977 | } |
| 4967 | 4978 | |
| 4979 | + /** |
|
| 4980 | + * @param string $actionurl |
|
| 4981 | + */ |
|
| 4968 | 4982 | public static function nonce_url_no_esc( $actionurl, $action = -1, $name = '_wpnonce' ) { |
| 4969 | 4983 | $actionurl = str_replace( '&', '&', $actionurl ); |
| 4970 | 4984 | return add_query_arg( $name, wp_create_nonce( $action ), $actionurl ); |
@@ -5267,7 +5281,7 @@ discard block |
||
| 5267 | 5281 | * @param String $action The action name. |
| 5268 | 5282 | * @param Integer $user_id The user identifier. |
| 5269 | 5283 | * @param Integer $exp Expiration time in seconds. |
| 5270 | - * @return array |
|
| 5284 | + * @return boolean |
|
| 5271 | 5285 | */ |
| 5272 | 5286 | public static function generate_secrets( $action, $user_id = false, $exp = 600 ) { |
| 5273 | 5287 | return self::connection()->generate_secrets( $action, $user_id, $exp ); |
@@ -5587,7 +5601,6 @@ discard block |
||
| 5587 | 5601 | /** |
| 5588 | 5602 | * Report authentication status to the WP REST API. |
| 5589 | 5603 | * |
| 5590 | - * @param WP_Error|mixed $result Error from another authentication handler, null if we should handle it, or another value if not |
|
| 5591 | 5604 | * @return WP_Error|boolean|null {@see WP_JSON_Server::check_authentication} |
| 5592 | 5605 | */ |
| 5593 | 5606 | public function wp_rest_authentication_errors( $value ) { |
@@ -5714,6 +5727,7 @@ discard block |
||
| 5714 | 5727 | * @param string $key |
| 5715 | 5728 | * @param string $value |
| 5716 | 5729 | * @param bool $restate private |
| 5730 | + * @return string |
|
| 5717 | 5731 | */ |
| 5718 | 5732 | public static function state( $key = null, $value = null, $restate = false ) { |
| 5719 | 5733 | static $state = array(); |
@@ -5774,6 +5788,9 @@ discard block |
||
| 5774 | 5788 | self::state( null, null, true ); |
| 5775 | 5789 | } |
| 5776 | 5790 | |
| 5791 | + /** |
|
| 5792 | + * @param string $file |
|
| 5793 | + */ |
|
| 5777 | 5794 | public static function check_privacy( $file ) { |
| 5778 | 5795 | static $is_site_publicly_accessible = null; |
| 5779 | 5796 | |
@@ -5854,6 +5871,9 @@ discard block |
||
| 5854 | 5871 | } |
| 5855 | 5872 | } |
| 5856 | 5873 | |
| 5874 | + /** |
|
| 5875 | + * @param string $url |
|
| 5876 | + */ |
|
| 5857 | 5877 | public static function staticize_subdomain( $url ) { |
| 5858 | 5878 | |
| 5859 | 5879 | // Extract hostname from URL |
@@ -6371,9 +6391,7 @@ discard block |
||
| 6371 | 6391 | * |
| 6372 | 6392 | * Attached to `style_loader_src` filter. |
| 6373 | 6393 | * |
| 6374 | - * @param string $tag The tag that would link to the external asset. |
|
| 6375 | 6394 | * @param string $handle The registered handle of the script in question. |
| 6376 | - * @param string $href The url of the asset in question. |
|
| 6377 | 6395 | */ |
| 6378 | 6396 | public static function set_suffix_on_min( $src, $handle ) { |
| 6379 | 6397 | if ( false === strpos( $src, '.min.css' ) ) { |
@@ -6580,8 +6598,8 @@ discard block |
||
| 6580 | 6598 | * - Absolute URLs `http://domain.com/feh.png` |
| 6581 | 6599 | * - Domain root relative URLs `/feh.png` |
| 6582 | 6600 | * |
| 6583 | - * @param $css string: The raw CSS -- should be read in directly from the file. |
|
| 6584 | - * @param $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
| 6601 | + * @param string $css string: The raw CSS -- should be read in directly from the file. |
|
| 6602 | + * @param string $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
| 6585 | 6603 | * |
| 6586 | 6604 | * @return mixed|string |
| 6587 | 6605 | */ |
@@ -6842,7 +6860,7 @@ discard block |
||
| 6842 | 6860 | /** |
| 6843 | 6861 | * Stores and prints out domains to prefetch for page speed optimization. |
| 6844 | 6862 | * |
| 6845 | - * @param mixed $new_urls |
|
| 6863 | + * @param string[] $new_urls |
|
| 6846 | 6864 | */ |
| 6847 | 6865 | public static function dns_prefetch( $new_urls = null ) { |
| 6848 | 6866 | static $prefetch_urls = array(); |
@@ -6899,7 +6917,6 @@ discard block |
||
| 6899 | 6917 | } |
| 6900 | 6918 | |
| 6901 | 6919 | /** |
| 6902 | - * @param mixed $result Value for the user's option |
|
| 6903 | 6920 | * @return mixed |
| 6904 | 6921 | */ |
| 6905 | 6922 | function get_user_option_meta_box_order_dashboard( $sorted ) { |
@@ -290,7 +290,7 @@ discard block |
||
| 290 | 290 | * Get Stats Options. |
| 291 | 291 | * |
| 292 | 292 | * @access public |
| 293 | - * @param mixed $option Option. |
|
| 293 | + * @param string $option Option. |
|
| 294 | 294 | * @return mixed|null. |
| 295 | 295 | */ |
| 296 | 296 | function stats_get_option( $option ) { |
@@ -744,7 +744,7 @@ discard block |
||
| 744 | 744 | * Stats Convert Chart URLs. |
| 745 | 745 | * |
| 746 | 746 | * @access public |
| 747 | - * @param mixed $html HTML. |
|
| 747 | + * @param string $html HTML. |
|
| 748 | 748 | * @return string |
| 749 | 749 | */ |
| 750 | 750 | function stats_convert_chart_urls( $html ) { |
@@ -1414,7 +1414,7 @@ discard block |
||
| 1414 | 1414 | * |
| 1415 | 1415 | * @access public |
| 1416 | 1416 | * @param mixed $get Get. |
| 1417 | - * @param mixed $url URL. |
|
| 1417 | + * @param string $url URL. |
|
| 1418 | 1418 | * @return void |
| 1419 | 1419 | */ |
| 1420 | 1420 | function stats_print_wp_remote_error( $get, $url ) { |
@@ -1556,7 +1556,7 @@ discard block |
||
| 1556 | 1556 | * Stats get remote CSV. |
| 1557 | 1557 | * |
| 1558 | 1558 | * @access public |
| 1559 | - * @param mixed $url URL. |
|
| 1559 | + * @param string $url URL. |
|
| 1560 | 1560 | * @return array |
| 1561 | 1561 | */ |
| 1562 | 1562 | function stats_get_remote_csv( $url ) { |
