Guida all’uso

Quick Demo Importer esegue importare demo wordpress un click da Strumenti → Demo Importer. Serve la capacità manage_options. Ogni demo è un profilo: una cartella con un config.json obbligatorio che definisce una pipeline ordinata di passi. I passi vengono eseguiti uno alla volta via AJAX. Se un passo fallisce, i successivi non vengono eseguiti.

Posizioni dei profili

• Inclusi: wp-content/plugins/quick-demo-importer/demos/{slug}/
• Personalizzati: wp-content/uploads/quick-demo-importer/profiles/{slug}/

Quando lo stesso slug esiste in entrambi i posti, viene usato per primo il profilo personalizzato.

File tipici dentro una cartella profilo:

{slug}/
  config.json     # obbligatorio
  content.xml     # export WXR opzionale
  images/         # media locali opzionali
  tasks.php       # task PHP opzionali

Campi root di config.json

• name (obbligatorio) — titolo visualizzato
• description (opzionale) — breve riepilogo
• pipeline (obbligatorio) — array non vuoto di oggetti passo

I tipi di passo sconosciuti vengono saltati durante l’analisi. Se non rimane nulla di valido, il profilo viene rifiutato.

Esempio minimo:

{
  "name": "My Demo",
  "description": "Theme only",
  "pipeline": [
    { "step": "install_theme", "slug": "twentytwentyfour" }
  ]
}

Passi della pipeline per importare demo wordpress un click

Ogni elemento richiede "step": "<type>" più i campi specifici del tipo. L’ordine dell’array è l’ordine di esecuzione. Usa questa struttura quando vuoi un’importazione demo WordPress affidabile che installa pacchetti, media e contenuti in un unico flusso.

1. install_theme

Installa un tema. L’attivazione è attiva per impostazione predefinita.

• slug — foglio di stile del tema / slug wordpress.org
• zip_url — URL HTTPS dello ZIP (alternativa o complemento opzionale allo slug)
• activate — predefinito true; imposta false per installare solo

Fornisci almeno slug o zip_url.

{ "step": "install_theme", "slug": "twentytwentythree" }

{
  "step": "install_theme",
  "slug": "my-theme",
  "zip_url": "https://example.com/my-theme.zip",
  "activate": true
}

• Già installato + activate: true → cambia tema quando necessario
• Già installato + activate: false → lasciato com’è (non viene forzata la disattivazione)

2. install_plugin

Installa un plugin. L’attivazione è attiva per impostazione predefinita.

• slug — cartella del plugin / slug wordpress.org
• zip_url — URL HTTPS dello ZIP
• activate — predefinito true; imposta false per installare solo

{ "step": "install_plugin", "slug": "classic-editor" }

{
  "step": "install_plugin",
  "slug": "hello-dolly",
  "activate": false
}

{
  "step": "install_plugin",
  "slug": "debug-bar",
  "zip_url": "https://downloads.wordpress.org/plugin/debug-bar.latest-stable.zip"
}

Quando è impostato zip_url, viene usato quell’archivio e l’API di wordpress.org viene saltata. Mantieni slug allineato al nome della cartella installata così l’attivazione può risolvere il file del plugin.

3. import_media

Importa file immagine da una sottocartella del profilo nella Libreria media.

• directory — predefinito "images"

Estensioni consentite: jpg, jpeg, png, gif, webp, ico.

{ "step": "import_media", "directory": "images" }

• post_name dell’allegato = nome file sanitizzato senza estensione
• Slug esistente → saltato (sicuro da rieseguire)
• Riutilizza quei slug più avanti in site_icon, custom_logo o theme_mods_attachments

4. import_content

Importa WXR/XML tramite l’Importatore WordPress ufficiale (WP_Import). Questo è il percorso standard per l’import XML WordPress e i contenuti demo esportati.

• content_url — URL HTTPS WXR remoto (usato se non vuoto)
• content_file — file relativo sotto il profilo (predefinito content.xml)
• fetch_attachments — predefinito true
• rewrite_urls — predefinito true

{
  "step": "import_content",
  "content_file": "content.xml",
  "fetch_attachments": true,
  "rewrite_urls": true
}

{
  "step": "import_content",
  "content_url": "https://example.com/exports/demo.xml",
  "fetch_attachments": true,
  "rewrite_urls": true
}

L’Importatore WordPress deve essere attivo. La schermata Demo Importer può installarlo quando necessario.

5. apply_setup

Applica configurazione generica del sito. Metti la logica specifica della demo in run_task invece.

Lettura / pagina iniziale

• show_on_front — page o posts
• page_on_front / page_for_posts — slug o titolo della pagina

Branding

• site_icon — slug allegato
• custom_logo — slug allegato

Menu

• menus — mappa oggetti: { "location_slug": "Nome menu" }

