How to Install Zorderz With an Ai Agent

Zorderz is open-source field service management software for WordPress, and it is built to be installed by an Ai agent, not only by a person.

This page is the short version. The full, ordered, machine-followable guide, with a verification after every step, lives in the repository and is linked below.

What you are installing

Zorderz ships as two files, a theme and an apps plugin, and it starts completely blank. No business is baked in, so you supply your own identity, people, catalog, and rules. It integrates the invoicing, customer relationship management, scheduling, and Ai tools a business already uses; Zorderz is deliberately not a customer relationship manager, and not a full billing system.

The install in four steps

1. Set WordPress permalinks to Post name, under Settings, then Permalinks.
2. Install and activate the theme, zorderz-theme, from the latest release. On most hosts that is the only upload you need, because the active theme installs and activates the apps for you.
3. Give the install its data: import a Company Data bundle, fill the Business Profile or apply an Identity Pack, or load the one-click sample company to explore first.
4. Reconnect your provider keys under Zorderz, Settings, App Authorizations. Connection secrets are never carried in a bundle, by design.

To confirm it is running: /wp-json/ lists the zorderz/v1 namespace, and /zdz-manifest.json returns JSON rather than your homepage.

For an autonomous Ai agent

Follow the canonical guide start to finish. It gives an action and a verification for every step, with WP-CLI, REST, and browser paths where they differ.

• Install guide for an Ai agent: docs/INSTALL-FOR-AI.md
• Agent entry point: AGENTS.md
• Latest release (the source of truth for the version): releases/latest
• Source and issues: github.com/CarletonTorpin/Zorderz

Always resolve the version from the latest release, and never hardcode a version number.

Requirements

• WordPress 6.0 or newer
• PHP 8.0 or newer
• MySQL 5.7+ or MariaDB 10.3+
• Pretty permalinks set to Post name
• HTTPS recommended, because OAuth connections require it

The one rule

Never invent business data. Zorderz ships empty on purpose, and what varies between businesses is configuration, not code. Give the install only the data the operator supplied, or leave fields blank to inherit from WordPress.