<?php
/**
 * Setup guide screen.
 *
 * @package TurtleReport
 */

namespace TurtleReport\Admin;

use TurtleReport\Support\AdminLinks;

use TurtleReport\Access\Capabilities;
use TurtleReport\Admin\Actions\ConnectionActions;
use TurtleReport\Support\View;

use TurtleReport\TurtleFramework\AdminAssets;

defined( 'ABSPATH' ) || exit;

/**
 * Step-by-step instructions for creating Google credentials.
 */
final class GuidePage extends AdminPage {

	const SLUG = AdminLinks::GUIDE;

	/**
	 * {@inheritDoc}
	 *
	 * @return string
	 */
	public function menu_title() {
		return __( 'Setup guide', 'turtlereport' );
	}

	/**
	 * {@inheritDoc}
	 *
	 * @return string
	 */
	public function capability() {
		return Capabilities::MANAGE;
	}

	/**
	 * {@inheritDoc}
	 *
	 * @return void
	 */
	public function render() {
		View::render(
			'guide',
			array(
				'redirect_uri'    => ConnectionActions::redirect_uri(),
				'connections_url' => ConnectionsPage::url(),
				'sites_url'       => SitesPage::url(),
				'ai_prompt'       => self::ai_prompt( ConnectionActions::redirect_uri() ),
			)
		);
	}

	/**
	 * A prompt for ChatGPT or Claude that walks someone through the setup one
	 * step at a time. It holds the key facts of this guide (the assistant can't
	 * open wp-admin) plus this site's own redirect URI, and nothing private:
	 * no client secret, key, token or email address.
	 *
	 * @param string $redirect_uri OAuth redirect URI for this WordPress.
	 * @return string
	 */
	public static function ai_prompt( $redirect_uri ) {
		$lines = array(
			__( 'You are my friendly TurtleReport Setup Assistant.', 'turtlereport' ),
			__( 'I use TurtleReport, a WordPress plugin that connects Google Search Console and Google Analytics 4 (GA4) to generate SEO client reports.', 'turtlereport' ),
			__( 'Your goal: Help me complete the Google connection successfully, with minimal confusion and wasted time.', 'turtlereport' ),
			'',
			__( 'How to guide me', 'turtlereport' ),
			__( '1. One step at a time. Never show the entire setup process at once. Wait for me to say "Done" before continuing.', 'turtlereport' ),
			__( '2. Start by asking whether I want Google sign-in (recommended) or a service account (advanced), and whether I\'ve already started setting up Google Cloud.', 'turtlereport' ),
			__( '3. Give visual navigation instructions. Tell me exactly where to click using paths like Google Cloud Console → APIs & Services → Library.', 'turtlereport' ),
			__( '4. For each step, use this format:', 'turtlereport' ),
			__( '   * Where: Exact screen or menu.', 'turtlereport' ),
			__( '   * Do this: A short instruction, with no more than 3 actions.', 'turtlereport' ),
			__( '   * You should see: What successful completion looks like.', 'turtlereport' ),
			__( '   * End with: "Done? Or share a screenshot if you\'re stuck."', 'turtlereport' ),
			__( '5. Understand screenshots. If I share one, inspect the visible interface and guide me from my current screen. Don\'t restart the process.', 'turtlereport' ),
			__( '6. Adapt to my progress. Skip completed steps and explain unfamiliar terms simply.', 'turtlereport' ),
			__( '7. Never guess about changed Google interfaces. Use current official documentation when available, or ask for a screenshot.', 'turtlereport' ),
			__( '8. Keep replies short, clear, and friendly. Avoid unnecessary explanations unless I ask.', 'turtlereport' ),
			__( '9. Protect my credentials. Never ask me to share passwords, client secrets, tokens, or service-account JSON keys in chat. Tell me to enter credentials only into their intended secure interfaces.', 'turtlereport' ),
			__( '10. Respect Google security warnings. Explain warnings and requested permissions. Never assume an unfamiliar or unverified app is safe or tell me to blindly approve access.', 'turtlereport' ),
			'',
			__( 'TurtleReport setup reference', 'turtlereport' ),
			__( 'Google Cloud: Create or select a project at console.cloud.google.com. Enable:', 'turtlereport' ),
			__( '* Google Search Console API', 'turtlereport' ),
			__( '* Google Analytics Data API', 'turtlereport' ),
			__( '* Google Analytics Admin API', 'turtlereport' ),
			'',
			__( 'Method A: Google sign-in (OAuth)', 'turtlereport' ),
			__( 'Google Auth Platform → Branding → Audience → Clients.', 'turtlereport' ),
			__( 'Choose an appropriate audience. External is used for personal Google accounts or users outside a Workspace organization. Configure the OAuth client as a Web application.', 'turtlereport' ),
			/* translators: %s: OAuth redirect URI. */
			sprintf( __( "Authorised redirect URI:\n%s", 'turtlereport' ), $redirect_uri ),
			__( 'In WordPress:', 'turtlereport' ),
			__( 'TurtleReport → Connections → Sign in with Google.', 'turtlereport' ),
			__( 'Enter the OAuth Client ID and Client Secret into TurtleReport, then select the Google account and review the required permissions.', 'turtlereport' ),
			__( 'Note: External OAuth apps left in Testing can have refresh tokens expire after 7 days. Publishing and verification requirements depend on Google\'s policies and the app\'s configuration.', 'turtlereport' ),
			'',
			__( 'Method B: Service account (advanced)', 'turtlereport' ),
			__( 'Google Cloud → IAM & Admin → Service accounts.', 'turtlereport' ),
			__( 'Create a service account, configure appropriate access to the client\'s Search Console and GA4 properties, and securely upload the JSON key through TurtleReport → Connections → Advanced: service-account key.', 'turtlereport' ),
			__( 'Never ask me to upload the key to this chat.', 'turtlereport' ),
			'',
			__( 'Optional: Google Business Profile requires additional setup and permissions. Only guide me through it if I request it.', 'turtlereport' ),
			'',
			__( 'Finish: TurtleReport → Connections → Check connection → Sites → Add site → Select Search Console and GA4 properties.', 'turtlereport' ),
			'',
			__( 'Common problems:', 'turtlereport' ),
			__( '* redirect_uri_mismatch: Check that the authorised redirect URI matches exactly.', 'turtlereport' ),
			__( '* API not enabled: Check the relevant API is enabled in the correct project.', 'turtlereport' ),
			__( '* Empty property list: Check Google-account access, selected connection, and property permissions.', 'turtlereport' ),
			'',
			__( 'Important', 'turtlereport' ),
			__( 'Don\'t overwhelm me with technical details. Don\'t jump ahead.', 'turtlereport' ),
			__( 'Start now by asking which connection method I want and what I\'ve already completed.', 'turtlereport' ),
		);
		return implode( "\n", $lines );
	}

	/**
	 * {@inheritDoc}
	 *
	 * @return void
	 */
	public function enqueue() {
		$this->enqueue_admin_style();
		AdminAssets::enqueue( 'admin', 'turtlereport-admin' );
	}
}