Skip to content

v2.0.0.0

Latest

Choose a tag to compare

@thathman thathman released this 01 Sep 15:09

OJS Chatwoot Integration v2.0.0.0

Live chat and a full public Support Gateway for OJS journals, powered by Chatwoot.

Target platform

  • OJS: 3.5.x (verified via a real install/upgrade on a live OJS 3.5.0-5 instance; OJS 3.6 is not claimed or tested).
  • PHP: 8.2, 8.3 (matches OJS 3.5's own real requirement; exercised on every CI run for this release).
  • Database: MySQL 8.0 has real integration-test evidence (a real v1→2.0.0.0 upgrade). MariaDB and PostgreSQL are supported by OJS itself and expected to work, but have not received equivalent integration testing for this release.

What's included

  • Live chat widget with rich journal/user context (v1), including blind-review anonymity protection.
  • Public Support Gateway: verified-identity sessions (PIN/link), a 14-endpoint REST API, an MCP adapter for AI-agent clients, generated public knowledge pages, and one-click Chatwoot Captain provisioning (Knowledge Document, Custom Tools, Scenarios).
  • Admin health/control plane: consolidated Support Gateway health dashboard, manual Captain sync/repair, dead-letter retry, Event Bridge delivery-mode policy (private note / customer-visible with explicit opt-in / audit-only), mail-transport test.
  • Real, tested v1 → 2.0.0.0 upgrade path.

Explicit scope boundaries (not included in this release)

  • No OJS 3.6 compatibility claim.
  • No public staff-facing mutation/diagnostics plane (staff writes remain out of scope for this release).
  • The built-in PIN/link verification emails work, but the full admin-configurable verification EmailTemplate migration is deferred.
  • MariaDB/PostgreSQL integration testing is deferred (OJS itself supports them; this plugin has not separately verified them).

Package

  • chatwootIntegration-2.0.0.0.tar.gz — single top-level chatwootIntegration/ directory, ready to extract into plugins/generic/.
  • MD5: 752d100032f333ba9d142c485bbfd8ac
  • SHA-256: af16b0657585af6676c86cd0cdd08ec25323cc941616ead97b6117f5107fb727
  • Size: 341510 bytes

See docs/v2/ at this release commit for the full guide set (install, upgrade, security, REST API, MCP setup, and more).