Troubleshooting Common Issues in OxyGen Code Management Studio
1) Quick checks (do these first)
- Clear caches: browser, server/host, CDN and any plugin caches.
- Update: OxyGen, IDE/plugins, and language runtimes to their latest compatible versions.
- Disable extensions: deactivate nonessential extensions/plugins and retry.
- Reproduce & note: record exact steps, timestamps, and any error messages or screenshots.
2) Builder/IDE won’t load, hangs, or fails to save
- Turn off caches and extensions; test in an incognito browser.
- Open browser DevTools → Console/Network and copy errors.
- Check server logs for timeouts, permission blocks, or PHP/worker errors.
- Increase server limits (or ask host): execution time, memory, FastCGI/nginx timeouts.
3) 4xx / 5xx HTTP errors
- 403 Forbidden: often a firewall/WAF, CDN, or security plugin blocking save/REST endpoints. Have host or security provider whitelist relevant endpoints. Known culprits: SiteLock/CDN, Hostinger CDN/firewall.
- 500 / 503 / 504: server or PHP crashes, timeouts, overloaded workers, or bad code (e.g., in Code Blocks). Provide exact timestamps and error-log excerpts to host/support.
- 524 (Cloudflare): origin too slow — optimize or increase origin timeouts.
4) Plugin/extension conflicts
- Run a conflict test (only OxyGen active).
- Reactivate extensions one-by-one to find the offender.
- Disable or replace incompatible extensions; check extension changelogs for compatibility notes.
5) CSS/asset or rendering problems
- Regenerate OxyGen’s CSS/asset cache (or equivalent rebuild).
- Disable CSS/asset caching while troubleshooting.
- Confirm correct file permissions and paths for generated assets.
6) Pagination, repeaters, or data-related issues
- Ensure site/OS-level “posts per page” or equivalent matches component settings.
- Check queries for limits, offsets, or malformed parameters.
7) Code block / custom code causing failures
- Comment out custom code snippets (JS/PHP) in Code Blocks to isolate.
- Validate code for infinite loops, heavy queries, or DOM bloat causing timeouts.
8) Multi-user editing, ID conflicts, or structure-pane problems
- Duplicate element IDs cause multiple selection/structure issues—remove duplicate IDs.
- For multi-user edit locks, follow the product’s collaboration troubleshooting steps or contact support.
9) Update, licensing, and activation errors
- Refresh license keys via the product portal if “unauthorized” or “inactive” on update.
- Ensure network connectivity and that licensing servers are reachable.
10) What to include when contacting support
- Exact reproduction steps and page/template URLs.
- Timestamp (with timezone) of the failure.
- Screenshots and browser console/network logs.
- Server/PHP/web-server log excerpts for the timestamp.
- Environment details: product/IDE version, OS/PHP/runtime version, active plugins/extensions list.
If you want, I can convert this into a stepped checklist or a one-page troubleshooting template you can use when filing support tickets.