wordpress-importer-setup

Scaffold a reusable WordPress page importer with AJAX-driven section imports.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/hifisaputra/wordpress-skills --skill wordpress-importer-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wordpress-importer-setup
Source: https://github.com/hifisaputra/wordpress-skills/tree/main/wordpress-importer-setup
Command: npx skills add https://github.com/hifisaputra/wordpress-skills --skill wordpress-importer-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill scaffolds a reusable WordPress page importer pattern to seed starter content into theme templates, enabling consistent initial data for new sites.

Core Features & Use Cases

  • Registry-based per-template bootstrap via a <prefix>_page_importer_versions hook that lets themes declare their own importer versions.
  • Tools → Import Page Template admin UI with a version dropdown, create-vs-replace option, target selection, and a live progress indicator.
  • AJAX-driven multi-step imports that run one section per request to avoid timeouts on slow hosts.
  • Image sideloader with source-path deduplication and safe SVG handling to attach media efficiently.
  • Per-template scaffolding that integrates with wordpress-page-acf-integration, producing a modular and replaceable importer setup.
  • Compatibility checks with the ACF JSON setup and a prereq prompt when the importer is missing.

Quick Start

Create a per-template bootstrap file that registers a version with the importer and use the Tools → Import Page Template page to seed starter content for a theme.

Frequently Asked Questions about wordpress-importer-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I seed starter content into custom WordPress page templates?

To seed starter content into custom WordPress page templates, you need a reusable importer pattern that registers versions via a hook and provides an admin UI to inject initial data. This scaffolds the importer directly into your theme.

How does an AJAX-driven WordPress importer prevent timeouts on slow hosts?

An AJAX-driven WordPress importer prevents timeouts by processing imports section-by-section per request rather than loading everything at once. This multi-step approach keeps each HTTP request lightweight and avoids server execution limits.

Does the WordPress page importer work with Advanced Custom Fields workflows?

Yes, the WordPress page importer integrates with Advanced Custom Fields workflows through per-template scaffolding and ACF JSON compatibility checks. It produces a modular setup that aligns directly with your existing ACF field configurations.

What is the best way to sideload images during a WordPress theme content import?

The best way to sideload images during a WordPress content import is using an image sideloader with source-path deduplication and safe SVG handling. This attaches media efficiently without duplicating existing files.

Can I replace existing page template content when running a WordPress import?

Yes, you can replace existing page template content during a WordPress import by selecting the create-vs-replace option within the Tools admin UI. This allows you to target specific templates and overwrite their current data cleanly.

Why does my WordPress theme need a version-based bootstrap for content imports?

A version-based bootstrap is needed for WordPress content imports to let themes declare their own importer versions securely. This registry hook ensures your theme handles data migrations correctly across different setup stages.