Demo Content Importer
Pro featureBuddyX Pro 5.1.0+ ships a built-in one-click demo content path. It creates a small set of pattern-driven pages so a fresh install lands somewhere visually finished instead of a blank dashboard.
Important: this is NOT a legacy "Demo Importer" that copies an external site. There are no downloaded assets, no BuddyPress demo users, no sample posts, no widget-area dumps, and no external HTTP calls. The button creates a handful of real WordPress pages using patterns that ship inside the theme.
What it creates
One click creates seven WordPress pages, each composed of theme-shipped block patterns rendered against the no-sidebar full-width template:
| Page | Patterns used |
|---|---|
| Home | hero-typography-led, social-proof-logos, features-alternating, social-proof-stats, services-grid, social-proof-testimonials, general-pricing, general-faq, cta-fullbleed |
| About | hero-split-screen, about-story, about-founder, team-grid |
| Services | services-grid, features-alternating, cta-newsletter |
| Pricing | general-pricing, general-faq |
| Journal | (empty - this page is set as the posts page so the blog archive renders here) |
| FAQ | general-faq, cta-newsletter |
| Contact | contact pattern (form + map + business hours) |
Plus a primary navigation menu wiring those pages in the order above, and a couple of theme_mod defaults that match the demo screenshots (sidebar layout, blog archive layout, color preset).
That is the complete footprint. No BuddyPress activity, no member fixtures, no sample posts.
Why it works this way
- No external HTTP - the patterns live in the theme zip, the customer's site never reaches out to an importer server.
- No bundled images - keeps the theme zip small enough for the WP.org review process; images on the demo pages are theme assets you already have.
- Idempotent - clicking the button twice does NOT create duplicate pages. The component checks for existing pages by slug and refuses to overwrite.
- Customer-triggered - the button never fires on activation; the admin must click it.
- Translation-ready - every page title + nav label runs through
__()so language packs work out of the box.
Where to find it
Two paths land in the same place:
- Fresh install - opening the Customizer on a brand-new WordPress site (where the
fresh_siteoption is still1) automatically previews the demo pages + menu via WP's native Starter Content API. The customer just clicks Publish to commit them. No button hunt required. - Existing site - an admin notice appears on the dashboard with a Set up demo site button. Clicking it materialises the same set of pages outside the Customizer (the WP Starter Content API only works on truly fresh installs, so the button covers the other 99% of cases).
Steps - existing site
- Activate the BuddyX Pro theme.
- Look for the "Set up demo site" admin notice on the dashboard.
- Click Set up demo site.
- The 7 pages + nav menu are created. You stay on the same admin screen; refresh to see the new menu in Appearance > Menus.
- Visit the homepage to see the new layout.
To dismiss the notice without creating anything, click Dismiss. The notice does not return.
Steps - fresh install
- Activate the BuddyX Pro theme.
- Go to Appearance > Customize.
- The preview iframe shows the demo pages + the primary nav already wired up. Make any edits you want.
- Click Publish to commit the pages.
If you skip the Customizer step on a fresh install, the demo content stays available behind the same admin button described above.
Customising the result
After the pages exist, they are normal WordPress pages. You can:
- Edit them in Gutenberg like any other page.
- Swap any block pattern for another from the theme's pattern library at Patterns > Browse all.
- Re-arrange or rename pages without breaking anything - the demo button does not track them after creation.
- Delete any page you do not need.
The demo set is a starting point, not a managed snapshot.
Resetting
To go back to a blank site:
- Trash the demo pages from Pages.
- Delete the primary nav menu from Appearance > Menus.
- Reset the theme_mods the demo set: Appearance > Customize, then change any defaults the demo applied (sidebar layout, color preset).
There is no built-in "reset" button - the demo button is a one-way fill, not a sync.
What 5.0.x users will notice
The 5.0.x One-Click Demo Import experience that downloaded a remote site bundle was retired in 5.1.0:
- The Welcome screen no longer ships a "Demo Installation" card linking to an external docs page.
- The legacy importer plugin dependency (One Click Demo Import / similar) is no longer required.
- There is no sample BuddyPress data, no widget content blob, and no
.xmlsite export to import. - Customers who used the legacy importer should not need to do anything during the upgrade - the legacy importer's pages remain in WordPress as plain pages, untouched.
If you need that kind of full-site clone for a customer migration, ship a real WordPress export (Tools > Export) instead of relying on a theme-bundled importer.
Related
- Quick Start - 15-minute path from install to live site (use the demo button at step 1)
- Block Patterns - The pattern library the demo pulls from
- Color Presets - The colour palette the demo selects (default-light by default)
- Choose Your Path - Recipes by site type once the demo is in
Got a question? We're a friendly team - happy to help. support@wbcomdesigns.com