Ein Add-on für das Icons-Panel bauen

wp-content/plugins/my-svg-check/
├── my-svg-check.php   Hauptdatei: Prüfungen, REST-Route, Menüeintrag, Einreihen
└── panel-tab.js       der Tab, registriert über window.EasySvgPanel

<?php
/**
 * Plugin Name:       My SVG Check
 * Description:       Adds an "SVG check" tab to the Easy SVG Icons panel.
 * Version:           1.0.0
 * Requires at least: 6.6
 * Requires PHP:      8.0
 * Text Domain:       my-svg-check
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

const MYSVGCHECK_VERSION   = '1.0.0';
const MYSVGCHECK_TAB       = 'mysvgcheck';
const MYSVGCHECK_CAP       = 'upload_files';
const MYSVGCHECK_MAX_BYTES = 512000;

add_action( 'plugins_loaded', 'mysvgcheck_boot' );

/**
 * Hängt alles ein, sobald alle Plugins geladen sind.
 */
function mysvgcheck_boot() {
	if ( ! mysvgcheck_easy_svg_ready() ) {
		add_action( 'admin_notices', 'mysvgcheck_missing_notice' );
		return;
	}

	add_action( 'rest_api_init', 'mysvgcheck_register_route' );
	add_filter( 'easy_svg_panel_menu_tabs', 'mysvgcheck_menu_tab' );
	add_action( 'easy_svg_panel_enqueue', 'mysvgcheck_enqueue' );
}

/**
 * Ist Easy SVG aktiv und neu genug für dieses Add-on?
 *
 * @return bool
 */
function mysvgcheck_easy_svg_ready() {
	return defined( 'EASY_SVG_API' )
		&& defined( 'EASY_SVG_PANEL_API' )
		&& 1 <= (int) EASY_SVG_API
		&& 2 <= (int) EASY_SVG_PANEL_API
		&& function_exists( 'easy_svg_sanitizer' );
}

/**
 * Sagt Administratoren, warum das Add-on nichts tut.
 */
function mysvgcheck_missing_notice() {
	if ( ! current_user_can( 'activate_plugins' ) ) {
		return;
	}

	printf(
		'<div class="notice notice-warning"><p>%s</p></div>',
		esc_html__( 'My SVG Check needs Easy SVG with a current version of its add-on contract. Install, activate or update Easy SVG.', 'my-svg-check' )
	);
}

/**
 * Ob das Icons-Panel einen Tab eines anderen Add-ons zeichnet.
 *
 * Spiegelt includes/panel.php und src/panel/App.jsx in Easy SVG 5.4.0:
 * zusätzliche Tabs erscheinen nur, solange Easy SVG Pro aktiv ist.
 *
 * @return bool
 */
function mysvgcheck_panel_draws_tab() {
	return defined( 'EASY_SVG_PRO_VERSION' );
}

/**
 * Die REST-Route, die der Tab aufruft.
 */
function mysvgcheck_register_route() {
	register_rest_route(
		'my-svg-check/v1',
		'/clean',
		array(
			'methods'             => 'POST',
			'callback'            => 'mysvgcheck_clean',
			'permission_callback' => 'mysvgcheck_can_use',
			'args'                => array(
				'markup' => array(
					'type'     => 'string',
					'required' => true,
				),
			),
		)
	);
}

/**
 * Dieselbe Berechtigung wie der Menüeintrag. Die REST-Schicht prüft den
 * Header X-WP-Nonce vorher, eine Anfrage ohne ihn ist also anonym.
 *
 * @return bool
 */
function mysvgcheck_can_use() {
	return current_user_can( MYSVGCHECK_CAP );
}

/**
 * Säubert das geschickte SVG und meldet, was der Sanitizer entfernt hat.
 *
 * @param WP_REST_Request $request Die Anfrage.
 * @return WP_REST_Response|WP_Error
 */
function mysvgcheck_clean( WP_REST_Request $request ) {
	$markup = (string) $request->get_param( 'markup' );

	// Der Sanitizer parst das ganze Dokument, also die Eingabe begrenzen.
	if ( strlen( $markup ) > MYSVGCHECK_MAX_BYTES ) {
		return new WP_Error(
			'mysvgcheck_too_large',
			__( 'That SVG is too large to check here.', 'my-svg-check' ),
			array( 'status' => 413 )
		);
	}

	$sanitizer = easy_svg_sanitizer();
	if ( null === $sanitizer ) {
		return new WP_Error(
			'mysvgcheck_no_sanitizer',
			__( 'The Easy SVG sanitizer is not available.', 'my-svg-check' ),
			array( 'status' => 503 )
		);
	}

	try {
		$clean = $sanitizer->sanitize( $markup );
	} catch ( \Throwable $e ) {
		// Wohlgeformtes XML ohne genau eine svg-Wurzel wirft eine Ausnahme.
		$clean = false;
	}

	if ( ! is_string( $clean ) || '' === trim( $clean ) ) {
		return new WP_Error(
			'mysvgcheck_not_svg',
			__( 'That is not an SVG the sanitizer accepts.', 'my-svg-check' ),
			array( 'status' => 422 )
		);
	}

	$removed = array();
	foreach ( (array) $sanitizer->getXmlIssues() as $issue ) {
		$removed[] = array(
			'message' => sanitize_text_field( (string) ( $issue['message'] ?? '' ) ),
			'line'    => (int) ( $issue['line'] ?? 0 ),
		);
	}

	return new WP_REST_Response(
		array(
			'clean'   => $clean,
			'removed' => $removed,
		)
	);
}

