Fiction DraftsWordPress backup plugin

Docs

Install & first backup

Two ways in: the release zip, which is ready to run, or the source repository, which is not — deliberately.

Requirements

RequirementVersion
WordPress6.4 or later
PHP8.1 or later
Tested up toWordPress 7.1
MultisiteNot 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
# 10694e753ae0f9bd527abaee4a2bb1bce1e6877cf81a4d87eea78a8562869bf3

From 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 screen

Then 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

  1. 1Fiction Drafts appears in your admin menu. Open it.
  2. 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.
  3. 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.
  4. 4Press Start backup. The screen names the stage it is on and counts real work, rather than showing an unexplained bar.
  5. 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 run

Uninstalling

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.