Quando elimini un articolo, WordPress non elimina la sua immagine in evidenza, che resta nella libreria media. Con l’hook before_delete_post puoi cancellarla insieme all’articolo, come facevo nel 2016. Ma il codice di allora aveva un difetto serio: cancellava l’immagine anche se era usata da altri articoli. La versione aggiornata controlla prima che non sia condivisa né inserita nel testo di altri contenuti.
Ogni volta che scriviamo un articolo o una pagina possiamo indicare l’immagine in evidenza, che finisce nel calderone della libreria media insieme a tutte le altre immagini e agli allegati. Cosa succede se eliminiamo l’articolo? Per impostazione predefinita WordPress elimina solo il contenuto, non l’immagine, e così ci si ritrova con decine di immagini orfane che riempiono la cartella uploads e lo spazio dell’hosting.
Qual era il problema del codice del 2016?
Il codice originale, agganciato a before_delete_post, prendeva l’ID dell’immagine in evidenza e la cancellava con wp_delete_attachment(), senza chiedersi nient’altro. Ma una stessa immagine può essere l’immagine in evidenza di più articoli, oppure comparire nel testo di un’altra pagina. Cancellandola, tutti quegli articoli restano senza immagine, o con un’immagine rotta nel testo.
Non è un caso teorico: proprio riscrivendo i vecchi articoli di questo blog ho trovato copertine condivise da quattro o nove articoli diversi. Una pulizia “cieca” le avrebbe fatte sparire da tutti.
Qual è il codice aggiornato?

In un file dentro wp-content/mu-plugins, così funziona con qualunque tema:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
<?php // l'immagine è usata da altri contenuti? function aa_immagine_usata( $img_id, $post_id ) { global $wpdb; // immagine in evidenza di un altro contenuto $altri = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM {$wpdb->postmeta} WHERE meta_key = '_thumbnail_id' AND meta_value = %d AND post_id <> %d", $img_id, $post_id ) ); if ( $altri ) { return true; } // nome del file citato nel testo di un altro contenuto $file = pathinfo( (string) get_attached_file( $img_id ), PATHINFO_FILENAME ); if ( '' === $file ) { return true; // nel dubbio non cancello } $nel_testo = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM {$wpdb->posts} WHERE ID <> %d AND post_type NOT IN ('revision','attachment') AND post_content LIKE %s", $post_id, '%' . $wpdb->esc_like( $file ) . '%' ) ); return (bool) $nel_testo; } // elimino l'immagine in evidenza insieme all'articolo, solo se non serve altrove function aa_elimina_evidenza( $post_id, $post ) { if ( ! in_array( $post->post_type, array( 'post', 'page' ), true ) ) { return; } $img_id = (int) get_post_thumbnail_id( $post_id ); if ( ! $img_id || aa_immagine_usata( $img_id, $post_id ) ) { return; } wp_delete_attachment( $img_id, true ); } add_action( 'before_delete_post', 'aa_elimina_evidenza', 10, 2 ); |
Come funzionano i controlli?
Il primo controllo limita l’azione ad articoli e pagine: before_delete_post scatta anche per revisioni, allegati e altri tipi di contenuto. Il secondo cerca altri contenuti che usano la stessa immagine come immagine in evidenza, nel campo _thumbnail_id. Il terzo cerca il nome del file nel testo degli altri contenuti, così trova anche le miniature con suffissi come -1024x768. Se uno dei controlli trova qualcosa, l’immagine resta. Nel dubbio, il codice preferisce non cancellare.
Il secondo parametro di wp_delete_attachment(), true, elimina definitivamente file e miniature senza passare dal cestino dei media.
Quando si attiva?
Solo quando l’articolo viene eliminato definitivamente, cioè svuotando il cestino o con “Elimina definitivamente”. Spostare un articolo nel cestino non cancella niente, e puoi ancora ripristinarlo. WordPress svuota il cestino da solo dopo 30 giorni (la costante EMPTY_TRASH_DAYS in wp-config.php cambia il numero), e anche in quel caso il codice entra in azione.
E le immagini orfane che ho già?
Questo codice previene, non recupera. Per le immagini già orfane esistono plugin che analizzano la libreria e segnalano i file non usati; non cancellare mai in blocco senza un backup e un controllo a campione, perché nessuno strumento vede tutto (per esempio le immagini usate nei CSS del tema o nei campi personalizzati). Prima di ogni pulizia, un backup come spiego in la strategia di backup 3-2-1. E se le immagini pesano troppo, oltre a cancellare quelle inutili conviene ottimizzare le altre con ShortPixel.
In sintesi
before_delete_post con due argomenti, solo per articoli e pagine, e un controllo prima di wp_delete_attachment(): l’immagine non deve essere l’immagine in evidenza di altri contenuti né comparire nel loro testo. Scatta solo all’eliminazione definitiva. Per le immagini già orfane, plugin di analisi, backup e controlli a campione.
Domande frequenti
WordPress elimina l’immagine in evidenza insieme all’articolo?
No, elimina solo l’articolo: l’immagine resta nella libreria media.
Come elimino l’immagine in evidenza quando elimino l’articolo?
Con l’hook before_delete_post e wp_delete_attachment, ma solo dopo aver controllato che l’immagine non sia usata altrove.
Perché controllare se l’immagine è usata da altri articoli?
Perché la stessa immagine può essere la copertina di più articoli o comparire nel testo: cancellarla li lascerebbe senza immagine.
Il codice si attiva quando sposto l’articolo nel cestino?
No, solo con l’eliminazione definitiva, quando svuoti il cestino.