Close this repository in favour of Umbra-Bookshelf

The three plugins tracked here are consolidated into a single Umbra Bookshelf
plugin, released from its own repository. This repository is now read-only and
retained for provenance.
This commit is contained in:
bdm
2026-10-18 19:55:45 -07:00
parent dec732931c
commit 43b9725cd0

54
CLOSED.md Normal file
View File

@@ -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`.