La Libreria Media di WordPress è più di un semplice caricatore di immagini. È un sistema di gestione file completo che gestisce immagini, documenti, audio, video e qualsiasi altro tipo di file che configuri. Per gli sviluppatori di plugin, la Libreria Media fornisce ampi hook per la personalizzazione: dall'aggiunta di campi personalizzati alla creazione di flussi di lavoro di upload completamente nuovi.
Questa guida copre come personalizzare ed estendere la Libreria Media di WordPress per le esigenze del tuo plugin.
Campi Allegato Personalizzati
Aggiungi campi personalizzati agli allegati media usando il filtro attachment_fields_to_edit. Questo aggiunge campi modulo alla schermata dei dettagli dell'allegato della Libreria Media. Definisci il tuo HTML dei campi e restituiscilo insieme ai campi esistenti. Salva i valori dei campi personalizzati con il filtro attachment_fields_to_save.
I campi personalizzati comuni includono credito/attribuzione per foto stock, date di scadenza per media a tempo limitato, URL personalizzati per immagini collegate e testo alternativo o didascalie personalizzate per casi d'uso specifici.
Schede Media Personalizzate
Aggiungi schede personalizzate alla finestra modale della Libreria Media usando il filtro media_upload_tabs. Ogni scheda ha un identificatore e un nome visualizzato. Registra una funzione callback che restituisce il contenuto della scheda quando un utente ci clicca. Le schede personalizzate possono integrarsi con servizi di terze parti, visualizzare media esterni o fornire interfacce di upload specializzate.
Le schede media personalizzate popolari includono l'integrazione con Unsplash o Pexels per foto stock, Google Drive o Dropbox per l'accesso al cloud storage e librerie media personalizzate con branding per i clienti.
Gestori di Upload Personalizzati
Se il tuo plugin accetta upload di file, personalizza il gestore di upload con il filtro wp_handle_upload_prefilter. Valida i tipi di file, controlla le dimensioni dei file, rinomina i file secondo la tua convenzione di denominazione e scansiona i contenuti dannosi prima che il file venga salvato. Per le restrizioni sui tipi di file oltre i default di WordPress, usa il filtro upload_mimes.
Crea supporto per tipi di file personalizzati con il filtro wp_check_filetype_and_ext. Se il tuo plugin deve accettare SVG, WebP o altri tipi di file che WordPress restringe di default, questo filtro ti permette di inserirli in whitelist.
Ricerca e Filtraggio della Libreria Media
Estendi la ricerca della Libreria Media per includere campi personalizzati con il filtro ajax_query_attachments_args. Modifica gli argomenti WP_Query che WordPress usa per cercare gli elementi media. Aggiungi il filtraggio basato su tassonomia registrando tassonomie media personalizzate: questo ti permette di taggare e categorizzare gli elementi media per una migliore organizzazione.
Per siti con migliaia di file media, considera l'aggiunta di filtri per tipo di file, intervallo di date, valori di campi personalizzati o autore dell'upload. Questi filtri rendono la Libreria Media utilizzabile su larga scala.
Dimensioni Media e Ritaglio
Registra dimensioni immagine personalizzate con add_image_size(). Queste dimensioni vengono generate quando le immagini vengono caricate. Usale nel tuo tema con the_post_thumbnail('custom-size'). Registra le dimensioni durante l'hook after_setup_theme. Rimuovi le dimensioni inutilizzate con remove_image_size() per evitare di sprecare spazio su disco.
Per il ritaglio avanzato delle immagini, usa il filtro image_resize_dimensions per controllare come le immagini vengono ritagliate alle tue dimensioni personalizzate.
Il punto fondamentale
La Libreria Media di WordPress è altamente estensibile. Aggiungi campi personalizzati ai dettagli dell'allegato, crea schede personalizzate per fonti media esterne, gestisci gli upload secondo i tuoi requisiti, estendi ricerca e filtraggio e registra dimensioni immagine personalizzate. Gli hook della Libreria Media ti danno gli strumenti per creare un'esperienza di gestione file su misura per le esigenze specifiche del tuo plugin.
