manifest / ecommerce / universal-product-reviews

Universal Product Reviews

Portable WooCommerce product-review operations plugin (UPR)

by magpern · github.com/magpern/universal-product-reviews · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/magpern/universal-product-reviews/archive/refs/heads/main.zip

Updates itself. It ships its own updater (Plugin Update Checker), so new versions appear under Dashboard → Updates.

Readme github.com/magpern/universal-product-reviews ↗

Public-source, proprietary WooCommerce plugin (UPR) for verified-purchase product reviews, line-item invitation lifecycle, moderation, retention, and host adapter integration.

Version: 0.8.0 (M7 storefront compatibility + M9 local AI shadow mode — tagged v0.8.0; v0.7.0 intentionally not published)

Status

Milestone	State
M0	Repository foundation and frozen architecture (Rev 6)
M1	Core enablement — bootstrap, HPOS declare, moderation hold, guest guard, availability filters (`v0.1.0`)
M2	Invitations runtime implemented on `feat/m2-invitations` (frozen at `m2-invitations-freeze`; not tagged `v0.2.0`)
M3+	Not started

This repository contains the portable plugin core and generic integration documentation. Host-specific adapters, theme CSS, and site configuration live outside this repository.

Requirements

WordPress 6.5+ (M1 CI/DEV mandatory: 7.0.2)
PHP 8.1+ (M1 CI/DEV mandatory: 8.4)
WooCommerce 8.2+ (M1 CI/DEV mandatory: 11.0.1)

Installation

Hosts install via bind-mount (DEV) or plugin ZIP (staging/production) after validating docs/production-replay.md. Apply WooCommerce settings per docs/integration/woocommerce-settings.md.

Documentation

Document	Purpose
`ARCHITECTURE.md`	Authoritative frozen technical specification (Rev 6)
`docs/milestones/M1-core-enablement.md`	Frozen M1 specification
`docs/milestones/M2-invitations.md`	Frozen M2 invitations specification
`docs/decisions/ADR-0001-repository-visibility.md`	Public repository governance
`docs/production-replay.md`	Host integration and deployment runbook
`docs/integration/`	Adapter contracts, public registry, onboarding, examples
`docs/decisions/ADR-0003-public-contract-compatibility.md`	Public contract compatibility policy
`docs/compatibility/`	Minimum platform expectations
`docs/runbooks/`	Operator runbooks
`docs/roadmap/post-m3-product-roadmap.md`	Post-M3 forward product roadmap (non-binding; M4–M8)
`docs/roadmap/m4-operator-controls-and-diagnostics.md`	Frozen M4.1 operator controls and diagnostics specification
`docs/roadmap/m4-operator-controls-and-diagnostics-closure.md`	M4.1 closure (`v0.4.0`)
`docs/roadmap/m5-review-moderation-operations.md`	Frozen M5 review moderation operations specification
`docs/roadmap/m5-review-moderation-operations-closure.md`	M5 closure (`v0.5.0`)
`docs/roadmap/m6-integration-and-developer-experience.md`	Frozen M6 integration and developer experience specification
`docs/roadmap/m6-integration-and-developer-experience-closure.md`	M6 closure (`v0.6.0`)
`docs/roadmap/m7-storefront-compatibility-and-quality.md`	Frozen M7 storefront compatibility and quality specification
`docs/integration/storefront-compatibility.md`	M7 storefront compatibility matrix (`upr-public-contracts/v1` C9/C10)
`docs/integration/public-contracts.md`	Canonical public contracts registry (`upr-public-contracts/v1`)

Development

composer install
composer ci
composer test:unit
# Integration (requires MySQL):
bash tests/bin/install-wp.sh
composer test:integration

Licence

Proprietary — public visibility does not grant an open-source licence. See LICENSE.md.

Freeze baselines

Tag	Purpose
`plan-rev6-freeze`	Rev 6 architecture baseline
`m1-core-enablement-freeze`	M1 plan freeze (documentation only)
`v0.1.0`	M1 runtime release (accepted)
`m2-invitations-freeze`	M2 plan freeze (documentation only)

Release tag v0.2.0 is created only after M2 closure acceptance.