Installation

View as Markdown

How to install Adminkeep from your WordPress admin or WP-CLI, what it needs to run, how updates arrive, and what deleting the plugin keeps or removes.

Requirements

  • WordPress 6.9 or newer
  • PHP 7.4 or newer

Adminkeep is free, GPL-licensed, and hosted in the WordPress.org plugin directory.

Install from your WordPress admin

01

Search

Go to Plugins → Add New Plugin and search for Adminkeep.

02

Install

Click Install Now on the Adminkeep card.

03

Activate

Click Activate. Done.

Prefer the command line? WP-CLI installs it by name:

wp plugin install adminkeep --activate

You can also download the zip from the plugin’s WordPress.org page and upload it under Plugins → Add New Plugin → Upload Plugin.

After activation

Adminkeep adds its settings under Settings → Adminkeep, and the Plugins screen has a Settings link to it. That screen is the whole plugin.

Every feature starts off. Activating the plugin changes nothing on your site until you switch something on — a feature you haven’t enabled registers zero hooks and loads zero assets.

Updating

Updates come from WordPress.org through the normal WordPress update flow. When a new version is released, it appears on your Dashboard → Updates screen and in the plugin list like any other update — one click, or automatic if you enable auto-updates for it.

Your settings survive every update: everything lives in a single option row that the update never touches. If you’d rather update by hand, uploading a newer release zip over the installed copy works too — WordPress asks to Replace current with uploaded.

Uninstalling

Deactivating the plugin simply stops all features and deletes nothing.

Deleting it keeps your data, unless you ask otherwise (since 2.2.0). The settings, your Custom CSS and Header & Footer Code, the SMTP and Contact Form settings, the email log and the Keep URL redirects all stay in the database, so installing Adminkeep again brings everything back as it was. Only its scheduled jobs are cleared, since nothing is left to run them. Before 2.2.0, deleting the plugin always removed its data.

To have everything removed when you delete the plugin, go to Settings → Adminkeep → Plugin settings, tick Delete all Adminkeep data when the plugin is deleted and press Save changes first. Or from a shell:

wp adminkeep setting set delete_data=true
wp plugin uninstall adminkeep --deactivate

With that setting on, deleting the plugin removes:

  • The settings, the Custom CSS, the Header & Footer Code, and the SMTP and Contact Form settings.
  • The email log table, with every email in it.
  • The Keep URL redirect table. Old page addresses stop redirecting.
  • Live Draft pointers and Replace Media bookkeeping from post meta.
  • What Two-Factor Login stored: remembered devices, any login waiting on its code, any wrong-code lock and the recovery link.

One thing is left alone on purpose, even then: media files. If Replace Media kept previous versions of a file, those stay on disk. Deleting user uploads is not this plugin’s call to make.

The clean-up runs when you press Delete on the Plugins screen, or run wp plugin uninstall adminkeep. wp plugin delete removes the files without running it, so it never deletes data.

On multisite, each site in the network follows its own setting: a site that switched it on is cleaned up, and the others keep their data.

Switch on what you need. Forget the rest.

A free WordPress plugin — GPL, instantly reversible, and updates come to you.

Type to search the whole site.