README

WordPress Site Manager using the Abilities API - A native, AI-ready alternative to MainWP.

Part of LW Plugins - Lightweight plugins for WordPress.

Requirements

PHP 8.1+
WordPress 6.9+
WordPress Abilities API

Installation

Via Composer

composer require lwplugins/lw-site-manager

Manual

Download the latest release from GitHub
Upload to wp-content/plugins/lw-site-manager
Activate the plugin in WordPress admin

Available Abilities

Updates

Ability	Description
`site-manager/check-updates`	Check for core, plugin, and theme updates
`site-manager/update-plugin`	Update a specific plugin
`site-manager/update-theme`	Update a specific theme
`site-manager/update-core`	Update WordPress core
`site-manager/update-all`	Update everything (with PHP error detection)

Plugin Management

Ability	Description
`site-manager/list-plugins`	List all installed plugins
`site-manager/install-plugin`	Install a plugin from WordPress.org
`site-manager/activate-plugin`	Activate a plugin
`site-manager/deactivate-plugin`	Deactivate a plugin
`site-manager/delete-plugin`	Delete a plugin

Theme Management

Ability	Description
`site-manager/list-themes`	List all installed themes
`site-manager/install-theme`	Install a theme from WordPress.org
`site-manager/activate-theme`	Switch to a different theme
`site-manager/delete-theme`	Delete a theme

Content Management

Ability	Description
`site-manager/list-posts`	List posts with filtering
`site-manager/get-post`	Get a single post
`site-manager/create-post`	Create a new post
`site-manager/update-post`	Update an existing post
`site-manager/delete-post`	Delete a post
`site-manager/set-post-terms`	Set taxonomy terms for a post
`site-manager/get-post-terms`	Get taxonomy terms for a post

Page Management

Ability	Description
`site-manager/list-pages`	List pages
`site-manager/get-page`	Get a single page
`site-manager/create-page`	Create a new page
`site-manager/update-page`	Update an existing page
`site-manager/delete-page`	Delete a page

Taxonomy Management

Ability	Description
`site-manager/list-categories`	List categories
`site-manager/get-category`	Get a single category
`site-manager/create-category`	Create a category
`site-manager/update-category`	Update a category
`site-manager/delete-category`	Delete a category
`site-manager/list-tags`	List tags
`site-manager/get-tag`	Get a single tag
`site-manager/create-tag`	Create a tag
`site-manager/update-tag`	Update a tag
`site-manager/delete-tag`	Delete a tag

User Management

Ability	Description
`site-manager/list-users`	List users
`site-manager/get-user`	Get user details
`site-manager/create-user`	Create a new user
`site-manager/update-user`	Update a user
`site-manager/delete-user`	Delete a user

Media Management

Ability	Description
`site-manager/list-media`	List media files
`site-manager/upload-media`	Upload a media file
`site-manager/delete-media`	Delete a media file

Comments

Ability	Description
`site-manager/list-comments`	List comments
`site-manager/approve-comment`	Approve a comment
`site-manager/spam-comment`	Mark comment as spam
`site-manager/delete-comment`	Delete a comment

Backup

Ability	Description
`site-manager/create-backup`	Create a full or partial site backup
`site-manager/list-backups`	List all available backups
`site-manager/restore-backup`	Restore site from a backup
`site-manager/delete-backup`	Delete a backup

Health & Diagnostics

Ability	Description
`site-manager/health-check`	Run comprehensive site health check
`site-manager/error-log`	Retrieve recent PHP errors

Database

Ability	Description
`site-manager/optimize-database`	Optimize database tables
`site-manager/cleanup-database`	Remove revisions, transients, spam, etc.
`site-manager/repair-database`	Repair database tables

Cache

Ability	Description
`site-manager/flush-cache`	Clear all caches (object, page, opcache)

Settings

Ability	Description
`site-manager/get-option`	Get a WordPress option
`site-manager/update-option`	Update a WordPress option
`site-manager/list-options`	List options with filtering

WooCommerce (if active)

Ability	Description
`site-manager/wc-list-products`	List WooCommerce products
`site-manager/wc-list-orders`	List WooCommerce orders
`site-manager/wc-order-stats`	Get order statistics
`site-manager/wc-revenue-report`	Get revenue reports

Documentation

Full API documentation is available in the docs/abilities directory.

Usage Examples

REST API

# Check for updates
curl -X GET "https://yoursite.com/wp-json/wp-abilities/v1/abilities/site-manager/check-updates/run" \
  -H "Authorization: Basic BASE64_ENCODED_APP_PASSWORD"

# Create a post with custom taxonomy
curl -X POST "https://yoursite.com/wp-json/wp-abilities/v1/abilities/site-manager/create-post/run" \
  -H "Authorization: Basic BASE64_ENCODED_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"input":{"title":"My Post","content":"Content here","status":"publish","taxonomies":{"my_custom_tax":[1,2,3]}}}'

# Set terms for a custom post type
curl -X POST "https://yoursite.com/wp-json/wp-abilities/v1/abilities/site-manager/set-post-terms/run" \
  -H "Authorization: Basic BASE64_ENCODED_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"input":{"id":123,"taxonomy":"product_cat","terms":[5,10]}}'

PHP

// Check updates
$ability = wp_get_ability( 'site-manager/check-updates' );
$updates = $ability->execute( [ 'type' => 'all' ] );

// Create a post with custom taxonomies
$ability = wp_get_ability( 'site-manager/create-post' );
$result = $ability->execute([
    'title' => 'My New Post',
    'content' => 'Post content here',
    'status' => 'publish',
    'taxonomies' => [
        'category' => [1, 2],
        'post_tag' => [5, 6, 7],
        'my_custom_tax' => [10, 11],
    ],
]);

Authentication

Use WordPress Application Passwords for REST API authentication:

Go to Users → Your Profile
Scroll to "Application Passwords"
Create new application password
Use Basic Auth: Authorization: Basic base64(username:app_password)

AI Integration

This plugin is designed for AI agent integration via:

REST API - Any AI can call abilities via HTTP
MCP Adapter - Claude, GPT can use abilities as tools
Agentic Loops - AI decides which abilities to call

Example AI workflow:

User: "Check my site and update everything safely"

AI Agent:
1. Calls site-manager/health-check
2. Calls site-manager/check-updates
3. Calls site-manager/create-backup
4. Calls site-manager/update-all with stop_on_error=true
5. If errors: reports issues, suggests rollback
6. If success: calls site-manager/health-check again
7. Returns summary to user

License

GPL-2.0-or-later

lwplugins / lw-site-manager

Maintainers

Details