<?php
/**
 * Custom CSS.
 *
 * WordPress keeps its Additional CSS per theme: switch themes and the rules stay behind with
 * the old one. On a block theme the box itself has moved inside the Site Editor, several clicks
 * from anywhere. This is CSS that belongs to the site — it prints on whichever theme is active,
 * and it is edited from Appearance, where people look for it.
 *
 * Front end only, on purpose. Core's own Additional CSS is left alone and both can be used; this
 * one prints second, so at equal specificity the site-level rule wins over the per-theme one.
 *
 * @package Adminkeep
 */

namespace Adminkeep\Feature;

use Adminkeep\Feature;
use Adminkeep\Admin\CustomCssScreen;

defined( 'ABSPATH' ) || exit;

/**
 * Site-level front-end CSS.
 */
class CustomCss implements Feature {

	/**
	 * Option holding the CSS. Its own row rather than a key in the settings array, so a
	 * stylesheet's worth of text does not ride along with every settings read and write.
	 */
	const OPTION = 'adminkeep_custom_css';

	/**
	 * wp_head priority. Core prints Additional CSS at 101.
	 */
	const HEAD_PRIORITY = 102;

	/**
	 * The editing screen, built on first use.
	 *
	 * @var CustomCssScreen|null
	 */
	private $screen = null;

	/**
	 * Feature id.
	 *
	 * @return string
	 */
	public function id() {
		return 'custom_css';
	}

	/**
	 * Label.
	 *
	 * @return string
	 */
	public function label() {
		return __( 'Custom CSS', 'adminkeep' );
	}

	/**
	 * Description.
	 *
	 * @return string
	 */
	public function description() {
		return __( 'CSS that belongs to your site rather than to a theme. It stays when you switch themes, and you edit it from Appearance.', 'adminkeep' );
	}

	/**
	 * A word for what this feature is doing right now.
	 *
	 * @return string
	 */
	public function state_label() {
		return '' === trim( self::css() ) ? __( 'No CSS yet', 'adminkeep' ) : __( 'CSS active', 'adminkeep' );
	}

	/**
	 * Settings schema. The CSS is edited on its own screen, so there is nothing here.
	 *
	 * @return array
	 */
	public function settings_schema() {
		return array();
	}

	/**
	 * No fields, so no labels.
	 *
	 * @param string $key Field key.
	 * @return string
	 */
	public function field_label( $key ) {
		return '';
	}

	/**
	 * What switching this on actually does.
	 *
	 * @return string[]
	 */
	public function how_it_works() {
		return array(
			__( 'Adds Appearance → Custom CSS, with the same code editor WordPress uses for its own CSS box.', 'adminkeep' ),
			__( 'Prints your CSS on the front end of the site, on whichever theme is active. Switching themes does not lose it.', 'adminkeep' ),
			__( 'Your theme\'s own Additional CSS is left alone. Both can be used; this one prints second, so it wins when the two disagree.', 'adminkeep' ),
			__( 'Anything that looks like HTML is refused when you save, so a pasted snippet cannot break out of the style tag.', 'adminkeep' ),
			__( 'Switching this off stops the CSS printing and removes the menu item. The CSS itself is kept until you uninstall.', 'adminkeep' ),
		);
	}

	/**
	 * Where the settings panel sends you to do the actual work.
	 *
	 * @return array{url?: string, label?: string} Empty when this user could not open the screen.
	 */
	public function panel_link() {
		if ( ! CustomCssScreen::can_edit() ) {
			return array();
		}

		return array(
			'url'   => CustomCssScreen::url(),
			'label' => __( 'Edit CSS', 'adminkeep' ),
		);
	}

	/**
	 * The editing screen.
	 *
	 * @return CustomCssScreen
	 */
	public function screen() {
		if ( null === $this->screen ) {
			$this->screen = new CustomCssScreen();
		}

		return $this->screen;
	}

	/**
	 * Register hooks.
	 *
	 * @param array $settings Resolved settings. Unused — this feature has none.
	 * @return void
	 */
	public function boot( array $settings ) {
		add_action( 'wp_head', array( $this, 'print_css' ), self::HEAD_PRIORITY );

		if ( is_admin() ) {
			$this->screen()->boot();
		}
	}

	/**
	 * The stored CSS.
	 *
	 * @return string
	 */
	public static function css() {
		$css = get_option( self::OPTION, '' );

		return is_string( $css ) ? $css : '';
	}

	/**
	 * Check CSS the way core checks its own Additional CSS: no markup.
	 *
	 * @param string $css Raw CSS.
	 * @return true|\WP_Error
	 */
	public static function validate( $css ) {
		if ( preg_match( '#</?\w+#', $css ) ) {
			return new \WP_Error( 'adminkeep_css_markup', __( 'Markup is not allowed in CSS. Remove anything that looks like an HTML tag and save again.', 'adminkeep' ) );
		}

		return true;
	}

	/**
	 * Print the CSS into the head.
	 *
	 * @return void
	 */
	public function print_css() {
		$css = trim( self::css() );

		if ( '' === $css ) {
			return;
		}

		// CSS cannot be HTML-escaped without corrupting it (child combinators, quoted strings).
		// Stripping tags is what core does for Additional CSS; markup was already refused on save.
		echo '<style id="adminkeep-custom-css">' . "\n" . wp_strip_all_tags( $css ) . "\n" . '</style>' . "\n"; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	}
}