274 lines
10 KiB
PHP
274 lines
10 KiB
PHP
<?php
|
|
/**
|
|
* WPSEO plugin file.
|
|
*
|
|
* @package WPSEO\Admin
|
|
*/
|
|
|
|
/**
|
|
* Class WPSEO_Help_Center
|
|
*/
|
|
class WPSEO_Help_Center {
|
|
|
|
/**
|
|
* The tabs in the help center.
|
|
*
|
|
* @var WPSEO_Option_Tab[] $tab
|
|
*/
|
|
private $tabs;
|
|
|
|
/**
|
|
* Mount point in the HTML.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $identifier = 'yoast-help-center-container';
|
|
|
|
/**
|
|
* Additional help center items.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $help_center_items = array();
|
|
|
|
/**
|
|
* Show premium support tab.
|
|
*
|
|
* @var bool
|
|
*/
|
|
protected $premium_support;
|
|
|
|
/**
|
|
* WPSEO_Help_Center constructor.
|
|
*
|
|
* @param string $unused Backwards compatible argument.
|
|
* @param WPSEO_Option_Tabs|WPSEO_Option_Tab $option_tabs Currently displayed tabs.
|
|
* @param boolean $premium_support Show premium support tab.
|
|
*/
|
|
public function __construct( $unused, $option_tabs, $premium_support = false ) {
|
|
$this->premium_support = $premium_support;
|
|
|
|
$tabs = new WPSEO_Option_Tabs( '' );
|
|
|
|
if ( $option_tabs instanceof WPSEO_Option_Tabs ) {
|
|
$tabs = $option_tabs;
|
|
}
|
|
|
|
if ( $option_tabs instanceof WPSEO_Option_Tab ) {
|
|
$tabs = new WPSEO_Option_Tabs( '', $option_tabs->get_name() );
|
|
$tabs->add_tab( $option_tabs );
|
|
}
|
|
|
|
$this->tabs = $tabs;
|
|
}
|
|
|
|
/**
|
|
* Localize data required by the help center component.
|
|
*/
|
|
public function localize_data() {
|
|
$this->add_contact_support_item();
|
|
$this->enqueue_localized_data( $this->format_data( $this->tabs->get_tabs() ) );
|
|
}
|
|
|
|
/**
|
|
* Format the required data for localized script.
|
|
*
|
|
* @param WPSEO_Option_Tab[] $tabs Yoast admin pages navigational tabs.
|
|
*
|
|
* @return array Associative array containing data for help center component.
|
|
*/
|
|
protected function format_data( array $tabs ) {
|
|
$formatted_data = array( 'tabs' => array() );
|
|
|
|
foreach ( $tabs as $tab ) {
|
|
$formatted_data['tabs'][ $tab->get_name() ] = array(
|
|
'label' => $tab->get_label(),
|
|
'videoUrl' => $tab->get_video_url(),
|
|
'id' => $tab->get_name(),
|
|
);
|
|
}
|
|
|
|
$active_tab = $this->tabs->get_active_tab();
|
|
$active_tab = ( null === $active_tab ) ? $tabs[0] : $active_tab;
|
|
|
|
$formatted_data['mountId'] = $this->identifier;
|
|
$formatted_data['initialTab'] = $active_tab->get_name();
|
|
|
|
$is_premium = WPSEO_Utils::is_yoast_seo_premium();
|
|
|
|
// Will translate to either empty string or "1" in localised script.
|
|
$formatted_data['isPremium'] = $is_premium;
|
|
$formatted_data['pluginVersion'] = WPSEO_VERSION;
|
|
|
|
// Open HelpScout on activating this tab ID.
|
|
$formatted_data['shouldDisplayContactForm'] = $this->premium_support;
|
|
|
|
$formatted_data['translations'] = self::get_translated_texts();
|
|
|
|
$formatted_data['videoDescriptions'] = array();
|
|
|
|
if ( $is_premium === false ) {
|
|
$formatted_data['videoDescriptions'][] = array(
|
|
'title' => __( 'Need some help?', 'wordpress-seo' ),
|
|
'description' => __( 'Go Premium and our experts will be there for you to answer any questions you might have about the setup and use of the plugin.', 'wordpress-seo' ),
|
|
'link' => WPSEO_Shortlinker::get( 'https://yoa.st/seo-premium-vt' ),
|
|
'linkText' => __( 'Get Yoast SEO Premium now »', 'wordpress-seo' ),
|
|
);
|
|
|
|
$formatted_data['videoDescriptions'][] = array(
|
|
'title' => __( 'Want to be a Yoast SEO Expert?', 'wordpress-seo' ),
|
|
'description' => __( 'Follow our Yoast SEO for WordPress training and become a certified Yoast SEO Expert!', 'wordpress-seo' ),
|
|
'link' => WPSEO_Shortlinker::get( 'https://yoa.st/wordpress-training-vt' ),
|
|
'linkText' => __( 'Enroll in the Yoast SEO for WordPress training »', 'wordpress-seo' ),
|
|
);
|
|
}
|
|
|
|
$formatted_data['contactSupportParagraphs'] = array(
|
|
array(
|
|
'image' => array(
|
|
'src' => esc_url( plugin_dir_url( WPSEO_FILE ) . 'images/support-team.svg' ),
|
|
'width' => 100,
|
|
'height' => 100,
|
|
'alt' => '',
|
|
),
|
|
'content' => null,
|
|
),
|
|
array(
|
|
'image' => null,
|
|
'content' => __( 'If you have a problem that you can\'t solve with our video tutorials or knowledge base, you can send a message to our support team. They can be reached 24/7.', 'wordpress-seo' ),
|
|
),
|
|
array(
|
|
'image' => null,
|
|
'content' => __( 'Support requests you create here are sent directly into our support system, which is secured with 256 bit SSL, so communication is 100% secure.', 'wordpress-seo' ),
|
|
),
|
|
);
|
|
|
|
$formatted_data['extraTabs'] = $this->get_extra_tabs();
|
|
|
|
return $formatted_data;
|
|
}
|
|
|
|
/**
|
|
* Get additional tabs for the help center component.
|
|
*
|
|
* @return array Additional help center tabs.
|
|
*/
|
|
protected function get_extra_tabs() {
|
|
$help_center_items = apply_filters( 'wpseo_help_center_items', $this->help_center_items );
|
|
|
|
return array_map( array( $this, 'format_helpcenter_tab' ), $help_center_items );
|
|
}
|
|
|
|
/**
|
|
* Convert WPSEO_Help_Center_Item into help center format.
|
|
*
|
|
* @param WPSEO_Help_Center_Item $item The item to convert.
|
|
*
|
|
* @return array Formatted item.
|
|
*/
|
|
protected function format_helpcenter_tab( WPSEO_Help_Center_Item $item ) {
|
|
return array(
|
|
'identifier' => $item->get_identifier(),
|
|
'label' => $item->get_label(),
|
|
'content' => $item->get_content(),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Enqueue localized script for help center component.
|
|
*
|
|
* @param array $data Data to localize.
|
|
*/
|
|
protected function enqueue_localized_data( $data ) {
|
|
wp_localize_script( WPSEO_Admin_Asset_Manager::PREFIX . 'help-center', 'wpseoHelpCenterData', $data );
|
|
|
|
$yoast_components_l10n = new WPSEO_Admin_Asset_Yoast_Components_L10n();
|
|
$yoast_components_l10n->localize_script( WPSEO_Admin_Asset_Manager::PREFIX . 'help-center' );
|
|
}
|
|
|
|
/**
|
|
* Outputs the help center div.
|
|
*/
|
|
public function mount() {
|
|
echo '<div id="' . esc_attr( $this->identifier ) . '">' . esc_html__( 'Loading help center.', 'wordpress-seo' ) . '</div>';
|
|
}
|
|
|
|
/**
|
|
* Add the contact support help center item to the help center.
|
|
*/
|
|
private function add_contact_support_item() {
|
|
/* translators: %s: expands to 'Yoast SEO Premium'. */
|
|
$popup_title = sprintf( __( 'Email support is a %s feature', 'wordpress-seo' ), 'Yoast SEO Premium' );
|
|
$popup_content = '<p class="yoast-measure">' . __( 'Go Premium and our experts will be there for you to answer any questions you might have about the setup and use of the plugin.', 'wordpress-seo' ) . '</p>';
|
|
/* translators: %1$s: expands to 'Yoast SEO Premium'. */
|
|
$popup_content .= '<p>' . sprintf( __( 'Other benefits of %1$s for you:', 'wordpress-seo' ), 'Yoast SEO Premium' ) . '</p>';
|
|
$popup_content .= '<ul class="wpseo-premium-advantages-list">';
|
|
$popup_content .= '<li>' . sprintf(
|
|
// We don't use strong text here, but we do use it in the "Add keyword" popup, this is just to have the same translatable strings.
|
|
/* translators: %1$s expands to a 'strong' start tag, %2$s to a 'strong' end tag. */
|
|
__( '%1$sNo more dead links%2$s: easy redirect manager', 'wordpress-seo' ),
|
|
'',
|
|
''
|
|
) . '</li>';
|
|
$popup_content .= '<li>' . __( 'Superfast internal links suggestions', 'wordpress-seo' ) . '</li>';
|
|
$popup_content .= '<li>' . sprintf(
|
|
// We don't use strong text here, but we do use it in the "Add keyword" popup, this is just to have the same translatable strings.
|
|
/* translators: %1$s expands to a 'strong' start tag, %2$s to a 'strong' end tag. */
|
|
__( '%1$sSocial media preview%2$s: Facebook & Twitter', 'wordpress-seo' ),
|
|
'',
|
|
''
|
|
) . '</li>';
|
|
$popup_content .= '<li>' . __( '24/7 support', 'wordpress-seo' ) . '</li>';
|
|
$popup_content .= '<li>' . __( 'No ads!', 'wordpress-seo' ) . '</li>';
|
|
$popup_content .= '</ul>';
|
|
|
|
$premium_popup = new WPSEO_Premium_Popup( 'contact-support', 'h2', $popup_title, $popup_content, WPSEO_Shortlinker::get( 'https://yoa.st/contact-support' ) );
|
|
$contact_support_help_center_item = new WPSEO_Help_Center_Item(
|
|
'contact-support',
|
|
__( 'Get support', 'wordpress-seo' ),
|
|
array( 'content' => $premium_popup->get_premium_message( false ) ),
|
|
'dashicons-email-alt'
|
|
);
|
|
|
|
$this->help_center_items[] = $contact_support_help_center_item;
|
|
}
|
|
|
|
/**
|
|
* Pass text variables to js for the help center JS module.
|
|
*
|
|
* %s is replaced with <code>%s</code> and replaced again in the javascript with the actual variable.
|
|
*
|
|
* @return array Translated text strings for the help center.
|
|
*/
|
|
public static function get_translated_texts() {
|
|
// Esc_html is not needed because React already handles HTML in the (translations of) these strings.
|
|
return array(
|
|
'locale' => WPSEO_Language_Utils::get_user_locale(),
|
|
'videoTutorial' => __( 'Video tutorial', 'wordpress-seo' ),
|
|
'knowledgeBase' => __( 'Knowledge base', 'wordpress-seo' ),
|
|
'getSupport' => __( 'Get support', 'wordpress-seo' ),
|
|
'algoliaSearcher.loadingPlaceholder' => __( 'Loading...', 'wordpress-seo' ),
|
|
'algoliaSearcher.errorMessage' => __( 'Something went wrong. Please try again later.', 'wordpress-seo' ),
|
|
'searchBar.headingText' => __( 'Search the Yoast Knowledge Base for answers to your questions:', 'wordpress-seo' ),
|
|
'searchBar.placeholderText' => __( 'Type here to search...', 'wordpress-seo' ),
|
|
'searchBar.buttonText' => __( 'Search', 'wordpress-seo' ),
|
|
'searchResultDetail.openButton' => __( 'View in KB', 'wordpress-seo' ),
|
|
'searchResultDetail.openButtonLabel' => __( 'Open the knowledge base article in a new window or read it in the iframe below', 'wordpress-seo' ),
|
|
'searchResultDetail.backButton' => __( 'Go back', 'wordpress-seo' ),
|
|
'searchResultDetail.backButtonLabel' => __( 'Go back to the search results', 'wordpress-seo' ),
|
|
'searchResultDetail.iframeTitle' => __( 'Knowledge base article', 'wordpress-seo' ),
|
|
'searchResultDetail.searchResult' => __( 'Search result', 'wordpress-seo' ),
|
|
'searchResult.noResultsText' => __( 'No results found.', 'wordpress-seo' ),
|
|
'searchResult.foundResultsText' => sprintf(
|
|
/* translators: %s expands to the number of results found . */
|
|
__( 'Number of results found: %s', 'wordpress-seo' ),
|
|
'{ resultsCount }'
|
|
),
|
|
'searchResult.searchResultsHeading' => __( 'Search results', 'wordpress-seo' ),
|
|
'a11yNotice.opensInNewTab' => __( '(Opens in a new browser tab)', 'wordpress-seo' ),
|
|
'contactSupport.button' => __( 'New support request', 'wordpress-seo' ),
|
|
'helpCenter.buttonText' => __( 'Need help?', 'wordpress-seo' ),
|
|
);
|
|
}
|
|
}
|