Troubleshooting
Diagnose common language, URL, relation, provider, and migration problems.
A translated URL returns 404
Confirm the translation exists, is related to the source, and has a public status. Check the language prefix and resave WordPress permalinks. A 404 is expected when no translation exists; mcLogiora does not fall back to the source language.
The switcher has no target
Use mclogiora_get_language_url() or the supported switcher. A null URL means the target translation does not exist. Do not construct a guessed path.
Suggestions are unavailable
Confirm suggestions are enabled, a provider is selected, a key is configured, and a model is explicitly selected where required. DeepL does not have a model selector. Run Test connection, then inspect System Status; testing the connection sends no content.
Import plan is stale
Generate a new dry-run plan. A stale-plan rejection protects the destination from applying an outdated view over newer changes.
REST is forbidden
Check the current user’s translation capability and the route family. /languages active reads are public; /languages?status=all, /relations, and /translations are more restricted by design.
Safe issue report
Include the mcLogiora version, WordPress/PHP versions, route family, redacted System Status output, and reproducible steps. Never include credentials, package files, private content, or unredacted server environment values.