Phase 5: Content and SEO - Yoast SEO, Schema.org markup, Open Graph, favicon support, XML sitemap

This commit is contained in:
Hanson.xyz Dev
2025-11-28 17:10:24 -06:00
parent c4f29a3152
commit 91de533da4
1552 changed files with 171432 additions and 7 deletions
@@ -0,0 +1,268 @@
<?php
namespace Yoast\WP\SEO\General\User_Interface;
use WPSEO_Admin_Asset_Manager;
use Yoast\WP\SEO\Actions\Alert_Dismissal_Action;
use Yoast\WP\SEO\Conditionals\Admin\Non_Network_Admin_Conditional;
use Yoast\WP\SEO\Conditionals\Admin_Conditional;
use Yoast\WP\SEO\Conditionals\WooCommerce_Conditional;
use Yoast\WP\SEO\Dashboard\Application\Configuration\Dashboard_Configuration;
use Yoast\WP\SEO\Helpers\Current_Page_Helper;
use Yoast\WP\SEO\Helpers\Notification_Helper;
use Yoast\WP\SEO\Helpers\Options_Helper;
use Yoast\WP\SEO\Helpers\Product_Helper;
use Yoast\WP\SEO\Helpers\Short_Link_Helper;
use Yoast\WP\SEO\Helpers\User_Helper;
use Yoast\WP\SEO\Integrations\Integration_Interface;
use Yoast\WP\SEO\Promotions\Application\Promotion_Manager;
/**
* Class General_Page_Integration.
*/
class General_Page_Integration implements Integration_Interface {
/**
* The page name.
*/
public const PAGE = 'wpseo_dashboard';
/**
* The notification helper.
*
* @var Notification_Helper
*/
protected $notification_helper;
/**
* The dashboard configuration.
*
* @var Dashboard_Configuration
*/
private $dashboard_configuration;
/**
* Holds the WPSEO_Admin_Asset_Manager.
*
* @var WPSEO_Admin_Asset_Manager
*/
private $asset_manager;
/**
* Holds the Current_Page_Helper.
*
* @var Current_Page_Helper
*/
private $current_page_helper;
/**
* Holds the Product_Helper.
*
* @var Product_Helper
*/
private $product_helper;
/**
* Holds the Short_Link_Helper.
*
* @var Short_Link_Helper
*/
private $shortlink_helper;
/**
* The promotion manager.
*
* @var Promotion_Manager
*/
private $promotion_manager;
/**
* The alert dismissal action.
*
* @var Alert_Dismissal_Action
*/
private $alert_dismissal_action;
/**
* Holds the user helper.
*
* @var User_Helper
*/
private $user_helper;
/**
* Holds the options helper.
*
* @var Options_Helper
*/
private $options_helper;
/**
* Holds the WooCommerce conditional.
*
* @var WooCommerce_Conditional
*/
private $woocommerce_conditional;
/**
* Constructs Academy_Integration.
*
* @param WPSEO_Admin_Asset_Manager $asset_manager The WPSEO_Admin_Asset_Manager.
* @param Current_Page_Helper $current_page_helper The Current_Page_Helper.
* @param Product_Helper $product_helper The Product_Helper.
* @param Short_Link_Helper $shortlink_helper The Short_Link_Helper.
* @param Notification_Helper $notification_helper The Notification_Helper.
* @param Alert_Dismissal_Action $alert_dismissal_action The alert dismissal action.
* @param Promotion_Manager $promotion_manager The promotion manager.
* @param Dashboard_Configuration $dashboard_configuration The dashboard configuration.
* @param User_Helper $user_helper The user helper.
* @param Options_Helper $options_helper The options helper.
* @param WooCommerce_Conditional $woocommerce_conditional The WooCommerce conditional.
*/
public function __construct(
WPSEO_Admin_Asset_Manager $asset_manager,
Current_Page_Helper $current_page_helper,
Product_Helper $product_helper,
Short_Link_Helper $shortlink_helper,
Notification_Helper $notification_helper,
Alert_Dismissal_Action $alert_dismissal_action,
Promotion_Manager $promotion_manager,
Dashboard_Configuration $dashboard_configuration,
User_Helper $user_helper,
Options_Helper $options_helper,
WooCommerce_Conditional $woocommerce_conditional
) {
$this->asset_manager = $asset_manager;
$this->current_page_helper = $current_page_helper;
$this->product_helper = $product_helper;
$this->shortlink_helper = $shortlink_helper;
$this->notification_helper = $notification_helper;
$this->alert_dismissal_action = $alert_dismissal_action;
$this->promotion_manager = $promotion_manager;
$this->dashboard_configuration = $dashboard_configuration;
$this->user_helper = $user_helper;
$this->options_helper = $options_helper;
$this->woocommerce_conditional = $woocommerce_conditional;
}
/**
* Returns the conditionals based on which this loadable should be active.
*
* @return array<string>
*/
public static function get_conditionals() {
return [ Admin_Conditional::class, Non_Network_Admin_Conditional::class ];
}
/**
* Initializes the integration.
*
* This is the place to register hooks and filters.
*
* @return void
*/
public function register_hooks() {
// Add page.
\add_filter( 'wpseo_submenu_pages', [ $this, 'add_page' ] );
// Are we on the dashboard page?
if ( $this->current_page_helper->get_current_yoast_seo_page() === self::PAGE ) {
\add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
}
}
/**
* Adds the page.
*
* @param array<string, array<string>> $pages The pages.
*
* @return array<string, array<string>> The pages.
*/
public function add_page( $pages ) {
\array_splice(
$pages,
0,
0,
[
[
self::PAGE,
'',
\__( 'General', 'wordpress-seo' ),
'wpseo_manage_options',
self::PAGE,
[ $this, 'display_page' ],
],
]
);
return $pages;
}
/**
* Displays the page.
*
* @return void
*/
public function display_page() {
echo '<div id="yoast-seo-general"></div>';
}
/**
* Enqueues the assets.
*
* @return void
*/
public function enqueue_assets() {
// Remove the emoji script as it is incompatible with both React and any contenteditable fields.
\remove_action( 'admin_print_scripts', 'print_emoji_detection_script' );
\wp_enqueue_media();
$this->asset_manager->enqueue_script( 'general-page' );
$this->asset_manager->enqueue_style( 'general-page' );
if ( $this->promotion_manager->is( 'black-friday-promotion' ) ) {
$this->asset_manager->enqueue_style( 'black-friday-banner' );
}
$this->asset_manager->localize_script( 'general-page', 'wpseoScriptData', $this->get_script_data() );
}
/**
* Creates the script data.
*
* @return array The script data.
*/
private function get_script_data() {
return [
'preferences' => [
'isPremium' => $this->product_helper->is_premium(),
'isRtl' => \is_rtl(),
'pluginUrl' => \plugins_url( '', \WPSEO_FILE ),
'upsellSettings' => [
'actionId' => 'load-nfd-ctb',
'premiumCtbId' => 'f6a84663-465f-4cb5-8ba5-f7a6d72224b2',
],
'llmTxtEnabled' => $this->options_helper->get( 'enable_llms_txt', true ),
'isWooCommerceActive' => $this->woocommerce_conditional->is_met(),
],
'adminUrl' => \admin_url( 'admin.php' ),
'linkParams' => $this->shortlink_helper->get_query_params(),
'userEditUrl' => \add_query_arg( 'user_id', '{user_id}', \admin_url( 'user-edit.php' ) ),
'alerts' => $this->notification_helper->get_alerts(),
'currentPromotions' => $this->promotion_manager->get_current_promotions(),
'dismissedAlerts' => $this->alert_dismissal_action->all_dismissed(),
'dashboard' => $this->dashboard_configuration->get_configuration(),
'optInNotificationSeen' => [
'wpseo_seen_llm_txt_opt_in_notification' => $this->is_llms_txt_opt_in_notification_seen(),
],
];
}
/**
* Gets if the llms.txt opt-in notification has been seen.
*
* @return bool True if the notification has been seen, false otherwise.
*/
private function is_llms_txt_opt_in_notification_seen(): bool {
$current_user_id = $this->user_helper->get_current_user_id();
return (bool) $this->user_helper->get_meta( $current_user_id, 'wpseo_seen_llm_txt_opt_in_notification', true );
}
}
@@ -0,0 +1,138 @@
<?php
namespace Yoast\WP\SEO\General\User_Interface;
use WP_REST_Request;
use WP_REST_Response;
use Yoast\WP\SEO\Conditionals\User_Can_Manage_Wpseo_Options_Conditional;
use Yoast\WP\SEO\Helpers\Capability_Helper;
use Yoast\WP\SEO\Helpers\User_Helper;
use Yoast\WP\SEO\Main;
use Yoast\WP\SEO\Routes\Route_Interface;
/**
* Registers a route to get dismiss opt in notification.
*/
class Opt_In_Route implements Route_Interface {
/**
* The namespace for this route.
*
* @var string
*/
public const ROUTE_NAMESPACE = Main::API_V1_NAMESPACE;
/**
* The prefix for this route.
*
* @var string
*/
public const SEEN_ROUTE = '/seen-opt-in-notification';
/**
* Holds the user helper.
*
* @var User_Helper
*/
private $user_helper;
/**
* Holds the capability helper instance.
*
* @var Capability_Helper
*/
private $capability_helper;
/**
* Returns the conditionals based on which this integration should be active.
*
* @return array<User_Can_Manage_Wpseo_Options_Conditional> The array of conditionals.
*/
public static function get_conditionals() {
return [
User_Can_Manage_Wpseo_Options_Conditional::class,
];
}
/**
* Constructs Opt_In_Route.
*
* @param User_Helper $user_helper The user helper.
* @param Capability_Helper $capability_helper The capability helper.
*/
public function __construct( User_Helper $user_helper, Capability_Helper $capability_helper ) {
$this->user_helper = $user_helper;
$this->capability_helper = $capability_helper;
}
/**
* Registers routes with WordPress.
*
* @return void
*/
public function register_routes() {
$opt_in_seen_route_args = [
'methods' => 'POST',
'callback' => [ $this, 'set_opt_in_seen' ],
'permission_callback' => [ $this, 'can_see_opt_in' ],
'args' => [
'key' => [
'required' => true,
'type' => 'string',
'sanitize_callback' => 'sanitize_text_field',
'validate_callback' => [ $this, 'validate_key' ],
],
],
];
\register_rest_route( Main::API_V1_NAMESPACE, self::SEEN_ROUTE, $opt_in_seen_route_args );
}
/**
* Sets the opt-in notification as seen.
*
* @param WP_REST_Request $request The request. This request should have a key param set.
*
* @return WP_REST_Response The response.
*/
public function set_opt_in_seen( $request ) {
$key = $request->get_param( 'key' );
$current_user_id = $this->user_helper->get_current_user_id();
$result = $this->user_helper->update_meta( $current_user_id, $key, true );
$success = $result !== false;
$status = ( $success ) ? 200 : 400;
return new WP_REST_Response(
(object) [
'success' => $success,
'status' => $status,
],
$status
);
}
/**
* Whether or not the current user is allowed to see the opt-in notification.
*
* @return bool Whether or not the current user is allowed to see the opt-in notification.
*/
public function can_see_opt_in() {
return $this->capability_helper->current_user_can( 'wpseo_manage_options' );
}
/**
* Validates the key parameter.
*
* @param string $key The key to validate.
*
* @return bool Whether the key is valid.
*/
public function validate_key( $key ) {
$allowed_keys = [
'wpseo_seen_llm_txt_opt_in_notification',
];
return \in_array( $key, $allowed_keys, true );
}
}