' . sprintf( __( 'The title & metas settings for %1$s are made up of variables that are replaced by specific values from the page when the page is displayed. The tabs on the left explain the available variables.', 'wordpress-seo' ), 'Yoast SEO' ) . '
' . '
' . __( 'Note that not all variables can be used in every template.', 'wordpress-seo' ) . '
\n\t\t" . WPSEO_Replace_Vars::get_advanced_help_texts(),
)
);
}
/**
* Register the settings page for the Network settings.
*/
function register_network_settings_page() {
if ( WPSEO_Utils::grant_access() ) {
// Base 64 encoded SVG image.
$icon_svg = WPSEO_Utils::get_icon_svg();
add_menu_page( 'Yoast SEO: ' . __( 'MultiSite Settings', 'wordpress-seo' ), __( 'SEO', 'wordpress-seo' ), 'delete_users', self::PAGE_IDENTIFIER, array(
$this,
'network_config_page',
), $icon_svg );
if ( WPSEO_Utils::allow_system_file_edit() === true ) {
add_submenu_page( self::PAGE_IDENTIFIER, 'Yoast SEO: ' . __( 'Edit Files', 'wordpress-seo' ), __( 'Edit Files', 'wordpress-seo' ), 'delete_users', 'wpseo_files', array(
$this,
'load_page',
) );
}
// Add Extension submenu page.
add_submenu_page( self::PAGE_IDENTIFIER, 'Yoast SEO: ' . __( 'Extensions', 'wordpress-seo' ), __( 'Extensions', 'wordpress-seo' ), 'delete_users', 'wpseo_licenses', array(
$this,
'load_page',
) );
}
}
/**
* Load the form for a WPSEO admin page
*/
function load_page() {
$page = filter_input( INPUT_GET, 'page' );
switch ( $page ) {
case 'wpseo_advanced':
require_once( WPSEO_PATH . 'admin/pages/advanced.php' );
break;
case 'wpseo_tools':
require_once( WPSEO_PATH . 'admin/pages/tools.php' );
break;
case 'wpseo_titles':
require_once( WPSEO_PATH . 'admin/pages/metas.php' );
break;
case 'wpseo_social':
require_once( WPSEO_PATH . 'admin/pages/social.php' );
break;
case 'wpseo_xml':
require_once( WPSEO_PATH . 'admin/pages/xml-sitemaps.php' );
break;
case 'wpseo_licenses':
require_once( WPSEO_PATH . 'admin/pages/licenses.php' );
break;
case 'wpseo_files':
require_once( WPSEO_PATH . 'admin/views/tool-file-editor.php' );
break;
case 'wpseo_tutorial_videos':
require_once( WPSEO_PATH . 'admin/pages/tutorial-videos.php' );
break;
case self::PAGE_IDENTIFIER:
default:
require_once( WPSEO_PATH . 'admin/pages/dashboard.php' );
break;
}
}
/**
* Loads the form for the network configuration page.
*/
function network_config_page() {
require_once( WPSEO_PATH . 'admin/pages/network.php' );
}
/**
* Adds the ability to choose how many posts are displayed per page
* on the bulk edit pages.
*/
function bulk_edit_options() {
$option = 'per_page';
$args = array(
'label' => __( 'Posts', 'wordpress-seo' ),
'default' => 10,
'option' => 'wpseo_posts_per_page',
);
add_screen_option( $option, $args );
}
/**
* Saves the posts per page limit for bulk edit pages.
*
* @param int $status Status value to pass through.
* @param string $option Option name.
* @param int $value Count value to check.
*
* @return int
*/
function save_bulk_edit_options( $status, $option, $value ) {
if ( 'wpseo_posts_per_page' === $option && ( $value > 0 && $value < 1000 ) ) {
return $value;
}
return $status;
}
/**
* Add a link to the settings page to the plugins list
*
* @staticvar string $this_plugin holds the directory & filename for the plugin
*
* @param array $links array of links for the plugins, adapted when the current plugin is found.
* @param string $file the filename for the current plugin, which the filter loops through.
*
* @return array $links
*/
function add_action_link( $links, $file ) {
if ( WPSEO_BASENAME === $file && WPSEO_Utils::grant_access() ) {
$settings_link = '' . __( 'Settings', 'wordpress-seo' ) . '';
array_unshift( $links, $settings_link );
}
if ( class_exists( 'WPSEO_Product_Premium' ) ) {
$license_manager = new Yoast_Plugin_License_Manager( new WPSEO_Product_Premium() );
if ( $license_manager->license_is_valid() ) {
return $links;
}
}
// Add link to premium support landing page.
$premium_link = '' . __( 'Premium Support', 'wordpress-seo' ) . '';
array_unshift( $links, $premium_link );
// Add link to docs.
$faq_link = '' . __( 'FAQ', 'wordpress-seo' ) . '';
array_unshift( $links, $faq_link );
return $links;
}
/**
* Enqueues the (tiny) global JS needed for the plugin.
*/
function config_page_scripts() {
if ( WPSEO_Utils::grant_access() ) {
$asset_manager = new WPSEO_Admin_Asset_Manager();
$asset_manager->enqueue_script( 'admin-global-script' );
wp_localize_script( WPSEO_Admin_Asset_Manager::PREFIX . 'admin-global-script', 'wpseoAdminGlobalL10n', $this->localize_admin_global_script() );
}
}
/**
* Enqueues the (tiny) global stylesheet needed for the plugin.
*/
public function enqueue_global_style() {
$asset_manager = new WPSEO_Admin_Asset_Manager();
$asset_manager->enqueue_style( 'admin-global' );
}
/**
* Filter the $contactmethods array and add Facebook, Google+ and Twitter.
*
* These are used with the Facebook author, rel="author" and Twitter cards implementation.
*
* @param array $contactmethods currently set contactmethods.
*
* @return array $contactmethods with added contactmethods.
*/
public function update_contactmethods( $contactmethods ) {
// Add Google+.
$contactmethods['googleplus'] = __( 'Google+', 'wordpress-seo' );
// Add Twitter.
$contactmethods['twitter'] = __( 'Twitter username (without @)', 'wordpress-seo' );
// Add Facebook.
$contactmethods['facebook'] = __( 'Facebook profile URL', 'wordpress-seo' );
return $contactmethods;
}
/**
* Cleans stopwords out of the slug, if the slug hasn't been set yet.
*
* @since 1.1.7
*
* @param string $slug if this isn't empty, the function will return an unaltered slug.
*
* @return string $clean_slug cleaned slug
*/
function remove_stopwords_from_slug( $slug ) {
return $this->filter_stopwords_from_slug( $slug, filter_input( INPUT_POST, 'post_title' ) );
}
/**
* Filter the stopwords from the slug
*
* @param string $slug The current slug, if not empty there will be done nothing.
* @param string $post_title The title which will be used in case of an empty slug.
*
* @return string
*/
public function filter_stopwords_from_slug( $slug, $post_title ) {
// Don't change an existing slug.
if ( isset( $slug ) && $slug !== '' ) {
return $slug;
}
// When the post title is empty, just return the slug.
if ( empty( $post_title ) ) {
return $slug;
}
// Don't change the slug if this is a multisite installation and the site has been switched.
if ( is_multisite() && ms_is_switched() ) {
return $slug;
}
// Don't change slug if the post is a draft, this conflicts with polylang.
// Doesn't work with filter_input() since need current value, not originally submitted one.
if ( 'draft' === $_POST['post_status'] ) {
return $slug;
}
// Lowercase the slug and strip slashes.
$new_slug = sanitize_title( stripslashes( $post_title ) );
$stop_words = new WPSEO_Admin_Stop_Words();
return $stop_words->remove_in( $new_slug );
}
/**
* Returns the stopwords for the current language
*
* @since 1.1.7
* @deprecated 3.1 Use WPSEO_Admin_Stop_Words::list_stop_words() instead.
*
* @return array $stopwords array of stop words to check and / or remove from slug
*/
function stopwords() {
$stop_words = new WPSEO_Admin_Stop_Words();
return $stop_words->list_stop_words();
}
/**
* Check whether the stopword appears in the string
*
* @deprecated 3.1
*
* @param string $haystack The string to be checked for the stopword.
* @param bool $checkingUrl Whether or not we're checking a URL.
*
* @return bool|mixed
*/
function stopwords_check( $haystack, $checkingUrl = false ) {
$stopWords = $this->stopwords();
if ( is_array( $stopWords ) && $stopWords !== array() ) {
foreach ( $stopWords as $stopWord ) {
// If checking a URL remove the single quotes.
if ( $checkingUrl ) {
$stopWord = str_replace( "'", '', $stopWord );
}
// Check whether the stopword appears as a whole word.
// @todo [JRF => whomever] check whether the use of \b (=word boundary) would be more efficient ;-).
$res = preg_match( "`(^|[ \n\r\t\.,'\(\)\"\+;!?:])" . preg_quote( $stopWord, '`' ) . "($|[ \n\r\t\.,'\(\)\"\+;!?:])`iu", $haystack );
if ( $res > 0 ) {
return $stopWord;
}
}
}
return false;
}
/**
* Log the updated timestamp for user profiles when theme is changed
*/
function switch_theme() {
$users = get_users( array( 'who' => 'authors' ) );
if ( is_array( $users ) && $users !== array() ) {
foreach ( $users as $user ) {
update_user_meta( $user->ID, '_yoast_wpseo_profile_updated', time() );
}
}
}
/**
* Localization for the dismiss urls.
*
* @return array
*/
private function localize_admin_global_script() {
return array(
'dismiss_about_url' => $this->get_dismiss_url( 'wpseo-dismiss-about' ),
'dismiss_tagline_url' => $this->get_dismiss_url( 'wpseo-dismiss-tagline-notice' ),
'help_video_iframe_title' => __( 'Yoast SEO video tutorial', 'wordpress-seo' ),
);
}
/**
* Extending the current page URL with two params to be able to ignore the tour.
*
* @param string $dismiss_param The param used to dismiss the notification.
*
* @return string
*/
private function get_dismiss_url( $dismiss_param ) {
$arr_params = array(
$dismiss_param => '1',
'nonce' => wp_create_nonce( $dismiss_param ),
);
return esc_url( add_query_arg( $arr_params ) );
}
/**
* @return string
*/
private function get_premium_indicator() {
/**
* The class that will be applied to the premium indicator.
*
* @type array Classes that will be applied tot the premium indicator.
*/
$classes = apply_filters( 'wpseo_premium_indicator_classes', array(
'wpseo-premium-indicator',
'wpseo-premium-indicator--no',
'wpseo-js-premium-indicator',
'update-plugins',
) );
/**
* The text to put inside the premium indicator.
*
* @type string The text to read to screen readers.
*/
$text = apply_filters( 'wpseo_premium_indicator_text', __( 'Disabled', 'wordpress-seo' ) );
$premium_indicator = sprintf(
"%s",
esc_attr( implode( ' ', $classes ) ),
esc_html( $text )
);
return $premium_indicator;
}
/********************** DEPRECATED METHODS **********************/
/**
* Check whether the current user is allowed to access the configuration.
*
* @deprecated 1.5.0
* @deprecated use WPSEO_Utils::grant_access()
* @see WPSEO_Utils::grant_access()
*
* @return boolean
*/
function grant_access() {
_deprecated_function( __METHOD__, 'WPSEO 1.5.0', 'WPSEO_Utils::grant_access()' );
return WPSEO_Utils::grant_access();
}
/**
* Check whether the current user is allowed to access the configuration.
*
* @deprecated 1.5.0
* @deprecated use wpseo_do_upgrade()
* @see WPSEO_Upgrade
*/
function maybe_upgrade() {
_deprecated_function( __METHOD__, 'WPSEO 1.5.0', 'wpseo_do_upgrade' );
new WPSEO_Upgrade();
}
/**
* Clears the cache
*
* @deprecated 1.5.0
* @deprecated use WPSEO_Utils::clear_cache()
* @see WPSEO_Utils::clear_cache()
*/
function clear_cache() {
_deprecated_function( __METHOD__, 'WPSEO 1.5.0', 'WPSEO_Utils::clear_cache()' );
WPSEO_Utils::clear_cache();
}
/**
* Clear rewrites
*
* @deprecated 1.5.0
* @deprecated use WPSEO_Utils::clear_rewrites()
* @see WPSEO_Utils::clear_rewrites()
*/
function clear_rewrites() {
_deprecated_function( __METHOD__, 'WPSEO 1.5.0', 'WPSEO_Utils::clear_rewrites()' );
WPSEO_Utils::clear_rewrites();
}
/**
* Register all the options needed for the configuration pages.
*
* @deprecated 1.5.0
* @deprecated use WPSEO_Option::register_setting() on each individual option
* @see WPSEO_Option::register_setting()
*/
function options_init() {
_deprecated_function( __METHOD__, 'WPSEO 1.5.0', 'WPSEO_Option::register_setting()' );
}
/**
* Display an error message when the blog is set to private.
*
* @deprecated 3.3
*/
function blog_public_warning() {
return;
}
/**
* Display an error message when the theme contains a meta description tag.
*
* @since 1.4.14
*
* @deprecated 3.3
*/
function meta_description_warning() {
_deprecated_function( __FUNCTION__, 'WPSEO 3.3.0' );
}
}