Modifiche tema

• theme_mods — valori scalari
• theme_mods_attachments — chiave modifica tema → slug allegato → memorizzato come URL

Opzioni

• options — oggetto opzioni WordPress (scalari)
• permalink_structure dentro options aggiorna la struttura e svuota le regole di riscrittura

{
  "step": "apply_setup",
  "show_on_front": "page",
  "page_on_front": "welcome",
  "page_for_posts": "notes",
  "site_icon": "demo-three-icon",
  "custom_logo": "demo-three-logo",
  "menus": { "primary": "Main Menu" },
  "theme_mods": { "my_setting": "value" },
  "theme_mods_attachments": { "hero_image": "hero-banner" },
  "options": {
    "blogname": "Demo Site",
    "permalink_structure": "/%postname%/",
    "posts_per_page": 5
  }
}

6. run_task

Esegue un metodo dalla classe tasks.php del profilo.

• name (obbligatorio) — nome del metodo
• tasks_class (opzionale) — deve iniziare con QDIMP_Tasks_

{ "step": "run_task", "name": "setup_primary_menu" }

{
  "step": "run_task",
  "name": "pin_welcome_note",
  "tasks_class": "QDIMP_Tasks_demo_three"
}

Forma di classe di esempio:

<?php
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class QDIMP_Tasks_my_demo {
	public function my_method() {
		return 'Done.';
	}
}

Risoluzione della classe: passo tasks_class → QDIMP_Tasks_{demo_slug} → prima classe caricata QDIMP_Tasks_* che ha il metodo. I profili personalizzati importati nell’interfaccia rimuovono tutti i passi run_task per motivi di sicurezza.

Esempio completo di pipeline

{
  "name": "Starter Shop",
  "description": "Theme, WooCommerce, media, content, setup, menu task",
  "pipeline": [
    { "step": "install_theme", "slug": "twentytwentyfour" },
    { "step": "install_plugin", "slug": "woocommerce" },
    { "step": "import_media", "directory": "images" },
    {
      "step": "import_content",
      "content_file": "content.xml",
      "fetch_attachments": true,
      "rewrite_urls": true
    },
    {
      "step": "apply_setup",
      "show_on_front": "page",
      "page_on_front": "home",
      "page_for_posts": "blog",
      "site_icon": "site-icon",
      "options": {
        "blogname": "Starter Shop",
        "permalink_structure": "/%postname%/"
      }
    },
    { "step": "run_task", "name": "setup_primary_menu" }
  ]
}

Flussi di lavoro di amministrazione

Eseguire una demo inclusa

1. Apri Strumenti → Demo Importer
2. Assicurati che l’Importatore WordPress sia pronto
3. Seleziona una demo, rivedi i passi, avvia l’importazione

Importare un profilo personalizzato

1. Incolla il config.json completo o scegli un file .json locale (letto nel browser)
2. Importa il profilo
3. Seleziona la nuova voce Custom ed eseguila

• Limite dimensione JSON circa 512 KB
• Vengono mantenuti solo i tipi di passo noti
• I passi run_task vengono rimossi all’import personalizzato
• I profili sono memorizzati sotto uploads e possono essere eliminati nell’interfaccia

Consigli pratici

• L’ordine conta: installa tema/plugin prima dei contenuti dipendenti; esegui import_media prima di apply_setup quando fai riferimento a slug di immagini.
• Riesecuzioni: temi/plugin già installati non vengono reinstallati alla cieca; gli slug media esistenti vengono saltati; i metodi dei task devono tollerare una seconda esecuzione.
• Permalink carini: imposta permalink_structure sotto apply_setup → options così le regole di riscrittura si aggiornano (importante su nginx).
• Mantieni la configurazione generica: pulizie una tantum o ricostruzioni di menu appartengono a tasks.php.
• Ometti chiavi vuote: non aggiungere "zip_url": ""; lascia fuori il campo quando non usato.

Errori e sicurezza

Ogni passo restituisce un messaggio di successo o un errore. L’interfaccia mostra il messaggio e interrompe la pipeline. Cause comuni includono uno slug di pagina mancante in apply_setup, Importatore WordPress inattivo, URL ZIP non valido, cartella images/ mancante o metodo task assente.

• Solo gli amministratori possono eseguire importazioni
• Gli URL remoti devono essere destinazioni http/https valide
• Il path traversal è bloccato per percorsi di contenuti e media
• Non distribuire PHP arbitrario tramite l’import di profili personalizzati; usa il tasks.php incluso solo per demo attendibili

Con un profilo ben ordinato, importare demo wordpress un click diventa un modo ripetibile per fornire risultati di importazione demo WordPress: pacchetti, media, contenuti WXR e opzioni finali del sito in un unico passaggio controllato.