Tabelle database custom in WordPress: quando wp_postmeta non basta più

wp_postmeta è comodo ma diventa un collo di bottiglia con migliaia di record. Quando e come creare tabelle custom in WordPress, come scriverle correttamente e perché la maggior parte dei plugin sbaglia.
wp_postmeta è la tabella più abusata di WordPress. È comoda: salvi qualsiasi dato come coppia chiave-valore collegata a un post, e il core lo gestisce con get_post_meta e update_post_meta. Per 50 campi personalizzati va benissimo. Per 50.000 record con 20 campi ciascuno, diventa un disastro di prestazioni — perché wp_postmeta è una tabella key-value senza indici sulle chiavi che contano, e ogni query per meta_value fa una scansione completa.
Il limite strutturale è questo: wp_postmeta ha un indice su meta_key ma non su meta_value. Una query che filtra per meta_value (es. 'trova tutti i prodotti con prezzo > 100') fa una full table scan su una tabella che può avere milioni di righe. La soluzione è creare una tabella dedicata con la struttura corretta: colonne tipizzate, indici sulle colonne di filtro, e relazioni esplicite. Non è complesso, ma va fatto rispettando le convenzioni di WordPress.
Quando serve una tabella custom (e quando no)
La regola pratica: se i tuoi dati sono pochi (centinaia di record) e li leggi per post_id, wp_postmeta va benissimo. Se i tuoi dati sono tanti (migliaia di record) e li filtri per valori (non per post_id), serve una tabella custom. Esempi classici: un sistema di prenotazioni dove filtri per data e stato, un log di eventi dove filtri per tipo e timestamp, un sistema di rating dove aggreghi per prodotto. In tutti questi casi, wp_postmeta costringe a query lente perché non puoi indicizzare il valore.
Un altro caso è quando i dati non sono legati a un post. wp_postmeta richiede un post_id, ma se stai salvando dati di un'integrazione esterna (es. sincronizzazione con un CRM), non hai un post — hai un'entità autonoma. Una tabella custom con la sua chiave primaria è la struttura corretta.
Creare la tabella con dbDelta
WordPress fornisce dbDelta per creare e aggiornare tabelle in modo sicuro. La funzione è esigente sulla sintassi SQL — ogni campo su una riga, due spazi dopo PRIMARY KEY, e la chiave primaria dichiarata esplicitamente. Ecco come creare una tabella per un sistema di prenotazioni:
// Crea la tabella custom all'attivazione del plugin
function wpplanet_crea_tabella_prenotazioni() {
global $wpdb;
$table_name = $wpdb->prefix . 'prenotazioni';
$charset_collate = $wpdb->get_charset_collate();
$sql = "CREATE TABLE $table_name (
id bigint(20) NOT NULL AUTO_INCREMENT,
post_id bigint(20) NOT NULL,
cliente_email varchar(255) NOT NULL,
data_prenotazione date NOT NULL,
ora_prenotazione time NOT NULL,
stato varchar(20) NOT NULL DEFAULT 'in_attesa',
prezzo decimal(10,2) NOT NULL DEFAULT 0,
creato_il datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (id),
KEY post_id (post_id),
KEY stato_data (stato, data_prenotazione),
KEY cliente_email (cliente_email)
) $charset_collate;";
require_once ABSPATH . 'wp-admin/includes/upgrade.php';
dbDelta( $sql );
// Salva la versione per aggiornamenti futuri
add_option( 'wpplanet_prenotazioni_db_version', '1.0' );
}
register_activation_hook( __FILE__, 'wpplanet_crea_tabella_prenotazioni' );Query ottimizzate con $wpdb
Una volta creata la tabella, le query usano $wpdb con prepared statements per sicurezza. La differenza con wp_postmeta è che puoi filtrare per qualsiasi colonna indicizzata in modo efficiente:
// Query: tutte le prenotazioni confermate di una data, ordinate per ora
function wpplanet_get_prenotazioni_giorno( $data ) {
global $wpdb;
$table = $wpdb->prefix . 'prenotazioni';
// Prepared statement — MAI concatenare $data direttamente
$results = $wpdb->get_results( $wpdb->prepare(
"SELECT * FROM $table
WHERE data_prenotazione = %s
AND stato = %s
ORDER BY ora_prenotazione ASC",
$data,
'confermata'
) );
return $results;
}
// Query aggregata: conteggio prenotazioni per stato (usa l'indice stato_data)
function wpplanet_conta_per_stato() {
global $wpdb;
$table = $wpdb->prefix . 'prenotazioni';
return $wpdb->get_results("
SELECT stato, COUNT(*) as totale
FROM $table
GROUP BY stato
");
}
// Insert con validazione
function wpplanet_inserisci_prenotazione( $dati ) {
global $wpdb;
$table = $wpdb->prefix . 'prenotazioni';
$wpdb->insert( $table, array(
'post_id' => absint( $dati['post_id'] ),
'cliente_email' => sanitize_email( $dati['email'] ),
'data_prenotazione' => sanitize_text_field( $dati['data'] ),
'ora_prenotazione' => sanitize_text_field( $dati['ora'] ),
'stato' => 'in_attesa',
'prezzo' => floatval( $dati['prezzo'] ),
), array( '%d', '%s', '%s', '%s', '%s', '%f' ) );
return $wpdb->insert_id;
}L'errore più comune: dimenticare gli indici
L'errore che vediamo più spesso è creare la tabella custom ma senza indici sulle colonne di filtro. Una tabella di 100.000 righe senza indice su 'stato' è lenta quanto wp_postmeta — la full table scan è identica. La differenza tra una tabella custom ben indicizzata e wp_postmeta può essere di due ordini di grandezza: una query che su wp_postmeta impiega 800ms su una tabella indicizzata impiega 3ms. Ma senza indici, la tabella custom è solo più lavoro per nessun guadagno.
La regola: prima di creare la tabella, scrivi le query che farai più spesso. Ogni colonna nella clausola WHERE deve avere un indice. Le colonne usate insieme in WHERE (es. stato + data) devono avere un indice composito, non due indici separati — MySQL usa un solo indice per tabella per query. Le colonne in ORDER BY beneficiano di un indice se non sono già coperte dall'indice di WHERE.
Creare tabelle custom in WordPress non è un'operazione da temere, ma va fatta con la stessa cura che dedicheresti allo schema di un'applicazione standalone. La tentazione di buttare tutto in wp_postmeta è forte perché è facile, ma quando i dati crescono la struttura key-value diventa un limite di prestazioni che nessun caching risolve. Un'architettura dati corretta fin dall'inizio è ciò che distingue un plugin che scala da uno che va in crisi al primo picco di traffico.
Architettura dati corretta per plugin e integrazioni WordPress.
Sviluppo WordPress personalizzato con tabelle custom ottimizzate, indici corretti e query efficienti: quando wp_postmeta non basta più, l'architettura dati fa la differenza.
Articoli correlati

Deploy WordPress: pipeline staging → produzione senza incidenti
Leggi
REST API authentication WordPress: application passwords, JWT e quando usare l'una o l'altra
Leggi
