# International Press Zone

International Press Zone is the Press.Zone multilingual and translation plugin for WordPress. The current architecture combines WordPress language management and translated content with a direct Press.Zone Connect/Worker integration for AI-assisted translation.

The repository is in the `0.9.x` commercial pre-release line. Production support is defined by the release's explicit supported-scope and evidence documents, not by historical roadmap files or dormant code.

## Current architecture

The plugin currently provides the core surfaces needed for a multilingual WordPress site:

- language management and default-language selection;
- translated posts; page translation is conditional on the current release acceptance evidence for the customer stack;
- string scanning and translation;
- synchronous and asynchronous/bulk AI translation through Press.Zone;
- localized frontend URLs and the WordPress language-switcher widget when the current release routing acceptance evidence is green;
- WordPress admin translation/settings/account surfaces;
- Connect-based per-site credentials stored server-side by WordPress, conditional on current Connect/social-auth release acceptance evidence.

The current account flow uses Connect-based per-site credentials stored server-side by WordPress. Historical architecture documents are not the current runtime contract.

## Requirements

Runtime requirements are the requirements enforced by the plugin and Composer configuration:

- WordPress 6.0+
- PHP 8.0+
- JSON and mbstring PHP extensions
- outbound HTTPS access to Press.Zone for connected account and AI translation features

Development/release tooling additionally requires Node.js and npm versions accepted by `admin/package.json`, Composer, `zip`, `unzip`, and the project's sanctioned WordPress/E2E fixtures.

## Installation

International Press Zone is currently distributed as a commercial ZIP package rather than through WordPress.org search.

1. Obtain the authorized release ZIP.
2. In WordPress admin, open **Plugins → Add New → Upload Plugin**.
3. Upload and activate **International Press Zone**.
4. Open the International Press Zone admin area.
5. Complete the account connection flow when available for the account.
6. Add the required languages and begin translating content.

Production package, billing, support, and entitlement details are supplied by Press.Zone. They are intentionally not duplicated as hard-coded prices, trials, or SLAs in this repository README.

## Release verification

Use the existing project tools; do not create ad-hoc release ZIPs.

```bash
# deterministic/static project gate
tools/factory-gate.sh all

# local WordPress verification of the checked-out plugin
node tools/verify-local.mjs

# build the next release archive; this command performs the project's
# version transaction and required archive/runtime verification
node tools/build-distribution.mjs

# verify an already-built archive
node tools/build-distribution.mjs --verify dist/international-press-zone-<version>.zip
```

Browser E2E must use the repository's sanctioned remote E2E path. Production deployment/update verification must follow the release plan and evidence contract; do not substitute a local source checkout for the built ZIP.

## Release scope

The first-customer support contract is maintained in:

- `docs/launch/FIRST-CUSTOMER-SCOPE.md`;
- `GOLIVE.md` for go-live criteria;
- `docs/launch/RELEASE-EVIDENCE.md` for the final release receipt once created.

A feature being present in source, an old plan, a demo, or a historical release does not by itself make it production-supported.

## Development documentation

Relevant current documentation is under `docs/`, especially:

- `docs/plans/INDEX.md` — active/superseded delivery plans;
- `docs/architecture/` — UI/runtime architecture rules and inventories;
- `docs/user_journeys/` — user-journey contracts and regression coverage;
- `docs/specs/` — current feature/design contracts.

When current implementation and an old historical plan disagree, follow the current canonical plan/index and current runtime architecture. Historical backend/onboarding designs are not the current release contract.

## Commercial terms and support

International Press Zone is commercial software. Current pricing, package limits, billing terms, trial availability, and support commitments belong to the live Press.Zone commercial/account surface and agreement. This repository intentionally does not hard-code values that can change independently of a plugin release.

See the plugin header and `composer.json` for repository/runtime licensing metadata. Current legal documents are under `legal/` and must be reviewed against the production service before commercial go-live.