Community Registry — WordPress install checklist
================================================

IMPORTANT — FOLDER NAME INSIDE THE ZIP (STABLE ACROSS VERSIONS)
----------------------------------------------------------------
Release zips extract to ONE folder whose name DOES NOT CHANGE between versions:

  community-registry/community-registry.php

After install you should see on disk:
  wp-content/plugins/community-registry/community-registry.php

The main PHP file basename matches the folder name on purpose — that is OK.
Updates must overwrite this same folder; the version appears only in the
.zip filename (e.g. community-registry-2.31.54.zip), not in the plugins path.

WordPress does NOT use the .zip file name as the plugin folder name.

ZIP FILENAME vs FOLDER NAME
---------------------------
If you unzip on Windows and upload by FTP, keep the extracted folder named
community-registry. Best: Plugins → Add New → Upload Plugin with the .zip.

1. BUILD THE ZIP (on your PC)
   Run in PowerShell from this plugin folder:
     .\package-zip.ps1
   This creates: ..\community-registry-<version>.zip and ..\community-registry.zip

2. BEFORE INSTALL (clean duplicate paths)
   Delete any existing Community Registry plugin folders under
   wp-content/plugins/, especially leftovers from old packages, e.g.:
     cr-community-registry
     community-registry
   Keep only ONE final install path you will use (recommended: community-registry).

3. INSTALL
   WordPress → Plugins → Add New → Upload Plugin → choose the zip → Install.

4. ACTIVATE
   The activation link should reference:
     community-registry/community-registry.php

5. IF "Plugin file does not exist"
   Confirm via FTP:
     wp-content/plugins/community-registry/community-registry.php
   exists and is readable.
   If the file exists but WordPress still shows the error, check for:
   - A second copy under a different folder name and remove duplicates.
   - A database import: wp_options.active_plugins may list an old path.
     Fix or reinstall from Plugins.

