Docs
Install & first backup
Two ways in: the release zip, which is ready to run, or the source repository, which is not — deliberately.
Requirements
| Requirement | Version |
|---|---|
| WordPress | 6.4 or later |
| PHP | 8.1 or later |
| Tested up to | WordPress 7.1 |
| Multisite | Not supported in this release — see Security |
From the release zip
Download fiction-drafts-0.1.0.zip (452 KB, 248 entries) and install it the ordinary way: Plugins → Add New → Upload Plugin → Activate.
The archive is self-contained. The Composer autoloader, the bundled Action Scheduler and the compiled admin bundle are all inside it, so nothing needs to be built on the server.
Activation creates the storage directory and generates its random 32-character suffix.
Verify the download before installing it:
shasum -a 256 fiction-drafts-0.1.0.zip
# 10694e753ae0f9bd527abaee4a2bb1bce1e6877cf81a4d87eea78a8562869bf3From source
The repository is the source, not a distributable build. vendor/ and build/ are deliberately not committed, so a plain clone dropped into wp-content/plugins/ will activate and then do nothing — there is no autoloader and no admin bundle until you produce them.
# clone, then build the two things the repo does not ship
git clone git@github.com:dgaitan/Fiction-Drafts.git fiction-drafts
cd fiction-drafts
composer install --no-dev # Action Scheduler + the autoloader
bun install && bun run build # the admin screenThen drop the directory in wp-content/plugins/ and activate it. To produce the exact distributable zip yourself, run bun run package — it verifies its own output before reporting success.
Your first backup
- 1Fiction Drafts appears in your admin menu. Open it.
- 2On the New backup tab, pick a profile. Everything is the default; Files without media is the smallest copy that still carries all your code and content.
- 3Decide about
wp-config.php. It is off unless you tick it, and the choice never carries over to the next backup. Read why before you tick it. - 4Press Start backup. The screen names the stage it is on and counts real work, rather than showing an unexplained bar.
- 5When it completes, download each volume and check the SHA-256 shown beside it.
On a very low-traffic site the queue can idle
Background work runs through Action Scheduler, which is nudged along by site traffic. If a job appears to sit still on a quiet site, force the queue:
wp action-scheduler runUninstalling
Deleting the plugin removes everything it created: its two fdrafts_ tables, its fiction_drafts_ options, the storage directory and every archive in it, and the fiction-drafts Action Scheduler group.
It deliberately does not drop the actionscheduler_* tables. Action Scheduler is a shared library — WooCommerce and anything else that bundles it use the same tables — and dropping them here would break every one of those plugins at the moment this one is removed.
Uninstall cleans the site it runs on. On a network it does not loop over the others.