README

This is a composer package of the ProteusThemes widgets that are used in latest themes (CargoPress and up).

Deps which needs to be included in the theme

• Font Awesome CSS file with handle font-awesome on admin.
• Mustache.js with handle mustache.js on admin.

Translations

Translation strings live in languages/. The pipeline uses WP-CLI, so install it first (macOS: brew install wp-cli; other platforms: https://wp-cli.org/#installing). Then:

npm install      # one-time
npm run i18n     # regenerate proteuswidgets.pot, merge into *.po, compile *.mo

Individual steps are available as npm run i18n:pot, npm run i18n:po, and npm run i18n:mo.

Testing

Use the full first-release version when pinning a major WordPress release in the test installer. For example, use 7.0.0 instead of 7.0 so the installer resolves the release tag correctly.

Branch consolidation (2026-02-12)

The v3 branch has been folded into master. Previously, master held the v2.x line (Mustache-based, frozen since April 2018) while v3 (Plates-based) was the active default branch. Since no theme uses v2.x anymore, the branches have been consolidated:

• Old master (v2.x) archived as the v2 branch
• master now contains what was previously v3
• v3 branch deleted
• v4 branch remains unchanged (used by woondershop-pt)

All theme Composer dependencies use version tags (e.g. ^3.16.13), not branch names, so this change has no effect on dependency resolution.