WP Mirage

what you see has never been there...

WP Mirage porta i dati di un'API nell'ecosistema WordPress, anche senza importarli nel database. Open source, gratuito ed estensibile.

Sembrano post. Nel database non ci sono.

Titoli, immagini, tassonomie e campi personalizzati vengono mostrati normalmente da WordPress. Il tema li renderizza, WP_Query li trova e i page builder possono utilizzarli.

In modalità Mirage, però, quei contenuti arrivano direttamente dall'API e non vengono salvati in wp_posts.

Adminer wp_posts
SELECT *
FROM wp_posts
WHERE post_type = 'mirage_item';
0 record trovati
L'API resta la fonte dei dati.
WordPress diventa l'interfaccia.

Il problema non è collegare un'API.
È mantenere due copie.

Quando gli stessi dati vivono nel gestionale e nel database WordPress, la sincronizzazione diventa parte del sistema.

Sincronizzazioni fragili

Un processo interrotto può lasciare il sito con dati incompleti o superati.

Dati che divergono

L'API dice una cosa, WordPress ne mostra un'altra. Diventa difficile capire quale sia quella corretta.

Database che cresce

Post, meta e allegati duplicano informazioni che esistono già altrove.

E se WordPress potesse usare quei dati
senza doverli possedere?

Lascia i dati dove nascono.

WP Mirage legge lo schema JSON dell'API e registra automaticamente le entità WordPress corrispondenti: Custom Post Type, tassonomie, custom field e relazioni.

Una sola fonte

I dati principali restano nell'API.

Esperienza WordPress

Temi, query e page builder continuano a usare le API native.

Intervento isolato

WP Mirage agisce soltanto sulle entità presenti nel proprio registro.

Scegli quanto WordPress deve conservare.

Discovery

Analizza lo schema dell'API e registra le entità WordPress, senza importare record.

Dump

Importa i record nel database WordPress in modo idempotente.

Mirage

Serve i contenuti direttamente dall'API, senza scriverli nel database.

Enrichment

Mantiene i dati principali nell'API e crea soltanto gli elementi WordPress necessari ai plugin.

Una scelta architetturale, non una scorciatoia.

Quando i contenuti vengono serviti live, disponibilità e tempi di risposta dipendono anche dall'API esterna.

Per questo WP Mirage offre più modalità operative: puoi iniziare con un'importazione tradizionale, sperimentare il flusso live e conservare localmente soltanto ciò che serve davvero.

Un core aperto, pronto a essere esteso.

WP Mirage sarà pubblicato come progetto open source e gratuito. Potrai installarlo, studiarne il funzionamento, adattarlo e contribuire al suo sviluppo.

Le esigenze specifiche restano fuori dal core e possono essere realizzate come addon indipendenti.

Avvisami su GitHub
Core
Contenuti Media SEO Integrazioni
Un progetto comune alla base.
Solo il codice necessario sopra.

WordPress continua a fare WordPress.

WP Mirage espone i dati remoti attraverso le API native che il tuo sito conosce già.

Query e filtri

WP_Query, tax_query e meta_query diventano richieste verso l'API.

Media virtuali

Immagini e gallerie diventano attachment WordPress utilizzabili dalle funzioni native.

Relazioni e tassonomie

Sono supportate relazioni tra contenuti e tassonomie gerarchiche.

Page builder

I dati funzionano con Elementor, Divi, Gutenberg e gli strumenti basati sulle API native.

SEO

Variabili Yoast/RankMath, sitemap dedicate e campi SEO locali tramite Enrichment.

Accesso protetto

Le richieste verso l'API possono utilizzare autenticazione Bearer configurata dall'amministrazione.

Tre filtri. Nessuna modifica al core.

I filtri vengono applicati soltanto ai Custom Post Type gestiti da WP Mirage. Il resto del sito segue il normale flusso WordPress.

posts_pre_query
Restituisce gli oggetti WP_Post ottenuti dall'API.
get_post_metadata
Espone come meta WordPress i valori presenti nei dati remoti.
get_terms
Fornisce a WordPress le tassonomie provenienti dall'API.
add_filter( 'posts_pre_query',
  [ $bridge, 'posts' ], 10, 2 );

add_filter( 'get_post_metadata',
  [ $bridge, 'meta' ], 10, 4 );

add_filter( 'get_terms',
  [ $bridge, 'terms' ], 10, 3 );

Elimina la sincronizzazione dove non serve.

In modalità Mirage:

  • non ci sono importazioni periodiche;
  • non esiste una seconda copia dei dati principali;
  • gli aggiornamenti dell'API sono disponibili alla richiesta successiva;
  • temi, builder e plugin continuano a lavorare con WordPress;
  • puoi passare a Dump o Enrichment quando il progetto lo richiede.

Il progetto, raccontato dal vivo.

WP Mirage è stato presentato a WordCamp Torino 2026 con una dimostrazione del flusso completo: schema remoto, contenuti WordPress virtuali e database vuoto.

Guarda il talk

Ti serve WP Mirage per un progetto reale?

Il core di WP Mirage è gratuito e open source. Collegarlo a un'infrastruttura esistente può però richiedere analisi, configurazione e sviluppo su misura.

Atman è il partner tecnologico del progetto. Può affiancarti nell'integrazione con API e sistemi aziendali, nella realizzazione di addon specifici e nell'implementazione di WP Mirage.

Parla con Atman Raccontaci quali dati vuoi portare in WordPress.

Analisi

  • Analisi dello schema e dell'architettura dei dati
  • Collegamento con gestionali, cataloghi e API proprietarie

Sviluppo

  • Sviluppo di addon e integrazioni dedicate
  • Configurazione delle modalità operative

Delivery

  • Adattamento a page builder, SEO e flussi editoriali
  • Supporto al deploy e al rilascio

Scegli come iniziare.

Due percorsi distinti, costruiti sullo stesso core.

Vuoi usare o contribuire al core?

Segui l'apertura della repository e i prossimi aggiornamenti.

Avvisami su GitHub

Hai un progetto da implementare?

Parla con il partner tecnologico per integrazioni e addon su misura.

Parla con Atman
×

Avvisami quando apre GitHub

Ricevi un messaggio quando la repository pubblica di WP Mirage sarà disponibile.

Utilizziamo Brevo per gestire gli aggiornamenti. I dati saranno trattati secondo la Privacy Policy di Brevo.