NOTE: This plugin is currently in beta.
AI-powered interactive tutorials for the WordPress block editor.
Admin Coach Tours helps WordPress users learn the block editor through AI-generated step-by-step tutorials. Click "Help me..." in the editor, select a task or ask a question, and get an interactive guided tour tailored to your needs.
add-image-some.mp4
- AI-Generated Tours — On-demand tutorials created by AI based on your request
- 12 Predefined Tasks — Common tasks like adding images, videos, headings, and more
- Freeform Questions — Ask anything about the block editor
- Interactive Overlay — Visual highlighting guides you through each step
- Smart Block Targeting — Accurately identifies and highlights the correct elements
- Automatic Progression — Tours advance when you complete each action
- WordPress 6.8+
- PHP 8.3+
- sodium extension (for API key encryption)
- AI provider API key (OpenAI, Azure OpenAI, or Anthropic)
- Upload
admin-coach-toursto/wp-content/plugins/ - Activate the plugin
- Go to Tools → Coach Tours to configure AI
- Navigate to Tours → Settings
- Enable AI Features
- Select your provider:
- OpenAI — Add your API key
- Azure OpenAI — Add your API key and endpoint URL
- Anthropic — Add your API key
- Save settings
- Open any post or page in the block editor
- Click the "Help me..." button (bottom-right)
- Choose from the options:
Common Tasks:
| Category | Tasks |
|---|---|
| Media | Add image, Add video, Create gallery, Add cover |
| Text | Add heading, Create list, Add quote, Create table |
| Design | Add button, Create columns |
| Embed | Embed YouTube |
Or Ask a Question: Type any question about the block editor and press Enter.
- Follow the highlighted steps to complete the task
- Each step auto-advances when you perform the action
- Previous/Next — Navigate between steps
- Skip — Skip a step you already know
- Stop — Exit the tour at any time
- You ask — Select a task or type a question
- AI generates — The AI creates a custom tour with step-by-step instructions
- You follow — Interactive overlay highlights each target element
- You learn — Complete actions to progress through the tour
Tours are generated on-demand and not stored — each request creates a fresh, context-aware tutorial.
| Method | Endpoint | Description |
|---|---|---|
| GET | /wp-json/admin-coach-tours/v1/ai/tasks |
List available tasks |
| POST | /wp-json/admin-coach-tours/v1/ai/tour |
Generate AI tour |
| GET | /wp-json/admin-coach-tours/v1/ai/status |
Check AI availability |
composer install
npm installnpm run build # Production build
npm run start # Development mode with watchcomposer test # PHP tests
npm run test # JavaScript tests
npm run test:watch # Watch modecomposer lint # PHP (WPCS)
npm run lint # JavaScript (ESLint)| Filter | Description |
|---|---|
act_ai_providers |
Register additional AI providers |
act_ai_tasks |
Modify available task definitions |
act_tour_data |
Filter tour data before display |
| Action | Description |
|---|---|
act_tour_started |
Fired when a tour starts |
act_tour_completed |
Fired when a tour completes |
act_step_completed |
Fired when a step completes |
| Capability | Description | Default Roles |
|---|---|---|
act_use_ai |
Use AI features | Administrator |
act_run_tours |
Run tours | All logged-in users |
- API keys encrypted with libsodium
- All endpoints require authentication
- Capability checks on all operations
- Input sanitization and output escaping
GPL v2 or later — see LICENSE for details.
- Built with @wordpress/scripts and @wordpress/data
- AI integration supports OpenAI, Azure OpenAI, and Anthropic
- RAG knowledge base includes pedagogical content from Learn WordPress courses
