/var/www/hkosl.com/aga/wp-content/plugins/jetpack/modules/seo-tools/jetpack-seo-utils.php


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<?php

/**
 * Class containing utility static methods that other SEO tools are relying on.
 */
class Jetpack_SEO_Utils {
    
/**
     * Site option name used to store front page meta description.
     */
    
const FRONT_PAGE_META_OPTION 'advanced_seo_front_page_description';

    
/**
     * Old version of option name that was previously used under Free plan.
     */
    
const GRANDFATHERED_META_OPTION 'seo_meta_description';

    
/**
     * Used to check whether SEO tools are enabled for given site.
     *
     * @param int $site_id Optional. Defaults to current blog id if not given.
     *
     * @return bool True if SEO tools are enabled, false otherwise.
     */
    
public static function is_enabled_jetpack_seo$site_id ) {
        
/**
         * Can be used by SEO plugin authors to disable the conflicting output of SEO Tools.
         *
         * @module seo-tools
         *
         * @since 5.0.0
         *
         * @param bool True if SEO Tools should be disabled, false otherwise.
         */
        
if ( apply_filters'jetpack_disable_seo_tools'false ) ) {
            return 
false;
        }

        if ( 
function_exists'has_any_blog_stickers' ) ) {
            
// For WPCOM sites
            
if ( empty( $site_id ) ) {
                
$site_id get_current_blog_id();
            }

            return 
has_any_blog_stickers( array( 'business-plan''ecommerce-plan' ), $site_id );
        }

        
// For all Jetpack sites
        
return true;
    }

    
/**
     * Checks if this option was set while it was still available under free plan.
     *
     * @return bool True if we should enable grandfathering, false otherwise.
     */
    
public static function has_grandfathered_front_page_meta() {
        return ! 
self::is_enabled_jetpack_seo() && get_optionself::GRANDFATHERED_META_OPTION );
    }

    
/**
     * Returns front page meta description for current site.
     *
     * Since we allowed non-business users to set Front page meta description for some time,
     * before bundling it with other SEO tools features that require a business plan,
     * we are supporting grandfathering here.
     *
     * @return string Front page meta description string or empty string.
     */
    
public static function get_front_page_meta_description() {
        if ( 
self::is_enabled_jetpack_seo() ) {
            
$front_page_meta get_optionself::FRONT_PAGE_META_OPTION );
            return  
$front_page_meta $front_page_meta get_optionself::GRANDFATHERED_META_OPTION'' );
        }

        
// Support grandfathering for non-business users.
        
return get_optionself::GRANDFATHERED_META_OPTION'' );
    }

    
/**
     * Updates the site option value for front page meta description.
     *
     * We are taking care to update the correct option, in case the value is grandfathered for current site.
     *
     * @param $value string New value for front page meta description.
     *
     * @return string Saved value, or empty string if no update was performed.
     */
    
public static function update_front_page_meta_description$value ) {
        
$front_page_description sanitize_text_field$value );

        
/**
         * Can be used to limit the lenght of front page meta description.
         *
         * @module seo-tools
         *
         * @since 4.4.0
         *
         * @param int Maximum length of front page meta description. Defaults to 300.
         */
        
$description_max_length apply_filters'jetpack_seo_front_page_description_max_length'300 );

        if ( 
function_exists'mb_substr' ) ) {
            
$front_page_description mb_substr$front_page_description0$description_max_length );
        } else {
            
$front_page_description substr$front_page_description0$description_max_length );
        }

        
$can_set_meta self::is_enabled_jetpack_seo();
        
$grandfathered_meta_option get_optionself::GRANDFATHERED_META_OPTION );
        
$has_old_meta = ! empty( $grandfathered_meta_option );
        
$option_name self::has_grandfathered_front_page_meta() ? self::GRANDFATHERED_META_OPTION self::FRONT_PAGE_META_OPTION;

        
$did_update update_option$option_name$front_page_description );

        if ( 
$did_update && $has_old_meta && $can_set_meta ) {
            
// Delete grandfathered option if user has switched to Business plan and updated meta description.
            
delete_option'seo_meta_description' );
        }

        if ( 
$did_update ) {
            return 
$front_page_description;
        }

        return 
'';
    }
}