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