diff --git a/CLOSED.md b/CLOSED.md new file mode 100644 index 0000000..a7e9291 --- /dev/null +++ b/CLOSED.md @@ -0,0 +1,54 @@ +# CLOSED + +**This repository is archived and closed. Development continues in +[`Umbra-Bookshelf`](https://git.mini-eq/umbragit/Umbra-Bookshelf).** + +Closed: 2026-10-18 + +--- + +## Why + +This repository held three separate WordPress plugins — **BD Bookshelf**, +**BD BookShelfHelper** and **BD SimpleEmail** — that shipped the same product +surface under three different admin menus. They were consolidated into a single +plugin, **Umbra Bookshelf**, which now lives in its own repository. + +## What moved where + +| Was | Is now | +|---|---| +| `bd-bookshelf-plugin/` | `Umbra-Bookshelf/umbra-bookshelf/includes/books/` | +| `bd-bookshelfhelper/` | `Umbra-Bookshelf/umbra-bookshelf/includes/library/` | +| `bd-simpleemail/` | `Umbra-Bookshelf/umbra-bookshelf/includes/email/` | +| `SPEC_BD_Bookshelf_Plugin.txt` | `Umbra-Bookshelf/umbra-bookshelf/spec/SPEC_Umbra_Bookshelf_Plugin.md` | +| `SPEC_BD_BookHelper_Plugin.txt` | `Umbra-Bookshelf/umbra-bookshelf/spec/archive/` | +| `bd-bookshelf/` (theme) | `Umbra-Bookshelf/theme/` — unchanged, still a separate artifact | + +The `v1.0.0` tag marks the final state of the consolidated plugin before the +repository was closed. + +## This repository is read-only + +No further commits will be made. The history is preserved for provenance — +including the original separate plugins, which are recoverable at the tags and +commits before `dec7329`. + +Do not install the individual plugins from here. They were never designed to run +together: they collide on the `bd_books` and `bd_series` tables, both register +an admin menu, and they attach duplicate handlers to the same AJAX actions and +cron hooks. See `Umbra-Bookshelf/umbra-bookshelf/docs/KNOWN-ISSUES.md`. + +## Upgrading an existing site + +Install **Umbra Bookshelf** from the new repository, then **deactivate** BD +Bookshelf, BD BookShelfHelper and BD SimpleEmail in WordPress. + +**Deactivate, do not delete.** Deleting a plugin runs its uninstall routine, +which drops your database tables and options. Umbra Bookshelf reads and writes +the same table names, option keys, post meta, cron hooks and shortcodes, so +existing data carries over untouched. + +The admin menu structure changed: three top-level menus became one +**Umbra Bookshelf** menu. The full submenu map is in +`Umbra-Bookshelf/umbra-bookshelf/spec/SPEC_Umbra_Bookshelf_Plugin.md`.