|
|
@@ -176,17 +176,31 @@ Caveat specific to this shop: **studiou.cz strips the `?ver=` query string**, so
|
|
|
|
|
|
## Translations
|
|
|
|
|
|
-Czech (`cs_CZ`) and English. Edit the `.po` files, then compile:
|
|
|
+Czech (`cs_CZ`) and English.
|
|
|
|
|
|
-```
|
|
|
-wp i18n make-mo languages/
|
|
|
-```
|
|
|
+### This machine has no PHP toolchain — do not try to compile `.mo`
|
|
|
+
|
|
|
+Verified absent on this dev box: **`php`, `wp` (WP-CLI), `msgfmt`, and a working `python`** (the `python`/`python3` on `PATH` are Windows Store alias stubs that print an install prompt and exit, so they are not interpreters). Only `perl` and `git` are real.
|
|
|
+
|
|
|
+That rules out every compilation route the sibling plugins document:
|
|
|
+
|
|
|
+- `wp i18n make-mo languages/` — no WP-CLI, and it needs PHP anyway
|
|
|
+- `php languages/generate-mo.php` (the fallback in `studiou-wc-free-photo-product`) — no PHP
|
|
|
+- `msgfmt` — not installed
|
|
|
|
|
|
-`studiou-wc-free-photo-product/languages/generate-mo.php` is a dependency-free PHP fallback (`php generate-mo.php`) if WP-CLI is unavailable. Poedit or `msgfmt` also work. The `.mo` must be regenerated by hand — nothing does it automatically.
|
|
|
+**So: edit the `.po` files only, and leave `.mo` compilation to the user.** They compile manually (Poedit, or `msgfmt` on the server). When a change touches translatable strings, update the `.po`, say so explicitly, and tell the user the `.mo` still needs regenerating — do not claim the translation is live, and do not hand-craft a `.mo` binary.
|
|
|
+
|
|
|
+Nothing regenerates `.mo` automatically. A stale `.mo` silently serves the old strings, so an un-flagged `.po` edit looks like a translation that simply did not work.
|
|
|
+
|
|
|
+The same constraint applies to **any PHP verification**: this box cannot lint, parse, or run a line of this plugin. `php -l` is unavailable. Syntax errors will surface only in the user's WordPress install.
|
|
|
|
|
|
## Verification
|
|
|
|
|
|
-There are no automated tests. Verify in a WordPress install:
|
|
|
+There are no automated tests, **and nothing about this plugin can be executed on this machine** — no PHP, so no `php -l` syntax check, no unit runner, no `.mo` compile (see § Translations). Every claim about runtime behaviour has to be verified by the user in a real WordPress install, or not claimed at all.
|
|
|
+
|
|
|
+Report edits as "written, not yet run." Do not describe untested code as working.
|
|
|
+
|
|
|
+Verify in a WordPress install:
|
|
|
|
|
|
1. Enable `WP_DEBUG` and `WP_DEBUG_LOG`; watch `wp-content/debug.log`.
|
|
|
2. Inspect the queue at **WooCommerce → Status → Scheduled Actions**, filtered to the plugin's action group — check pending/complete/failed and the spacing between scheduled times.
|