*/ namespace RankMath\Abilities\Settings; defined( 'ABSPATH' ) || exit; /** * Registers and executes the rank-math/set-link-settings ability. */ class Set_Link_Settings extends Abstract_Ability { /** * Constructor. * * @param string $category Ability category slug. * @param array $shared_meta Shared meta args. */ public function __construct( string $category, array $shared_meta ) { parent::__construct( $category, $shared_meta, 'rank_math_general' ); } /** * Register the ability with the WordPress Abilities API. * * @return void */ public function register(): void { \wp_register_ability( 'rank-math/set-link-settings', [ 'category' => $this->category, 'label' => esc_html__( 'Set link settings', 'seo-by-rank-math' ), 'description' => esc_html__( 'Updates site-wide link behavior: nofollow for external and image links, opening external links in a new tab, nofollow domain allow/exclude lists, category base stripping, and attachment page redirects. All fields are optional — omitted fields keep their current stored value.', 'seo-by-rank-math' ), 'input_schema' => [ 'type' => 'object', 'default' => [], 'properties' => [ 'nofollow_external_links' => [ 'type' => 'boolean', 'title' => esc_html__( 'Nofollow External Links', 'seo-by-rank-math' ), 'description' => esc_html__( 'Automatically add rel="nofollow" to external links in content.', 'seo-by-rank-math' ), ], 'new_window_external_links' => [ 'type' => 'boolean', 'title' => esc_html__( 'Open External Links in New Tab/Window', 'seo-by-rank-math' ), 'description' => esc_html__( 'Automatically add target="_blank" to external links in content.', 'seo-by-rank-math' ), ], 'nofollow_image_links' => [ 'type' => 'boolean', 'title' => esc_html__( 'Nofollow Image File Links', 'seo-by-rank-math' ), 'description' => esc_html__( 'Automatically add rel="nofollow" to links pointing to external image files.', 'seo-by-rank-math' ), ], 'nofollow_domains' => [ 'type' => 'string', 'title' => esc_html__( 'Nofollow Domains', 'seo-by-rank-math' ), 'description' => esc_html__( 'Newline-separated list of domains to nofollow. If empty, nofollow applies to all external domains (when enabled). Only takes effect when nofollow_external_links or nofollow_image_links is also enabled — hidden in the UI otherwise.', 'seo-by-rank-math' ), ], 'nofollow_exclude_domains' => [ 'type' => 'string', 'title' => esc_html__( 'Nofollow Exclude Domains', 'seo-by-rank-math' ), 'description' => esc_html__( 'Newline-separated list of domains to exclude from nofollow. Only takes effect when nofollow_external_links or nofollow_image_links is also enabled — hidden in the UI otherwise.', 'seo-by-rank-math' ), ], 'strip_category_base' => [ 'type' => 'boolean', 'title' => esc_html__( 'Strip Category Base', 'seo-by-rank-math' ), 'description' => esc_html__( 'Remove /category/ from category archive URLs.', 'seo-by-rank-math' ), ], 'attachment_redirect_urls' => [ 'type' => 'boolean', 'title' => esc_html__( 'Redirect Attachments', 'seo-by-rank-math' ), 'description' => esc_html__( 'Redirect attachment page URLs to the post they appear in.', 'seo-by-rank-math' ), ], ], 'additionalProperties' => false, ], 'output_schema' => $this->write_success_schema(), 'permission_callback' => [ $this, 'check_permissions' ], 'execute_callback' => [ $this, 'execute' ], 'meta' => $this->build_meta( false ), ] ); } /** * Execute the ability. * * @param array $input Ability input arguments. * @return array */ public function execute( array $input = [] ): array { $general = $this->get_general_option(); $this->apply_toggle_fields( $general, $input, [ 'nofollow_external_links', 'new_window_external_links', 'nofollow_image_links', 'strip_category_base', 'attachment_redirect_urls', ] ); foreach ( [ 'nofollow_domains', 'nofollow_exclude_domains' ] as $field ) { if ( isset( $input[ $field ] ) ) { $general[ $field ] = sanitize_textarea_field( $input[ $field ] ); } } $this->save_and_reset( $general, null, null ); $keys = array_keys( $input ); rank_math()->tracking->track_ability_executed( 'Link Settings Updated', [ 'fields_updated' => $keys ], 'rank_math_general' ); return [ 'saved' => true, 'updated' => $keys, ]; } }