'wp360_mc_per_page_original', 'legacy' => 'wp360_mc_per_page_legacy', 'trash' => 'wp360_mc_per_page_trash', ); /** @var string Hook-Suffix der (einzigen) Plugin-Seite, fuer Asset-Enqueue + Screen-Options. */ private static $tools_hook; public static function init() { add_action( 'admin_menu', array( __CLASS__, 'register_menu' ) ); add_action( 'admin_enqueue_scripts', array( __CLASS__, 'enqueue_assets' ) ); add_filter( 'set-screen-option', array( __CLASS__, 'sanitize_screen_option' ), 10, 3 ); // set-screen-option ist seit WP 5.4.2 als Filter deprecated (feuert aber // weiterhin) -- zusaetzlich den Nachfolger je Option registrieren, damit // das Speichern auch auf neueren WP-Versionen sicher greift. foreach ( self::PER_PAGE_OPTIONS as $option_name ) { add_filter( "set_screen_option_{$option_name}", array( __CLASS__, 'sanitize_screen_option_value' ), 10, 2 ); } add_action( 'admin_enqueue_scripts', array( __CLASS__, 'enqueue_deactivation_notice_script' ) ); add_filter( 'wp360_orbit_health', array( __CLASS__, 'health_lines' ), 10, 2 ); add_filter( 'plugin_action_links_' . plugin_basename( WP360_MC_FILE ), array( __CLASS__, 'action_links' ) ); } /** * @param string[] $links Bisherige Links. * @return string[] */ public static function action_links( $links ) { $url = add_query_arg( array( 'page' => self::SLUG ), admin_url( 'admin.php' ) ); array_unshift( $links, '' . esc_html__( 'Settings', '360-orbit-media-cleaner' ) . '' ); return $links; } public static function register_menu() { // Genau ein Eintrag im gemeinsamen "360 WP Orbit"-Untermenue -- Einstellungen // und Lizenz sind eigene Tabs auf dieser einen Seite, keine eigenen Menueeintraege mehr. self::$tools_hook = add_submenu_page( Wp360_Media_Cleaner_Orbit_Menu::SLUG, 'Media Cleaner', 'Media Cleaner', 'manage_options', self::SLUG, array( __CLASS__, 'render_page' ) ); add_action( 'load-' . self::$tools_hook, array( __CLASS__, 'add_screen_options' ) ); add_action( 'load-' . self::$tools_hook, array( __CLASS__, 'add_help_tabs' ) ); } /** * Einheitliches Hilfe-Panel (README "Suite-übergreifend"): WordPress' * eigene "Hilfe"-Lasche oben rechts mit den drei wichtigsten Fragen, * statt sie ungenutzt zu lassen. Reine Texte, keine Logik. */ public static function add_help_tabs() { $screen = get_current_screen(); if ( ! $screen ) { return; } $screen->add_help_tab( array( 'id' => 'wp360-mc-help-basics', 'title' => __( 'What does Media Cleaner do?', '360-orbit-media-cleaner' ), 'content' => '

' . __( 'A scan finds media files that are no longer referenced anywhere in the project or only exist as an outdated image size, and moves them reversibly to uploads-legacy — nothing is deleted right away.', '360-orbit-media-cleaner' ) . '

', ) ); $screen->add_help_tab( array( 'id' => 'wp360-mc-help-restore', 'title' => __( 'I still need a moved file after all — now what?', '360-orbit-media-cleaner' ), 'content' => '

' . __( 'As long as it is under "Legacy Media" or "Original Backups", it can be moved back individually or via bulk selection. Only the trash permanently deletes files from disk, after confirmation.', '360-orbit-media-cleaner' ) . '

', ) ); $screen->add_help_tab( array( 'id' => 'wp360-mc-help-safety', 'title' => __( 'How does the plugin make sure nothing wrong gets moved?', '360-orbit-media-cleaner' ), 'content' => '

' . __( 'Before every move, a safety net checks the filename against the content, postmeta and options of the site. The scan additionally searches featured images, ACF fields (incl. gallery/repeater), Gutenberg blocks, widgets, theme mods and ACF options pages for references before a file counts as unused.', '360-orbit-media-cleaner' ) . '

', ) ); } /** * Deaktivierungs-Rückfrage (README "Suite-übergreifend"): kein Formular, * nur ein kurzer Hinweis vor dem eigentlichen Deaktivieren in der * Plugin-Liste, was dabei aufhoert und was erhalten bleibt. */ public static function enqueue_deactivation_notice_script( $hook ) { if ( 'plugins.php' !== $hook || ! defined( 'WP360_MC_FILE' ) ) { return; } $basename = plugin_basename( WP360_MC_FILE ); $message = __( 'Deactivate Media Cleaner? A format variant delivered via .htaccess (Pro, "Deliver via .htaccess") is immediately deactivated -- visitors then get the original again. Legacy media, original backups, trash and settings stay saved and come back if you reactivate the plugin.', '360-orbit-media-cleaner' ); // Kein eigenes Script-Tag im Markup (WordPress.org-Richtlinie): ein Handle // ohne Datei, an das der Code per wp_add_inline_script() haengt. wp_register_script( 'wp360-mc-deactivate', false, array(), WP360_MC_VERSION, true ); wp_enqueue_script( 'wp360-mc-deactivate' ); wp_add_inline_script( 'wp360-mc-deactivate', sprintf( '( function () { var row = document.querySelector( %s ); var link = row ? row.querySelector( \'a[href*="action=deactivate"]\' ) : null; if ( ! link ) { return; } link.addEventListener( \'click\', function ( event ) { if ( ! window.confirm( %s ) ) { event.preventDefault(); } } ); } )();', wp_json_encode( 'tr[data-plugin="' . $basename . '"]' ), wp_json_encode( $message ) ) ); } /** * Gesundheitscheck (README "Suite-übergreifend"): traegt zur * gemeinsamen "360 WP Orbit"-Uebersicht bei -- rein lesend, nichts * wird hier ausgeloest. Bewusst am gemeinsamen, nicht praefigierten * Filter 'wp360_orbit_health' registriert (siehe class-orbit-menu.php). */ public static function health_lines( array $lines, $slug ) { if ( '360-orbit-media-cleaner' !== $slug ) { return $lines; } if ( class_exists( 'Wp360_Media_Cleaner_Mover' ) ) { $legacy = Wp360_Media_Cleaner_Mover::count( 'legacy', 'exclude_originals' ); if ( $legacy > 0 ) { $lines[] = sprintf( /* translators: %d: number of files in legacy media, not yet permanently deleted */ _n( '%d file in legacy media, not yet permanently deleted.', '%d files in legacy media, not yet permanently deleted.', $legacy, '360-orbit-media-cleaner' ), $legacy ); } } return $lines; } /** Registriert "Eintraege pro Seite" im Screen-Options-Panel, passend zum aktuell aufgerufenen Listen-Tab. */ public static function add_screen_options() { $tab = self::current_tab(); $labels = array( 'original' => __( 'Original backups per page', '360-orbit-media-cleaner' ), 'legacy' => __( 'Legacy media per page', '360-orbit-media-cleaner' ), 'trash' => __( 'Trash entries per page', '360-orbit-media-cleaner' ), ); if ( ! isset( self::PER_PAGE_OPTIONS[ $tab ] ) ) { return; } add_screen_option( 'per_page', array( 'label' => $labels[ $tab ], 'default' => 30, 'option' => self::PER_PAGE_OPTIONS[ $tab ], ) ); } /** @see add_screen_options() -- set-screen-option feuert fuer ALLE Screen-Options aller Plugins, daher hier auf unsere Options-Namen eingrenzen. */ public static function sanitize_screen_option( $status, $option, $value ) { if ( in_array( $option, self::PER_PAGE_OPTIONS, true ) ) { return (int) $value; } return $status; } /** @see add_screen_options() -- Nachfolger-Filter (WP 5.4.2+), pro Option bereits eindeutig, kein Namensabgleich noetig. */ public static function sanitize_screen_option_value( $status, $value ) { return (int) $value; } /** Aktuell aktiver Tab auf der Tools-Seite (rein lesende Navigation, kein Nonce noetig). */ private static function current_tab() { $valid = array( 'scan', 'original', 'legacy', 'trash', 'pro' ); if ( isset( $_GET['tab'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended $tab = sanitize_key( wp_unslash( $_GET['tab'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended if ( in_array( $tab, $valid, true ) ) { return $tab; } } return 'scan'; } public static function enqueue_assets( $hook ) { if ( self::$tools_hook !== $hook ) { return; } wp_enqueue_style( 'wp360-mc-admin', WP360_MC_URL . 'assets/admin.css', array(), WP360_MC_VERSION ); wp_enqueue_script( 'wp360-mc-admin', WP360_MC_URL . 'assets/admin.js', array( 'jquery' ), WP360_MC_VERSION, true ); wp_localize_script( 'wp360-mc-admin', 'wp360MediaCleaner', array( 'ajaxUrl' => admin_url( 'admin-ajax.php' ), 'nonce' => wp_create_nonce( 'wp360_mc_nonce' ), 'confirmEmptyTrash' => __( 'Really empty the trash for good? The files are permanently deleted from disk.', '360-orbit-media-cleaner' ), 'confirmDeleteOne' => __( 'Really delete this file for good? This cannot be undone.', '360-orbit-media-cleaner' ), 'starting' => __( 'Starting …', '360-orbit-media-cleaner' ), 'scanError' => __( 'Error during scan.', '360-orbit-media-cleaner' ), /* translators: 1: percent complete, 2: number of files moved so far */ 'scanRunningLabel' => __( 'Running … %1$d%% (%2$d files moved so far)', '360-orbit-media-cleaner' ), /* translators: %1$d: number of failed moves */ 'scanFailedSuffix' => __( ' – %1$d error(s)', '360-orbit-media-cleaner' ), /* translators: 1: number of moved files, 2: total size, already formatted */ 'scanDoneMsg' => __( 'Done. %1$d files in uploads-legacy (%2$s).', '360-orbit-media-cleaner' ), /* translators: %1$d: number of files that could not be moved */ 'scanFailedNotice' => __( ' Warning: %1$d file(s) could not be moved (see PHP error log).', '360-orbit-media-cleaner' ), ) ); } /** Tab-Navigation (URL bleibt bei ?page=wp360-media-cleaner&tab=..., kein JS noetig). */ private static function render_tabs( $current_tab, $orig_count, $legacy_count, $trash_count ) { $tabs = array( 'scan' => __( 'Clean Up', '360-orbit-media-cleaner' ), ); // FREE zeigt einen einzigen Pro-Tab statt gesperrter Attrappen-Tabs // (WordPress.org-Richtlinie 11: Upgrade-Hinweise sparsam und nur auf // der eigenen Einstellungsseite). PRO behaelt seine bisherigen Tabs. $show_pro_tab = true; /* translators: %d: number of original backup files */ $tabs['original'] = sprintf( __( 'Original Backups (%d)', '360-orbit-media-cleaner' ), $orig_count ); /* translators: %d: number of legacy media files */ $tabs['legacy'] = sprintf( __( 'Legacy Media (%d)', '360-orbit-media-cleaner' ), $legacy_count ); /* translators: %d: number of trashed files */ $tabs['trash'] = sprintf( __( 'Trash (%d)', '360-orbit-media-cleaner' ), $trash_count ); if ( $show_pro_tab ) { $tabs['pro'] = __( 'Media Cleaner Pro', '360-orbit-media-cleaner' ); } ?>

360 Orbit ()

-- das steckt hier im Flex-Branding-Block, die Meldung erschiene also neben der Ueberschrift statt darunter. ?>

uploads-legacy — nothing is deleted in the process.', '360-orbit-media-cleaner' ), array( 'code' => array() ) ); ?>

prepare_items(); } ?>

uploads-legacy.', '360-orbit-media-cleaner' ), array( 'code' => array() ) ); echo $scan_intro; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- oben per wp_kses()/esc_url() bereinigt. ?>

uploads-original-legacy. Move them back from here (individually, via bulk selection, or all at once) or put them in the trash.', '360-orbit-media-cleaner' ), array( 'code' => array() ) ); ?>

0 ) { ?>

display(); ?>

display(); ?>

display(); ?>