-
Notifications
You must be signed in to change notification settings - Fork 0
Managing Projects
Once Dispatch is connected to Telex, you can install, update, and remove projects from the WordPress admin.
Navigate to Dispatch in the WordPress admin sidebar. A stats bar at the top shows total projects, how many are installed, and any available updates. Below it is the full project list.
- Search by name using the search field
- Filter by type using the Blocks and Themes tabs
- Sort by name, last updated, or most used
- Group projects into named collections using the groups panel
- Find the project in the list.
- Click Install.
- Dispatch downloads the latest build from Telex, validates all files with SHA-256 checksums, and installs it using the WordPress Upgrader API.
Blocks are activated automatically. Themes are registered but not activated — switch to a new theme manually via Appearance → Themes when ready.
wp telex install <project-id>When a new build is available, the project shows an update badge. You can update from:
- The Dispatch screen — click Update on the project row.
- The WordPress Updates screen — Dispatch surfaces Telex updates in the native updates list alongside your other plugins and themes.
wp telex update <project-id>
wp telex update --all # Update every installed, non-pinned project- Click the remove icon on any installed project row.
- Confirm the removal.
- Dispatch deactivates the item, removes all files, and cleans up its tracker.
wp telex remove <project-id>Lock a project at its current build to prevent updates — even from wp telex update --all. Useful for holding a known-good version stable while you test a newer build in staging.
Click the pin icon on any installed project to toggle it. Pinned projects show a lock badge.
wp telex pin <project-id>
wp telex unpin <project-id>Set any project to update automatically whenever a new build is published in Telex. Every automatic update is recorded in the activity log.
Configure auto-update from the dropdown on each project row:
| Mode | Behaviour |
|---|---|
| Off | Never update automatically |
| Immediate | Update as soon as a new build is available |
| Delayed 24h | Wait 24 hours after a new build before updating |
Snapshots capture the complete set of installed project versions at a point in time. Take one before a risky deploy and restore it in one command if anything breaks.
wp telex snapshot create --name="Before v2 launch"
wp telex snapshot list
wp telex snapshot restore <snapshot-id>
wp telex snapshot delete <snapshot-id>Snapshots are also accessible from the Dispatch admin screen.
Organize your library into named collections. Groups are per-user — each team member arranges projects independently. Use the group filter in the toolbar to show only projects in a specific collection.
Dispatch tracks how many posts each installed block appears in. The count is shown on each project row — a quick signal for which blocks are load-bearing before you update or remove them. This data is collected locally from your post_content and is never sent to Telex.
The Activity tab shows a full history of installs, updates, removals, and connection events with timestamps and acting user. Filter by action type, user, or date range. The log is GDPR-ready and registered with WordPress Privacy Tools.