Overview
This feature enables site administrators to manage Gregius Data plugin features from a single dashboard in the WordPress admin by providing tabbed access to Models, Connections, Sync, Vectors, Prompts, Search, and Logs.
Prerequisites
- Administrator access to the WordPress admin panel
- Gregius Data plugin installed and activated
- Modern browser with JavaScript enabled
Access the Dashboard
Navigate to the Gregius Data menu in the WordPress admin sidebar. The dashboard appears as the main admin page for the plugin.
Dashboard Tabs Overview
The dashboard organizes features into tabs. Each tab corresponds to a feature area:
- Models — Manage AI model configurations and settings.
- Connections — View and manage data source connections with active or inactive status.
- Sync — Configure and monitor data synchronization operations.
- Vectors — Manage vector embeddings and vector store settings.
- Prompts — Configure prompt templates and settings.
- Search — Manage AI site search settings and indexing.
- Logs — View plugin activity and operation logs.
Each tab loads its content from the Gregius Data REST API and displays status indicators for connectivity and data availability.
How the Dashboard Works
Startup and Connectivity Check
When the dashboard loads, it performs an automatic connectivity check against the WordPress REST API. During this check the dashboard shows a loading state. If the connection succeeds, the tabs become available for use. If it fails, an error notice appears on screen.
Navigation Between Tabs
Click any tab to switch between feature pages. Some areas of the plugin can trigger tab navigation programmatically, ensuring consistent cross-feature workflows without leaving the dashboard.
State Management
The dashboard uses shared state stores to keep data consistent across tabs. Settings, connection records, logs, and selection state remain in sync as you navigate between feature areas.
Error Handling and Troubleshooting
The dashboard handles errors at multiple levels:
- Startup failures — If the dashboard cannot initialize, diagnostic information is logged and a failure signal is emitted for support debugging.
- API errors — REST API errors returned by the server are displayed as visible notices in the dashboard interface.
- Missing container — If the dashboard container element is missing from the page, the plugin attempts to create a fallback container and render the dashboard.
Quick Troubleshooting
| Issue | What to check |
|---|---|
| Dashboard does not appear | Confirm the Gregius Data menu is visible in the admin sidebar |
| Tabs show loading state without resolving | Check that the WordPress REST API is accessible and you are logged in |
| Tab content does not switch | Refresh the page and try navigating again |
| Error notices on load | Check browser console for details and confirm API routes are registered |
Permissions
| Action | Required capability | Notes |
|---|---|---|
| Access and view the dashboard | manage_options | Standard WordPress admin capability for plugin settings pages |
| Read settings and status | manage_options | All dashboard tabs require this capability |
| Perform data operations through dashboard | manage_options | Backend REST controllers enforce permission checks independently |
Permission errors returned by the REST API are displayed as visible notices in the dashboard interface.
Known Limitations
- Not all backend features have dedicated dashboard pages yet. Some capabilities are available through the REST API or WP-CLI but a limitation of visual interface surface in the current dashboard.
- The dashboard requires JavaScript. It does not function in environments with scripting disabled.
Next Steps
View on GitHub: You can review, fork, and inspect the entire codebase and core logic over at the repository on GitHub.
Gregius Data is the open-source AI orchestration layer for WordPress.