Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
Complex classes like Jetpack often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use Jetpack, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 27 | class Jetpack { |
||
| 28 | public $xmlrpc_server = null; |
||
| 29 | |||
| 30 | private $xmlrpc_verification = null; |
||
| 31 | private $rest_authentication_status = null; |
||
| 32 | |||
| 33 | public $HTTP_RAW_POST_DATA = null; // copy of $GLOBALS['HTTP_RAW_POST_DATA'] |
||
| 34 | |||
| 35 | /** |
||
| 36 | * @var array The handles of styles that are concatenated into jetpack.css |
||
| 37 | */ |
||
| 38 | public $concatenated_style_handles = array( |
||
| 39 | 'jetpack-carousel', |
||
| 40 | 'grunion.css', |
||
| 41 | 'the-neverending-homepage', |
||
| 42 | 'jetpack_likes', |
||
| 43 | 'jetpack_related-posts', |
||
| 44 | 'sharedaddy', |
||
| 45 | 'jetpack-slideshow', |
||
| 46 | 'presentations', |
||
| 47 | 'jetpack-subscriptions', |
||
| 48 | 'jetpack-responsive-videos-style', |
||
| 49 | 'jetpack-social-menu', |
||
| 50 | 'tiled-gallery', |
||
| 51 | 'jetpack_display_posts_widget', |
||
| 52 | 'gravatar-profile-widget', |
||
| 53 | 'goodreads-widget', |
||
| 54 | 'jetpack_social_media_icons_widget', |
||
| 55 | 'jetpack-top-posts-widget', |
||
| 56 | 'jetpack_image_widget', |
||
| 57 | 'jetpack-my-community-widget', |
||
| 58 | 'wordads', |
||
| 59 | 'eu-cookie-law-style', |
||
| 60 | 'flickr-widget-style', |
||
| 61 | 'jetpack-search-widget' |
||
| 62 | ); |
||
| 63 | |||
| 64 | /** |
||
| 65 | * Contains all assets that have had their URL rewritten to minified versions. |
||
| 66 | * |
||
| 67 | * @var array |
||
| 68 | */ |
||
| 69 | static $min_assets = array(); |
||
|
|
|||
| 70 | |||
| 71 | public $plugins_to_deactivate = array( |
||
| 72 | 'stats' => array( 'stats/stats.php', 'WordPress.com Stats' ), |
||
| 73 | 'shortlinks' => array( 'stats/stats.php', 'WordPress.com Stats' ), |
||
| 74 | 'sharedaddy' => array( 'sharedaddy/sharedaddy.php', 'Sharedaddy' ), |
||
| 75 | 'twitter-widget' => array( 'wickett-twitter-widget/wickett-twitter-widget.php', 'Wickett Twitter Widget' ), |
||
| 76 | 'after-the-deadline' => array( 'after-the-deadline/after-the-deadline.php', 'After The Deadline' ), |
||
| 77 | 'contact-form' => array( 'grunion-contact-form/grunion-contact-form.php', 'Grunion Contact Form' ), |
||
| 78 | 'contact-form' => array( 'mullet/mullet-contact-form.php', 'Mullet Contact Form' ), |
||
| 79 | 'custom-css' => array( 'safecss/safecss.php', 'WordPress.com Custom CSS' ), |
||
| 80 | 'random-redirect' => array( 'random-redirect/random-redirect.php', 'Random Redirect' ), |
||
| 81 | 'videopress' => array( 'video/video.php', 'VideoPress' ), |
||
| 82 | 'widget-visibility' => array( 'jetpack-widget-visibility/widget-visibility.php', 'Jetpack Widget Visibility' ), |
||
| 83 | 'widget-visibility' => array( 'widget-visibility-without-jetpack/widget-visibility-without-jetpack.php', 'Widget Visibility Without Jetpack' ), |
||
| 84 | 'sharedaddy' => array( 'jetpack-sharing/sharedaddy.php', 'Jetpack Sharing' ), |
||
| 85 | 'gravatar-hovercards' => array( 'jetpack-gravatar-hovercards/gravatar-hovercards.php', 'Jetpack Gravatar Hovercards' ), |
||
| 86 | 'latex' => array( 'wp-latex/wp-latex.php', 'WP LaTeX' ) |
||
| 87 | ); |
||
| 88 | |||
| 89 | static $capability_translations = array( |
||
| 90 | 'administrator' => 'manage_options', |
||
| 91 | 'editor' => 'edit_others_posts', |
||
| 92 | 'author' => 'publish_posts', |
||
| 93 | 'contributor' => 'edit_posts', |
||
| 94 | 'subscriber' => 'read', |
||
| 95 | ); |
||
| 96 | |||
| 97 | /** |
||
| 98 | * Map of modules that have conflicts with plugins and should not be auto-activated |
||
| 99 | * if the plugins are active. Used by filter_default_modules |
||
| 100 | * |
||
| 101 | * Plugin Authors: If you'd like to prevent a single module from auto-activating, |
||
| 102 | * change `module-slug` and add this to your plugin: |
||
| 103 | * |
||
| 104 | * add_filter( 'jetpack_get_default_modules', 'my_jetpack_get_default_modules' ); |
||
| 105 | * function my_jetpack_get_default_modules( $modules ) { |
||
| 106 | * return array_diff( $modules, array( 'module-slug' ) ); |
||
| 107 | * } |
||
| 108 | * |
||
| 109 | * @var array |
||
| 110 | */ |
||
| 111 | private $conflicting_plugins = array( |
||
| 112 | 'comments' => array( |
||
| 113 | 'Intense Debate' => 'intensedebate/intensedebate.php', |
||
| 114 | 'Disqus' => 'disqus-comment-system/disqus.php', |
||
| 115 | 'Livefyre' => 'livefyre-comments/livefyre.php', |
||
| 116 | 'Comments Evolved for WordPress' => 'gplus-comments/comments-evolved.php', |
||
| 117 | 'Google+ Comments' => 'google-plus-comments/google-plus-comments.php', |
||
| 118 | 'WP-SpamShield Anti-Spam' => 'wp-spamshield/wp-spamshield.php', |
||
| 119 | ), |
||
| 120 | 'comment-likes' => array( |
||
| 121 | 'Epoch' => 'epoch/plugincore.php', |
||
| 122 | ), |
||
| 123 | 'contact-form' => array( |
||
| 124 | 'Contact Form 7' => 'contact-form-7/wp-contact-form-7.php', |
||
| 125 | 'Gravity Forms' => 'gravityforms/gravityforms.php', |
||
| 126 | 'Contact Form Plugin' => 'contact-form-plugin/contact_form.php', |
||
| 127 | 'Easy Contact Forms' => 'easy-contact-forms/easy-contact-forms.php', |
||
| 128 | 'Fast Secure Contact Form' => 'si-contact-form/si-contact-form.php', |
||
| 129 | 'Ninja Forms' => 'ninja-forms/ninja-forms.php', |
||
| 130 | ), |
||
| 131 | 'minileven' => array( |
||
| 132 | 'WPtouch' => 'wptouch/wptouch.php', |
||
| 133 | ), |
||
| 134 | 'latex' => array( |
||
| 135 | 'LaTeX for WordPress' => 'latex/latex.php', |
||
| 136 | 'Youngwhans Simple Latex' => 'youngwhans-simple-latex/yw-latex.php', |
||
| 137 | 'Easy WP LaTeX' => 'easy-wp-latex-lite/easy-wp-latex-lite.php', |
||
| 138 | 'MathJax-LaTeX' => 'mathjax-latex/mathjax-latex.php', |
||
| 139 | 'Enable Latex' => 'enable-latex/enable-latex.php', |
||
| 140 | 'WP QuickLaTeX' => 'wp-quicklatex/wp-quicklatex.php', |
||
| 141 | ), |
||
| 142 | 'protect' => array( |
||
| 143 | 'Limit Login Attempts' => 'limit-login-attempts/limit-login-attempts.php', |
||
| 144 | 'Captcha' => 'captcha/captcha.php', |
||
| 145 | 'Brute Force Login Protection' => 'brute-force-login-protection/brute-force-login-protection.php', |
||
| 146 | 'Login Security Solution' => 'login-security-solution/login-security-solution.php', |
||
| 147 | 'WPSecureOps Brute Force Protect' => 'wpsecureops-bruteforce-protect/wpsecureops-bruteforce-protect.php', |
||
| 148 | 'BulletProof Security' => 'bulletproof-security/bulletproof-security.php', |
||
| 149 | 'SiteGuard WP Plugin' => 'siteguard/siteguard.php', |
||
| 150 | 'Security-protection' => 'security-protection/security-protection.php', |
||
| 151 | 'Login Security' => 'login-security/login-security.php', |
||
| 152 | 'Botnet Attack Blocker' => 'botnet-attack-blocker/botnet-attack-blocker.php', |
||
| 153 | 'Wordfence Security' => 'wordfence/wordfence.php', |
||
| 154 | 'All In One WP Security & Firewall' => 'all-in-one-wp-security-and-firewall/wp-security.php', |
||
| 155 | 'iThemes Security' => 'better-wp-security/better-wp-security.php', |
||
| 156 | ), |
||
| 157 | 'random-redirect' => array( |
||
| 158 | 'Random Redirect 2' => 'random-redirect-2/random-redirect.php', |
||
| 159 | ), |
||
| 160 | 'related-posts' => array( |
||
| 161 | 'YARPP' => 'yet-another-related-posts-plugin/yarpp.php', |
||
| 162 | 'WordPress Related Posts' => 'wordpress-23-related-posts-plugin/wp_related_posts.php', |
||
| 163 | 'nrelate Related Content' => 'nrelate-related-content/nrelate-related.php', |
||
| 164 | 'Contextual Related Posts' => 'contextual-related-posts/contextual-related-posts.php', |
||
| 165 | 'Related Posts for WordPress' => 'microkids-related-posts/microkids-related-posts.php', |
||
| 166 | 'outbrain' => 'outbrain/outbrain.php', |
||
| 167 | 'Shareaholic' => 'shareaholic/shareaholic.php', |
||
| 168 | 'Sexybookmarks' => 'sexybookmarks/shareaholic.php', |
||
| 169 | ), |
||
| 170 | 'sharedaddy' => array( |
||
| 171 | 'AddThis' => 'addthis/addthis_social_widget.php', |
||
| 172 | 'Add To Any' => 'add-to-any/add-to-any.php', |
||
| 173 | 'ShareThis' => 'share-this/sharethis.php', |
||
| 174 | 'Shareaholic' => 'shareaholic/shareaholic.php', |
||
| 175 | ), |
||
| 176 | 'seo-tools' => array( |
||
| 177 | 'WordPress SEO by Yoast' => 'wordpress-seo/wp-seo.php', |
||
| 178 | 'WordPress SEO Premium by Yoast' => 'wordpress-seo-premium/wp-seo-premium.php', |
||
| 179 | 'All in One SEO Pack' => 'all-in-one-seo-pack/all_in_one_seo_pack.php', |
||
| 180 | 'All in One SEO Pack Pro' => 'all-in-one-seo-pack-pro/all_in_one_seo_pack.php', |
||
| 181 | ), |
||
| 182 | 'verification-tools' => array( |
||
| 183 | 'WordPress SEO by Yoast' => 'wordpress-seo/wp-seo.php', |
||
| 184 | 'WordPress SEO Premium by Yoast' => 'wordpress-seo-premium/wp-seo-premium.php', |
||
| 185 | 'All in One SEO Pack' => 'all-in-one-seo-pack/all_in_one_seo_pack.php', |
||
| 186 | 'All in One SEO Pack Pro' => 'all-in-one-seo-pack-pro/all_in_one_seo_pack.php', |
||
| 187 | ), |
||
| 188 | 'widget-visibility' => array( |
||
| 189 | 'Widget Logic' => 'widget-logic/widget_logic.php', |
||
| 190 | 'Dynamic Widgets' => 'dynamic-widgets/dynamic-widgets.php', |
||
| 191 | ), |
||
| 192 | 'sitemaps' => array( |
||
| 193 | 'Google XML Sitemaps' => 'google-sitemap-generator/sitemap.php', |
||
| 194 | 'Better WordPress Google XML Sitemaps' => 'bwp-google-xml-sitemaps/bwp-simple-gxs.php', |
||
| 195 | 'Google XML Sitemaps for qTranslate' => 'google-xml-sitemaps-v3-for-qtranslate/sitemap.php', |
||
| 196 | 'XML Sitemap & Google News feeds' => 'xml-sitemap-feed/xml-sitemap.php', |
||
| 197 | 'Google Sitemap by BestWebSoft' => 'google-sitemap-plugin/google-sitemap-plugin.php', |
||
| 198 | 'WordPress SEO by Yoast' => 'wordpress-seo/wp-seo.php', |
||
| 199 | 'WordPress SEO Premium by Yoast' => 'wordpress-seo-premium/wp-seo-premium.php', |
||
| 200 | 'All in One SEO Pack' => 'all-in-one-seo-pack/all_in_one_seo_pack.php', |
||
| 201 | 'All in One SEO Pack Pro' => 'all-in-one-seo-pack-pro/all_in_one_seo_pack.php', |
||
| 202 | 'Sitemap' => 'sitemap/sitemap.php', |
||
| 203 | 'Simple Wp Sitemap' => 'simple-wp-sitemap/simple-wp-sitemap.php', |
||
| 204 | 'Simple Sitemap' => 'simple-sitemap/simple-sitemap.php', |
||
| 205 | 'XML Sitemaps' => 'xml-sitemaps/xml-sitemaps.php', |
||
| 206 | 'MSM Sitemaps' => 'msm-sitemap/msm-sitemap.php', |
||
| 207 | ), |
||
| 208 | 'lazy-images' => array( |
||
| 209 | 'Lazy Load' => 'lazy-load/lazy-load.php', |
||
| 210 | 'BJ Lazy Load' => 'bj-lazy-load/bj-lazy-load.php', |
||
| 211 | 'Lazy Load by WP Rocket' => 'rocket-lazy-load/rocket-lazy-load.php', |
||
| 212 | ), |
||
| 213 | ); |
||
| 214 | |||
| 215 | /** |
||
| 216 | * Plugins for which we turn off our Facebook OG Tags implementation. |
||
| 217 | * |
||
| 218 | * Note: All in One SEO Pack, All in one SEO Pack Pro, WordPress SEO by Yoast, and WordPress SEO Premium by Yoast automatically deactivate |
||
| 219 | * Jetpack's Open Graph tags via filter when their Social Meta modules are active. |
||
| 220 | * |
||
| 221 | * Plugin authors: If you'd like to prevent Jetpack's Open Graph tag generation in your plugin, you can do so via this filter: |
||
| 222 | * add_filter( 'jetpack_enable_open_graph', '__return_false' ); |
||
| 223 | */ |
||
| 224 | private $open_graph_conflicting_plugins = array( |
||
| 225 | '2-click-socialmedia-buttons/2-click-socialmedia-buttons.php', |
||
| 226 | // 2 Click Social Media Buttons |
||
| 227 | 'add-link-to-facebook/add-link-to-facebook.php', // Add Link to Facebook |
||
| 228 | 'add-meta-tags/add-meta-tags.php', // Add Meta Tags |
||
| 229 | 'autodescription/autodescription.php', // The SEO Framework |
||
| 230 | 'easy-facebook-share-thumbnails/esft.php', // Easy Facebook Share Thumbnail |
||
| 231 | 'heateor-open-graph-meta-tags/heateor-open-graph-meta-tags.php', |
||
| 232 | // Open Graph Meta Tags by Heateor |
||
| 233 | 'facebook/facebook.php', // Facebook (official plugin) |
||
| 234 | 'facebook-awd/AWD_facebook.php', // Facebook AWD All in one |
||
| 235 | 'facebook-featured-image-and-open-graph-meta-tags/fb-featured-image.php', |
||
| 236 | // Facebook Featured Image & OG Meta Tags |
||
| 237 | 'facebook-meta-tags/facebook-metatags.php', // Facebook Meta Tags |
||
| 238 | 'wonderm00ns-simple-facebook-open-graph-tags/wonderm00n-open-graph.php', |
||
| 239 | // Facebook Open Graph Meta Tags for WordPress |
||
| 240 | 'facebook-revised-open-graph-meta-tag/index.php', // Facebook Revised Open Graph Meta Tag |
||
| 241 | 'facebook-thumb-fixer/_facebook-thumb-fixer.php', // Facebook Thumb Fixer |
||
| 242 | 'facebook-and-digg-thumbnail-generator/facebook-and-digg-thumbnail-generator.php', |
||
| 243 | // Fedmich's Facebook Open Graph Meta |
||
| 244 | 'network-publisher/networkpub.php', // Network Publisher |
||
| 245 | 'nextgen-facebook/nextgen-facebook.php', // NextGEN Facebook OG |
||
| 246 | 'social-networks-auto-poster-facebook-twitter-g/NextScripts_SNAP.php', |
||
| 247 | // NextScripts SNAP |
||
| 248 | 'og-tags/og-tags.php', // OG Tags |
||
| 249 | 'opengraph/opengraph.php', // Open Graph |
||
| 250 | 'open-graph-protocol-framework/open-graph-protocol-framework.php', |
||
| 251 | // Open Graph Protocol Framework |
||
| 252 | 'seo-facebook-comments/seofacebook.php', // SEO Facebook Comments |
||
| 253 | 'seo-ultimate/seo-ultimate.php', // SEO Ultimate |
||
| 254 | 'sexybookmarks/sexy-bookmarks.php', // Shareaholic |
||
| 255 | 'shareaholic/sexy-bookmarks.php', // Shareaholic |
||
| 256 | 'sharepress/sharepress.php', // SharePress |
||
| 257 | 'simple-facebook-connect/sfc.php', // Simple Facebook Connect |
||
| 258 | 'social-discussions/social-discussions.php', // Social Discussions |
||
| 259 | 'social-sharing-toolkit/social_sharing_toolkit.php', // Social Sharing Toolkit |
||
| 260 | 'socialize/socialize.php', // Socialize |
||
| 261 | 'squirrly-seo/squirrly.php', // SEO by SQUIRRLY™ |
||
| 262 | 'only-tweet-like-share-and-google-1/tweet-like-plusone.php', |
||
| 263 | // Tweet, Like, Google +1 and Share |
||
| 264 | 'wordbooker/wordbooker.php', // Wordbooker |
||
| 265 | 'wpsso/wpsso.php', // WordPress Social Sharing Optimization |
||
| 266 | 'wp-caregiver/wp-caregiver.php', // WP Caregiver |
||
| 267 | 'wp-facebook-like-send-open-graph-meta/wp-facebook-like-send-open-graph-meta.php', |
||
| 268 | // WP Facebook Like Send & Open Graph Meta |
||
| 269 | 'wp-facebook-open-graph-protocol/wp-facebook-ogp.php', // WP Facebook Open Graph protocol |
||
| 270 | 'wp-ogp/wp-ogp.php', // WP-OGP |
||
| 271 | 'zoltonorg-social-plugin/zosp.php', // Zolton.org Social Plugin |
||
| 272 | 'wp-fb-share-like-button/wp_fb_share-like_widget.php', // WP Facebook Like Button |
||
| 273 | 'open-graph-metabox/open-graph-metabox.php' // Open Graph Metabox |
||
| 274 | ); |
||
| 275 | |||
| 276 | /** |
||
| 277 | * Plugins for which we turn off our Twitter Cards Tags implementation. |
||
| 278 | */ |
||
| 279 | private $twitter_cards_conflicting_plugins = array( |
||
| 280 | // 'twitter/twitter.php', // The official one handles this on its own. |
||
| 281 | // // https://github.com/twitter/wordpress/blob/master/src/Twitter/WordPress/Cards/Compatibility.php |
||
| 282 | 'eewee-twitter-card/index.php', // Eewee Twitter Card |
||
| 283 | 'ig-twitter-cards/ig-twitter-cards.php', // IG:Twitter Cards |
||
| 284 | 'jm-twitter-cards/jm-twitter-cards.php', // JM Twitter Cards |
||
| 285 | 'kevinjohn-gallagher-pure-web-brilliants-social-graph-twitter-cards-extention/kevinjohn_gallagher___social_graph_twitter_output.php', |
||
| 286 | // Pure Web Brilliant's Social Graph Twitter Cards Extension |
||
| 287 | 'twitter-cards/twitter-cards.php', // Twitter Cards |
||
| 288 | 'twitter-cards-meta/twitter-cards-meta.php', // Twitter Cards Meta |
||
| 289 | 'wp-twitter-cards/twitter_cards.php', // WP Twitter Cards |
||
| 290 | ); |
||
| 291 | |||
| 292 | /** |
||
| 293 | * Message to display in admin_notice |
||
| 294 | * @var string |
||
| 295 | */ |
||
| 296 | public $message = ''; |
||
| 297 | |||
| 298 | /** |
||
| 299 | * Error to display in admin_notice |
||
| 300 | * @var string |
||
| 301 | */ |
||
| 302 | public $error = ''; |
||
| 303 | |||
| 304 | /** |
||
| 305 | * Modules that need more privacy description. |
||
| 306 | * @var string |
||
| 307 | */ |
||
| 308 | public $privacy_checks = ''; |
||
| 309 | |||
| 310 | /** |
||
| 311 | * Stats to record once the page loads |
||
| 312 | * |
||
| 313 | * @var array |
||
| 314 | */ |
||
| 315 | public $stats = array(); |
||
| 316 | |||
| 317 | /** |
||
| 318 | * Jetpack_Sync object |
||
| 319 | */ |
||
| 320 | public $sync; |
||
| 321 | |||
| 322 | /** |
||
| 323 | * Verified data for JSON authorization request |
||
| 324 | */ |
||
| 325 | public $json_api_authorization_request = array(); |
||
| 326 | |||
| 327 | /** |
||
| 328 | * @var string Transient key used to prevent multiple simultaneous plugin upgrades |
||
| 329 | */ |
||
| 330 | public static $plugin_upgrade_lock_key = 'jetpack_upgrade_lock'; |
||
| 331 | |||
| 332 | /** |
||
| 333 | * Holds the singleton instance of this class |
||
| 334 | * @since 2.3.3 |
||
| 335 | * @var Jetpack |
||
| 336 | */ |
||
| 337 | static $instance = false; |
||
| 338 | |||
| 339 | /** |
||
| 340 | * Singleton |
||
| 341 | * @static |
||
| 342 | */ |
||
| 343 | public static function init() { |
||
| 344 | if ( ! self::$instance ) { |
||
| 345 | self::$instance = new Jetpack; |
||
| 346 | |||
| 347 | self::$instance->plugin_upgrade(); |
||
| 348 | } |
||
| 349 | |||
| 350 | return self::$instance; |
||
| 351 | } |
||
| 352 | |||
| 353 | /** |
||
| 354 | * Must never be called statically |
||
| 355 | */ |
||
| 356 | function plugin_upgrade() { |
||
| 357 | if ( Jetpack::is_active() ) { |
||
| 358 | list( $version ) = explode( ':', Jetpack_Options::get_option( 'version' ) ); |
||
| 359 | if ( JETPACK__VERSION != $version ) { |
||
| 360 | // Prevent multiple upgrades at once - only a single process should trigger |
||
| 361 | // an upgrade to avoid stampedes |
||
| 362 | if ( false !== get_transient( self::$plugin_upgrade_lock_key ) ) { |
||
| 363 | return; |
||
| 364 | } |
||
| 365 | |||
| 366 | // Set a short lock to prevent multiple instances of the upgrade |
||
| 367 | set_transient( self::$plugin_upgrade_lock_key, 1, 10 ); |
||
| 368 | |||
| 369 | // check which active modules actually exist and remove others from active_modules list |
||
| 370 | $unfiltered_modules = Jetpack::get_active_modules(); |
||
| 371 | $modules = array_filter( $unfiltered_modules, array( 'Jetpack', 'is_module' ) ); |
||
| 372 | if ( array_diff( $unfiltered_modules, $modules ) ) { |
||
| 373 | Jetpack::update_active_modules( $modules ); |
||
| 374 | } |
||
| 375 | |||
| 376 | add_action( 'init', array( __CLASS__, 'activate_new_modules' ) ); |
||
| 377 | |||
| 378 | // Upgrade to 4.3.0 |
||
| 379 | if ( Jetpack_Options::get_option( 'identity_crisis_whitelist' ) ) { |
||
| 380 | Jetpack_Options::delete_option( 'identity_crisis_whitelist' ); |
||
| 381 | } |
||
| 382 | |||
| 383 | // Make sure Markdown for posts gets turned back on |
||
| 384 | if ( ! get_option( 'wpcom_publish_posts_with_markdown' ) ) { |
||
| 385 | update_option( 'wpcom_publish_posts_with_markdown', true ); |
||
| 386 | } |
||
| 387 | |||
| 388 | if ( did_action( 'wp_loaded' ) ) { |
||
| 389 | self::upgrade_on_load(); |
||
| 390 | } else { |
||
| 391 | add_action( |
||
| 392 | 'wp_loaded', |
||
| 393 | array( __CLASS__, 'upgrade_on_load' ) |
||
| 394 | ); |
||
| 395 | } |
||
| 396 | } |
||
| 397 | } |
||
| 398 | } |
||
| 399 | |||
| 400 | /** |
||
| 401 | * Runs upgrade routines that need to have modules loaded. |
||
| 402 | */ |
||
| 403 | static function upgrade_on_load() { |
||
| 404 | |||
| 405 | // Not attempting any upgrades if jetpack_modules_loaded did not fire. |
||
| 406 | // This can happen in case Jetpack has been just upgraded and is |
||
| 407 | // being initialized late during the page load. In this case we wait |
||
| 408 | // until the next proper admin page load with Jetpack active. |
||
| 409 | if ( ! did_action( 'jetpack_modules_loaded' ) ) { |
||
| 410 | delete_transient( self::$plugin_upgrade_lock_key ); |
||
| 411 | |||
| 412 | return; |
||
| 413 | } |
||
| 414 | |||
| 415 | Jetpack::maybe_set_version_option(); |
||
| 416 | |||
| 417 | if ( class_exists( 'Jetpack_Widget_Conditions' ) ) { |
||
| 418 | Jetpack_Widget_Conditions::migrate_post_type_rules(); |
||
| 419 | } |
||
| 420 | |||
| 421 | if ( |
||
| 422 | class_exists( 'Jetpack_Sitemap_Manager' ) |
||
| 423 | && version_compare( JETPACK__VERSION, '5.3', '>=' ) |
||
| 424 | ) { |
||
| 425 | do_action( 'jetpack_sitemaps_purge_data' ); |
||
| 426 | } |
||
| 427 | |||
| 428 | delete_transient( self::$plugin_upgrade_lock_key ); |
||
| 429 | } |
||
| 430 | |||
| 431 | static function activate_manage( ) { |
||
| 432 | if ( did_action( 'init' ) || current_filter() == 'init' ) { |
||
| 433 | self::activate_module( 'manage', false, false ); |
||
| 434 | } else if ( ! has_action( 'init' , array( __CLASS__, 'activate_manage' ) ) ) { |
||
| 435 | add_action( 'init', array( __CLASS__, 'activate_manage' ) ); |
||
| 436 | } |
||
| 437 | } |
||
| 438 | |||
| 439 | static function update_active_modules( $modules ) { |
||
| 440 | $current_modules = Jetpack_Options::get_option( 'active_modules', array() ); |
||
| 441 | |||
| 442 | $success = Jetpack_Options::update_option( 'active_modules', array_unique( $modules ) ); |
||
| 443 | |||
| 444 | if ( is_array( $modules ) && is_array( $current_modules ) ) { |
||
| 445 | $new_active_modules = array_diff( $modules, $current_modules ); |
||
| 446 | foreach( $new_active_modules as $module ) { |
||
| 447 | /** |
||
| 448 | * Fires when a specific module is activated. |
||
| 449 | * |
||
| 450 | * @since 1.9.0 |
||
| 451 | * |
||
| 452 | * @param string $module Module slug. |
||
| 453 | * @param boolean $success whether the module was activated. @since 4.2 |
||
| 454 | */ |
||
| 455 | do_action( 'jetpack_activate_module', $module, $success ); |
||
| 456 | |||
| 457 | /** |
||
| 458 | * Fires when a module is activated. |
||
| 459 | * The dynamic part of the filter, $module, is the module slug. |
||
| 460 | * |
||
| 461 | * @since 1.9.0 |
||
| 462 | * |
||
| 463 | * @param string $module Module slug. |
||
| 464 | */ |
||
| 465 | do_action( "jetpack_activate_module_$module", $module ); |
||
| 466 | } |
||
| 467 | |||
| 468 | $new_deactive_modules = array_diff( $current_modules, $modules ); |
||
| 469 | foreach( $new_deactive_modules as $module ) { |
||
| 470 | /** |
||
| 471 | * Fired after a module has been deactivated. |
||
| 472 | * |
||
| 473 | * @since 4.2.0 |
||
| 474 | * |
||
| 475 | * @param string $module Module slug. |
||
| 476 | * @param boolean $success whether the module was deactivated. |
||
| 477 | */ |
||
| 478 | do_action( 'jetpack_deactivate_module', $module, $success ); |
||
| 479 | /** |
||
| 480 | * Fires when a module is deactivated. |
||
| 481 | * The dynamic part of the filter, $module, is the module slug. |
||
| 482 | * |
||
| 483 | * @since 1.9.0 |
||
| 484 | * |
||
| 485 | * @param string $module Module slug. |
||
| 486 | */ |
||
| 487 | do_action( "jetpack_deactivate_module_$module", $module ); |
||
| 488 | } |
||
| 489 | } |
||
| 490 | |||
| 491 | return $success; |
||
| 492 | } |
||
| 493 | |||
| 494 | static function delete_active_modules() { |
||
| 495 | self::update_active_modules( array() ); |
||
| 496 | } |
||
| 497 | |||
| 498 | /** |
||
| 499 | * Constructor. Initializes WordPress hooks |
||
| 500 | */ |
||
| 501 | private function __construct() { |
||
| 502 | /* |
||
| 503 | * Check for and alert any deprecated hooks |
||
| 504 | */ |
||
| 505 | add_action( 'init', array( $this, 'deprecated_hooks' ) ); |
||
| 506 | |||
| 507 | /* |
||
| 508 | * Enable enhanced handling of previewing sites in Calypso |
||
| 509 | */ |
||
| 510 | if ( Jetpack::is_active() ) { |
||
| 511 | require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-iframe-embed.php'; |
||
| 512 | add_action( 'init', array( 'Jetpack_Iframe_Embed', 'init' ), 9, 0 ); |
||
| 513 | } |
||
| 514 | |||
| 515 | /* |
||
| 516 | * Load things that should only be in Network Admin. |
||
| 517 | * |
||
| 518 | * For now blow away everything else until a more full |
||
| 519 | * understanding of what is needed at the network level is |
||
| 520 | * available |
||
| 521 | */ |
||
| 522 | if( is_multisite() ) { |
||
| 523 | Jetpack_Network::init(); |
||
| 524 | } |
||
| 525 | |||
| 526 | add_action( 'set_user_role', array( $this, 'maybe_clear_other_linked_admins_transient' ), 10, 3 ); |
||
| 527 | |||
| 528 | // Unlink user before deleting the user from .com |
||
| 529 | add_action( 'deleted_user', array( $this, 'unlink_user' ), 10, 1 ); |
||
| 530 | add_action( 'remove_user_from_blog', array( $this, 'unlink_user' ), 10, 1 ); |
||
| 531 | |||
| 532 | if ( defined( 'XMLRPC_REQUEST' ) && XMLRPC_REQUEST && isset( $_GET['for'] ) && 'jetpack' == $_GET['for'] ) { |
||
| 533 | @ini_set( 'display_errors', false ); // Display errors can cause the XML to be not well formed. |
||
| 534 | |||
| 535 | require_once JETPACK__PLUGIN_DIR . 'class.jetpack-xmlrpc-server.php'; |
||
| 536 | $this->xmlrpc_server = new Jetpack_XMLRPC_Server(); |
||
| 537 | |||
| 538 | $this->require_jetpack_authentication(); |
||
| 539 | |||
| 540 | if ( Jetpack::is_active() ) { |
||
| 541 | // Hack to preserve $HTTP_RAW_POST_DATA |
||
| 542 | add_filter( 'xmlrpc_methods', array( $this, 'xmlrpc_methods' ) ); |
||
| 543 | |||
| 544 | $signed = $this->verify_xml_rpc_signature(); |
||
| 545 | if ( $signed && ! is_wp_error( $signed ) ) { |
||
| 546 | // The actual API methods. |
||
| 547 | add_filter( 'xmlrpc_methods', array( $this->xmlrpc_server, 'xmlrpc_methods' ) ); |
||
| 548 | } else { |
||
| 549 | // The jetpack.authorize method should be available for unauthenticated users on a site with an |
||
| 550 | // active Jetpack connection, so that additional users can link their account. |
||
| 551 | add_filter( 'xmlrpc_methods', array( $this->xmlrpc_server, 'authorize_xmlrpc_methods' ) ); |
||
| 552 | } |
||
| 553 | } else { |
||
| 554 | // The bootstrap API methods. |
||
| 555 | add_filter( 'xmlrpc_methods', array( $this->xmlrpc_server, 'bootstrap_xmlrpc_methods' ) ); |
||
| 556 | } |
||
| 557 | |||
| 558 | // Now that no one can authenticate, and we're whitelisting all XML-RPC methods, force enable_xmlrpc on. |
||
| 559 | add_filter( 'pre_option_enable_xmlrpc', '__return_true' ); |
||
| 560 | } elseif ( |
||
| 561 | is_admin() && |
||
| 562 | isset( $_POST['action'] ) && ( |
||
| 563 | 'jetpack_upload_file' == $_POST['action'] || |
||
| 564 | 'jetpack_update_file' == $_POST['action'] |
||
| 565 | ) |
||
| 566 | ) { |
||
| 567 | $this->require_jetpack_authentication(); |
||
| 568 | $this->add_remote_request_handlers(); |
||
| 569 | } else { |
||
| 570 | if ( Jetpack::is_active() ) { |
||
| 571 | add_action( 'login_form_jetpack_json_api_authorization', array( &$this, 'login_form_json_api_authorization' ) ); |
||
| 572 | add_filter( 'xmlrpc_methods', array( $this, 'public_xmlrpc_methods' ) ); |
||
| 573 | } |
||
| 574 | } |
||
| 575 | |||
| 576 | if ( Jetpack::is_active() ) { |
||
| 577 | Jetpack_Heartbeat::init(); |
||
| 578 | require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-search-performance-logger.php'; |
||
| 579 | Jetpack_Search_Performance_Logger::init(); |
||
| 580 | } |
||
| 581 | |||
| 582 | add_filter( 'determine_current_user', array( $this, 'wp_rest_authenticate' ) ); |
||
| 583 | add_filter( 'rest_authentication_errors', array( $this, 'wp_rest_authentication_errors' ) ); |
||
| 584 | |||
| 585 | add_action( 'jetpack_clean_nonces', array( 'Jetpack', 'clean_nonces' ) ); |
||
| 586 | if ( ! wp_next_scheduled( 'jetpack_clean_nonces' ) ) { |
||
| 587 | wp_schedule_event( time(), 'hourly', 'jetpack_clean_nonces' ); |
||
| 588 | } |
||
| 589 | |||
| 590 | add_filter( 'xmlrpc_blog_options', array( $this, 'xmlrpc_options' ) ); |
||
| 591 | |||
| 592 | add_action( 'admin_init', array( $this, 'admin_init' ) ); |
||
| 593 | add_action( 'admin_init', array( $this, 'dismiss_jetpack_notice' ) ); |
||
| 594 | |||
| 595 | add_filter( 'admin_body_class', array( $this, 'admin_body_class' ) ); |
||
| 596 | |||
| 597 | add_action( 'wp_dashboard_setup', array( $this, 'wp_dashboard_setup' ) ); |
||
| 598 | // Filter the dashboard meta box order to swap the new one in in place of the old one. |
||
| 599 | add_filter( 'get_user_option_meta-box-order_dashboard', array( $this, 'get_user_option_meta_box_order_dashboard' ) ); |
||
| 600 | |||
| 601 | // returns HTTPS support status |
||
| 602 | add_action( 'wp_ajax_jetpack-recheck-ssl', array( $this, 'ajax_recheck_ssl' ) ); |
||
| 603 | |||
| 604 | // If any module option is updated before Jump Start is dismissed, hide Jump Start. |
||
| 605 | add_action( 'update_option', array( $this, 'jumpstart_has_updated_module_option' ) ); |
||
| 606 | |||
| 607 | // JITM AJAX callback function |
||
| 608 | add_action( 'wp_ajax_jitm_ajax', array( $this, 'jetpack_jitm_ajax_callback' ) ); |
||
| 609 | |||
| 610 | // Universal ajax callback for all tracking events triggered via js |
||
| 611 | add_action( 'wp_ajax_jetpack_tracks', array( $this, 'jetpack_admin_ajax_tracks_callback' ) ); |
||
| 612 | |||
| 613 | add_action( 'wp_ajax_jetpack_connection_banner', array( $this, 'jetpack_connection_banner_callback' ) ); |
||
| 614 | |||
| 615 | add_action( 'wp_loaded', array( $this, 'register_assets' ) ); |
||
| 616 | add_action( 'wp_enqueue_scripts', array( $this, 'devicepx' ) ); |
||
| 617 | add_action( 'customize_controls_enqueue_scripts', array( $this, 'devicepx' ) ); |
||
| 618 | add_action( 'admin_enqueue_scripts', array( $this, 'devicepx' ) ); |
||
| 619 | |||
| 620 | add_action( 'plugins_loaded', array( $this, 'extra_oembed_providers' ), 100 ); |
||
| 621 | |||
| 622 | /** |
||
| 623 | * These actions run checks to load additional files. |
||
| 624 | * They check for external files or plugins, so they need to run as late as possible. |
||
| 625 | */ |
||
| 626 | add_action( 'wp_head', array( $this, 'check_open_graph' ), 1 ); |
||
| 627 | add_action( 'plugins_loaded', array( $this, 'check_twitter_tags' ), 999 ); |
||
| 628 | add_action( 'plugins_loaded', array( $this, 'check_rest_api_compat' ), 1000 ); |
||
| 629 | |||
| 630 | add_filter( 'plugins_url', array( 'Jetpack', 'maybe_min_asset' ), 1, 3 ); |
||
| 631 | add_action( 'style_loader_src', array( 'Jetpack', 'set_suffix_on_min' ), 10, 2 ); |
||
| 632 | add_filter( 'style_loader_tag', array( 'Jetpack', 'maybe_inline_style' ), 10, 2 ); |
||
| 633 | |||
| 634 | add_filter( 'map_meta_cap', array( $this, 'jetpack_custom_caps' ), 1, 4 ); |
||
| 635 | |||
| 636 | add_filter( 'jetpack_get_default_modules', array( $this, 'filter_default_modules' ) ); |
||
| 637 | add_filter( 'jetpack_get_default_modules', array( $this, 'handle_deprecated_modules' ), 99 ); |
||
| 638 | |||
| 639 | // A filter to control all just in time messages |
||
| 640 | add_filter( 'jetpack_just_in_time_msgs', '__return_true', 9 ); |
||
| 641 | add_filter( 'jetpack_just_in_time_msg_cache', '__return_true', 9); |
||
| 642 | |||
| 643 | // If enabled, point edit post, page, and comment links to Calypso instead of WP-Admin. |
||
| 644 | // We should make sure to only do this for front end links. |
||
| 645 | if ( Jetpack::get_option( 'edit_links_calypso_redirect' ) && ! is_admin() ) { |
||
| 646 | add_filter( 'get_edit_post_link', array( $this, 'point_edit_post_links_to_calypso' ), 1, 2 ); |
||
| 647 | add_filter( 'get_edit_comment_link', array( $this, 'point_edit_comment_links_to_calypso' ), 1 ); |
||
| 648 | |||
| 649 | //we'll override wp_notify_postauthor and wp_notify_moderator pluggable functions |
||
| 650 | //so they point moderation links on emails to Calypso |
||
| 651 | jetpack_require_lib( 'functions.wp-notify' ); |
||
| 652 | } |
||
| 653 | |||
| 654 | // Update the Jetpack plan from API on heartbeats |
||
| 655 | add_action( 'jetpack_heartbeat', array( $this, 'refresh_active_plan_from_wpcom' ) ); |
||
| 656 | |||
| 657 | /** |
||
| 658 | * This is the hack to concatinate all css files into one. |
||
| 659 | * For description and reasoning see the implode_frontend_css method |
||
| 660 | * |
||
| 661 | * Super late priority so we catch all the registered styles |
||
| 662 | */ |
||
| 663 | if( !is_admin() ) { |
||
| 664 | add_action( 'wp_print_styles', array( $this, 'implode_frontend_css' ), -1 ); // Run first |
||
| 665 | add_action( 'wp_print_footer_scripts', array( $this, 'implode_frontend_css' ), -1 ); // Run first to trigger before `print_late_styles` |
||
| 666 | } |
||
| 667 | |||
| 668 | /** |
||
| 669 | * These are sync actions that we need to keep track of for jitms |
||
| 670 | */ |
||
| 671 | add_filter( 'jetpack_sync_before_send_updated_option', array( $this, 'jetpack_track_last_sync_callback' ), 99 ); |
||
| 672 | |||
| 673 | // Actually push the stats on shutdown. |
||
| 674 | if ( ! has_action( 'shutdown', array( $this, 'push_stats' ) ) ) { |
||
| 675 | add_action( 'shutdown', array( $this, 'push_stats' ) ); |
||
| 676 | } |
||
| 677 | } |
||
| 678 | |||
| 679 | function point_edit_post_links_to_calypso( $default_url, $post_id ) { |
||
| 680 | $post = get_post( $post_id ); |
||
| 681 | |||
| 682 | if ( empty( $post ) ) { |
||
| 683 | return $default_url; |
||
| 684 | } |
||
| 685 | |||
| 686 | $post_type = $post->post_type; |
||
| 687 | |||
| 688 | // Mapping the allowed CPTs on WordPress.com to corresponding paths in Calypso. |
||
| 689 | // https://en.support.wordpress.com/custom-post-types/ |
||
| 690 | $allowed_post_types = array( |
||
| 691 | 'post' => 'post', |
||
| 692 | 'page' => 'page', |
||
| 693 | 'jetpack-portfolio' => 'edit/jetpack-portfolio', |
||
| 694 | 'jetpack-testimonial' => 'edit/jetpack-testimonial', |
||
| 695 | ); |
||
| 696 | |||
| 697 | if ( ! in_array( $post_type, array_keys( $allowed_post_types ) ) ) { |
||
| 698 | return $default_url; |
||
| 699 | } |
||
| 700 | |||
| 701 | $path_prefix = $allowed_post_types[ $post_type ]; |
||
| 702 | |||
| 703 | $site_slug = Jetpack::build_raw_urls( get_home_url() ); |
||
| 704 | |||
| 705 | return esc_url( sprintf( 'https://wordpress.com/%s/%s/%d', $path_prefix, $site_slug, $post_id ) ); |
||
| 706 | } |
||
| 707 | |||
| 708 | function point_edit_comment_links_to_calypso( $url ) { |
||
| 709 | // Take the `query` key value from the URL, and parse its parts to the $query_args. `amp;c` matches the comment ID. |
||
| 710 | wp_parse_str( wp_parse_url( $url, PHP_URL_QUERY ), $query_args ); |
||
| 711 | return esc_url( sprintf( 'https://wordpress.com/comment/%s/%d', |
||
| 712 | Jetpack::build_raw_urls( get_home_url() ), |
||
| 713 | $query_args['amp;c'] |
||
| 714 | ) ); |
||
| 715 | } |
||
| 716 | |||
| 717 | function jetpack_track_last_sync_callback( $params ) { |
||
| 718 | /** |
||
| 719 | * Filter to turn off jitm caching |
||
| 720 | * |
||
| 721 | * @since 5.4.0 |
||
| 722 | * |
||
| 723 | * @param bool false Whether to cache just in time messages |
||
| 724 | */ |
||
| 725 | if ( ! apply_filters( 'jetpack_just_in_time_msg_cache', false ) ) { |
||
| 726 | return $params; |
||
| 727 | } |
||
| 728 | |||
| 729 | if ( is_array( $params ) && isset( $params[0] ) ) { |
||
| 730 | $option = $params[0]; |
||
| 731 | if ( 'active_plugins' === $option ) { |
||
| 732 | // use the cache if we can, but not terribly important if it gets evicted |
||
| 733 | set_transient( 'jetpack_last_plugin_sync', time(), HOUR_IN_SECONDS ); |
||
| 734 | } |
||
| 735 | } |
||
| 736 | |||
| 737 | return $params; |
||
| 738 | } |
||
| 739 | |||
| 740 | function jetpack_connection_banner_callback() { |
||
| 741 | check_ajax_referer( 'jp-connection-banner-nonce', 'nonce' ); |
||
| 742 | |||
| 743 | if ( isset( $_REQUEST['dismissBanner'] ) ) { |
||
| 744 | Jetpack_Options::update_option( 'dismissed_connection_banner', 1 ); |
||
| 745 | wp_send_json_success(); |
||
| 746 | } |
||
| 747 | |||
| 748 | wp_die(); |
||
| 749 | } |
||
| 750 | |||
| 751 | function jetpack_admin_ajax_tracks_callback() { |
||
| 752 | // Check for nonce |
||
| 753 | if ( ! isset( $_REQUEST['tracksNonce'] ) || ! wp_verify_nonce( $_REQUEST['tracksNonce'], 'jp-tracks-ajax-nonce' ) ) { |
||
| 754 | wp_die( 'Permissions check failed.' ); |
||
| 755 | } |
||
| 756 | |||
| 757 | if ( ! isset( $_REQUEST['tracksEventName'] ) || ! isset( $_REQUEST['tracksEventType'] ) ) { |
||
| 758 | wp_die( 'No valid event name or type.' ); |
||
| 759 | } |
||
| 760 | |||
| 761 | $tracks_data = array(); |
||
| 762 | if ( 'click' === $_REQUEST['tracksEventType'] && isset( $_REQUEST['tracksEventProp'] ) ) { |
||
| 763 | if ( is_array( $_REQUEST['tracksEventProp'] ) ) { |
||
| 764 | $tracks_data = $_REQUEST['tracksEventProp']; |
||
| 765 | } else { |
||
| 766 | $tracks_data = array( 'clicked' => $_REQUEST['tracksEventProp'] ); |
||
| 767 | } |
||
| 768 | } |
||
| 769 | |||
| 770 | JetpackTracking::record_user_event( $_REQUEST['tracksEventName'], $tracks_data ); |
||
| 771 | wp_send_json_success(); |
||
| 772 | wp_die(); |
||
| 773 | } |
||
| 774 | |||
| 775 | /** |
||
| 776 | * The callback for the JITM ajax requests. |
||
| 777 | */ |
||
| 778 | function jetpack_jitm_ajax_callback() { |
||
| 779 | // Check for nonce |
||
| 780 | if ( ! isset( $_REQUEST['jitmNonce'] ) || ! wp_verify_nonce( $_REQUEST['jitmNonce'], 'jetpack-jitm-nonce' ) ) { |
||
| 781 | wp_die( 'Module activation failed due to lack of appropriate permissions' ); |
||
| 782 | } |
||
| 783 | if ( isset( $_REQUEST['jitmActionToTake'] ) && 'activate' == $_REQUEST['jitmActionToTake'] ) { |
||
| 784 | $module_slug = $_REQUEST['jitmModule']; |
||
| 785 | Jetpack::log( 'activate', $module_slug ); |
||
| 786 | Jetpack::activate_module( $module_slug, false, false ); |
||
| 787 | Jetpack::state( 'message', 'no_message' ); |
||
| 788 | |||
| 789 | //A Jetpack module is being activated through a JITM, track it |
||
| 790 | $this->stat( 'jitm', $module_slug.'-activated-' . JETPACK__VERSION ); |
||
| 791 | $this->do_stats( 'server_side' ); |
||
| 792 | |||
| 793 | wp_send_json_success(); |
||
| 794 | } |
||
| 795 | if ( isset( $_REQUEST['jitmActionToTake'] ) && 'dismiss' == $_REQUEST['jitmActionToTake'] ) { |
||
| 796 | // get the hide_jitm options array |
||
| 797 | $jetpack_hide_jitm = Jetpack_Options::get_option( 'hide_jitm' ); |
||
| 798 | $module_slug = $_REQUEST['jitmModule']; |
||
| 799 | |||
| 800 | if( ! $jetpack_hide_jitm ) { |
||
| 801 | $jetpack_hide_jitm = array( |
||
| 802 | $module_slug => 'hide' |
||
| 803 | ); |
||
| 804 | } else { |
||
| 805 | $jetpack_hide_jitm[$module_slug] = 'hide'; |
||
| 806 | } |
||
| 807 | |||
| 808 | Jetpack_Options::update_option( 'hide_jitm', $jetpack_hide_jitm ); |
||
| 809 | |||
| 810 | //jitm is being dismissed forever, track it |
||
| 811 | $this->stat( 'jitm', $module_slug.'-dismissed-' . JETPACK__VERSION ); |
||
| 812 | $this->do_stats( 'server_side' ); |
||
| 813 | |||
| 814 | wp_send_json_success(); |
||
| 815 | } |
||
| 816 | View Code Duplication | if ( isset( $_REQUEST['jitmActionToTake'] ) && 'launch' == $_REQUEST['jitmActionToTake'] ) { |
|
| 817 | $module_slug = $_REQUEST['jitmModule']; |
||
| 818 | |||
| 819 | // User went to WordPress.com, track this |
||
| 820 | $this->stat( 'jitm', $module_slug.'-wordpress-tools-' . JETPACK__VERSION ); |
||
| 821 | $this->do_stats( 'server_side' ); |
||
| 822 | |||
| 823 | wp_send_json_success(); |
||
| 824 | } |
||
| 825 | View Code Duplication | if ( isset( $_REQUEST['jitmActionToTake'] ) && 'viewed' == $_REQUEST['jitmActionToTake'] ) { |
|
| 826 | $track = $_REQUEST['jitmModule']; |
||
| 827 | |||
| 828 | // User is viewing JITM, track it. |
||
| 829 | $this->stat( 'jitm', $track . '-viewed-' . JETPACK__VERSION ); |
||
| 830 | $this->do_stats( 'server_side' ); |
||
| 831 | |||
| 832 | wp_send_json_success(); |
||
| 833 | } |
||
| 834 | } |
||
| 835 | |||
| 836 | /** |
||
| 837 | * If there are any stats that need to be pushed, but haven't been, push them now. |
||
| 838 | */ |
||
| 839 | function push_stats() { |
||
| 840 | if ( ! empty( $this->stats ) ) { |
||
| 841 | $this->do_stats( 'server_side' ); |
||
| 842 | } |
||
| 843 | } |
||
| 844 | |||
| 845 | function jetpack_custom_caps( $caps, $cap, $user_id, $args ) { |
||
| 846 | switch( $cap ) { |
||
| 847 | case 'jetpack_connect' : |
||
| 848 | case 'jetpack_reconnect' : |
||
| 849 | if ( Jetpack::is_development_mode() ) { |
||
| 850 | $caps = array( 'do_not_allow' ); |
||
| 851 | break; |
||
| 852 | } |
||
| 853 | /** |
||
| 854 | * Pass through. If it's not development mode, these should match disconnect. |
||
| 855 | * Let users disconnect if it's development mode, just in case things glitch. |
||
| 856 | */ |
||
| 857 | case 'jetpack_disconnect' : |
||
| 858 | /** |
||
| 859 | * In multisite, can individual site admins manage their own connection? |
||
| 860 | * |
||
| 861 | * Ideally, this should be extracted out to a separate filter in the Jetpack_Network class. |
||
| 862 | */ |
||
| 863 | if ( is_multisite() && ! is_super_admin() && is_plugin_active_for_network( 'jetpack/jetpack.php' ) ) { |
||
| 864 | if ( ! Jetpack_Network::init()->get_option( 'sub-site-connection-override' ) ) { |
||
| 865 | /** |
||
| 866 | * We need to update the option name -- it's terribly unclear which |
||
| 867 | * direction the override goes. |
||
| 868 | * |
||
| 869 | * @todo: Update the option name to `sub-sites-can-manage-own-connections` |
||
| 870 | */ |
||
| 871 | $caps = array( 'do_not_allow' ); |
||
| 872 | break; |
||
| 873 | } |
||
| 874 | } |
||
| 875 | |||
| 876 | $caps = array( 'manage_options' ); |
||
| 877 | break; |
||
| 878 | case 'jetpack_manage_modules' : |
||
| 879 | case 'jetpack_activate_modules' : |
||
| 880 | case 'jetpack_deactivate_modules' : |
||
| 881 | $caps = array( 'manage_options' ); |
||
| 882 | break; |
||
| 883 | case 'jetpack_configure_modules' : |
||
| 884 | $caps = array( 'manage_options' ); |
||
| 885 | break; |
||
| 886 | case 'jetpack_network_admin_page': |
||
| 887 | case 'jetpack_network_settings_page': |
||
| 888 | $caps = array( 'manage_network_plugins' ); |
||
| 889 | break; |
||
| 890 | case 'jetpack_network_sites_page': |
||
| 891 | $caps = array( 'manage_sites' ); |
||
| 892 | break; |
||
| 893 | case 'jetpack_admin_page' : |
||
| 894 | if ( Jetpack::is_development_mode() ) { |
||
| 895 | $caps = array( 'manage_options' ); |
||
| 896 | break; |
||
| 897 | } else { |
||
| 898 | $caps = array( 'read' ); |
||
| 899 | } |
||
| 900 | break; |
||
| 901 | case 'jetpack_connect_user' : |
||
| 902 | if ( Jetpack::is_development_mode() ) { |
||
| 903 | $caps = array( 'do_not_allow' ); |
||
| 904 | break; |
||
| 905 | } |
||
| 906 | $caps = array( 'read' ); |
||
| 907 | break; |
||
| 908 | } |
||
| 909 | return $caps; |
||
| 910 | } |
||
| 911 | |||
| 912 | function require_jetpack_authentication() { |
||
| 913 | // Don't let anyone authenticate |
||
| 914 | $_COOKIE = array(); |
||
| 915 | remove_all_filters( 'authenticate' ); |
||
| 916 | remove_all_actions( 'wp_login_failed' ); |
||
| 917 | |||
| 918 | if ( Jetpack::is_active() ) { |
||
| 919 | // Allow Jetpack authentication |
||
| 920 | add_filter( 'authenticate', array( $this, 'authenticate_jetpack' ), 10, 3 ); |
||
| 921 | } |
||
| 922 | } |
||
| 923 | |||
| 924 | /** |
||
| 925 | * Load language files |
||
| 926 | * @action plugins_loaded |
||
| 927 | */ |
||
| 928 | public static function plugin_textdomain() { |
||
| 929 | // Note to self, the third argument must not be hardcoded, to account for relocated folders. |
||
| 930 | load_plugin_textdomain( 'jetpack', false, dirname( plugin_basename( JETPACK__PLUGIN_FILE ) ) . '/languages/' ); |
||
| 931 | } |
||
| 932 | |||
| 933 | /** |
||
| 934 | * Register assets for use in various modules and the Jetpack admin page. |
||
| 935 | * |
||
| 936 | * @uses wp_script_is, wp_register_script, plugins_url |
||
| 937 | * @action wp_loaded |
||
| 938 | * @return null |
||
| 939 | */ |
||
| 940 | public function register_assets() { |
||
| 941 | if ( ! wp_script_is( 'spin', 'registered' ) ) { |
||
| 942 | wp_register_script( |
||
| 943 | 'spin', |
||
| 944 | self::get_file_url_for_environment( '_inc/build/spin.min.js', '_inc/spin.js' ), |
||
| 945 | false, |
||
| 946 | '1.3' |
||
| 947 | ); |
||
| 948 | } |
||
| 949 | |||
| 950 | if ( ! wp_script_is( 'jquery.spin', 'registered' ) ) { |
||
| 951 | wp_register_script( |
||
| 952 | 'jquery.spin', |
||
| 953 | self::get_file_url_for_environment( '_inc/build/jquery.spin.min.js', '_inc/jquery.spin.js' ), |
||
| 954 | array( 'jquery', 'spin' ), |
||
| 955 | '1.3' |
||
| 956 | ); |
||
| 957 | } |
||
| 958 | |||
| 959 | View Code Duplication | if ( ! wp_script_is( 'jetpack-gallery-settings', 'registered' ) ) { |
|
| 960 | wp_register_script( |
||
| 961 | 'jetpack-gallery-settings', |
||
| 962 | self::get_file_url_for_environment( '_inc/build/gallery-settings.min.js', '_inc/gallery-settings.js' ), |
||
| 963 | array( 'media-views' ), |
||
| 964 | '20121225' |
||
| 965 | ); |
||
| 966 | } |
||
| 967 | |||
| 968 | if ( ! wp_script_is( 'jetpack-twitter-timeline', 'registered' ) ) { |
||
| 969 | wp_register_script( |
||
| 970 | 'jetpack-twitter-timeline', |
||
| 971 | self::get_file_url_for_environment( '_inc/build/twitter-timeline.min.js', '_inc/twitter-timeline.js' ), |
||
| 972 | array( 'jquery' ), |
||
| 973 | '4.0.0', |
||
| 974 | true |
||
| 975 | ); |
||
| 976 | } |
||
| 977 | |||
| 978 | if ( ! wp_script_is( 'jetpack-facebook-embed', 'registered' ) ) { |
||
| 979 | wp_register_script( |
||
| 980 | 'jetpack-facebook-embed', |
||
| 981 | self::get_file_url_for_environment( '_inc/build/facebook-embed.min.js', '_inc/facebook-embed.js' ), |
||
| 982 | array( 'jquery' ), |
||
| 983 | null, |
||
| 984 | true |
||
| 985 | ); |
||
| 986 | |||
| 987 | /** This filter is documented in modules/sharedaddy/sharing-sources.php */ |
||
| 988 | $fb_app_id = apply_filters( 'jetpack_sharing_facebook_app_id', '249643311490' ); |
||
| 989 | if ( ! is_numeric( $fb_app_id ) ) { |
||
| 990 | $fb_app_id = ''; |
||
| 991 | } |
||
| 992 | wp_localize_script( |
||
| 993 | 'jetpack-facebook-embed', |
||
| 994 | 'jpfbembed', |
||
| 995 | array( |
||
| 996 | 'appid' => $fb_app_id, |
||
| 997 | 'locale' => $this->get_locale(), |
||
| 998 | ) |
||
| 999 | ); |
||
| 1000 | } |
||
| 1001 | |||
| 1002 | /** |
||
| 1003 | * As jetpack_register_genericons is by default fired off a hook, |
||
| 1004 | * the hook may have already fired by this point. |
||
| 1005 | * So, let's just trigger it manually. |
||
| 1006 | */ |
||
| 1007 | require_once( JETPACK__PLUGIN_DIR . '_inc/genericons.php' ); |
||
| 1008 | jetpack_register_genericons(); |
||
| 1009 | |||
| 1010 | /** |
||
| 1011 | * Register the social logos |
||
| 1012 | */ |
||
| 1013 | require_once( JETPACK__PLUGIN_DIR . '_inc/social-logos.php' ); |
||
| 1014 | jetpack_register_social_logos(); |
||
| 1015 | |||
| 1016 | View Code Duplication | if ( ! wp_style_is( 'jetpack-icons', 'registered' ) ) |
|
| 1017 | wp_register_style( 'jetpack-icons', plugins_url( 'css/jetpack-icons.min.css', JETPACK__PLUGIN_FILE ), false, JETPACK__VERSION ); |
||
| 1018 | } |
||
| 1019 | |||
| 1020 | /** |
||
| 1021 | * Guess locale from language code. |
||
| 1022 | * |
||
| 1023 | * @param string $lang Language code. |
||
| 1024 | * @return string|bool |
||
| 1025 | */ |
||
| 1026 | function guess_locale_from_lang( $lang ) { |
||
| 1027 | if ( 'en' === $lang || 'en_US' === $lang || ! $lang ) { |
||
| 1028 | return 'en_US'; |
||
| 1029 | } |
||
| 1030 | |||
| 1031 | View Code Duplication | if ( ! class_exists( 'GP_Locales' ) ) { |
|
| 1032 | if ( ! defined( 'JETPACK__GLOTPRESS_LOCALES_PATH' ) || ! file_exists( JETPACK__GLOTPRESS_LOCALES_PATH ) ) { |
||
| 1033 | return false; |
||
| 1034 | } |
||
| 1035 | |||
| 1036 | require JETPACK__GLOTPRESS_LOCALES_PATH; |
||
| 1037 | } |
||
| 1038 | |||
| 1039 | if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) { |
||
| 1040 | // WP.com: get_locale() returns 'it' |
||
| 1041 | $locale = GP_Locales::by_slug( $lang ); |
||
| 1042 | } else { |
||
| 1043 | // Jetpack: get_locale() returns 'it_IT'; |
||
| 1044 | $locale = GP_Locales::by_field( 'facebook_locale', $lang ); |
||
| 1045 | } |
||
| 1046 | |||
| 1047 | if ( ! $locale ) { |
||
| 1048 | return false; |
||
| 1049 | } |
||
| 1050 | |||
| 1051 | if ( empty( $locale->facebook_locale ) ) { |
||
| 1052 | if ( empty( $locale->wp_locale ) ) { |
||
| 1053 | return false; |
||
| 1054 | } else { |
||
| 1055 | // Facebook SDK is smart enough to fall back to en_US if a |
||
| 1056 | // locale isn't supported. Since supported Facebook locales |
||
| 1057 | // can fall out of sync, we'll attempt to use the known |
||
| 1058 | // wp_locale value and rely on said fallback. |
||
| 1059 | return $locale->wp_locale; |
||
| 1060 | } |
||
| 1061 | } |
||
| 1062 | |||
| 1063 | return $locale->facebook_locale; |
||
| 1064 | } |
||
| 1065 | |||
| 1066 | /** |
||
| 1067 | * Get the locale. |
||
| 1068 | * |
||
| 1069 | * @return string|bool |
||
| 1070 | */ |
||
| 1071 | function get_locale() { |
||
| 1072 | $locale = $this->guess_locale_from_lang( get_locale() ); |
||
| 1073 | |||
| 1074 | if ( ! $locale ) { |
||
| 1075 | $locale = 'en_US'; |
||
| 1076 | } |
||
| 1077 | |||
| 1078 | return $locale; |
||
| 1079 | } |
||
| 1080 | |||
| 1081 | /** |
||
| 1082 | * Device Pixels support |
||
| 1083 | * This improves the resolution of gravatars and wordpress.com uploads on hi-res and zoomed browsers. |
||
| 1084 | */ |
||
| 1085 | function devicepx() { |
||
| 1086 | if ( Jetpack::is_active() ) { |
||
| 1087 | wp_enqueue_script( 'devicepx', 'https://s0.wp.com/wp-content/js/devicepx-jetpack.js', array(), gmdate( 'oW' ), true ); |
||
| 1088 | } |
||
| 1089 | } |
||
| 1090 | |||
| 1091 | /** |
||
| 1092 | * Return the network_site_url so that .com knows what network this site is a part of. |
||
| 1093 | * @param bool $option |
||
| 1094 | * @return string |
||
| 1095 | */ |
||
| 1096 | public function jetpack_main_network_site_option( $option ) { |
||
| 1097 | return network_site_url(); |
||
| 1098 | } |
||
| 1099 | /** |
||
| 1100 | * Network Name. |
||
| 1101 | */ |
||
| 1102 | static function network_name( $option = null ) { |
||
| 1103 | global $current_site; |
||
| 1104 | return $current_site->site_name; |
||
| 1105 | } |
||
| 1106 | /** |
||
| 1107 | * Does the network allow new user and site registrations. |
||
| 1108 | * @return string |
||
| 1109 | */ |
||
| 1110 | static function network_allow_new_registrations( $option = null ) { |
||
| 1111 | return ( in_array( get_site_option( 'registration' ), array('none', 'user', 'blog', 'all' ) ) ? get_site_option( 'registration') : 'none' ); |
||
| 1112 | } |
||
| 1113 | /** |
||
| 1114 | * Does the network allow admins to add new users. |
||
| 1115 | * @return boolian |
||
| 1116 | */ |
||
| 1117 | static function network_add_new_users( $option = null ) { |
||
| 1118 | return (bool) get_site_option( 'add_new_users' ); |
||
| 1119 | } |
||
| 1120 | /** |
||
| 1121 | * File upload psace left per site in MB. |
||
| 1122 | * -1 means NO LIMIT. |
||
| 1123 | * @return number |
||
| 1124 | */ |
||
| 1125 | static function network_site_upload_space( $option = null ) { |
||
| 1126 | // value in MB |
||
| 1127 | return ( get_site_option( 'upload_space_check_disabled' ) ? -1 : get_space_allowed() ); |
||
| 1128 | } |
||
| 1129 | |||
| 1130 | /** |
||
| 1131 | * Network allowed file types. |
||
| 1132 | * @return string |
||
| 1133 | */ |
||
| 1134 | static function network_upload_file_types( $option = null ) { |
||
| 1135 | return get_site_option( 'upload_filetypes', 'jpg jpeg png gif' ); |
||
| 1136 | } |
||
| 1137 | |||
| 1138 | /** |
||
| 1139 | * Maximum file upload size set by the network. |
||
| 1140 | * @return number |
||
| 1141 | */ |
||
| 1142 | static function network_max_upload_file_size( $option = null ) { |
||
| 1143 | // value in KB |
||
| 1144 | return get_site_option( 'fileupload_maxk', 300 ); |
||
| 1145 | } |
||
| 1146 | |||
| 1147 | /** |
||
| 1148 | * Lets us know if a site allows admins to manage the network. |
||
| 1149 | * @return array |
||
| 1150 | */ |
||
| 1151 | static function network_enable_administration_menus( $option = null ) { |
||
| 1152 | return get_site_option( 'menu_items' ); |
||
| 1153 | } |
||
| 1154 | |||
| 1155 | /** |
||
| 1156 | * If a user has been promoted to or demoted from admin, we need to clear the |
||
| 1157 | * jetpack_other_linked_admins transient. |
||
| 1158 | * |
||
| 1159 | * @since 4.3.2 |
||
| 1160 | * @since 4.4.0 $old_roles is null by default and if it's not passed, the transient is cleared. |
||
| 1161 | * |
||
| 1162 | * @param int $user_id The user ID whose role changed. |
||
| 1163 | * @param string $role The new role. |
||
| 1164 | * @param array $old_roles An array of the user's previous roles. |
||
| 1165 | */ |
||
| 1166 | function maybe_clear_other_linked_admins_transient( $user_id, $role, $old_roles = null ) { |
||
| 1167 | if ( 'administrator' == $role |
||
| 1168 | || ( is_array( $old_roles ) && in_array( 'administrator', $old_roles ) ) |
||
| 1169 | || is_null( $old_roles ) |
||
| 1170 | ) { |
||
| 1171 | delete_transient( 'jetpack_other_linked_admins' ); |
||
| 1172 | } |
||
| 1173 | } |
||
| 1174 | |||
| 1175 | /** |
||
| 1176 | * Checks to see if there are any other users available to become primary |
||
| 1177 | * Users must both: |
||
| 1178 | * - Be linked to wpcom |
||
| 1179 | * - Be an admin |
||
| 1180 | * |
||
| 1181 | * @return mixed False if no other users are linked, Int if there are. |
||
| 1182 | */ |
||
| 1183 | static function get_other_linked_admins() { |
||
| 1184 | $other_linked_users = get_transient( 'jetpack_other_linked_admins' ); |
||
| 1185 | |||
| 1186 | if ( false === $other_linked_users ) { |
||
| 1187 | $admins = get_users( array( 'role' => 'administrator' ) ); |
||
| 1188 | if ( count( $admins ) > 1 ) { |
||
| 1189 | $available = array(); |
||
| 1190 | foreach ( $admins as $admin ) { |
||
| 1191 | if ( Jetpack::is_user_connected( $admin->ID ) ) { |
||
| 1192 | $available[] = $admin->ID; |
||
| 1193 | } |
||
| 1194 | } |
||
| 1195 | |||
| 1196 | $count_connected_admins = count( $available ); |
||
| 1197 | if ( count( $available ) > 1 ) { |
||
| 1198 | $other_linked_users = $count_connected_admins; |
||
| 1199 | } else { |
||
| 1200 | $other_linked_users = 0; |
||
| 1201 | } |
||
| 1202 | } else { |
||
| 1203 | $other_linked_users = 0; |
||
| 1204 | } |
||
| 1205 | |||
| 1206 | set_transient( 'jetpack_other_linked_admins', $other_linked_users, HOUR_IN_SECONDS ); |
||
| 1207 | } |
||
| 1208 | |||
| 1209 | return ( 0 === $other_linked_users ) ? false : $other_linked_users; |
||
| 1210 | } |
||
| 1211 | |||
| 1212 | /** |
||
| 1213 | * Return whether we are dealing with a multi network setup or not. |
||
| 1214 | * The reason we are type casting this is because we want to avoid the situation where |
||
| 1215 | * the result is false since when is_main_network_option return false it cases |
||
| 1216 | * the rest the get_option( 'jetpack_is_multi_network' ); to return the value that is set in the |
||
| 1217 | * database which could be set to anything as opposed to what this function returns. |
||
| 1218 | * @param bool $option |
||
| 1219 | * |
||
| 1220 | * @return boolean |
||
| 1221 | */ |
||
| 1222 | public function is_main_network_option( $option ) { |
||
| 1223 | // return '1' or '' |
||
| 1224 | return (string) (bool) Jetpack::is_multi_network(); |
||
| 1225 | } |
||
| 1226 | |||
| 1227 | /** |
||
| 1228 | * Return true if we are with multi-site or multi-network false if we are dealing with single site. |
||
| 1229 | * |
||
| 1230 | * @param string $option |
||
| 1231 | * @return boolean |
||
| 1232 | */ |
||
| 1233 | public function is_multisite( $option ) { |
||
| 1234 | return (string) (bool) is_multisite(); |
||
| 1235 | } |
||
| 1236 | |||
| 1237 | /** |
||
| 1238 | * Implemented since there is no core is multi network function |
||
| 1239 | * Right now there is no way to tell if we which network is the dominant network on the system |
||
| 1240 | * |
||
| 1241 | * @since 3.3 |
||
| 1242 | * @return boolean |
||
| 1243 | */ |
||
| 1244 | public static function is_multi_network() { |
||
| 1245 | global $wpdb; |
||
| 1246 | |||
| 1247 | // if we don't have a multi site setup no need to do any more |
||
| 1248 | if ( ! is_multisite() ) { |
||
| 1249 | return false; |
||
| 1250 | } |
||
| 1251 | |||
| 1252 | $num_sites = $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->site}" ); |
||
| 1253 | if ( $num_sites > 1 ) { |
||
| 1254 | return true; |
||
| 1255 | } else { |
||
| 1256 | return false; |
||
| 1257 | } |
||
| 1258 | } |
||
| 1259 | |||
| 1260 | /** |
||
| 1261 | * Trigger an update to the main_network_site when we update the siteurl of a site. |
||
| 1262 | * @return null |
||
| 1263 | */ |
||
| 1264 | function update_jetpack_main_network_site_option() { |
||
| 1265 | _deprecated_function( __METHOD__, 'jetpack-4.2' ); |
||
| 1266 | } |
||
| 1267 | /** |
||
| 1268 | * Triggered after a user updates the network settings via Network Settings Admin Page |
||
| 1269 | * |
||
| 1270 | */ |
||
| 1271 | function update_jetpack_network_settings() { |
||
| 1272 | _deprecated_function( __METHOD__, 'jetpack-4.2' ); |
||
| 1273 | // Only sync this info for the main network site. |
||
| 1274 | } |
||
| 1275 | |||
| 1276 | /** |
||
| 1277 | * Get back if the current site is single user site. |
||
| 1278 | * |
||
| 1279 | * @return bool |
||
| 1280 | */ |
||
| 1281 | public static function is_single_user_site() { |
||
| 1282 | global $wpdb; |
||
| 1283 | |||
| 1284 | View Code Duplication | if ( false === ( $some_users = get_transient( 'jetpack_is_single_user' ) ) ) { |
|
| 1285 | $some_users = $wpdb->get_var( "SELECT COUNT(*) FROM (SELECT user_id FROM $wpdb->usermeta WHERE meta_key = '{$wpdb->prefix}capabilities' LIMIT 2) AS someusers" ); |
||
| 1286 | set_transient( 'jetpack_is_single_user', (int) $some_users, 12 * HOUR_IN_SECONDS ); |
||
| 1287 | } |
||
| 1288 | return 1 === (int) $some_users; |
||
| 1289 | } |
||
| 1290 | |||
| 1291 | /** |
||
| 1292 | * Returns true if the site has file write access false otherwise. |
||
| 1293 | * @return string ( '1' | '0' ) |
||
| 1294 | **/ |
||
| 1295 | public static function file_system_write_access() { |
||
| 1296 | if ( ! function_exists( 'get_filesystem_method' ) ) { |
||
| 1297 | require_once( ABSPATH . 'wp-admin/includes/file.php' ); |
||
| 1298 | } |
||
| 1299 | |||
| 1300 | require_once( ABSPATH . 'wp-admin/includes/template.php' ); |
||
| 1301 | |||
| 1302 | $filesystem_method = get_filesystem_method(); |
||
| 1303 | if ( $filesystem_method === 'direct' ) { |
||
| 1304 | return 1; |
||
| 1305 | } |
||
| 1306 | |||
| 1307 | ob_start(); |
||
| 1308 | $filesystem_credentials_are_stored = request_filesystem_credentials( self_admin_url() ); |
||
| 1309 | ob_end_clean(); |
||
| 1310 | if ( $filesystem_credentials_are_stored ) { |
||
| 1311 | return 1; |
||
| 1312 | } |
||
| 1313 | return 0; |
||
| 1314 | } |
||
| 1315 | |||
| 1316 | /** |
||
| 1317 | * Finds out if a site is using a version control system. |
||
| 1318 | * @return string ( '1' | '0' ) |
||
| 1319 | **/ |
||
| 1320 | public static function is_version_controlled() { |
||
| 1321 | _deprecated_function( __METHOD__, 'jetpack-4.2', 'Jetpack_Sync_Functions::is_version_controlled' ); |
||
| 1322 | return (string) (int) Jetpack_Sync_Functions::is_version_controlled(); |
||
| 1323 | } |
||
| 1324 | |||
| 1325 | /** |
||
| 1326 | * Determines whether the current theme supports featured images or not. |
||
| 1327 | * @return string ( '1' | '0' ) |
||
| 1328 | */ |
||
| 1329 | public static function featured_images_enabled() { |
||
| 1330 | _deprecated_function( __METHOD__, 'jetpack-4.2' ); |
||
| 1331 | return current_theme_supports( 'post-thumbnails' ) ? '1' : '0'; |
||
| 1332 | } |
||
| 1333 | |||
| 1334 | /** |
||
| 1335 | * Wrapper for core's get_avatar_url(). This one is deprecated. |
||
| 1336 | * |
||
| 1337 | * @deprecated 4.7 use get_avatar_url instead. |
||
| 1338 | * @param int|string|object $id_or_email A user ID, email address, or comment object |
||
| 1339 | * @param int $size Size of the avatar image |
||
| 1340 | * @param string $default URL to a default image to use if no avatar is available |
||
| 1341 | * @param bool $force_display Whether to force it to return an avatar even if show_avatars is disabled |
||
| 1342 | * |
||
| 1343 | * @return array |
||
| 1344 | */ |
||
| 1345 | public static function get_avatar_url( $id_or_email, $size = 96, $default = '', $force_display = false ) { |
||
| 1346 | _deprecated_function( __METHOD__, 'jetpack-4.7', 'get_avatar_url' ); |
||
| 1347 | return get_avatar_url( $id_or_email, array( |
||
| 1348 | 'size' => $size, |
||
| 1349 | 'default' => $default, |
||
| 1350 | 'force_default' => $force_display, |
||
| 1351 | ) ); |
||
| 1352 | } |
||
| 1353 | |||
| 1354 | /** |
||
| 1355 | * jetpack_updates is saved in the following schema: |
||
| 1356 | * |
||
| 1357 | * array ( |
||
| 1358 | * 'plugins' => (int) Number of plugin updates available. |
||
| 1359 | * 'themes' => (int) Number of theme updates available. |
||
| 1360 | * 'wordpress' => (int) Number of WordPress core updates available. |
||
| 1361 | * 'translations' => (int) Number of translation updates available. |
||
| 1362 | * 'total' => (int) Total of all available updates. |
||
| 1363 | * 'wp_update_version' => (string) The latest available version of WordPress, only present if a WordPress update is needed. |
||
| 1364 | * ) |
||
| 1365 | * @return array |
||
| 1366 | */ |
||
| 1367 | public static function get_updates() { |
||
| 1368 | $update_data = wp_get_update_data(); |
||
| 1369 | |||
| 1370 | // Stores the individual update counts as well as the total count. |
||
| 1371 | if ( isset( $update_data['counts'] ) ) { |
||
| 1372 | $updates = $update_data['counts']; |
||
| 1373 | } |
||
| 1374 | |||
| 1375 | // If we need to update WordPress core, let's find the latest version number. |
||
| 1376 | View Code Duplication | if ( ! empty( $updates['wordpress'] ) ) { |
|
| 1377 | $cur = get_preferred_from_update_core(); |
||
| 1378 | if ( isset( $cur->response ) && 'upgrade' === $cur->response ) { |
||
| 1379 | $updates['wp_update_version'] = $cur->current; |
||
| 1380 | } |
||
| 1381 | } |
||
| 1382 | return isset( $updates ) ? $updates : array(); |
||
| 1383 | } |
||
| 1384 | |||
| 1385 | public static function get_update_details() { |
||
| 1386 | $update_details = array( |
||
| 1387 | 'update_core' => get_site_transient( 'update_core' ), |
||
| 1388 | 'update_plugins' => get_site_transient( 'update_plugins' ), |
||
| 1389 | 'update_themes' => get_site_transient( 'update_themes' ), |
||
| 1390 | ); |
||
| 1391 | return $update_details; |
||
| 1392 | } |
||
| 1393 | |||
| 1394 | public static function refresh_update_data() { |
||
| 1395 | _deprecated_function( __METHOD__, 'jetpack-4.2' ); |
||
| 1396 | |||
| 1397 | } |
||
| 1398 | |||
| 1399 | public static function refresh_theme_data() { |
||
| 1400 | _deprecated_function( __METHOD__, 'jetpack-4.2' ); |
||
| 1401 | } |
||
| 1402 | |||
| 1403 | /** |
||
| 1404 | * Is Jetpack active? |
||
| 1405 | */ |
||
| 1406 | public static function is_active() { |
||
| 1407 | return (bool) Jetpack_Data::get_access_token( JETPACK_MASTER_USER ); |
||
| 1408 | } |
||
| 1409 | |||
| 1410 | /** |
||
| 1411 | * Make an API call to WordPress.com for plan status |
||
| 1412 | * |
||
| 1413 | * @uses Jetpack_Options::get_option() |
||
| 1414 | * @uses Jetpack_Client::wpcom_json_api_request_as_blog() |
||
| 1415 | * @uses update_option() |
||
| 1416 | * |
||
| 1417 | * @access public |
||
| 1418 | * @static |
||
| 1419 | * |
||
| 1420 | * @return bool True if plan is updated, false if no update |
||
| 1421 | */ |
||
| 1422 | public static function refresh_active_plan_from_wpcom() { |
||
| 1423 | // Make the API request |
||
| 1424 | $request = sprintf( '/sites/%d', Jetpack_Options::get_option( 'id' ) ); |
||
| 1425 | $response = Jetpack_Client::wpcom_json_api_request_as_blog( $request, '1.1' ); |
||
| 1426 | |||
| 1427 | // Bail if there was an error or malformed response |
||
| 1428 | if ( is_wp_error( $response ) || ! is_array( $response ) || ! isset( $response['body'] ) ) { |
||
| 1429 | return false; |
||
| 1430 | } |
||
| 1431 | |||
| 1432 | // Decode the results |
||
| 1433 | $results = json_decode( $response['body'], true ); |
||
| 1434 | |||
| 1435 | // Bail if there were no results or plan details returned |
||
| 1436 | if ( ! is_array( $results ) || ! isset( $results['plan'] ) ) { |
||
| 1437 | return false; |
||
| 1438 | } |
||
| 1439 | |||
| 1440 | // Store the option and return true if updated |
||
| 1441 | return update_option( 'jetpack_active_plan', $results['plan'] ); |
||
| 1442 | } |
||
| 1443 | |||
| 1444 | /** |
||
| 1445 | * Get the plan that this Jetpack site is currently using |
||
| 1446 | * |
||
| 1447 | * @uses get_option() |
||
| 1448 | * |
||
| 1449 | * @access public |
||
| 1450 | * @static |
||
| 1451 | * |
||
| 1452 | * @return array Active Jetpack plan details |
||
| 1453 | */ |
||
| 1454 | public static function get_active_plan() { |
||
| 1455 | global $active_plan_cache; |
||
| 1456 | |||
| 1457 | // this can be expensive to compute so we cache for the duration of a request |
||
| 1458 | if ( $active_plan_cache ) { |
||
| 1459 | return $active_plan_cache; |
||
| 1460 | } |
||
| 1461 | |||
| 1462 | $plan = get_option( 'jetpack_active_plan', array() ); |
||
| 1463 | |||
| 1464 | // Set the default options |
||
| 1465 | if ( empty( $plan ) || ( isset( $plan['product_slug'] ) && 'jetpack_free' === $plan['product_slug'] ) ) { |
||
| 1466 | $plan = wp_parse_args( $plan, array( |
||
| 1467 | 'product_slug' => 'jetpack_free', |
||
| 1468 | 'supports' => array(), |
||
| 1469 | 'class' => 'free', |
||
| 1470 | ) ); |
||
| 1471 | } |
||
| 1472 | |||
| 1473 | $supports = array(); |
||
| 1474 | |||
| 1475 | // Define what paid modules are supported by personal plans |
||
| 1476 | $personal_plans = array( |
||
| 1477 | 'jetpack_personal', |
||
| 1478 | 'jetpack_personal_monthly', |
||
| 1479 | 'personal-bundle', |
||
| 1480 | ); |
||
| 1481 | |||
| 1482 | if ( in_array( $plan['product_slug'], $personal_plans ) ) { |
||
| 1483 | // special support value, not a module but a separate plugin |
||
| 1484 | $supports[] = 'akismet'; |
||
| 1485 | $plan['class'] = 'personal'; |
||
| 1486 | } |
||
| 1487 | |||
| 1488 | // Define what paid modules are supported by premium plans |
||
| 1489 | $premium_plans = array( |
||
| 1490 | 'jetpack_premium', |
||
| 1491 | 'jetpack_premium_monthly', |
||
| 1492 | 'value_bundle', |
||
| 1493 | ); |
||
| 1494 | |||
| 1495 | View Code Duplication | if ( in_array( $plan['product_slug'], $premium_plans ) ) { |
|
| 1496 | $supports[] = 'akismet'; |
||
| 1497 | $supports[] = 'vaultpress'; |
||
| 1498 | $plan['class'] = 'premium'; |
||
| 1499 | } |
||
| 1500 | |||
| 1501 | // Define what paid modules are supported by professional plans |
||
| 1502 | $business_plans = array( |
||
| 1503 | 'jetpack_business', |
||
| 1504 | 'jetpack_business_monthly', |
||
| 1505 | 'business-bundle', |
||
| 1506 | 'vip', |
||
| 1507 | ); |
||
| 1508 | |||
| 1509 | View Code Duplication | if ( in_array( $plan['product_slug'], $business_plans ) ) { |
|
| 1510 | $supports[] = 'akismet'; |
||
| 1511 | $supports[] = 'vaultpress'; |
||
| 1512 | $plan['class'] = 'business'; |
||
| 1513 | } |
||
| 1514 | |||
| 1515 | // get available features |
||
| 1516 | foreach ( self::get_available_modules() as $module_slug ) { |
||
| 1517 | $module = self::get_module( $module_slug ); |
||
| 1518 | if ( in_array( 'free', $module['plan_classes'] ) || in_array( $plan['class'], $module['plan_classes'] ) ) { |
||
| 1519 | $supports[] = $module_slug; |
||
| 1520 | } |
||
| 1521 | } |
||
| 1522 | |||
| 1523 | $plan['supports'] = $supports; |
||
| 1524 | |||
| 1525 | $active_plan_cache = $plan; |
||
| 1526 | |||
| 1527 | return $plan; |
||
| 1528 | } |
||
| 1529 | |||
| 1530 | /** |
||
| 1531 | * Determine whether the active plan supports a particular feature |
||
| 1532 | * |
||
| 1533 | * @uses Jetpack::get_active_plan() |
||
| 1534 | * |
||
| 1535 | * @access public |
||
| 1536 | * @static |
||
| 1537 | * |
||
| 1538 | * @return bool True if plan supports feature, false if not |
||
| 1539 | */ |
||
| 1540 | public static function active_plan_supports( $feature ) { |
||
| 1541 | $plan = Jetpack::get_active_plan(); |
||
| 1542 | |||
| 1543 | if ( in_array( $feature, $plan['supports'] ) ) { |
||
| 1544 | return true; |
||
| 1545 | } |
||
| 1546 | |||
| 1547 | return false; |
||
| 1548 | } |
||
| 1549 | |||
| 1550 | /** |
||
| 1551 | * Is Jetpack in development (offline) mode? |
||
| 1552 | */ |
||
| 1553 | public static function is_development_mode() { |
||
| 1554 | $development_mode = false; |
||
| 1555 | |||
| 1556 | if ( defined( 'JETPACK_DEV_DEBUG' ) ) { |
||
| 1557 | $development_mode = JETPACK_DEV_DEBUG; |
||
| 1558 | } elseif ( $site_url = site_url() ) { |
||
| 1559 | $development_mode = false === strpos( $site_url, '.' ); |
||
| 1560 | } |
||
| 1561 | |||
| 1562 | /** |
||
| 1563 | * Filters Jetpack's development mode. |
||
| 1564 | * |
||
| 1565 | * @see https://jetpack.com/support/development-mode/ |
||
| 1566 | * |
||
| 1567 | * @since 2.2.1 |
||
| 1568 | * |
||
| 1569 | * @param bool $development_mode Is Jetpack's development mode active. |
||
| 1570 | */ |
||
| 1571 | return apply_filters( 'jetpack_development_mode', $development_mode ); |
||
| 1572 | } |
||
| 1573 | |||
| 1574 | /** |
||
| 1575 | * Whether the site is currently onboarding or not. |
||
| 1576 | * A site is considered as being onboarded if it currently has an onboarding token. |
||
| 1577 | * |
||
| 1578 | * @since 5.8 |
||
| 1579 | * |
||
| 1580 | * @access public |
||
| 1581 | * @static |
||
| 1582 | * |
||
| 1583 | * @return bool True if the site is currently onboarding, false otherwise |
||
| 1584 | */ |
||
| 1585 | public static function is_onboarding() { |
||
| 1586 | return Jetpack_Options::get_option( 'onboarding' ) !== false; |
||
| 1587 | } |
||
| 1588 | |||
| 1589 | /** |
||
| 1590 | * Get Jetpack development mode notice text and notice class. |
||
| 1591 | * |
||
| 1592 | * Mirrors the checks made in Jetpack::is_development_mode |
||
| 1593 | * |
||
| 1594 | */ |
||
| 1595 | public static function show_development_mode_notice() { |
||
| 1596 | if ( Jetpack::is_development_mode() ) { |
||
| 1597 | if ( defined( 'JETPACK_DEV_DEBUG' ) && JETPACK_DEV_DEBUG ) { |
||
| 1598 | $notice = sprintf( |
||
| 1599 | /* translators: %s is a URL */ |
||
| 1600 | __( 'In <a href="%s" target="_blank">Development Mode</a>, via the JETPACK_DEV_DEBUG constant being defined in wp-config.php or elsewhere.', 'jetpack' ), |
||
| 1601 | 'https://jetpack.com/support/development-mode/' |
||
| 1602 | ); |
||
| 1603 | } elseif ( site_url() && false === strpos( site_url(), '.' ) ) { |
||
| 1604 | $notice = sprintf( |
||
| 1605 | /* translators: %s is a URL */ |
||
| 1606 | __( 'In <a href="%s" target="_blank">Development Mode</a>, via site URL lacking a dot (e.g. http://localhost).', 'jetpack' ), |
||
| 1607 | 'https://jetpack.com/support/development-mode/' |
||
| 1608 | ); |
||
| 1609 | } else { |
||
| 1610 | $notice = sprintf( |
||
| 1611 | /* translators: %s is a URL */ |
||
| 1612 | __( 'In <a href="%s" target="_blank">Development Mode</a>, via the jetpack_development_mode filter.', 'jetpack' ), |
||
| 1613 | 'https://jetpack.com/support/development-mode/' |
||
| 1614 | ); |
||
| 1615 | } |
||
| 1616 | |||
| 1617 | echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; |
||
| 1618 | } |
||
| 1619 | |||
| 1620 | // Throw up a notice if using a development version and as for feedback. |
||
| 1621 | if ( Jetpack::is_development_version() ) { |
||
| 1622 | /* translators: %s is a URL */ |
||
| 1623 | $notice = sprintf( __( 'You are currently running a development version of Jetpack. <a href="%s" target="_blank">Submit your feedback</a>', 'jetpack' ), 'https://jetpack.com/contact-support/beta-group/' ); |
||
| 1624 | |||
| 1625 | echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; |
||
| 1626 | } |
||
| 1627 | // Throw up a notice if using staging mode |
||
| 1628 | if ( Jetpack::is_staging_site() ) { |
||
| 1629 | /* translators: %s is a URL */ |
||
| 1630 | $notice = sprintf( __( 'You are running Jetpack on a <a href="%s" target="_blank">staging server</a>.', 'jetpack' ), 'https://jetpack.com/support/staging-sites/' ); |
||
| 1631 | |||
| 1632 | echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; |
||
| 1633 | } |
||
| 1634 | } |
||
| 1635 | |||
| 1636 | /** |
||
| 1637 | * Whether Jetpack's version maps to a public release, or a development version. |
||
| 1638 | */ |
||
| 1639 | public static function is_development_version() { |
||
| 1640 | /** |
||
| 1641 | * Allows filtering whether this is a development version of Jetpack. |
||
| 1642 | * |
||
| 1643 | * This filter is especially useful for tests. |
||
| 1644 | * |
||
| 1645 | * @since 4.3.0 |
||
| 1646 | * |
||
| 1647 | * @param bool $development_version Is this a develoment version of Jetpack? |
||
| 1648 | */ |
||
| 1649 | return (bool) apply_filters( |
||
| 1650 | 'jetpack_development_version', |
||
| 1651 | ! preg_match( '/^\d+(\.\d+)+$/', Jetpack_Constants::get_constant( 'JETPACK__VERSION' ) ) |
||
| 1652 | ); |
||
| 1653 | } |
||
| 1654 | |||
| 1655 | /** |
||
| 1656 | * Is a given user (or the current user if none is specified) linked to a WordPress.com user? |
||
| 1657 | */ |
||
| 1658 | public static function is_user_connected( $user_id = false ) { |
||
| 1659 | $user_id = false === $user_id ? get_current_user_id() : absint( $user_id ); |
||
| 1660 | if ( ! $user_id ) { |
||
| 1661 | return false; |
||
| 1662 | } |
||
| 1663 | |||
| 1664 | return (bool) Jetpack_Data::get_access_token( $user_id ); |
||
| 1665 | } |
||
| 1666 | |||
| 1667 | /** |
||
| 1668 | * Get the wpcom user data of the current|specified connected user. |
||
| 1669 | */ |
||
| 1670 | public static function get_connected_user_data( $user_id = null ) { |
||
| 1671 | if ( ! $user_id ) { |
||
| 1672 | $user_id = get_current_user_id(); |
||
| 1673 | } |
||
| 1674 | |||
| 1675 | $transient_key = "jetpack_connected_user_data_$user_id"; |
||
| 1676 | |||
| 1677 | if ( $cached_user_data = get_transient( $transient_key ) ) { |
||
| 1678 | return $cached_user_data; |
||
| 1679 | } |
||
| 1680 | |||
| 1681 | Jetpack::load_xml_rpc_client(); |
||
| 1682 | $xml = new Jetpack_IXR_Client( array( |
||
| 1683 | 'user_id' => $user_id, |
||
| 1684 | ) ); |
||
| 1685 | $xml->query( 'wpcom.getUser' ); |
||
| 1686 | if ( ! $xml->isError() ) { |
||
| 1687 | $user_data = $xml->getResponse(); |
||
| 1688 | set_transient( $transient_key, $xml->getResponse(), DAY_IN_SECONDS ); |
||
| 1689 | return $user_data; |
||
| 1690 | } |
||
| 1691 | |||
| 1692 | return false; |
||
| 1693 | } |
||
| 1694 | |||
| 1695 | /** |
||
| 1696 | * Get the wpcom email of the current|specified connected user. |
||
| 1697 | */ |
||
| 1698 | View Code Duplication | public static function get_connected_user_email( $user_id = null ) { |
|
| 1699 | if ( ! $user_id ) { |
||
| 1700 | $user_id = get_current_user_id(); |
||
| 1701 | } |
||
| 1702 | Jetpack::load_xml_rpc_client(); |
||
| 1703 | $xml = new Jetpack_IXR_Client( array( |
||
| 1704 | 'user_id' => $user_id, |
||
| 1705 | ) ); |
||
| 1706 | $xml->query( 'wpcom.getUserEmail' ); |
||
| 1707 | if ( ! $xml->isError() ) { |
||
| 1708 | return $xml->getResponse(); |
||
| 1709 | } |
||
| 1710 | return false; |
||
| 1711 | } |
||
| 1712 | |||
| 1713 | /** |
||
| 1714 | * Get the wpcom email of the master user. |
||
| 1715 | */ |
||
| 1716 | public static function get_master_user_email() { |
||
| 1717 | $master_user_id = Jetpack_Options::get_option( 'master_user' ); |
||
| 1718 | if ( $master_user_id ) { |
||
| 1719 | return self::get_connected_user_email( $master_user_id ); |
||
| 1720 | } |
||
| 1721 | return ''; |
||
| 1722 | } |
||
| 1723 | |||
| 1724 | function current_user_is_connection_owner() { |
||
| 1725 | $user_token = Jetpack_Data::get_access_token( JETPACK_MASTER_USER ); |
||
| 1726 | return $user_token && is_object( $user_token ) && isset( $user_token->external_user_id ) && get_current_user_id() === $user_token->external_user_id; |
||
| 1727 | } |
||
| 1728 | |||
| 1729 | /** |
||
| 1730 | * Gets current user IP address. |
||
| 1731 | * |
||
| 1732 | * @param bool $check_all_headers Check all headers? Default is `false`. |
||
| 1733 | * |
||
| 1734 | * @return string Current user IP address. |
||
| 1735 | */ |
||
| 1736 | public static function current_user_ip( $check_all_headers = false ) { |
||
| 1737 | if ( $check_all_headers ) { |
||
| 1738 | foreach ( array( |
||
| 1739 | 'HTTP_CF_CONNECTING_IP', |
||
| 1740 | 'HTTP_CLIENT_IP', |
||
| 1741 | 'HTTP_X_FORWARDED_FOR', |
||
| 1742 | 'HTTP_X_FORWARDED', |
||
| 1743 | 'HTTP_X_CLUSTER_CLIENT_IP', |
||
| 1744 | 'HTTP_FORWARDED_FOR', |
||
| 1745 | 'HTTP_FORWARDED', |
||
| 1746 | 'HTTP_VIA', |
||
| 1747 | ) as $key ) { |
||
| 1748 | if ( ! empty( $_SERVER[ $key ] ) ) { |
||
| 1749 | return $_SERVER[ $key ]; |
||
| 1750 | } |
||
| 1751 | } |
||
| 1752 | } |
||
| 1753 | |||
| 1754 | return ! empty( $_SERVER['REMOTE_ADDR'] ) ? $_SERVER['REMOTE_ADDR'] : ''; |
||
| 1755 | } |
||
| 1756 | |||
| 1757 | /** |
||
| 1758 | * Add any extra oEmbed providers that we know about and use on wpcom for feature parity. |
||
| 1759 | */ |
||
| 1760 | function extra_oembed_providers() { |
||
| 1761 | // Cloudup: https://dev.cloudup.com/#oembed |
||
| 1762 | wp_oembed_add_provider( 'https://cloudup.com/*' , 'https://cloudup.com/oembed' ); |
||
| 1763 | wp_oembed_add_provider( 'https://me.sh/*', 'https://me.sh/oembed?format=json' ); |
||
| 1764 | wp_oembed_add_provider( '#https?://(www\.)?gfycat\.com/.*#i', 'https://api.gfycat.com/v1/oembed', true ); |
||
| 1765 | wp_oembed_add_provider( '#https?://[^.]+\.(wistia\.com|wi\.st)/(medias|embed)/.*#', 'https://fast.wistia.com/oembed', true ); |
||
| 1766 | wp_oembed_add_provider( '#https?://sketchfab\.com/.*#i', 'https://sketchfab.com/oembed', true ); |
||
| 1767 | wp_oembed_add_provider( '#https?://(www\.)?icloud\.com/keynote/.*#i', 'https://iwmb.icloud.com/iwmb/oembed', true ); |
||
| 1768 | } |
||
| 1769 | |||
| 1770 | /** |
||
| 1771 | * Synchronize connected user role changes |
||
| 1772 | */ |
||
| 1773 | function user_role_change( $user_id ) { |
||
| 1774 | _deprecated_function( __METHOD__, 'jetpack-4.2', 'Jetpack_Sync_Users::user_role_change()' ); |
||
| 1775 | Jetpack_Sync_Users::user_role_change( $user_id ); |
||
| 1776 | } |
||
| 1777 | |||
| 1778 | /** |
||
| 1779 | * Loads the currently active modules. |
||
| 1780 | */ |
||
| 1781 | public static function load_modules() { |
||
| 1782 | if ( |
||
| 1783 | ! self::is_active() |
||
| 1784 | && ! self::is_development_mode() |
||
| 1785 | && ! self::is_onboarding() |
||
| 1786 | && ( |
||
| 1787 | ! is_multisite() |
||
| 1788 | || ! get_site_option( 'jetpack_protect_active' ) |
||
| 1789 | ) |
||
| 1790 | ) { |
||
| 1791 | return; |
||
| 1792 | } |
||
| 1793 | |||
| 1794 | $version = Jetpack_Options::get_option( 'version' ); |
||
| 1795 | View Code Duplication | if ( ! $version ) { |
|
| 1796 | $version = $old_version = JETPACK__VERSION . ':' . time(); |
||
| 1797 | /** This action is documented in class.jetpack.php */ |
||
| 1798 | do_action( 'updating_jetpack_version', $version, false ); |
||
| 1799 | Jetpack_Options::update_options( compact( 'version', 'old_version' ) ); |
||
| 1800 | } |
||
| 1801 | list( $version ) = explode( ':', $version ); |
||
| 1802 | |||
| 1803 | $modules = array_filter( Jetpack::get_active_modules(), array( 'Jetpack', 'is_module' ) ); |
||
| 1804 | |||
| 1805 | $modules_data = array(); |
||
| 1806 | |||
| 1807 | // Don't load modules that have had "Major" changes since the stored version until they have been deactivated/reactivated through the lint check. |
||
| 1808 | if ( version_compare( $version, JETPACK__VERSION, '<' ) ) { |
||
| 1809 | $updated_modules = array(); |
||
| 1810 | foreach ( $modules as $module ) { |
||
| 1811 | $modules_data[ $module ] = Jetpack::get_module( $module ); |
||
| 1812 | if ( ! isset( $modules_data[ $module ]['changed'] ) ) { |
||
| 1813 | continue; |
||
| 1814 | } |
||
| 1815 | |||
| 1816 | if ( version_compare( $modules_data[ $module ]['changed'], $version, '<=' ) ) { |
||
| 1817 | continue; |
||
| 1818 | } |
||
| 1819 | |||
| 1820 | $updated_modules[] = $module; |
||
| 1821 | } |
||
| 1822 | |||
| 1823 | $modules = array_diff( $modules, $updated_modules ); |
||
| 1824 | } |
||
| 1825 | |||
| 1826 | $is_development_mode = Jetpack::is_development_mode(); |
||
| 1827 | |||
| 1828 | foreach ( $modules as $index => $module ) { |
||
| 1829 | // If we're in dev mode, disable modules requiring a connection |
||
| 1830 | if ( $is_development_mode ) { |
||
| 1831 | // Prime the pump if we need to |
||
| 1832 | if ( empty( $modules_data[ $module ] ) ) { |
||
| 1833 | $modules_data[ $module ] = Jetpack::get_module( $module ); |
||
| 1834 | } |
||
| 1835 | // If the module requires a connection, but we're in local mode, don't include it. |
||
| 1836 | if ( $modules_data[ $module ]['requires_connection'] ) { |
||
| 1837 | continue; |
||
| 1838 | } |
||
| 1839 | } |
||
| 1840 | |||
| 1841 | if ( did_action( 'jetpack_module_loaded_' . $module ) ) { |
||
| 1842 | continue; |
||
| 1843 | } |
||
| 1844 | |||
| 1845 | if ( ! include_once( Jetpack::get_module_path( $module ) ) ) { |
||
| 1846 | unset( $modules[ $index ] ); |
||
| 1847 | self::update_active_modules( array_values( $modules ) ); |
||
| 1848 | continue; |
||
| 1849 | } |
||
| 1850 | |||
| 1851 | /** |
||
| 1852 | * Fires when a specific module is loaded. |
||
| 1853 | * The dynamic part of the hook, $module, is the module slug. |
||
| 1854 | * |
||
| 1855 | * @since 1.1.0 |
||
| 1856 | */ |
||
| 1857 | do_action( 'jetpack_module_loaded_' . $module ); |
||
| 1858 | } |
||
| 1859 | |||
| 1860 | /** |
||
| 1861 | * Fires when all the modules are loaded. |
||
| 1862 | * |
||
| 1863 | * @since 1.1.0 |
||
| 1864 | */ |
||
| 1865 | do_action( 'jetpack_modules_loaded' ); |
||
| 1866 | |||
| 1867 | // Load module-specific code that is needed even when a module isn't active. Loaded here because code contained therein may need actions such as setup_theme. |
||
| 1868 | require_once( JETPACK__PLUGIN_DIR . 'modules/module-extras.php' ); |
||
| 1869 | } |
||
| 1870 | |||
| 1871 | /** |
||
| 1872 | * Check if Jetpack's REST API compat file should be included |
||
| 1873 | * @action plugins_loaded |
||
| 1874 | * @return null |
||
| 1875 | */ |
||
| 1876 | public function check_rest_api_compat() { |
||
| 1877 | /** |
||
| 1878 | * Filters the list of REST API compat files to be included. |
||
| 1879 | * |
||
| 1880 | * @since 2.2.5 |
||
| 1881 | * |
||
| 1882 | * @param array $args Array of REST API compat files to include. |
||
| 1883 | */ |
||
| 1884 | $_jetpack_rest_api_compat_includes = apply_filters( 'jetpack_rest_api_compat', array() ); |
||
| 1885 | |||
| 1886 | if ( function_exists( 'bbpress' ) ) |
||
| 1887 | $_jetpack_rest_api_compat_includes[] = JETPACK__PLUGIN_DIR . 'class.jetpack-bbpress-json-api-compat.php'; |
||
| 1888 | |||
| 1889 | foreach ( $_jetpack_rest_api_compat_includes as $_jetpack_rest_api_compat_include ) |
||
| 1890 | require_once $_jetpack_rest_api_compat_include; |
||
| 1891 | } |
||
| 1892 | |||
| 1893 | /** |
||
| 1894 | * Gets all plugins currently active in values, regardless of whether they're |
||
| 1895 | * traditionally activated or network activated. |
||
| 1896 | * |
||
| 1897 | * @todo Store the result in core's object cache maybe? |
||
| 1898 | */ |
||
| 1899 | public static function get_active_plugins() { |
||
| 1900 | $active_plugins = (array) get_option( 'active_plugins', array() ); |
||
| 1901 | |||
| 1902 | if ( is_multisite() ) { |
||
| 1903 | // Due to legacy code, active_sitewide_plugins stores them in the keys, |
||
| 1904 | // whereas active_plugins stores them in the values. |
||
| 1905 | $network_plugins = array_keys( get_site_option( 'active_sitewide_plugins', array() ) ); |
||
| 1906 | if ( $network_plugins ) { |
||
| 1907 | $active_plugins = array_merge( $active_plugins, $network_plugins ); |
||
| 1908 | } |
||
| 1909 | } |
||
| 1910 | |||
| 1911 | sort( $active_plugins ); |
||
| 1912 | |||
| 1913 | return array_unique( $active_plugins ); |
||
| 1914 | } |
||
| 1915 | |||
| 1916 | /** |
||
| 1917 | * Gets and parses additional plugin data to send with the heartbeat data |
||
| 1918 | * |
||
| 1919 | * @since 3.8.1 |
||
| 1920 | * |
||
| 1921 | * @return array Array of plugin data |
||
| 1922 | */ |
||
| 1923 | public static function get_parsed_plugin_data() { |
||
| 1924 | if ( ! function_exists( 'get_plugins' ) ) { |
||
| 1925 | require_once( ABSPATH . 'wp-admin/includes/plugin.php' ); |
||
| 1926 | } |
||
| 1927 | /** This filter is documented in wp-admin/includes/class-wp-plugins-list-table.php */ |
||
| 1928 | $all_plugins = apply_filters( 'all_plugins', get_plugins() ); |
||
| 1929 | $active_plugins = Jetpack::get_active_plugins(); |
||
| 1930 | |||
| 1931 | $plugins = array(); |
||
| 1932 | foreach ( $all_plugins as $path => $plugin_data ) { |
||
| 1933 | $plugins[ $path ] = array( |
||
| 1934 | 'is_active' => in_array( $path, $active_plugins ), |
||
| 1935 | 'file' => $path, |
||
| 1936 | 'name' => $plugin_data['Name'], |
||
| 1937 | 'version' => $plugin_data['Version'], |
||
| 1938 | 'author' => $plugin_data['Author'], |
||
| 1939 | ); |
||
| 1940 | } |
||
| 1941 | |||
| 1942 | return $plugins; |
||
| 1943 | } |
||
| 1944 | |||
| 1945 | /** |
||
| 1946 | * Gets and parses theme data to send with the heartbeat data |
||
| 1947 | * |
||
| 1948 | * @since 3.8.1 |
||
| 1949 | * |
||
| 1950 | * @return array Array of theme data |
||
| 1951 | */ |
||
| 1952 | public static function get_parsed_theme_data() { |
||
| 1953 | $all_themes = wp_get_themes( array( 'allowed' => true ) ); |
||
| 1954 | $header_keys = array( 'Name', 'Author', 'Version', 'ThemeURI', 'AuthorURI', 'Status', 'Tags' ); |
||
| 1955 | |||
| 1956 | $themes = array(); |
||
| 1957 | foreach ( $all_themes as $slug => $theme_data ) { |
||
| 1958 | $theme_headers = array(); |
||
| 1959 | foreach ( $header_keys as $header_key ) { |
||
| 1960 | $theme_headers[ $header_key ] = $theme_data->get( $header_key ); |
||
| 1961 | } |
||
| 1962 | |||
| 1963 | $themes[ $slug ] = array( |
||
| 1964 | 'is_active_theme' => $slug == wp_get_theme()->get_template(), |
||
| 1965 | 'slug' => $slug, |
||
| 1966 | 'theme_root' => $theme_data->get_theme_root_uri(), |
||
| 1967 | 'parent' => $theme_data->parent(), |
||
| 1968 | 'headers' => $theme_headers |
||
| 1969 | ); |
||
| 1970 | } |
||
| 1971 | |||
| 1972 | return $themes; |
||
| 1973 | } |
||
| 1974 | |||
| 1975 | /** |
||
| 1976 | * Checks whether a specific plugin is active. |
||
| 1977 | * |
||
| 1978 | * We don't want to store these in a static variable, in case |
||
| 1979 | * there are switch_to_blog() calls involved. |
||
| 1980 | */ |
||
| 1981 | public static function is_plugin_active( $plugin = 'jetpack/jetpack.php' ) { |
||
| 1982 | return in_array( $plugin, self::get_active_plugins() ); |
||
| 1983 | } |
||
| 1984 | |||
| 1985 | /** |
||
| 1986 | * Check if Jetpack's Open Graph tags should be used. |
||
| 1987 | * If certain plugins are active, Jetpack's og tags are suppressed. |
||
| 1988 | * |
||
| 1989 | * @uses Jetpack::get_active_modules, add_filter, get_option, apply_filters |
||
| 1990 | * @action plugins_loaded |
||
| 1991 | * @return null |
||
| 1992 | */ |
||
| 1993 | public function check_open_graph() { |
||
| 1994 | if ( in_array( 'publicize', Jetpack::get_active_modules() ) || in_array( 'sharedaddy', Jetpack::get_active_modules() ) ) { |
||
| 1995 | add_filter( 'jetpack_enable_open_graph', '__return_true', 0 ); |
||
| 1996 | } |
||
| 1997 | |||
| 1998 | $active_plugins = self::get_active_plugins(); |
||
| 1999 | |||
| 2000 | if ( ! empty( $active_plugins ) ) { |
||
| 2001 | foreach ( $this->open_graph_conflicting_plugins as $plugin ) { |
||
| 2002 | if ( in_array( $plugin, $active_plugins ) ) { |
||
| 2003 | add_filter( 'jetpack_enable_open_graph', '__return_false', 99 ); |
||
| 2004 | break; |
||
| 2005 | } |
||
| 2006 | } |
||
| 2007 | } |
||
| 2008 | |||
| 2009 | /** |
||
| 2010 | * Allow the addition of Open Graph Meta Tags to all pages. |
||
| 2011 | * |
||
| 2012 | * @since 2.0.3 |
||
| 2013 | * |
||
| 2014 | * @param bool false Should Open Graph Meta tags be added. Default to false. |
||
| 2015 | */ |
||
| 2016 | if ( apply_filters( 'jetpack_enable_open_graph', false ) ) { |
||
| 2017 | require_once JETPACK__PLUGIN_DIR . 'functions.opengraph.php'; |
||
| 2018 | } |
||
| 2019 | } |
||
| 2020 | |||
| 2021 | /** |
||
| 2022 | * Check if Jetpack's Twitter tags should be used. |
||
| 2023 | * If certain plugins are active, Jetpack's twitter tags are suppressed. |
||
| 2024 | * |
||
| 2025 | * @uses Jetpack::get_active_modules, add_filter, get_option, apply_filters |
||
| 2026 | * @action plugins_loaded |
||
| 2027 | * @return null |
||
| 2028 | */ |
||
| 2029 | public function check_twitter_tags() { |
||
| 2030 | |||
| 2031 | $active_plugins = self::get_active_plugins(); |
||
| 2032 | |||
| 2033 | if ( ! empty( $active_plugins ) ) { |
||
| 2034 | foreach ( $this->twitter_cards_conflicting_plugins as $plugin ) { |
||
| 2035 | if ( in_array( $plugin, $active_plugins ) ) { |
||
| 2036 | add_filter( 'jetpack_disable_twitter_cards', '__return_true', 99 ); |
||
| 2037 | break; |
||
| 2038 | } |
||
| 2039 | } |
||
| 2040 | } |
||
| 2041 | |||
| 2042 | /** |
||
| 2043 | * Allow Twitter Card Meta tags to be disabled. |
||
| 2044 | * |
||
| 2045 | * @since 2.6.0 |
||
| 2046 | * |
||
| 2047 | * @param bool true Should Twitter Card Meta tags be disabled. Default to true. |
||
| 2048 | */ |
||
| 2049 | if ( ! apply_filters( 'jetpack_disable_twitter_cards', false ) ) { |
||
| 2050 | require_once JETPACK__PLUGIN_DIR . 'class.jetpack-twitter-cards.php'; |
||
| 2051 | } |
||
| 2052 | } |
||
| 2053 | |||
| 2054 | /** |
||
| 2055 | * Allows plugins to submit security reports. |
||
| 2056 | * |
||
| 2057 | * @param string $type Report type (login_form, backup, file_scanning, spam) |
||
| 2058 | * @param string $plugin_file Plugin __FILE__, so that we can pull plugin data |
||
| 2059 | * @param array $args See definitions above |
||
| 2060 | */ |
||
| 2061 | public static function submit_security_report( $type = '', $plugin_file = '', $args = array() ) { |
||
| 2062 | _deprecated_function( __FUNCTION__, 'jetpack-4.2', null ); |
||
| 2063 | } |
||
| 2064 | |||
| 2065 | /* Jetpack Options API */ |
||
| 2066 | |||
| 2067 | public static function get_option_names( $type = 'compact' ) { |
||
| 2068 | return Jetpack_Options::get_option_names( $type ); |
||
| 2069 | } |
||
| 2070 | |||
| 2071 | /** |
||
| 2072 | * Returns the requested option. Looks in jetpack_options or jetpack_$name as appropriate. |
||
| 2073 | * |
||
| 2074 | * @param string $name Option name |
||
| 2075 | * @param mixed $default (optional) |
||
| 2076 | */ |
||
| 2077 | public static function get_option( $name, $default = false ) { |
||
| 2078 | return Jetpack_Options::get_option( $name, $default ); |
||
| 2079 | } |
||
| 2080 | |||
| 2081 | /** |
||
| 2082 | * Updates the single given option. Updates jetpack_options or jetpack_$name as appropriate. |
||
| 2083 | * |
||
| 2084 | * @deprecated 3.4 use Jetpack_Options::update_option() instead. |
||
| 2085 | * @param string $name Option name |
||
| 2086 | * @param mixed $value Option value |
||
| 2087 | */ |
||
| 2088 | public static function update_option( $name, $value ) { |
||
| 2089 | _deprecated_function( __METHOD__, 'jetpack-3.4', 'Jetpack_Options::update_option()' ); |
||
| 2090 | return Jetpack_Options::update_option( $name, $value ); |
||
| 2091 | } |
||
| 2092 | |||
| 2093 | /** |
||
| 2094 | * Updates the multiple given options. Updates jetpack_options and/or jetpack_$name as appropriate. |
||
| 2095 | * |
||
| 2096 | * @deprecated 3.4 use Jetpack_Options::update_options() instead. |
||
| 2097 | * @param array $array array( option name => option value, ... ) |
||
| 2098 | */ |
||
| 2099 | public static function update_options( $array ) { |
||
| 2100 | _deprecated_function( __METHOD__, 'jetpack-3.4', 'Jetpack_Options::update_options()' ); |
||
| 2101 | return Jetpack_Options::update_options( $array ); |
||
| 2102 | } |
||
| 2103 | |||
| 2104 | /** |
||
| 2105 | * Deletes the given option. May be passed multiple option names as an array. |
||
| 2106 | * Updates jetpack_options and/or deletes jetpack_$name as appropriate. |
||
| 2107 | * |
||
| 2108 | * @deprecated 3.4 use Jetpack_Options::delete_option() instead. |
||
| 2109 | * @param string|array $names |
||
| 2110 | */ |
||
| 2111 | public static function delete_option( $names ) { |
||
| 2112 | _deprecated_function( __METHOD__, 'jetpack-3.4', 'Jetpack_Options::delete_option()' ); |
||
| 2113 | return Jetpack_Options::delete_option( $names ); |
||
| 2114 | } |
||
| 2115 | |||
| 2116 | /** |
||
| 2117 | * Enters a user token into the user_tokens option |
||
| 2118 | * |
||
| 2119 | * @param int $user_id |
||
| 2120 | * @param string $token |
||
| 2121 | * return bool |
||
| 2122 | */ |
||
| 2123 | public static function update_user_token( $user_id, $token, $is_master_user ) { |
||
| 2124 | // not designed for concurrent updates |
||
| 2125 | $user_tokens = Jetpack_Options::get_option( 'user_tokens' ); |
||
| 2126 | if ( ! is_array( $user_tokens ) ) |
||
| 2127 | $user_tokens = array(); |
||
| 2128 | $user_tokens[$user_id] = $token; |
||
| 2129 | if ( $is_master_user ) { |
||
| 2130 | $master_user = $user_id; |
||
| 2131 | $options = compact( 'user_tokens', 'master_user' ); |
||
| 2132 | } else { |
||
| 2133 | $options = compact( 'user_tokens' ); |
||
| 2134 | } |
||
| 2135 | return Jetpack_Options::update_options( $options ); |
||
| 2136 | } |
||
| 2137 | |||
| 2138 | /** |
||
| 2139 | * Returns an array of all PHP files in the specified absolute path. |
||
| 2140 | * Equivalent to glob( "$absolute_path/*.php" ). |
||
| 2141 | * |
||
| 2142 | * @param string $absolute_path The absolute path of the directory to search. |
||
| 2143 | * @return array Array of absolute paths to the PHP files. |
||
| 2144 | */ |
||
| 2145 | public static function glob_php( $absolute_path ) { |
||
| 2146 | if ( function_exists( 'glob' ) ) { |
||
| 2147 | return glob( "$absolute_path/*.php" ); |
||
| 2148 | } |
||
| 2149 | |||
| 2150 | $absolute_path = untrailingslashit( $absolute_path ); |
||
| 2151 | $files = array(); |
||
| 2152 | if ( ! $dir = @opendir( $absolute_path ) ) { |
||
| 2153 | return $files; |
||
| 2154 | } |
||
| 2155 | |||
| 2156 | while ( false !== $file = readdir( $dir ) ) { |
||
| 2157 | if ( '.' == substr( $file, 0, 1 ) || '.php' != substr( $file, -4 ) ) { |
||
| 2158 | continue; |
||
| 2159 | } |
||
| 2160 | |||
| 2161 | $file = "$absolute_path/$file"; |
||
| 2162 | |||
| 2163 | if ( ! is_file( $file ) ) { |
||
| 2164 | continue; |
||
| 2165 | } |
||
| 2166 | |||
| 2167 | $files[] = $file; |
||
| 2168 | } |
||
| 2169 | |||
| 2170 | closedir( $dir ); |
||
| 2171 | |||
| 2172 | return $files; |
||
| 2173 | } |
||
| 2174 | |||
| 2175 | public static function activate_new_modules( $redirect = false ) { |
||
| 2176 | if ( ! Jetpack::is_active() && ! Jetpack::is_development_mode() ) { |
||
| 2177 | return; |
||
| 2178 | } |
||
| 2179 | |||
| 2180 | $jetpack_old_version = Jetpack_Options::get_option( 'version' ); // [sic] |
||
| 2181 | View Code Duplication | if ( ! $jetpack_old_version ) { |
|
| 2182 | $jetpack_old_version = $version = $old_version = '1.1:' . time(); |
||
| 2183 | /** This action is documented in class.jetpack.php */ |
||
| 2184 | do_action( 'updating_jetpack_version', $version, false ); |
||
| 2185 | Jetpack_Options::update_options( compact( 'version', 'old_version' ) ); |
||
| 2186 | } |
||
| 2187 | |||
| 2188 | list( $jetpack_version ) = explode( ':', $jetpack_old_version ); // [sic] |
||
| 2189 | |||
| 2190 | if ( version_compare( JETPACK__VERSION, $jetpack_version, '<=' ) ) { |
||
| 2191 | return; |
||
| 2192 | } |
||
| 2193 | |||
| 2194 | $active_modules = Jetpack::get_active_modules(); |
||
| 2195 | $reactivate_modules = array(); |
||
| 2196 | foreach ( $active_modules as $active_module ) { |
||
| 2197 | $module = Jetpack::get_module( $active_module ); |
||
| 2198 | if ( ! isset( $module['changed'] ) ) { |
||
| 2199 | continue; |
||
| 2200 | } |
||
| 2201 | |||
| 2202 | if ( version_compare( $module['changed'], $jetpack_version, '<=' ) ) { |
||
| 2203 | continue; |
||
| 2204 | } |
||
| 2205 | |||
| 2206 | $reactivate_modules[] = $active_module; |
||
| 2207 | Jetpack::deactivate_module( $active_module ); |
||
| 2208 | } |
||
| 2209 | |||
| 2210 | $new_version = JETPACK__VERSION . ':' . time(); |
||
| 2211 | /** This action is documented in class.jetpack.php */ |
||
| 2212 | do_action( 'updating_jetpack_version', $new_version, $jetpack_old_version ); |
||
| 2213 | Jetpack_Options::update_options( |
||
| 2214 | array( |
||
| 2215 | 'version' => $new_version, |
||
| 2216 | 'old_version' => $jetpack_old_version, |
||
| 2217 | ) |
||
| 2218 | ); |
||
| 2219 | |||
| 2220 | Jetpack::state( 'message', 'modules_activated' ); |
||
| 2221 | Jetpack::activate_default_modules( $jetpack_version, JETPACK__VERSION, $reactivate_modules ); |
||
| 2222 | |||
| 2223 | if ( $redirect ) { |
||
| 2224 | $page = 'jetpack'; // make sure we redirect to either settings or the jetpack page |
||
| 2225 | if ( isset( $_GET['page'] ) && in_array( $_GET['page'], array( 'jetpack', 'jetpack_modules' ) ) ) { |
||
| 2226 | $page = $_GET['page']; |
||
| 2227 | } |
||
| 2228 | |||
| 2229 | wp_safe_redirect( Jetpack::admin_url( 'page=' . $page ) ); |
||
| 2230 | exit; |
||
| 2231 | } |
||
| 2232 | } |
||
| 2233 | |||
| 2234 | /** |
||
| 2235 | * List available Jetpack modules. Simply lists .php files in /modules/. |
||
| 2236 | * Make sure to tuck away module "library" files in a sub-directory. |
||
| 2237 | */ |
||
| 2238 | public static function get_available_modules( $min_version = false, $max_version = false ) { |
||
| 2239 | static $modules = null; |
||
| 2240 | |||
| 2241 | if ( ! isset( $modules ) ) { |
||
| 2242 | $available_modules_option = Jetpack_Options::get_option( 'available_modules', array() ); |
||
| 2243 | // Use the cache if we're on the front-end and it's available... |
||
| 2244 | if ( ! is_admin() && ! empty( $available_modules_option[ JETPACK__VERSION ] ) ) { |
||
| 2245 | $modules = $available_modules_option[ JETPACK__VERSION ]; |
||
| 2246 | } else { |
||
| 2247 | $files = Jetpack::glob_php( JETPACK__PLUGIN_DIR . 'modules' ); |
||
| 2248 | |||
| 2249 | $modules = array(); |
||
| 2250 | |||
| 2251 | foreach ( $files as $file ) { |
||
| 2252 | if ( ! $headers = Jetpack::get_module( $file ) ) { |
||
| 2253 | continue; |
||
| 2254 | } |
||
| 2255 | |||
| 2256 | $modules[ Jetpack::get_module_slug( $file ) ] = $headers['introduced']; |
||
| 2257 | } |
||
| 2258 | |||
| 2259 | Jetpack_Options::update_option( 'available_modules', array( |
||
| 2260 | JETPACK__VERSION => $modules, |
||
| 2261 | ) ); |
||
| 2262 | } |
||
| 2263 | } |
||
| 2264 | |||
| 2265 | /** |
||
| 2266 | * Filters the array of modules available to be activated. |
||
| 2267 | * |
||
| 2268 | * @since 2.4.0 |
||
| 2269 | * |
||
| 2270 | * @param array $modules Array of available modules. |
||
| 2271 | * @param string $min_version Minimum version number required to use modules. |
||
| 2272 | * @param string $max_version Maximum version number required to use modules. |
||
| 2273 | */ |
||
| 2274 | $mods = apply_filters( 'jetpack_get_available_modules', $modules, $min_version, $max_version ); |
||
| 2275 | |||
| 2276 | if ( ! $min_version && ! $max_version ) { |
||
| 2277 | return array_keys( $mods ); |
||
| 2278 | } |
||
| 2279 | |||
| 2280 | $r = array(); |
||
| 2281 | foreach ( $mods as $slug => $introduced ) { |
||
| 2282 | if ( $min_version && version_compare( $min_version, $introduced, '>=' ) ) { |
||
| 2283 | continue; |
||
| 2284 | } |
||
| 2285 | |||
| 2286 | if ( $max_version && version_compare( $max_version, $introduced, '<' ) ) { |
||
| 2287 | continue; |
||
| 2288 | } |
||
| 2289 | |||
| 2290 | $r[] = $slug; |
||
| 2291 | } |
||
| 2292 | |||
| 2293 | return $r; |
||
| 2294 | } |
||
| 2295 | |||
| 2296 | /** |
||
| 2297 | * Default modules loaded on activation. |
||
| 2298 | */ |
||
| 2299 | public static function get_default_modules( $min_version = false, $max_version = false ) { |
||
| 2300 | $return = array(); |
||
| 2301 | |||
| 2302 | foreach ( Jetpack::get_available_modules( $min_version, $max_version ) as $module ) { |
||
| 2303 | $module_data = Jetpack::get_module( $module ); |
||
| 2304 | |||
| 2305 | switch ( strtolower( $module_data['auto_activate'] ) ) { |
||
| 2306 | case 'yes' : |
||
| 2307 | $return[] = $module; |
||
| 2308 | break; |
||
| 2309 | case 'public' : |
||
| 2310 | if ( Jetpack_Options::get_option( 'public' ) ) { |
||
| 2311 | $return[] = $module; |
||
| 2312 | } |
||
| 2313 | break; |
||
| 2314 | case 'no' : |
||
| 2315 | default : |
||
| 2316 | break; |
||
| 2317 | } |
||
| 2318 | } |
||
| 2319 | /** |
||
| 2320 | * Filters the array of default modules. |
||
| 2321 | * |
||
| 2322 | * @since 2.5.0 |
||
| 2323 | * |
||
| 2324 | * @param array $return Array of default modules. |
||
| 2325 | * @param string $min_version Minimum version number required to use modules. |
||
| 2326 | * @param string $max_version Maximum version number required to use modules. |
||
| 2327 | */ |
||
| 2328 | return apply_filters( 'jetpack_get_default_modules', $return, $min_version, $max_version ); |
||
| 2329 | } |
||
| 2330 | |||
| 2331 | /** |
||
| 2332 | * Checks activated modules during auto-activation to determine |
||
| 2333 | * if any of those modules are being deprecated. If so, close |
||
| 2334 | * them out, and add any replacement modules. |
||
| 2335 | * |
||
| 2336 | * Runs at priority 99 by default. |
||
| 2337 | * |
||
| 2338 | * This is run late, so that it can still activate a module if |
||
| 2339 | * the new module is a replacement for another that the user |
||
| 2340 | * currently has active, even if something at the normal priority |
||
| 2341 | * would kibosh everything. |
||
| 2342 | * |
||
| 2343 | * @since 2.6 |
||
| 2344 | * @uses jetpack_get_default_modules filter |
||
| 2345 | * @param array $modules |
||
| 2346 | * @return array |
||
| 2347 | */ |
||
| 2348 | function handle_deprecated_modules( $modules ) { |
||
| 2349 | $deprecated_modules = array( |
||
| 2350 | 'debug' => null, // Closed out and moved to ./class.jetpack-debugger.php |
||
| 2351 | 'wpcc' => 'sso', // Closed out in 2.6 -- SSO provides the same functionality. |
||
| 2352 | 'gplus-authorship' => null, // Closed out in 3.2 -- Google dropped support. |
||
| 2353 | ); |
||
| 2354 | |||
| 2355 | // Don't activate SSO if they never completed activating WPCC. |
||
| 2356 | if ( Jetpack::is_module_active( 'wpcc' ) ) { |
||
| 2357 | $wpcc_options = Jetpack_Options::get_option( 'wpcc_options' ); |
||
| 2358 | if ( empty( $wpcc_options ) || empty( $wpcc_options['client_id'] ) || empty( $wpcc_options['client_id'] ) ) { |
||
| 2359 | $deprecated_modules['wpcc'] = null; |
||
| 2360 | } |
||
| 2361 | } |
||
| 2362 | |||
| 2363 | foreach ( $deprecated_modules as $module => $replacement ) { |
||
| 2364 | if ( Jetpack::is_module_active( $module ) ) { |
||
| 2365 | self::deactivate_module( $module ); |
||
| 2366 | if ( $replacement ) { |
||
| 2367 | $modules[] = $replacement; |
||
| 2368 | } |
||
| 2369 | } |
||
| 2370 | } |
||
| 2371 | |||
| 2372 | return array_unique( $modules ); |
||
| 2373 | } |
||
| 2374 | |||
| 2375 | /** |
||
| 2376 | * Checks activated plugins during auto-activation to determine |
||
| 2377 | * if any of those plugins are in the list with a corresponding module |
||
| 2378 | * that is not compatible with the plugin. The module will not be allowed |
||
| 2379 | * to auto-activate. |
||
| 2380 | * |
||
| 2381 | * @since 2.6 |
||
| 2382 | * @uses jetpack_get_default_modules filter |
||
| 2383 | * @param array $modules |
||
| 2384 | * @return array |
||
| 2385 | */ |
||
| 2386 | function filter_default_modules( $modules ) { |
||
| 2387 | |||
| 2388 | $active_plugins = self::get_active_plugins(); |
||
| 2389 | |||
| 2390 | if ( ! empty( $active_plugins ) ) { |
||
| 2391 | |||
| 2392 | // For each module we'd like to auto-activate... |
||
| 2393 | foreach ( $modules as $key => $module ) { |
||
| 2394 | // If there are potential conflicts for it... |
||
| 2395 | if ( ! empty( $this->conflicting_plugins[ $module ] ) ) { |
||
| 2396 | // For each potential conflict... |
||
| 2397 | foreach ( $this->conflicting_plugins[ $module ] as $title => $plugin ) { |
||
| 2398 | // If that conflicting plugin is active... |
||
| 2399 | if ( in_array( $plugin, $active_plugins ) ) { |
||
| 2400 | // Remove that item from being auto-activated. |
||
| 2401 | unset( $modules[ $key ] ); |
||
| 2402 | } |
||
| 2403 | } |
||
| 2404 | } |
||
| 2405 | } |
||
| 2406 | } |
||
| 2407 | |||
| 2408 | return $modules; |
||
| 2409 | } |
||
| 2410 | |||
| 2411 | /** |
||
| 2412 | * Extract a module's slug from its full path. |
||
| 2413 | */ |
||
| 2414 | public static function get_module_slug( $file ) { |
||
| 2415 | return str_replace( '.php', '', basename( $file ) ); |
||
| 2416 | } |
||
| 2417 | |||
| 2418 | /** |
||
| 2419 | * Generate a module's path from its slug. |
||
| 2420 | */ |
||
| 2421 | public static function get_module_path( $slug ) { |
||
| 2422 | return JETPACK__PLUGIN_DIR . "modules/$slug.php"; |
||
| 2423 | } |
||
| 2424 | |||
| 2425 | /** |
||
| 2426 | * Load module data from module file. Headers differ from WordPress |
||
| 2427 | * plugin headers to avoid them being identified as standalone |
||
| 2428 | * plugins on the WordPress plugins page. |
||
| 2429 | */ |
||
| 2430 | public static function get_module( $module ) { |
||
| 2431 | $headers = array( |
||
| 2432 | 'name' => 'Module Name', |
||
| 2433 | 'description' => 'Module Description', |
||
| 2434 | 'jumpstart_desc' => 'Jumpstart Description', |
||
| 2435 | 'sort' => 'Sort Order', |
||
| 2436 | 'recommendation_order' => 'Recommendation Order', |
||
| 2437 | 'introduced' => 'First Introduced', |
||
| 2438 | 'changed' => 'Major Changes In', |
||
| 2439 | 'deactivate' => 'Deactivate', |
||
| 2440 | 'free' => 'Free', |
||
| 2441 | 'requires_connection' => 'Requires Connection', |
||
| 2442 | 'auto_activate' => 'Auto Activate', |
||
| 2443 | 'module_tags' => 'Module Tags', |
||
| 2444 | 'feature' => 'Feature', |
||
| 2445 | 'additional_search_queries' => 'Additional Search Queries', |
||
| 2446 | 'plan_classes' => 'Plans', |
||
| 2447 | ); |
||
| 2448 | |||
| 2449 | $file = Jetpack::get_module_path( Jetpack::get_module_slug( $module ) ); |
||
| 2450 | |||
| 2451 | $mod = Jetpack::get_file_data( $file, $headers ); |
||
| 2452 | if ( empty( $mod['name'] ) ) { |
||
| 2453 | return false; |
||
| 2454 | } |
||
| 2455 | |||
| 2456 | $mod['sort'] = empty( $mod['sort'] ) ? 10 : (int) $mod['sort']; |
||
| 2457 | $mod['recommendation_order'] = empty( $mod['recommendation_order'] ) ? 20 : (int) $mod['recommendation_order']; |
||
| 2458 | $mod['deactivate'] = empty( $mod['deactivate'] ); |
||
| 2459 | $mod['free'] = empty( $mod['free'] ); |
||
| 2460 | $mod['requires_connection'] = ( ! empty( $mod['requires_connection'] ) && 'No' == $mod['requires_connection'] ) ? false : true; |
||
| 2461 | |||
| 2462 | if ( empty( $mod['auto_activate'] ) || ! in_array( strtolower( $mod['auto_activate'] ), array( 'yes', 'no', 'public' ) ) ) { |
||
| 2463 | $mod['auto_activate'] = 'No'; |
||
| 2464 | } else { |
||
| 2465 | $mod['auto_activate'] = (string) $mod['auto_activate']; |
||
| 2466 | } |
||
| 2467 | |||
| 2468 | if ( $mod['module_tags'] ) { |
||
| 2469 | $mod['module_tags'] = explode( ',', $mod['module_tags'] ); |
||
| 2470 | $mod['module_tags'] = array_map( 'trim', $mod['module_tags'] ); |
||
| 2471 | $mod['module_tags'] = array_map( array( __CLASS__, 'translate_module_tag' ), $mod['module_tags'] ); |
||
| 2472 | } else { |
||
| 2473 | $mod['module_tags'] = array( self::translate_module_tag( 'Other' ) ); |
||
| 2474 | } |
||
| 2475 | |||
| 2476 | View Code Duplication | if ( $mod['plan_classes'] ) { |
|
| 2477 | $mod['plan_classes'] = explode( ',', $mod['plan_classes'] ); |
||
| 2478 | $mod['plan_classes'] = array_map( 'strtolower', array_map( 'trim', $mod['plan_classes'] ) ); |
||
| 2479 | } else { |
||
| 2480 | $mod['plan_classes'] = array( 'free' ); |
||
| 2481 | } |
||
| 2482 | |||
| 2483 | View Code Duplication | if ( $mod['feature'] ) { |
|
| 2484 | $mod['feature'] = explode( ',', $mod['feature'] ); |
||
| 2485 | $mod['feature'] = array_map( 'trim', $mod['feature'] ); |
||
| 2486 | } else { |
||
| 2487 | $mod['feature'] = array( self::translate_module_tag( 'Other' ) ); |
||
| 2488 | } |
||
| 2489 | |||
| 2490 | /** |
||
| 2491 | * Filters the feature array on a module. |
||
| 2492 | * |
||
| 2493 | * This filter allows you to control where each module is filtered: Recommended, |
||
| 2494 | * Jumpstart, and the default "Other" listing. |
||
| 2495 | * |
||
| 2496 | * @since 3.5.0 |
||
| 2497 | * |
||
| 2498 | * @param array $mod['feature'] The areas to feature this module: |
||
| 2499 | * 'Jumpstart' adds to the "Jumpstart" option to activate many modules at once. |
||
| 2500 | * 'Recommended' shows on the main Jetpack admin screen. |
||
| 2501 | * 'Other' should be the default if no other value is in the array. |
||
| 2502 | * @param string $module The slug of the module, e.g. sharedaddy. |
||
| 2503 | * @param array $mod All the currently assembled module data. |
||
| 2504 | */ |
||
| 2505 | $mod['feature'] = apply_filters( 'jetpack_module_feature', $mod['feature'], $module, $mod ); |
||
| 2506 | |||
| 2507 | /** |
||
| 2508 | * Filter the returned data about a module. |
||
| 2509 | * |
||
| 2510 | * This filter allows overriding any info about Jetpack modules. It is dangerous, |
||
| 2511 | * so please be careful. |
||
| 2512 | * |
||
| 2513 | * @since 3.6.0 |
||
| 2514 | * |
||
| 2515 | * @param array $mod The details of the requested module. |
||
| 2516 | * @param string $module The slug of the module, e.g. sharedaddy |
||
| 2517 | * @param string $file The path to the module source file. |
||
| 2518 | */ |
||
| 2519 | return apply_filters( 'jetpack_get_module', $mod, $module, $file ); |
||
| 2520 | } |
||
| 2521 | |||
| 2522 | /** |
||
| 2523 | * Like core's get_file_data implementation, but caches the result. |
||
| 2524 | */ |
||
| 2525 | public static function get_file_data( $file, $headers ) { |
||
| 2526 | //Get just the filename from $file (i.e. exclude full path) so that a consistent hash is generated |
||
| 2527 | $file_name = basename( $file ); |
||
| 2528 | |||
| 2529 | $cache_key = 'jetpack_file_data_' . JETPACK__VERSION; |
||
| 2530 | |||
| 2531 | $file_data_option = get_transient( $cache_key ); |
||
| 2532 | |||
| 2533 | if ( false === $file_data_option ) { |
||
| 2534 | $file_data_option = array(); |
||
| 2535 | } |
||
| 2536 | |||
| 2537 | $key = md5( $file_name . serialize( $headers ) ); |
||
| 2538 | $refresh_cache = is_admin() && isset( $_GET['page'] ) && 'jetpack' === substr( $_GET['page'], 0, 7 ); |
||
| 2539 | |||
| 2540 | // If we don't need to refresh the cache, and already have the value, short-circuit! |
||
| 2541 | if ( ! $refresh_cache && isset( $file_data_option[ $key ] ) ) { |
||
| 2542 | return $file_data_option[ $key ]; |
||
| 2543 | } |
||
| 2544 | |||
| 2545 | $data = get_file_data( $file, $headers ); |
||
| 2546 | |||
| 2547 | $file_data_option[ $key ] = $data; |
||
| 2548 | |||
| 2549 | set_transient( $cache_key, $file_data_option, 29 * DAY_IN_SECONDS ); |
||
| 2550 | |||
| 2551 | return $data; |
||
| 2552 | } |
||
| 2553 | |||
| 2554 | |||
| 2555 | /** |
||
| 2556 | * Return translated module tag. |
||
| 2557 | * |
||
| 2558 | * @param string $tag Tag as it appears in each module heading. |
||
| 2559 | * |
||
| 2560 | * @return mixed |
||
| 2561 | */ |
||
| 2562 | public static function translate_module_tag( $tag ) { |
||
| 2565 | |||
| 2566 | /** |
||
| 2567 | * Return module name translation. Uses matching string created in modules/module-headings.php. |
||
| 2568 | * |
||
| 2569 | * @since 3.9.2 |
||
| 2570 | * |
||
| 2571 | * @param array $modules |
||
| 2572 | * |
||
| 2573 | * @return string|void |
||
| 2574 | */ |
||
| 2575 | public static function get_translated_modules( $modules ) { |
||
| 2588 | |||
| 2589 | /** |
||
| 2590 | * Get a list of activated modules as an array of module slugs. |
||
| 2591 | */ |
||
| 2592 | public static function get_active_modules() { |
||
| 2593 | $active = Jetpack_Options::get_option( 'active_modules' ); |
||
| 2594 | |||
| 2595 | if ( ! is_array( $active ) ) { |
||
| 2596 | $active = array(); |
||
| 2597 | } |
||
| 2598 | |||
| 2599 | if ( class_exists( 'VaultPress' ) || function_exists( 'vaultpress_contact_service' ) ) { |
||
| 2600 | $active[] = 'vaultpress'; |
||
| 2601 | } else { |
||
| 2602 | $active = array_diff( $active, array( 'vaultpress' ) ); |
||
| 2603 | } |
||
| 2604 | |||
| 2605 | //If protect is active on the main site of a multisite, it should be active on all sites. |
||
| 2606 | if ( ! in_array( 'protect', $active ) && is_multisite() && get_site_option( 'jetpack_protect_active' ) ) { |
||
| 2607 | $active[] = 'protect'; |
||
| 2608 | } |
||
| 2609 | |||
| 2610 | /** |
||
| 2611 | * Allow filtering of the active modules. |
||
| 2612 | * |
||
| 2613 | * Gives theme and plugin developers the power to alter the modules that |
||
| 2614 | * are activated on the fly. |
||
| 2615 | * |
||
| 2616 | * @since 5.8.0 |
||
| 2617 | * |
||
| 2618 | * @param array $active Array of active module slugs. |
||
| 2619 | */ |
||
| 2620 | $active = apply_filters( 'jetpack_active_modules', $active ); |
||
| 2621 | |||
| 2622 | return array_unique( $active ); |
||
| 2623 | } |
||
| 2624 | |||
| 2625 | /** |
||
| 2626 | * Check whether or not a Jetpack module is active. |
||
| 2627 | * |
||
| 2628 | * @param string $module The slug of a Jetpack module. |
||
| 2629 | * @return bool |
||
| 2630 | * |
||
| 2631 | * @static |
||
| 2632 | */ |
||
| 2633 | public static function is_module_active( $module ) { |
||
| 2634 | return in_array( $module, self::get_active_modules() ); |
||
| 2635 | } |
||
| 2636 | |||
| 2637 | public static function is_module( $module ) { |
||
| 2638 | return ! empty( $module ) && ! validate_file( $module, Jetpack::get_available_modules() ); |
||
| 2639 | } |
||
| 2640 | |||
| 2641 | /** |
||
| 2642 | * Catches PHP errors. Must be used in conjunction with output buffering. |
||
| 2643 | * |
||
| 2644 | * @param bool $catch True to start catching, False to stop. |
||
| 2645 | * |
||
| 2646 | * @static |
||
| 2647 | */ |
||
| 2648 | public static function catch_errors( $catch ) { |
||
| 2649 | static $display_errors, $error_reporting; |
||
| 2650 | |||
| 2651 | if ( $catch ) { |
||
| 2652 | $display_errors = @ini_set( 'display_errors', 1 ); |
||
| 2653 | $error_reporting = @error_reporting( E_ALL ); |
||
| 2654 | add_action( 'shutdown', array( 'Jetpack', 'catch_errors_on_shutdown' ), 0 ); |
||
| 2655 | } else { |
||
| 2656 | @ini_set( 'display_errors', $display_errors ); |
||
| 2657 | @error_reporting( $error_reporting ); |
||
| 2658 | remove_action( 'shutdown', array( 'Jetpack', 'catch_errors_on_shutdown' ), 0 ); |
||
| 2659 | } |
||
| 2660 | } |
||
| 2661 | |||
| 2662 | /** |
||
| 2663 | * Saves any generated PHP errors in ::state( 'php_errors', {errors} ) |
||
| 2664 | */ |
||
| 2665 | public static function catch_errors_on_shutdown() { |
||
| 2666 | Jetpack::state( 'php_errors', self::alias_directories( ob_get_clean() ) ); |
||
| 2667 | } |
||
| 2668 | |||
| 2669 | /** |
||
| 2670 | * Rewrite any string to make paths easier to read. |
||
| 2671 | * |
||
| 2672 | * Rewrites ABSPATH (eg `/home/jetpack/wordpress/`) to ABSPATH, and if WP_CONTENT_DIR |
||
| 2673 | * is located outside of ABSPATH, rewrites that to WP_CONTENT_DIR. |
||
| 2674 | * |
||
| 2675 | * @param $string |
||
| 2676 | * @return mixed |
||
| 2677 | */ |
||
| 2678 | public static function alias_directories( $string ) { |
||
| 2679 | // ABSPATH has a trailing slash. |
||
| 2686 | |||
| 2687 | public static function activate_default_modules( |
||
| 2823 | |||
| 2824 | public static function activate_module( $module, $exit = true, $redirect = true ) { |
||
| 2923 | |||
| 2924 | function activate_module_actions( $module ) { |
||
| 2927 | |||
| 2928 | public static function deactivate_module( $module ) { |
||
| 2955 | |||
| 2956 | public static function enable_module_configurable( $module ) { |
||
| 2960 | |||
| 2961 | public static function module_configuration_url( $module ) { |
||
| 2965 | |||
| 2966 | public static function module_configuration_load( $module, $method ) { |
||
| 2970 | |||
| 2971 | public static function module_configuration_head( $module, $method ) { |
||
| 2975 | |||
| 2976 | public static function module_configuration_screen( $module, $method ) { |
||
| 2980 | |||
| 2981 | public static function module_configuration_activation_screen( $module, $method ) { |
||
| 2985 | |||
| 2986 | /* Installation */ |
||
| 2987 | |||
| 2988 | public static function bail_on_activation( $message, $deactivate = true ) { |
||
| 3028 | |||
| 3029 | /** |
||
| 3030 | * Attached to activate_{ plugin_basename( __FILES__ ) } by register_activation_hook() |
||
| 3031 | * @static |
||
| 3032 | */ |
||
| 3033 | public static function plugin_activation( $network_wide ) { |
||
| 3050 | |||
| 3051 | public static function get_activation_source( $referer_url ) { |
||
| 3100 | |||
| 3101 | /** |
||
| 3102 | * Runs before bumping version numbers up to a new version |
||
| 3103 | * @param string $version Version:timestamp |
||
| 3104 | * @param string $old_version Old Version:timestamp or false if not set yet. |
||
| 3105 | * @return null [description] |
||
| 3106 | */ |
||
| 3107 | public static function do_version_bump( $version, $old_version ) { |
||
| 3114 | |||
| 3115 | /** |
||
| 3116 | * Sets the internal version number and activation state. |
||
| 3117 | * @static |
||
| 3118 | */ |
||
| 3119 | public static function plugin_initialize() { |
||
| 3136 | |||
| 3137 | /** |
||
| 3138 | * Removes all connection options |
||
| 3139 | * @static |
||
| 3140 | */ |
||
| 3141 | public static function plugin_deactivation( ) { |
||
| 3150 | |||
| 3151 | /** |
||
| 3152 | * Disconnects from the Jetpack servers. |
||
| 3153 | * Forgets all connection details and tells the Jetpack servers to do the same. |
||
| 3154 | * @static |
||
| 3155 | */ |
||
| 3156 | public static function disconnect( $update_activated_state = true ) { |
||
| 3217 | |||
| 3218 | /** |
||
| 3219 | * Unlinks the current user from the linked WordPress.com user |
||
| 3220 | */ |
||
| 3221 | public static function unlink_user( $user_id = null ) { |
||
| 3252 | |||
| 3253 | /** |
||
| 3254 | * Attempts Jetpack registration. If it fail, a state flag is set: @see ::admin_page_load() |
||
| 3255 | */ |
||
| 3256 | public static function try_registration() { |
||
| 3284 | |||
| 3285 | /** |
||
| 3286 | * Tracking an internal event log. Try not to put too much chaff in here. |
||
| 3287 | * |
||
| 3288 | * [Everyone Loves a Log!](https://www.youtube.com/watch?v=2C7mNr5WMjA) |
||
| 3289 | */ |
||
| 3290 | public static function log( $code, $data = null ) { |
||
| 3330 | |||
| 3331 | /** |
||
| 3332 | * Get the internal event log. |
||
| 3333 | * |
||
| 3334 | * @param $event (string) - only return the specific log events |
||
| 3335 | * @param $num (int) - get specific number of latest results, limited to 200 |
||
| 3336 | * |
||
| 3337 | * @return array of log events || WP_Error for invalid params |
||
| 3338 | */ |
||
| 3339 | public static function get_log( $event = false, $num = false ) { |
||
| 3375 | |||
| 3376 | /** |
||
| 3377 | * Log modification of important settings. |
||
| 3378 | */ |
||
| 3379 | public static function log_settings_change( $option, $old_value, $value ) { |
||
| 3386 | |||
| 3387 | /** |
||
| 3388 | * Return stat data for WPCOM sync |
||
| 3389 | */ |
||
| 3390 | public static function get_stat_data( $encode = true, $extended = true ) { |
||
| 3404 | |||
| 3405 | /** |
||
| 3406 | * Get additional stat data to sync to WPCOM |
||
| 3407 | */ |
||
| 3408 | public static function get_additional_stat_data( $prefix = '' ) { |
||
| 3419 | |||
| 3420 | private static function get_site_user_count() { |
||
| 3435 | |||
| 3436 | /* Admin Pages */ |
||
| 3437 | |||
| 3438 | function admin_init() { |
||
| 3487 | |||
| 3488 | function admin_body_class( $admin_body_class = '' ) { |
||
| 3496 | |||
| 3497 | static function add_jetpack_pagestyles( $admin_body_class = '' ) { |
||
| 3500 | |||
| 3501 | /** |
||
| 3502 | * Call this function if you want the Big Jetpack Manage Notice to show up. |
||
| 3503 | * |
||
| 3504 | * @return null |
||
| 3505 | */ |
||
| 3506 | function prepare_manage_jetpack_notice() { |
||
| 3511 | |||
| 3512 | function manage_activate_screen() { |
||
| 3515 | /** |
||
| 3516 | * Sometimes a plugin can activate without causing errors, but it will cause errors on the next page load. |
||
| 3517 | * This function artificially throws errors for such cases (whitelisted). |
||
| 3518 | * |
||
| 3519 | * @param string $plugin The activated plugin. |
||
| 3520 | */ |
||
| 3521 | function throw_error_on_activate_plugin( $plugin ) { |
||
| 3545 | |||
| 3546 | function intercept_plugin_error_scrape_init() { |
||
| 3549 | |||
| 3550 | function intercept_plugin_error_scrape( $action, $result ) { |
||
| 3561 | |||
| 3562 | function add_remote_request_handlers() { |
||
| 3566 | |||
| 3567 | function remote_request_handlers() { |
||
| 3607 | |||
| 3608 | /** |
||
| 3609 | * Uploads a file gotten from the global $_FILES. |
||
| 3610 | * If `$update_media_item` is true and `post_id` is defined |
||
| 3611 | * the attachment file of the media item (gotten through of the post_id) |
||
| 3612 | * will be updated instead of add a new one. |
||
| 3613 | * |
||
| 3614 | * @param boolean $update_media_item - update media attachment |
||
| 3615 | * @return array - An array describing the uploadind files process |
||
| 3616 | */ |
||
| 3617 | function upload_handler( $update_media_item = false ) { |
||
| 3739 | |||
| 3740 | /** |
||
| 3741 | * Add help to the Jetpack page |
||
| 3742 | * |
||
| 3743 | * @since Jetpack (1.2.3) |
||
| 3744 | * @return false if not the Jetpack page |
||
| 3745 | */ |
||
| 3746 | function admin_help() { |
||
| 3787 | |||
| 3788 | function admin_menu_css() { |
||
| 3791 | |||
| 3792 | function admin_menu_order() { |
||
| 3795 | |||
| 3796 | View Code Duplication | function jetpack_menu_order( $menu_order ) { |
|
| 3811 | |||
| 3812 | function admin_head() { |
||
| 3817 | |||
| 3818 | function admin_banner_styles() { |
||
| 3839 | |||
| 3840 | function plugin_action_links( $actions ) { |
||
| 3855 | |||
| 3856 | /** |
||
| 3857 | * This is the first banner |
||
| 3858 | * It should be visible only to user that can update the option |
||
| 3859 | * Are not connected |
||
| 3860 | * |
||
| 3861 | * @return null |
||
| 3862 | */ |
||
| 3863 | function admin_jetpack_manage_notice() { |
||
| 3893 | |||
| 3894 | /** |
||
| 3895 | * Returns the url that the user clicks to remove the notice for the big banner |
||
| 3896 | * @return string |
||
| 3897 | */ |
||
| 3898 | function opt_out_jetpack_manage_url() { |
||
| 3902 | /** |
||
| 3903 | * Returns the url that the user clicks to opt in to Jetpack Manage |
||
| 3904 | * @return string |
||
| 3905 | */ |
||
| 3906 | function opt_in_jetpack_manage_url() { |
||
| 3909 | |||
| 3910 | function opt_in_jetpack_manage_notice() { |
||
| 3920 | /** |
||
| 3921 | * Determines whether to show the notice of not true = display notice |
||
| 3922 | * @return bool |
||
| 3923 | */ |
||
| 3924 | function can_display_jetpack_manage_notice() { |
||
| 3946 | |||
| 3947 | /* |
||
| 3948 | * Registration flow: |
||
| 3949 | * 1 - ::admin_page_load() action=register |
||
| 3950 | * 2 - ::try_registration() |
||
| 3951 | * 3 - ::register() |
||
| 3952 | * - Creates jetpack_register option containing two secrets and a timestamp |
||
| 3953 | * - Calls https://jetpack.wordpress.com/jetpack.register/1/ with |
||
| 3954 | * siteurl, home, gmt_offset, timezone_string, site_name, secret_1, secret_2, site_lang, timeout, stats_id |
||
| 3955 | * - That request to jetpack.wordpress.com does not immediately respond. It first makes a request BACK to this site's |
||
| 3956 | * xmlrpc.php?for=jetpack: RPC method: jetpack.verifyRegistration, Parameters: secret_1 |
||
| 3957 | * - The XML-RPC request verifies secret_1, deletes both secrets and responds with: secret_2 |
||
| 3958 | * - https://jetpack.wordpress.com/jetpack.register/1/ verifies that XML-RPC response (secret_2) then finally responds itself with |
||
| 3959 | * jetpack_id, jetpack_secret, jetpack_public |
||
| 3960 | * - ::register() then stores jetpack_options: id => jetpack_id, blog_token => jetpack_secret |
||
| 3961 | * 4 - redirect to https://wordpress.com/start/jetpack-connect |
||
| 3962 | * 5 - user logs in with WP.com account |
||
| 3963 | * 6 - remote request to this site's xmlrpc.php with action remoteAuthorize, Jetpack_XMLRPC_Server->remote_authorize |
||
| 3964 | * - Jetpack_Client_Server::authorize() |
||
| 3965 | * - Jetpack_Client_Server::get_token() |
||
| 3966 | * - GET https://jetpack.wordpress.com/jetpack.token/1/ with |
||
| 3967 | * client_id, client_secret, grant_type, code, redirect_uri:action=authorize, state, scope, user_email, user_login |
||
| 3968 | * - which responds with access_token, token_type, scope |
||
| 3969 | * - Jetpack_Client_Server::authorize() stores jetpack_options: user_token => access_token.$user_id |
||
| 3970 | * - Jetpack::activate_default_modules() |
||
| 3971 | * - Deactivates deprecated plugins |
||
| 3972 | * - Activates all default modules |
||
| 3973 | * - Responds with either error, or 'connected' for new connection, or 'linked' for additional linked users |
||
| 3974 | * 7 - For a new connection, user selects a Jetpack plan on wordpress.com |
||
| 3975 | * 8 - User is redirected back to wp-admin/index.php?page=jetpack with state:message=authorized |
||
| 3976 | * Done! |
||
| 3977 | */ |
||
| 3978 | |||
| 3979 | /** |
||
| 3980 | * Handles the page load events for the Jetpack admin page |
||
| 3981 | */ |
||
| 3982 | function admin_page_load() { |
||
| 4257 | |||
| 4258 | function admin_notices() { |
||
| 4355 | |||
| 4356 | /** |
||
| 4357 | * Record a stat for later output. This will only currently output in the admin_footer. |
||
| 4358 | */ |
||
| 4359 | function stat( $group, $detail ) { |
||
| 4364 | |||
| 4365 | /** |
||
| 4366 | * Load stats pixels. $group is auto-prefixed with "x_jetpack-" |
||
| 4367 | */ |
||
| 4368 | function do_stats( $method = '' ) { |
||
| 4383 | |||
| 4384 | /** |
||
| 4385 | * Runs stats code for a one-off, server-side. |
||
| 4386 | * |
||
| 4387 | * @param $args array|string The arguments to append to the URL. Should include `x_jetpack-{$group}={$stats}` or whatever we want to store. |
||
| 4388 | * |
||
| 4389 | * @return bool If it worked. |
||
| 4390 | */ |
||
| 4391 | static function do_server_side_stat( $args ) { |
||
| 4401 | |||
| 4402 | /** |
||
| 4403 | * Builds the stats url. |
||
| 4404 | * |
||
| 4405 | * @param $args array|string The arguments to append to the URL. |
||
| 4406 | * |
||
| 4407 | * @return string The URL to be pinged. |
||
| 4408 | */ |
||
| 4409 | static function build_stats_url( $args ) { |
||
| 4429 | |||
| 4430 | static function translate_current_user_to_role() { |
||
| 4439 | |||
| 4440 | static function translate_user_to_role( $user ) { |
||
| 4449 | |||
| 4450 | static function translate_role_to_cap( $role ) { |
||
| 4457 | |||
| 4458 | static function sign_role( $role, $user_id = null ) { |
||
| 4474 | |||
| 4475 | |||
| 4476 | /** |
||
| 4477 | * Builds a URL to the Jetpack connection auth page |
||
| 4478 | * |
||
| 4479 | * @since 3.9.5 |
||
| 4480 | * |
||
| 4481 | * @param bool $raw If true, URL will not be escaped. |
||
| 4482 | * @param bool|string $redirect If true, will redirect back to Jetpack wp-admin landing page after connection. |
||
| 4483 | * If string, will be a custom redirect. |
||
| 4484 | * @param bool|string $from If not false, adds 'from=$from' param to the connect URL. |
||
| 4485 | * @param bool $register If true, will generate a register URL regardless of the existing token, since 4.9.0 |
||
| 4486 | * |
||
| 4487 | * @return string Connect URL |
||
| 4488 | */ |
||
| 4489 | function build_connect_url( $raw = false, $redirect = false, $from = false, $register = false ) { |
||
| 4610 | |||
| 4611 | public static function apply_activation_source_to_args( &$args ) { |
||
| 4622 | |||
| 4623 | function build_reconnect_url( $raw = false ) { |
||
| 4627 | |||
| 4628 | public static function admin_url( $args = null ) { |
||
| 4633 | |||
| 4634 | public static function nonce_url_no_esc( $actionurl, $action = -1, $name = '_wpnonce' ) { |
||
| 4638 | |||
| 4639 | function dismiss_jetpack_notice() { |
||
| 4713 | |||
| 4714 | public static function admin_screen_configure_module( $module_id ) { |
||
| 4766 | |||
| 4767 | /** |
||
| 4768 | * Display link to activate the module to see the settings screen. |
||
| 4769 | * @param string $module_id |
||
| 4770 | * @return null |
||
| 4771 | */ |
||
| 4772 | public static function display_activate_module_link( $module_id ) { |
||
| 4824 | |||
| 4825 | public static function sort_modules( $a, $b ) { |
||
| 4831 | |||
| 4832 | function ajax_recheck_ssl() { |
||
| 4840 | |||
| 4841 | /* Client API */ |
||
| 4842 | |||
| 4843 | /** |
||
| 4844 | * Returns the requested Jetpack API URL |
||
| 4845 | * |
||
| 4846 | * @return string |
||
| 4847 | */ |
||
| 4848 | public static function api_url( $relative_url ) { |
||
| 4851 | |||
| 4852 | /** |
||
| 4853 | * Some hosts disable the OpenSSL extension and so cannot make outgoing HTTPS requsets |
||
| 4854 | */ |
||
| 4855 | public static function fix_url_for_bad_hosts( $url ) { |
||
| 4871 | |||
| 4872 | /** |
||
| 4873 | * Create a random secret for validating onboarding payload |
||
| 4874 | * |
||
| 4875 | * @return string Secret token |
||
| 4876 | */ |
||
| 4877 | public static function create_onboarding_token() { |
||
| 4885 | |||
| 4886 | /** |
||
| 4887 | * Remove the onboarding token |
||
| 4888 | * |
||
| 4889 | * @return bool True on success, false on failure |
||
| 4890 | */ |
||
| 4891 | public static function invalidate_onboarding_token() { |
||
| 4894 | |||
| 4895 | /** |
||
| 4896 | * Validate an onboarding token for a specific action |
||
| 4897 | * |
||
| 4898 | * @return boolean True if token/action pair is accepted, false if not |
||
| 4899 | */ |
||
| 4900 | public static function validate_onboarding_token_action( $token, $action ) { |
||
| 4918 | |||
| 4919 | /** |
||
| 4920 | * Checks to see if the URL is using SSL to connect with Jetpack |
||
| 4921 | * |
||
| 4922 | * @since 2.3.3 |
||
| 4923 | * @return boolean |
||
| 4924 | */ |
||
| 4925 | public static function permit_ssl( $force_recheck = false ) { |
||
| 4967 | |||
| 4968 | /* |
||
| 4969 | * Displays an admin_notice, alerting the user to their JETPACK_CLIENT__HTTPS constant being 'AUTO' but SSL isn't working. |
||
| 4970 | */ |
||
| 4971 | public function alert_auto_ssl_fail() { |
||
| 5020 | |||
| 5021 | /** |
||
| 5022 | * Returns the Jetpack XML-RPC API |
||
| 5023 | * |
||
| 5024 | * @return string |
||
| 5025 | */ |
||
| 5026 | public static function xmlrpc_api_url() { |
||
| 5030 | |||
| 5031 | /** |
||
| 5032 | * Creates two secret tokens and the end of life timestamp for them. |
||
| 5033 | * |
||
| 5034 | * Note these tokens are unique per call, NOT static per site for connecting. |
||
| 5035 | * |
||
| 5036 | * @since 2.6 |
||
| 5037 | * @return array |
||
| 5038 | */ |
||
| 5039 | public static function generate_secrets( $action, $user_id = false, $exp = 600 ) { |
||
| 5065 | |||
| 5066 | public static function get_secrets( $action, $user_id ) { |
||
| 5081 | |||
| 5082 | public static function delete_secrets( $action, $user_id ) { |
||
| 5090 | |||
| 5091 | /** |
||
| 5092 | * Builds the timeout limit for queries talking with the wpcom servers. |
||
| 5093 | * |
||
| 5094 | * Based on local php max_execution_time in php.ini |
||
| 5095 | * |
||
| 5096 | * @since 2.6 |
||
| 5097 | * @return int |
||
| 5098 | * @deprecated |
||
| 5099 | **/ |
||
| 5100 | public function get_remote_query_timeout_limit() { |
||
| 5104 | |||
| 5105 | /** |
||
| 5106 | * Builds the timeout limit for queries talking with the wpcom servers. |
||
| 5107 | * |
||
| 5108 | * Based on local php max_execution_time in php.ini |
||
| 5109 | * |
||
| 5110 | * @since 5.4 |
||
| 5111 | * @return int |
||
| 5112 | **/ |
||
| 5113 | public static function get_max_execution_time() { |
||
| 5122 | |||
| 5123 | /** |
||
| 5124 | * Sets a minimum request timeout, and returns the current timeout |
||
| 5125 | * |
||
| 5126 | * @since 5.4 |
||
| 5127 | **/ |
||
| 5128 | public static function set_min_time_limit( $min_timeout ) { |
||
| 5136 | |||
| 5137 | |||
| 5138 | /** |
||
| 5139 | * Takes the response from the Jetpack register new site endpoint and |
||
| 5140 | * verifies it worked properly. |
||
| 5141 | * |
||
| 5142 | * @since 2.6 |
||
| 5143 | * @return string|Jetpack_Error A JSON object on success or Jetpack_Error on failures |
||
| 5144 | **/ |
||
| 5145 | public function validate_remote_register_response( $response ) { |
||
| 5185 | /** |
||
| 5186 | * @return bool|WP_Error |
||
| 5187 | */ |
||
| 5188 | public static function register() { |
||
| 5292 | |||
| 5293 | /** |
||
| 5294 | * If the db version is showing something other that what we've got now, bump it to current. |
||
| 5295 | * |
||
| 5296 | * @return bool: True if the option was incorrect and updated, false if nothing happened. |
||
| 5297 | */ |
||
| 5298 | public static function maybe_set_version_option() { |
||
| 5312 | |||
| 5313 | /* Client Server API */ |
||
| 5314 | |||
| 5315 | /** |
||
| 5316 | * Loads the Jetpack XML-RPC client |
||
| 5317 | */ |
||
| 5318 | public static function load_xml_rpc_client() { |
||
| 5322 | |||
| 5323 | /** |
||
| 5324 | * Resets the saved authentication state in between testing requests. |
||
| 5325 | */ |
||
| 5326 | public function reset_saved_auth_state() { |
||
| 5330 | |||
| 5331 | function verify_xml_rpc_signature() { |
||
| 5461 | |||
| 5462 | /** |
||
| 5463 | * Authenticates XML-RPC and other requests from the Jetpack Server |
||
| 5464 | */ |
||
| 5465 | function authenticate_jetpack( $user, $username, $password ) { |
||
| 5488 | |||
| 5489 | // Authenticates requests from Jetpack server to WP REST API endpoints. |
||
| 5490 | // Uses the existing XMLRPC request signing implementation. |
||
| 5491 | function wp_rest_authenticate( $user ) { |
||
| 5585 | |||
| 5586 | /** |
||
| 5587 | * Report authentication status to the WP REST API. |
||
| 5588 | * |
||
| 5589 | * @param WP_Error|mixed $result Error from another authentication handler, null if we should handle it, or another value if not |
||
| 5590 | * @return WP_Error|boolean|null {@see WP_JSON_Server::check_authentication} |
||
| 5591 | */ |
||
| 5592 | public function wp_rest_authentication_errors( $value ) { |
||
| 5598 | |||
| 5599 | function add_nonce( $timestamp, $nonce ) { |
||
| 5637 | |||
| 5638 | /** |
||
| 5639 | * In some setups, $HTTP_RAW_POST_DATA can be emptied during some IXR_Server paths since it is passed by reference to various methods. |
||
| 5640 | * Capture it here so we can verify the signature later. |
||
| 5641 | */ |
||
| 5642 | function xmlrpc_methods( $methods ) { |
||
| 5646 | |||
| 5647 | function public_xmlrpc_methods( $methods ) { |
||
| 5653 | |||
| 5654 | function jetpack_getOptions( $args ) { |
||
| 5694 | |||
| 5695 | function xmlrpc_options( $options ) { |
||
| 5713 | |||
| 5714 | public static function clean_nonces( $all = false ) { |
||
| 5735 | |||
| 5736 | /** |
||
| 5737 | * State is passed via cookies from one request to the next, but never to subsequent requests. |
||
| 5738 | * SET: state( $key, $value ); |
||
| 5739 | * GET: $value = state( $key ); |
||
| 5740 | * |
||
| 5741 | * @param string $key |
||
| 5742 | * @param string $value |
||
| 5743 | * @param bool $restate private |
||
| 5744 | */ |
||
| 5745 | public static function state( $key = null, $value = null, $restate = false ) { |
||
| 5795 | |||
| 5796 | public static function restate() { |
||
| 5799 | |||
| 5800 | public static function check_privacy( $file ) { |
||
| 5835 | |||
| 5836 | /** |
||
| 5837 | * Helper method for multicall XMLRPC. |
||
| 5838 | */ |
||
| 5839 | public static function xmlrpc_async_call() { |
||
| 5881 | |||
| 5882 | public static function staticize_subdomain( $url ) { |
||
| 5917 | |||
| 5918 | /* JSON API Authorization */ |
||
| 5919 | |||
| 5920 | /** |
||
| 5921 | * Handles the login action for Authorizing the JSON API |
||
| 5922 | */ |
||
| 5923 | function login_form_json_api_authorization() { |
||
| 5932 | |||
| 5933 | // Make sure the login form is POSTed to the signed URL so we can reverify the request |
||
| 5934 | function post_login_form_to_signed_url( $url, $path, $scheme ) { |
||
| 5947 | |||
| 5948 | // Make sure the POSTed request is handled by the same action |
||
| 5949 | function preserve_action_in_login_form_for_json_api_authorization() { |
||
| 5953 | |||
| 5954 | // If someone logs in to approve API access, store the Access Code in usermeta |
||
| 5955 | function store_json_api_authorization_token( $user_login, $user ) { |
||
| 5961 | |||
| 5962 | // Add public-api.wordpress.com to the safe redirect whitelist - only added when someone allows API access |
||
| 5963 | function allow_wpcom_public_api_domain( $domains ) { |
||
| 5967 | |||
| 5968 | // Add all wordpress.com environments to the safe redirect whitelist |
||
| 5969 | function allow_wpcom_environments( $domains ) { |
||
| 5976 | |||
| 5977 | // Add the Access Code details to the public-api.wordpress.com redirect |
||
| 5978 | function add_token_to_login_redirect_json_api_authorization( $redirect_to, $original_redirect_to, $user ) { |
||
| 5990 | |||
| 5991 | |||
| 5992 | /** |
||
| 5993 | * Verifies the request by checking the signature |
||
| 5994 | * |
||
| 5995 | * @since 4.6.0 Method was updated to use `$_REQUEST` instead of `$_GET` and `$_POST`. Method also updated to allow |
||
| 5996 | * passing in an `$environment` argument that overrides `$_REQUEST`. This was useful for integrating with SSO. |
||
| 5997 | * |
||
| 5998 | * @param null|array $environment |
||
| 5999 | */ |
||
| 6000 | function verify_json_api_authorization_request( $environment = null ) { |
||
| 6093 | |||
| 6094 | function login_message_json_api_authorization( $message ) { |
||
| 6100 | |||
| 6101 | /** |
||
| 6102 | * Get $content_width, but with a <s>twist</s> filter. |
||
| 6103 | */ |
||
| 6104 | public static function get_content_width() { |
||
| 6115 | |||
| 6116 | /** |
||
| 6117 | * Pings the WordPress.com Mirror Site for the specified options. |
||
| 6118 | * |
||
| 6119 | * @param string|array $option_names The option names to request from the WordPress.com Mirror Site |
||
| 6120 | * |
||
| 6121 | * @return array An associative array of the option values as stored in the WordPress.com Mirror Site |
||
| 6122 | */ |
||
| 6123 | public function get_cloud_site_options( $option_names ) { |
||
| 6139 | |||
| 6140 | /** |
||
| 6141 | * Checks if the site is currently in an identity crisis. |
||
| 6142 | * |
||
| 6143 | * @return array|bool Array of options that are in a crisis, or false if everything is OK. |
||
| 6144 | */ |
||
| 6145 | public static function check_identity_crisis() { |
||
| 6152 | |||
| 6153 | /** |
||
| 6154 | * Checks whether the home and siteurl specifically are whitelisted |
||
| 6155 | * Written so that we don't have re-check $key and $value params every time |
||
| 6156 | * we want to check if this site is whitelisted, for example in footer.php |
||
| 6157 | * |
||
| 6158 | * @since 3.8.0 |
||
| 6159 | * @return bool True = already whitelisted False = not whitelisted |
||
| 6160 | */ |
||
| 6161 | public static function is_staging_site() { |
||
| 6220 | |||
| 6221 | /** |
||
| 6222 | * Checks whether the sync_error_idc option is valid or not, and if not, will do cleanup. |
||
| 6223 | * |
||
| 6224 | * @since 4.4.0 |
||
| 6225 | * @since 5.4.0 Do not call get_sync_error_idc_option() unless site is in IDC |
||
| 6226 | * |
||
| 6227 | * @return bool |
||
| 6228 | */ |
||
| 6229 | public static function validate_sync_error_idc_option() { |
||
| 6273 | |||
| 6274 | /** |
||
| 6275 | * Normalizes a url by doing three things: |
||
| 6276 | * - Strips protocol |
||
| 6277 | * - Strips www |
||
| 6278 | * - Adds a trailing slash |
||
| 6279 | * |
||
| 6280 | * @since 4.4.0 |
||
| 6281 | * @param string $url |
||
| 6282 | * @return WP_Error|string |
||
| 6283 | */ |
||
| 6284 | public static function normalize_url_protocol_agnostic( $url ) { |
||
| 6294 | |||
| 6295 | /** |
||
| 6296 | * Gets the value that is to be saved in the jetpack_sync_error_idc option. |
||
| 6297 | * |
||
| 6298 | * @since 4.4.0 |
||
| 6299 | * @since 5.4.0 Add transient since home/siteurl retrieved directly from DB |
||
| 6300 | * |
||
| 6301 | * @param array $response |
||
| 6302 | * @return array Array of the local urls, wpcom urls, and error code |
||
| 6303 | */ |
||
| 6304 | public static function get_sync_error_idc_option( $response = array() ) { |
||
| 6337 | |||
| 6338 | /** |
||
| 6339 | * Returns the value of the jetpack_sync_idc_optin filter, or constant. |
||
| 6340 | * If set to true, the site will be put into staging mode. |
||
| 6341 | * |
||
| 6342 | * @since 4.3.2 |
||
| 6343 | * @return bool |
||
| 6344 | */ |
||
| 6345 | public static function sync_idc_optin() { |
||
| 6363 | |||
| 6364 | /** |
||
| 6365 | * Maybe Use a .min.css stylesheet, maybe not. |
||
| 6366 | * |
||
| 6367 | * Hooks onto `plugins_url` filter at priority 1, and accepts all 3 args. |
||
| 6368 | */ |
||
| 6369 | public static function maybe_min_asset( $url, $path, $plugin ) { |
||
| 6411 | |||
| 6412 | /** |
||
| 6413 | * If the asset is minified, let's flag .min as the suffix. |
||
| 6414 | * |
||
| 6415 | * Attached to `style_loader_src` filter. |
||
| 6416 | * |
||
| 6417 | * @param string $tag The tag that would link to the external asset. |
||
| 6418 | * @param string $handle The registered handle of the script in question. |
||
| 6419 | * @param string $href The url of the asset in question. |
||
| 6420 | */ |
||
| 6421 | public static function set_suffix_on_min( $src, $handle ) { |
||
| 6437 | |||
| 6438 | /** |
||
| 6439 | * Maybe inlines a stylesheet. |
||
| 6440 | * |
||
| 6441 | * If you'd like to inline a stylesheet instead of printing a link to it, |
||
| 6442 | * wp_style_add_data( 'handle', 'jetpack-inline', true ); |
||
| 6443 | * |
||
| 6444 | * Attached to `style_loader_tag` filter. |
||
| 6445 | * |
||
| 6446 | * @param string $tag The tag that would link to the external asset. |
||
| 6447 | * @param string $handle The registered handle of the script in question. |
||
| 6448 | * |
||
| 6449 | * @return string |
||
| 6450 | */ |
||
| 6451 | public static function maybe_inline_style( $tag, $handle ) { |
||
| 6501 | |||
| 6502 | /** |
||
| 6503 | * Loads a view file from the views |
||
| 6504 | * |
||
| 6505 | * Data passed in with the $data parameter will be available in the |
||
| 6506 | * template file as $data['value'] |
||
| 6507 | * |
||
| 6508 | * @param string $template - Template file to load |
||
| 6509 | * @param array $data - Any data to pass along to the template |
||
| 6510 | * @return boolean - If template file was found |
||
| 6511 | **/ |
||
| 6512 | public function load_view( $template, $data = array() ) { |
||
| 6523 | |||
| 6524 | /** |
||
| 6525 | * Throws warnings for deprecated hooks to be removed from Jetpack |
||
| 6526 | */ |
||
| 6527 | public function deprecated_hooks() { |
||
| 6584 | |||
| 6585 | /** |
||
| 6586 | * Converts any url in a stylesheet, to the correct absolute url. |
||
| 6587 | * |
||
| 6588 | * Considerations: |
||
| 6589 | * - Normal, relative URLs `feh.png` |
||
| 6590 | * - Data URLs `data:image/gif;base64,eh129ehiuehjdhsa==` |
||
| 6591 | * - Schema-agnostic URLs `//domain.com/feh.png` |
||
| 6592 | * - Absolute URLs `http://domain.com/feh.png` |
||
| 6593 | * - Domain root relative URLs `/feh.png` |
||
| 6594 | * |
||
| 6595 | * @param $css string: The raw CSS -- should be read in directly from the file. |
||
| 6596 | * @param $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
||
| 6597 | * |
||
| 6598 | * @return mixed|string |
||
| 6599 | */ |
||
| 6600 | public static function absolutize_css_urls( $css, $css_file_url ) { |
||
| 6644 | |||
| 6645 | /** |
||
| 6646 | * This methods removes all of the registered css files on the front end |
||
| 6647 | * from Jetpack in favor of using a single file. In effect "imploding" |
||
| 6648 | * all the files into one file. |
||
| 6649 | * |
||
| 6650 | * Pros: |
||
| 6651 | * - Uses only ONE css asset connection instead of 15 |
||
| 6652 | * - Saves a minimum of 56k |
||
| 6653 | * - Reduces server load |
||
| 6654 | * - Reduces time to first painted byte |
||
| 6655 | * |
||
| 6656 | * Cons: |
||
| 6657 | * - Loads css for ALL modules. However all selectors are prefixed so it |
||
| 6658 | * should not cause any issues with themes. |
||
| 6659 | * - Plugins/themes dequeuing styles no longer do anything. See |
||
| 6660 | * jetpack_implode_frontend_css filter for a workaround |
||
| 6661 | * |
||
| 6662 | * For some situations developers may wish to disable css imploding and |
||
| 6663 | * instead operate in legacy mode where each file loads seperately and |
||
| 6664 | * can be edited individually or dequeued. This can be accomplished with |
||
| 6665 | * the following line: |
||
| 6666 | * |
||
| 6667 | * add_filter( 'jetpack_implode_frontend_css', '__return_false' ); |
||
| 6668 | * |
||
| 6669 | * @since 3.2 |
||
| 6670 | **/ |
||
| 6671 | public function implode_frontend_css( $travis_test = false ) { |
||
| 6723 | |||
| 6724 | function concat_remove_style_loader_tag( $tag, $handle ) { |
||
| 6734 | |||
| 6735 | /* |
||
| 6736 | * Check the heartbeat data |
||
| 6737 | * |
||
| 6738 | * Organizes the heartbeat data by severity. For example, if the site |
||
| 6739 | * is in an ID crisis, it will be in the $filtered_data['bad'] array. |
||
| 6740 | * |
||
| 6741 | * Data will be added to "caution" array, if it either: |
||
| 6742 | * - Out of date Jetpack version |
||
| 6743 | * - Out of date WP version |
||
| 6744 | * - Out of date PHP version |
||
| 6745 | * |
||
| 6746 | * $return array $filtered_data |
||
| 6747 | */ |
||
| 6748 | public static function jetpack_check_heartbeat_data() { |
||
| 6801 | |||
| 6802 | |||
| 6803 | /* |
||
| 6804 | * This method is used to organize all options that can be reset |
||
| 6805 | * without disconnecting Jetpack. |
||
| 6806 | * |
||
| 6807 | * It is used in class.jetpack-cli.php to reset options |
||
| 6808 | * |
||
| 6809 | * @since 5.4.0 Logic moved to Jetpack_Options class. Method left in Jetpack class for backwards compat. |
||
| 6810 | * |
||
| 6811 | * @return array of options to delete. |
||
| 6812 | */ |
||
| 6813 | public static function get_jetpack_options_for_reset() { |
||
| 6816 | |||
| 6817 | /** |
||
| 6818 | * Check if an option of a Jetpack module has been updated. |
||
| 6819 | * |
||
| 6820 | * If any module option has been updated before Jump Start has been dismissed, |
||
| 6821 | * update the 'jumpstart' option so we can hide Jump Start. |
||
| 6822 | * |
||
| 6823 | * @param string $option_name |
||
| 6824 | * |
||
| 6825 | * @return bool |
||
| 6826 | */ |
||
| 6827 | public static function jumpstart_has_updated_module_option( $option_name = '' ) { |
||
| 6848 | |||
| 6849 | /* |
||
| 6850 | * Strip http:// or https:// from a url, replaces forward slash with ::, |
||
| 6851 | * so we can bring them directly to their site in calypso. |
||
| 6852 | * |
||
| 6853 | * @param string | url |
||
| 6854 | * @return string | url without the guff |
||
| 6855 | */ |
||
| 6856 | public static function build_raw_urls( $url ) { |
||
| 6862 | |||
| 6863 | /** |
||
| 6864 | * Stores and prints out domains to prefetch for page speed optimization. |
||
| 6865 | * |
||
| 6866 | * @param mixed $new_urls |
||
| 6867 | */ |
||
| 6868 | public static function dns_prefetch( $new_urls = null ) { |
||
| 6885 | |||
| 6886 | public function wp_dashboard_setup() { |
||
| 6910 | |||
| 6911 | /** |
||
| 6912 | * @param mixed $result Value for the user's option |
||
| 6913 | * @return mixed |
||
| 6914 | */ |
||
| 6915 | function get_user_option_meta_box_order_dashboard( $sorted ) { |
||
| 6940 | |||
| 6941 | public static function dashboard_widget() { |
||
| 6949 | |||
| 6950 | public static function dashboard_widget_footer() { |
||
| 6983 | |||
| 6984 | /** |
||
| 6985 | * Return string containing the Jetpack logo. |
||
| 6986 | * |
||
| 6987 | * @since 3.9.0 |
||
| 6988 | * |
||
| 6989 | * @return string |
||
| 6990 | */ |
||
| 6991 | public static function get_jp_emblem() { |
||
| 6994 | |||
| 6995 | /* |
||
| 6996 | * Adds a "blank" column in the user admin table to display indication of user connection. |
||
| 6997 | */ |
||
| 6998 | function jetpack_icon_user_connected( $columns ) { |
||
| 7002 | |||
| 7003 | /* |
||
| 7004 | * Show Jetpack icon if the user is linked. |
||
| 7005 | */ |
||
| 7006 | function jetpack_show_user_connected_icon( $val, $col, $user_id ) { |
||
| 7018 | |||
| 7019 | /* |
||
| 7020 | * Style the Jetpack user column |
||
| 7021 | */ |
||
| 7022 | function jetpack_user_col_style() { |
||
| 7039 | |||
| 7040 | /** |
||
| 7041 | * Checks if Akismet is active and working. |
||
| 7042 | * |
||
| 7043 | * @since 5.1.0 |
||
| 7044 | * @return bool True = Akismet available. False = Aksimet not available. |
||
| 7045 | */ |
||
| 7046 | public static function is_akismet_active() { |
||
| 7052 | |||
| 7053 | /** |
||
| 7054 | * Checks if one or more function names is in debug_backtrace |
||
| 7055 | * |
||
| 7056 | * @param $names Mixed string name of function or array of string names of functions |
||
| 7057 | * |
||
| 7058 | * @return bool |
||
| 7059 | */ |
||
| 7060 | public static function is_function_in_backtrace( $names ) { |
||
| 7083 | |||
| 7084 | /** |
||
| 7085 | * Given a minified path, and a non-minified path, will return |
||
| 7086 | * a minified or non-minified file URL based on whether SCRIPT_DEBUG is set and truthy. |
||
| 7087 | * |
||
| 7088 | * Both `$min_base` and `$non_min_base` are expected to be relative to the |
||
| 7089 | * root Jetpack directory. |
||
| 7090 | * |
||
| 7091 | * @since 5.6.0 |
||
| 7092 | * |
||
| 7093 | * @param string $min_path |
||
| 7094 | * @param string $non_min_path |
||
| 7095 | * @return string The URL to the file |
||
| 7096 | */ |
||
| 7097 | public static function get_file_url_for_environment( $min_path, $non_min_path ) { |
||
| 7104 | |||
| 7105 | /** |
||
| 7106 | * Checks for whether Jetpack Rewind is enabled. |
||
| 7107 | * Will return true if the state of Rewind is anything except "unavailable". |
||
| 7108 | * @return bool|int|mixed |
||
| 7109 | */ |
||
| 7110 | public static function is_rewind_enabled() { |
||
| 7129 | |||
| 7130 | /** |
||
| 7131 | * Checks whether or not TOS has been agreed upon. |
||
| 7132 | * Will return true if a user has clicked to register, or is already connected. |
||
| 7133 | */ |
||
| 7134 | public static function jetpack_tos_agreed() { |
||
| 7137 | } |
||
| 7138 |
The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using
the property is implicitly global.
To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2.