Fix problems that appear immediately after updating the Cointacted Social Terminal.

If the terminal worked before updating but now:

• doesn’t load
• commands don’t run
• styling is broken
• help output is empty
• JavaScript errors appear
• wallet detection fails

…this guide explains why and how to fix it fast.

These issues almost always come from caching, minification, or stale assets — not the update itself.

---

🔹 1. Clear Browser Cache (Most Common Fix) #

The update includes:

• new JS files
• updated CSS
• changed HTML structure
• new output logic

But your browser may still use old files.
This causes broken UI or non-working commands.

Fix:

Press: CTRL + F5 (Windows) #

Or: CMD + SHIFT + R (Mac) #

This forces a hard refresh.

---

🔹 2. Clear Cache From Optimization Plugins #

If you use:

• WP Rocket
• LiteSpeed Cache
• Autoptimize
• Nitropack
• SG Optimizer
• Cloudflare Cache
• FlyingPress

These plugins may still serve old JS/CSS, causing the new version to malfunction.

Fix:

• Purge all caches
• Disable JS minify
• Disable combine JS
• Disable defer JS
• Exclude the terminal scripts from optimization
• Purge Cloudflare

Then reload the page.

---

🔹 3. Minification Broke Script Order #

If your optimization plugin combined/minified scripts:

• core terminal JS loads too late
• add-on JS loads too early
• custom scripts load before dependencies

This leads to errors like:

CointactedSocialTerminalTerminal is not defined
registry is undefined
append_line is not a function

Fix:

Exclude these scripts from minify/defer:

cointacted-social-terminal-public.js
cointacted-social-terminal-terminal.js

And any add-on files:

cst-*.js
my-addon.js

---

🔹 4. Cloudflare Rocket Loader Broke the Terminal #

Rocket Loader is known for breaking:

• JS timing
• global variables
• event listeners

If terminal broke after an update:

Turn off Rocket Loader.

---

🔹 5. Add-On Incompatibility After Update #

If you updated the core plugin but not your add-ons:

• old add-on code may reference removed functions
• metadata structure may have changed
• deprecated commands may no longer exist

Fix:

• Update all Cointacted add-ons
• Reload the page
• Clear caches

Add-ons must match the core version.

---

🔹 6. Duplicate Terminals After Page Builder Update #

Page builders sometimes duplicate widgets after:

• template changes
• copy-paste blocks
• global section sync updates

If two terminals exist on one page:

• commands break
• registry gets overwritten
• input affects wrong DOM instance
• massive UI bugs appear

Fix:

• Remove duplicate shortcode
• Ensure terminal appears only once per page

---

🔹 7. Theme Update Overwrote CSS Fixes #

If your theme updated right before or after the plugin update:

• global form styles changed
• monospace fonts overridden
• input height forced
• spacing injected around containers

Fix:

Add CSS overrides back:

#cointacted-social-terminal-input {
    height: auto !important;
    padding: 0 !important;
    margin: 0 !important;
}

---

🔹 8. JavaScript Error in Custom Add-On or Theme Code #

If you added any custom JS that interacts with the terminal:

• update may have changed function names
• new structure may break old overrides
• outdated code may cause fatal JS errors

Check:

Inspect → Console

Look for:

Uncaught ReferenceError
Uncaught TypeError

Fix your custom code accordingly.

---

🔹 9. WordPress Update Changed Script Loading Order #

WP 6.1+ changed how scripts load, which can break older add-ons.

Fix:

Ensure your add-on enqueues depend on terminal script:

['cointacted-social-terminal-js']

If dependency missing → your script loads too early.

---

🔹 10. REST API Disabled or Conflicting After Update #

If an update introduced new REST endpoints and your security plugin blocks them:

• commands using fetch() fail
• JSON errors appear
• commands output nothing

Fix:

Whitelist:

/wp-json/cointacted/*

in your security plugin.

---

🔹 11. Rare: Old Files Still on Server (Stale Plugin Folder) #

Sometimes hosts fail to delete old files when replacing plugin folders.

Result:

• two versions of JS
• ghost functions
• outdated logic mixing with new logic

Fix:

1. Deactivate plugin
2. Delete plugin folder
3. Re-install from ZIP
4. Clear caches

This guarantees a clean install.

---

🎯 Summary #

If terminal breaks after updating:

✔ Clear browser cache #

✔ Clear plugin + theme + server + CDN cache #

✔ Exclude terminal scripts from minify/defer #

✔ Turn off Cloudflare Rocket Loader #

✔ Update add-ons to match core #

✔ Ensure only one terminal per page #

✔ Fix CSS overrides if theme changed #

✔ Check console for JS errors #

✔ Whitelist REST API routes #

✔ Reinstall plugin if necessary #

99% of update problems are caused by stale caches or optimization plugins—not the update itself.