PHPackages coysh-digital/craft-manager-connector - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. coysh-digital/craft-manager-connector ActiveCraft-plugin[Logging & Monitoring](/categories/logging) coysh-digital/craft-manager-connector ===================================== Reports operational metadata from a Craft CMS installation to a Manager platform over signed, outbound-only requests. 1.5.0(today)010↑2600%proprietaryPHPPHP >=8.2CI failing Since Jul 30Pushed todayCompare [ Source](https://github.com/Coysh-Digital/craft-manager-connector)[ Packagist](https://packagist.org/packages/coysh-digital/craft-manager-connector)[ RSS](/packages/coysh-digital-craft-manager-connector/feed)WikiDiscussions main Synced today READMEChangelogDependencies (4)Versions (6)Used By (0) Manager Connector for Craft CMS =============================== [](#manager-connector-for-craft-cms) Reports operational metadata from a Craft CMS 5 installation to a [Manager](https://managerforcraft.com) platform over signed, outbound-only requests. **MIT licensed.** This plugin is privileged code running inside your production website, so it is published in full, kept deliberately small, and licensed permissively: it sits in your codebase next to your own work, and a copyleft licence there would raise a question you should never have to put to a lawyer before you can monitor your own websites. Read it before you install it. That is what it is here for. Requires PHP 8.2+ and Craft CMS 5.0+. What it does ------------ [](#what-it-does) - Generates an Ed25519 keypair **on your server**. The private key never leaves it. - Signs every request it sends, so the platform can prove it came from this installation. - Reports version numbers, update availability, licence state and similar operational metadata. What it cannot do ----------------- [](#what-it-cannot-do) These are not promises about intent; they are properties of the code. **No inbound endpoint**The plugin registers no site or control-panel route that accepts management input. Every exchange is started by this plugin, outbound. It works from behind NAT with no inbound firewall rules.**No remote execution**There is no console-command runner, no PHP evaluation, no SQL, no shell, no arbitrary file access. Jobs come from a closed registry, and this plugin refuses any type it does not itself implement — so a compromised platform cannot make your site do something new.**No credentials held**Manager never receives an administrator password, an SSH credential or a database password. There is nowhere in its schema to put one.**No site content**What may be transmitted is fixed by a shared schema. The platform rejects anything outside it rather than quietly discarding the extra.What it reports --------------- [](#what-it-reports) Version numbers, plugin and Composer package names and versions, a handful of safe configuration booleans, queue and migration counts, locally-computed licence state, and an environment classification. Never entries, assets, user records, password hashes, sessions, logs, environment-variable values, security keys, licence keys, API credentials, database credentials or configuration file contents. Do not take that on trust. See exactly what your site would send: ``` php craft manager-connector/preview ``` Documentation ------------- [](#documentation) Full documentation lives in the [`docs`](docs/) folder of this repository. This README is the short version; the docs go deeper on pairing, exactly what is and is not sent, what each capability permits, how backups work, the security model, the console commands, and troubleshooting. Requirements ------------ [](#requirements) - Craft CMS 5.0 or later - PHP 8.2 or later - A Manager installation to report to, self-hosted or Manager Cloud Installation ------------ [](#installation) ``` composer require coysh-digital/craft-manager-connector php craft plugin/install manager-connector ``` Set the platform URL in `config/manager-connector.php`: ``` return [ 'platformUrl' => 'https://manager.example.org', ]; ``` Kept in version control rather than in the database on purpose: pointing a site at a different Manager platform should take a deployment. Pairing ------- [](#pairing) Ask your administrator for a single-use enrolment code, then: ``` php craft manager-connector/pair mgr_enrol_... ``` The code is valid once and expires quickly. If the host this site serves from differs from the domain the platform expected, pairing is held until a person confirms it — nothing is reported in the meantime. Scheduling ---------- [](#scheduling) ``` */5 * * * * cd /path/to/site && php craft manager-connector/heartbeat */5 * * * * cd /path/to/site && php craft manager-connector/jobs 0 * * * * cd /path/to/site && php craft manager-connector/report 17 4 * * * cd /path/to/site && php craft manager-connector/updates ``` The heartbeat carries no data at all. Hourly is plenty for the inventory report, since version numbers only change when you deploy. The update check runs daily and at an odd minute, so a fleet of sites does not all ask Craft's update service at once. `jobs` is what makes anything the platform asks for actually happen. Nothing is pushed to your site — the platform has no way to reach it — so this is the site choosing to ask. Commands -------- [](#commands) CommandPurpose`manager-connector/pair `Pair with a platform`manager-connector/heartbeat`Report liveness`manager-connector/report`Send an inventory report`manager-connector/updates`Check for updates and report what is available`manager-connector/jobs`Ask the platform whether there is anything to do, and do it`manager-connector/preview`Print what would be sent, without sending it`manager-connector/status`Show the current connection`manager-connector/disconnect`Delete this site's signing keyPairing and disconnection are console commands rather than buttons. Both are deliberate acts by someone with server access, and behind a button a hijacked control-panel session could hand a platform access to your site, or take it away. Disconnecting ------------- [](#disconnecting) ``` php craft manager-connector/disconnect ``` The keypair is deleted outright rather than flagged, so there is nothing to reactivate. Reconnecting needs a new enrolment code. Revoke the connector in Manager as well, so the platform stops expecting it. Security -------- [](#security) Report vulnerabilities privately to . Please do not open a public issue. Dependencies are limited to the shared protocol package and PHP's own `sodium` extension; HTTP goes through the Guzzle client Craft already ships. Licence ------- [](#licence) **MIT.** See [LICENSE.md](LICENSE.md). Permissive on purpose. This plugin is installed into other people's codebases, so the licence should never be a reason to hesitate. The control plane it reports to is [AGPL-3.0-or-later](https://github.com/Coysh-Digital/manager), and the [wire protocol](https://github.com/Coysh-Digital/manager-protocol) between them is MIT, so the whole contract can be read, verified or reimplemented by anyone. ### Health Score 43 — FairBetter than 89% of packages Maintenance100 Actively maintained with recent releases Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 5 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5764356?v=4)[Tim Coysh](/maintainers/Coysh)[@Coysh](https://github.com/Coysh) --- Top Contributors [![Coysh](https://avatars.githubusercontent.com/u/5764356?v=4)](https://github.com/Coysh "Coysh (19 commits)") --- Tags monitoringmanagercmsCraftcraftcmscraft-plugin ### Embed Badge ![Health badge](/badges/coysh-digital-craft-manager-connector/health.svg) ``` [![Health](https://phpackages.com/badges/coysh-digital-craft-manager-connector/health.svg)](https://phpackages.com/packages/coysh-digital-craft-manager-connector) ``` ### Alternatives [verbb/formie The most user-friendly forms plugin for Craft. 101393.6k74](/packages/verbb-formie)[verbb/vizy A flexible visual editor field for Craft. 4250.4k](/packages/verbb-vizy)[verbb/hyper A user-friendly links field for Craft. 24147.8k12](/packages/verbb-hyper)[verbb/events A full-featured plugin for event management and ticketing. 2311.9k](/packages/verbb-events) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)