<h2>File Contents: /home/planet5/public_html/wp-content/plugins/google-site-kit/includes/Core/Golinks/Golinks.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-content/plugins/google-site-kit/includes/Core/Golinks/Golinks.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Class Google\Site_Kit\Core\Golinks\Golinks
 *
 * @package   Google\Site_Kit\Core\Golinks
 * @copyright 2026 Google LLC
 * @license   https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
 * @link      https://sitekit.withgoogle.com
 */

namespace Google\Site_Kit\Core\Golinks;

use Google\Site_Kit\Context;
use Google\Site_Kit\Core\Permissions\Permissions;
use InvalidArgumentException;
use WP_Error;

/**
 * Class for handling Site Kit golinks.
 *
 * @since 1.174.0
 * @access private
 * @ignore
 */
class Golinks {

	/**
	 * Action name for handling golinks.
	 *
	 * @since 1.174.0
	 */
	const ACTION_GO = &#039;googlesitekit_go&#039;;

	/**
	 * Plugin context.
	 *
	 * @since 1.174.0
	 * @var Context
	 */
	private $context;

	/**
	 * Registered golink handlers keyed by golink key.
	 *
	 * @since 1.174.0
	 * @var array&lt;string, Golink_Handler_Interface&gt;
	 */
	private $handlers = array();

	/**
	 * Constructor.
	 *
	 * @since 1.174.0
	 *
	 * @param Context $context Plugin context.
	 */
	public function __construct( Context $context ) {
		$this-&gt;context = $context;
	}

	/**
	 * Registers functionality through WordPress hooks.
	 *
	 * @since 1.174.0
	 */
	public function register() {
		add_action( &#039;admin_action_&#039; . self::ACTION_GO, array( $this, &#039;handle_go&#039; ) );
	}

	/**
	 * Registers a handler for a golink key.
	 *
	 * @since 1.174.0
	 *
	 * @param string                   $key     Golink key.
	 * @param Golink_Handler_Interface $handler Handler instance.
	 * @throws InvalidArgumentException Thrown if a handler is already registered for the key.
	 */
	public function register_handler( string $key, Golink_Handler_Interface $handler ) {
		$key = sanitize_key( $key );

		if ( isset( $this-&gt;handlers[ $key ] ) ) {
			throw new InvalidArgumentException( sprintf( &#039;A handler is already registered for golink key &quot;%s&quot;.&#039;, esc_html( $key ) ) );
		}

		$this-&gt;handlers[ $key ] = $handler;
	}

	/**
	 * Gets a golink URL for a registered key.
	 *
	 * @since 1.174.0
	 *
	 * @param string $key Golink key.
	 * @return string|null Golink URL if registered, otherwise null.
	 */
	public function get_url( $key ) {
		$key = sanitize_key( (string) $key );

		return add_query_arg(
			array(
				&#039;action&#039; =&gt; self::ACTION_GO,
				&#039;to&#039;     =&gt; $key,
			),
			$this-&gt;get_action_url()
		);
	}

	/**
	 * Handles a golink redirect action.
	 *
	 * @since 1.174.0
	 */
	public function handle_go() {
		$key = sanitize_key( (string) $this-&gt;context-&gt;input()-&gt;filter( INPUT_GET, &#039;to&#039;, FILTER_DEFAULT ) );

		if ( empty( $this-&gt;handlers[ $key ] ) ) {
			$this-&gt;handle_destination_error( $this-&gt;get_invalid_golink_error() );
			exit;
		}

		$destination = $this-&gt;handlers[ $key ]-&gt;handle( $this-&gt;context );

		if ( is_wp_error( $destination ) ) {
			$this-&gt;handle_destination_error( $destination );
			exit;
		}

		wp_safe_redirect( $destination );
		exit;
	}

	/**
	 * Handles a handler error by displaying a wp_die screen.
	 *
	 * @since 1.174.0
	 *
	 * @param WP_Error $error Handler error.
	 */
	private function handle_destination_error( WP_Error $error ) {
		$status = 500;
		$data   = $error-&gt;get_error_data();
		$args   = array();

		if ( ! empty( $data[&#039;status&#039;] ) ) {
			$status = (int) $data[&#039;status&#039;];
		}

		if ( ! empty( $data[&#039;link_url&#039;] ) ) {
			$args[&#039;link_url&#039;] = esc_url_raw( $data[&#039;link_url&#039;] );
		}

		if ( ! empty( $data[&#039;link_text&#039;] ) ) {
			$args[&#039;link_text&#039;] = esc_html( $data[&#039;link_text&#039;] );
		}

		$args[&#039;response&#039;] = absint( $status );
		$message          = $error-&gt;get_error_message();

		if ( &#039;&#039; === $message ) {
			$message = __( &#039;Something went wrong.&#039;, &#039;google-site-kit&#039; );
		}

		wp_die( esc_html( $message ), &#039;&#039;, $args ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_die args are sanitized above.
	}

	/**
	 * Gets the URL used for handling golink actions.
	 *
	 * @since 1.174.0
	 *
	 * @return string Action URL.
	 */
	private function get_action_url() {
		if ( $this-&gt;context-&gt;is_network_mode() ) {
			return network_admin_url( &#039;index.php&#039; );
		}

		return admin_url( &#039;index.php&#039; );
	}

	/**
	 * Gets invalid golink error.
	 *
	 * @since 1.174.0
	 *
	 * @return WP_Error Invalid golink error.
	 */
	private function get_invalid_golink_error() {
		if ( current_user_can( Permissions::VIEW_DASHBOARD ) ) {
			$link_url  = $this-&gt;context-&gt;admin_url( &#039;dashboard&#039; );
			$link_text = __( &#039;Site Kit dashboard&#039;, &#039;google-site-kit&#039; );
		} else {
			$link_url  = $this-&gt;context-&gt;admin_url( &#039;splash&#039; );
			$link_text = __( &#039;Site Kit setup page&#039;, &#039;google-site-kit&#039; );
		}

		return new WP_Error(
			&#039;googlesitekit_invalid_golink&#039;,
			__( &#039;The link you followed is invalid.&#039;, &#039;google-site-kit&#039; ),
			array(
				&#039;status&#039;    =&gt; 404,
				&#039;link_url&#039;  =&gt; $link_url,
				&#039;link_text&#039; =&gt; $link_text,
			)
		);
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-content%2Fplugins%2Fgoogle-site-kit%2Fincludes%2FCore%2FGolinks'>⬅ Back to Directory</a>