/**
 * Trägt den Menüeintrag mit eigener Berechtigung ein, wenn der Tab gezeichnet wird.
 *
 * @param array $tabs Tab-ID zu Label oder zu Label und Berechtigung.
 * @return array
 */
function mysvgcheck_menu_tab( $tabs ) {
	$tabs = (array) $tabs;

	if ( ! mysvgcheck_panel_draws_tab() ) {
		return $tabs;
	}

	$tabs[ MYSVGCHECK_TAB ] = array(
		'label'      => __( 'SVG check', 'my-svg-check' ),
		'capability' => MYSVGCHECK_CAP,
	);

	return $tabs;
}

/**
 * Lädt das Tab-Script ins Icons-Panel.
 *
 * @param string $handle Das Script-Handle des Panels.
 */
function mysvgcheck_enqueue( $handle ) {
	wp_enqueue_script(
		'my-svg-check-panel',
		plugins_url( 'panel-tab.js', __FILE__ ),
		array( $handle, 'wp-element', 'wp-i18n' ),
		MYSVGCHECK_VERSION,
		true
	);

	wp_set_script_translations( 'my-svg-check-panel', 'my-svg-check', plugin_dir_path( __FILE__ ) . 'languages' );
}

/* global window */
( function () {
	'use strict';

	const panel = window.EasySvgPanel;
	if ( ! panel || 'function' !== typeof panel.registerTab ) {
		return;
	}

	const { createElement: el, useState } = window.wp.element;
	const { __ } = window.wp.i18n;

	async function cleanSvg( ctx, markup ) {
		const response = await window.fetch( ctx.restRoot + 'my-svg-check/v1/clean', {
			method: 'POST',
			credentials: 'same-origin',
			headers: {
				'Content-Type': 'application/json',
				'X-WP-Nonce': ctx.nonce,
			},
			body: JSON.stringify( { markup } ),
		} );
		const data = await response.json().catch( () => ( {} ) );

		if ( ! response.ok ) {
			throw new Error( data.message || __( 'The check failed.', 'my-svg-check' ) );
		}
		return data;
	}

	function Removed( { items } ) {
		if ( ! items.length ) {
			return el( 'p', null, __( 'Nothing was removed. This SVG is clean.', 'my-svg-check' ) );
		}
		return el(
			'ul',
			null,
			items.map( ( item, index ) =>
				el( 'li', { key: index }, item.message + ' (' + __( 'line', 'my-svg-check' ) + ' ' + item.line + ')' )
			)
		);
	}

	function SvgCheck( { ctx } ) {
		const [ markup, setMarkup ] = useState( '' );
		const [ result, setResult ] = useState( null );
		const [ error, setError ] = useState( '' );
		const [ busy, setBusy ] = useState( false );

		async function check() {
			setBusy( true );
			setError( '' );
			setResult( null );
			try {
				setResult( await cleanSvg( ctx, markup ) );
			} catch ( e ) {
				setError( e.message );
			} finally {
				setBusy( false );
			}
		}

		return el(
			'div',
			{ className: 'my-svg-check' },
			el( 'p', null, __( 'Paste an SVG to see what this site\'s sanitizer removes from it. Nothing is saved.', 'my-svg-check' ) ),
			el( 'textarea', {
				rows: 10,
				style: { width: '100%' },
				value: markup,
				'aria-label': __( 'SVG markup', 'my-svg-check' ),
				onChange: ( event ) => setMarkup( event.target.value ),
			} ),
			el(
				'p',
				null,
				el(
					'button',
					{
						type: 'button',
						className: 'button button-primary',
						disabled: busy || '' === markup.trim(),
						onClick: check,
					},
					busy ? __( 'Checking…', 'my-svg-check' ) : __( 'Check SVG', 'my-svg-check' )
				)
			),
			error ? el( 'p', { role: 'alert' }, error ) : null,
			result
				? el(
						'div',
						null,
						el( 'h3', null, __( 'Removed', 'my-svg-check' ) ),
						el( Removed, { items: result.removed || [] } ),
						el( 'h3', null, __( 'Clean result', 'my-svg-check' ) ),
						el( 'textarea', {
							rows: 10,
							style: { width: '100%' },
							readOnly: true,
							value: result.clean,
							'aria-label': __( 'Clean SVG markup', 'my-svg-check' ),
						} )
				  )
				: null
		);
	}

	panel.registerTab( {
		id: 'mysvgcheck',
		label: __( 'SVG check', 'my-svg-check' ),
		area: 'inspect',
		order: 30,
		// Ein Haken, gezeichnet auf dem 24 mal 24 Icon-Raster des Panels.
		icon: el( 'path', { d: 'M5 12l4 4L19 7' } ),
		render: ( ctx ) => el( SvgCheck, { ctx } ),
	} );
} )();