Guide d’utilisation

Quick Demo Importer exécute importer démo wordpress un clic depuis Outils → Demo Importer. Vous avez besoin de la capacité manage_options. Chaque démo est un profil : un dossier avec un config.json obligatoire qui définit une pipeline ordonnée d’étapes. Les étapes s’exécutent une par une via AJAX. Si une étape échoue, les suivantes ne s’exécutent pas.

Emplacements des profils

• Fournis : wp-content/plugins/quick-demo-importer/demos/{slug}/
• Personnalisés : wp-content/uploads/quick-demo-importer/profiles/{slug}/

Lorsque le même slug existe aux deux endroits, le profil personnalisé est utilisé en premier.

Fichiers typiques dans un dossier de profil :

{slug}/
  config.json     # obligatoire
  content.xml     # export WXR optionnel
  images/         # médias locaux optionnels
  tasks.php       # tâches PHP optionnelles

Champs racine de config.json

• name (obligatoire) — titre d’affichage
• description (optionnel) — résumé court
• pipeline (obligatoire) — tableau non vide d’objets d’étape

Les types d’étape inconnus sont ignorés lors de l’analyse. S’il ne reste rien de valide, le profil est rejeté.

Exemple minimal :

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

Étapes de pipeline pour importer démo wordpress un clic

Chaque élément nécessite "step": "<type>" plus les champs spécifiques au type. L’ordre du tableau est l’ordre d’exécution. Utilisez cette structure lorsque vous souhaitez un import démo WordPress fiable qui installe les paquets, médias et contenus en un seul flux.

1. install_theme

Installe un thème. L’activation est activée par défaut.

• slug — feuille de style du thème / slug wordpress.org
• zip_url — URL HTTPS du ZIP (alternative ou complément optionnel au slug)
• activate — par défaut true ; définissez false pour installer uniquement

Fournissez au moins slug ou zip_url.

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

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

• Déjà installé + activate: true → change de thème si nécessaire
• Déjà installé + activate: false → laissé tel quel (pas de désactivation forcée)

2. install_plugin

Installe une extension. L’activation est activée par défaut.

• slug — dossier de l’extension / slug wordpress.org
• zip_url — URL HTTPS du ZIP
• activate — par défaut true ; définissez false pour installer uniquement

{ "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"
}

Lorsque zip_url est défini, cette archive est utilisée et l’API wordpress.org est ignorée. Gardez slug aligné avec le nom du dossier installé pour que l’activation puisse résoudre le fichier de l’extension.

3. import_media

Importe des fichiers image depuis un sous-dossier du profil dans la Médiathèque.

• directory — par défaut "images"

Extensions autorisées : jpg, jpeg, png, gif, webp, ico.

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

• post_name de la pièce jointe = nom de fichier assaini sans extension
• Slug existant → ignoré (sûr de relancer)
• Réutilisez ces slugs plus tard dans site_icon, custom_logo ou theme_mods_attachments

4. import_content

Importe WXR/XML via l’Importateur WordPress officiel (WP_Import). C’est la voie standard pour l’import XML WordPress et le contenu de démo exporté.

• content_url — URL HTTPS WXR distante (utilisée si non vide)
• content_file — fichier relatif sous le profil (par défaut content.xml)
• fetch_attachments — par défaut true
• rewrite_urls — par défaut 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’Importateur WordPress doit être actif. L’écran Demo Importer peut l’installer si nécessaire.

5. apply_setup

Applique une configuration générique du site. Placez la logique spécifique à la démo dans run_task à la place.

Lecture / page d’accueil

• show_on_front — page ou posts
• page_on_front / page_for_posts — slug ou titre de page

Identité visuelle

• site_icon — slug de pièce jointe
• custom_logo — slug de pièce jointe

Menus

• menus — map d’objets : { "location_slug": "Nom du menu" }

Modifications de thème

• theme_mods — valeurs scalaires
• theme_mods_attachments — clé de mod de thème → slug de pièce jointe → stocké comme URL

Options

• options — objet d’options WordPress (scalaires)
• permalink_structure dans options met à jour la structure et vide les règles de réécriture

{
  "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

Exécute une méthode de la classe tasks.php du profil.

• name (obligatoire) — nom de la méthode
• tasks_class (optionnel) — doit commencer par QDIMP_Tasks_

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

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

Forme de classe d’exemple :

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

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

Résolution de classe : étape tasks_class → QDIMP_Tasks_{demo_slug} → première classe chargée QDIMP_Tasks_* qui possède la méthode. Les profils personnalisés importés dans l’interface suppriment toutes les étapes run_task pour des raisons de sécurité.

Exemple complet de 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" }
  ]
}

Flux de travail d’administration

Exécuter une démo fournie

1. Ouvrir Outils → Demo Importer
2. S’assurer que l’Importateur WordPress est prêt
3. Sélectionner une démo, revoir les étapes, démarrer l’import

Importer un profil personnalisé

1. Coller le config.json complet ou choisir un fichier .json local (lu dans le navigateur)
2. Importer le profil
3. Sélectionner la nouvelle entrée Custom et l’exécuter

• Limite de taille JSON d’environ 512 Ko
• Seuls les types d’étape connus sont conservés
• Les étapes run_task sont supprimées à l’import personnalisé
• Les profils sont stockés sous uploads et peuvent être supprimés dans l’interface

Conseils pratiques

• L’ordre compte : installez thème/extensions avant le contenu dépendant ; exécutez import_media avant apply_setup lorsque vous référencez des slugs d’images.
• Relances : les thèmes/extensions déjà installés ne sont pas réinstallés à l’aveugle ; les slugs de médias existants sont ignorés ; les méthodes de tâche doivent tolérer une seconde exécution.
• Permaliens jolis : définissez permalink_structure sous apply_setup → options pour que les règles de réécriture se rafraîchissent (important sur nginx).
• Gardez la configuration générique : les nettoyages ponctuels ou reconstructions de menus appartiennent à tasks.php.
• Omettez les clés vides : n’ajoutez pas "zip_url": "" ; laissez le champ de côté lorsqu’il n’est pas utilisé.

Erreurs et sécurité

Chaque étape renvoie un message de succès ou une erreur. L’interface affiche le message et arrête la pipeline. Causes courantes : slug de page manquant dans apply_setup, Importateur WordPress inactif, URL ZIP invalide, dossier images/ manquant ou méthode de tâche absente.

• Seuls les administrateurs peuvent lancer des imports
• Les URL distantes doivent être des cibles http/https valides
• Le path traversal est bloqué pour les chemins de contenu et de médias
• Ne livrez pas de PHP arbitraire via l’import de profil personnalisé ; utilisez le tasks.php fourni uniquement pour les démos de confiance

Avec un profil bien ordonné, importer démo wordpress un clic devient un moyen répétable de livrer des résultats d’import démo WordPress : paquets, médias, contenu WXR et options finales du site en un seul passage contrôlé.