Installation & Distribution

Install order

  1. Go to Appearance → Themes → Upload and upload my-theme.zip.
  2. Activate My Theme from the Themes screen.
  3. Go to Addons → Upload and upload my-theme-loader.zip.
  4. Activate My Theme Loader from the Addons screen.

The theme must be installed and active before the loader is activated, otherwise the loader will display a warning banner on the front end until the theme is in place.

Distributing via a repository

You can host both zips on any web server and register them in a WordCore repository index. Add both as separate entries — the theme under themes and the loader under addons — so they can be installed individually from Settings → Repositories.

{
  "addons": [
    {
      "slug": "my-theme-loader",
      "name": "My Theme Loader",
      "version": "1.0.0",
      "description": "Loader for My Theme. Install alongside the My Theme theme.",
      "author": "You",
      "download": "https://example.com/repo/my-theme-loader.zip"
    }
  ],
  "themes": [
    {
      "slug": "my-theme",
      "name": "My Theme",
      "version": "1.0.0",
      "description": "A dark theme for WordCore.",
      "author": "You",
      "preview_color": "#1b2838",
      "download": "https://example.com/repo/my-theme.zip"
    }
  ]
}

Updating the theme

Because the CSS is read from disk at request time with file_get_contents(), updating the theme is as simple as uploading a new version of the theme zip. No changes to the loader addon are needed unless the theme slug changes.