wp-plugin-demo-library

Remote demo library for devmonowar's WordPress plugins. Served over GitHub Pages and consumed by each plugin's built-in "Demo Library" screen, so demos can be added or updated without shipping a new plugin release.

This repository contains only demo resources (JSON + images). It never contains WordPress plugin code, and nothing here is bundled into any plugin's WordPress.org package.

Layout

wp-plugin-demo-library/
├── general-slider/
│   ├── demo-library.json      # manifest: list of demos + metadata
│   ├── demos/                 # one JSON per demo (slides, settings, image URLs)
│   ├── previews/              # card thumbnails
│   └── assets/
│       ├── images/            # full-size slide images (sideloaded on import)
│       └── fonts/  svg/  videos/
└── advanced-testimonial/
    ├── demo-library.json      # manifest: list of demos + metadata
    ├── demos/                 # one JSON per demo (groups, testimonials, image URLs)
    ├── previews/              # card thumbnails
    └── assets/
        └── images/            # avatars / photos (sideloaded on import)

Each plugin gets its own top-level folder (general-slider/, advanced-testimonial/, future plugins…).

GitHub Pages

Enable Settings → Pages → Deploy from branch → main / / (root).

Base URL:

https://devmonowar.github.io/wp-plugin-demo-library/

Plugin manifests:

https://devmonowar.github.io/wp-plugin-demo-library/general-slider/demo-library.json
https://devmonowar.github.io/wp-plugin-demo-library/advanced-testimonial/demo-library.json

Manifest format

demo-library.json lists the available demos:

{
  "schema_version": 1,
  "plugin": "general-slider",
  "minimum_plugin_version": "2.3.2",
  "demos": [
    {
      "id": "nature-showcase",
      "name": "Nature Showcase",
      "description": "A cinematic full-width hero slider.",
      "version": "1.0",
      "updated": "2026-06-25",
      "requires": "2.3.2",
      "category": "Photography",
      "tags": ["hero", "nature"],
      "featured": true,
      "new": true,
      "preview": ".../previews/nature-showcase.jpg",
      "preview_width": 1200,
      "preview_height": 675,
      "file": ".../demos/nature-showcase.json"
    }
  ]
}

Each file points to one demo JSON. The shape depends on the plugin:

• General Slider: { "title", "slides": [ { "image_url", "sub_heading", "heading", "text", "btn_text", "btn_url" } ], "settings": { … }, "custom_css" }
• Advanced Testimonial: { "groups": [ { "name", "slug" } ], "testimonials": [ { "title", "content", "meta": { "company", "designation", "rating", "verified", … }, "groups": [ "slug" ], "image" } ] }

How plugins consume it

The plugin fetches its demo-library.json server-side (cached ~6 hours), renders one card per demo, and version-gates each by requires. On import it downloads that demo's file, sideloads every image into the site's Media Library, and creates the content (sliders, testimonials, …) — so nothing here ships inside the plugin package.

Adding a demo

1. Build the slider, then use Export Slider in General Slider to get a ZIP (demo JSON with image URLs already rewritten + the image files).
2. Drop the images into general-slider/assets/images/ and the JSON into general-slider/demos/.
3. Add the demo's entry to general-slider/demo-library.json.
4. Record the image source/license in general-slider/CREDITS.md.
5. Commit & push. The new demo appears in the plugin automatically (after the 6-hour manifest cache expires, or a manual refresh).

Advanced Testimonial: export a set from Testimonials → Settings → Tools → Export (testimonials + groups), drop the images into advanced-testimonial/assets/images/, rewrite the image URLs to this library, then add the demo JSON to advanced-testimonial/demos/ and an entry to advanced-testimonial/demo-library.json.

No plugin release or Git tag required.

Image licensing

Use only CC0 / public-domain or explicitly redistribution-friendly images (Openverse with the CC0 filter, Pexels, Pixabay). Images are downloaded onto end-user sites on import, so the license must allow that. See CREDITS.md.