- Preparation & Precautions Before Installation – GEOmatic AI
Preparation & Precautions Before Installation – GEOmatic AI #
1. Mandatory Backup #
Make a full backup of your site (database + files) before any installation or major update.
Recommended tools: UpdraftPlus, All-in-One WP Migration, cPanel backup, or your hosting provider’s backup system.
If an activation problem occurs, you’ll be able to restore the site within minutes.
2. Check the Server Environment #
- PHP: minimum version 7.4, recommended 8.x.
- HTTPS enabled: GEOmatic AI will reject license checks over plain HTTP.
- Required PHP extensions:
- cURL (HTTP requests)
- OpenSSL (HMAC, AES encryption)
- JSON (API response handling)
- cURL (HTTP requests)
- wp_cron enabled:
- Required for silent license verification and scheduled tasks.
- Check using wp cron event list or a plugin like WP Crontrol.
- Required for silent license verification and scheduled tasks.
- Outgoing connections allowed:
- Hosting must allow HTTPS requests to geomatic.cloud.
- If you have a server firewall, whitelist geomatic.cloud.
- Hosting must allow HTTPS requests to geomatic.cloud.
3. Plugin & Theme Compatibility #
Security Plugins #
- Wordfence, iThemes Security, SecuPress, etc.
→ Temporarily disable “firewall” protection during activation.
→ Afterwards, add geomatic.cloud as an allowed domain for outgoing connections.
SEO Plugins #
- Yoast, Rank Math, SEOPress, All in One SEO…
- May rewrite or block GEOmatic AI’s REST routes (/wp-json/geoai/*).
- May inject HTML into JSON responses → parsing errors.
- Solution: add an exception in settings for /wp-json/geoai/* routes and disable HTML optimizations for these routes.
- May rewrite or block GEOmatic AI’s REST routes (/wp-json/geoai/*).
Caching/Optimization Plugins #
- WP Rocket, LiteSpeed Cache, W3 Total Cache…
- Clear the cache after installation.
- Add an exclusion for /wp-json/geoai/* routes.
- Clear the cache after installation.
Themes #
- Themes generally don’t cause issues, but beware of themes with built-in firewalls or that modify REST routes.
4. Previous Version of the Plugin #
If an older version is present:
- Deactivate the plugin.
- Save the license key if you plan to reuse it.
- Delete the old version before uploading the new one.
5. License & API Keys (optional at installation) #
- No license key or token is required to install and activate GEOmatic AI — the plugin works autonomously with its basic features right after installation.
- API keys (e.g., OpenAI) can be added later to enable advanced AI features.
- OpenAI API Key:
- Free or paid creation depending on the quota needed.
- Official link to get a key: https://platform.openai.com/account/api-keys
- Free or paid creation depending on the quota needed.
- Once obtained, the OpenAI key can be entered in GEOmatic AI Settings → API Keys.
6. Installation Procedure #
- Go to Plugins → Add New.
- Click Upload Plugin and select the plugin .zip file.
- Activate the plugin.
- Go to the GEOmatic → License menu.
- Paste your key/token → click Test Connection.
- Check that the status shows Valid License.
7. After Activation #
- Let it run for at least 15 minutes to allow the first silent verification via WP-Cron.
- In the GEOmatic AI dashboard, check that:
- Status = “ok”
- Watermark is displayed
- Quotas are correct
- Status = “ok”
- Clear the cache (if a caching plugin is active).
8. Important Technical Points (code review) #
- Deferred kill-switch: if the license is revoked server-side, GEOmatic AI first switches to Lite mode, then disables premium features after a delay (prevents sudden blocking).
- Offline grace period: if the license server is unreachable, GEOmatic AI keeps working for several days.
- Client watermark: unique fingerprint embedded in the plugin, traceable in case of piracy.
- HMAC signature + anti-replay: every server communication is signed and protected against replay attacks.
- Encrypted license storage in the database (AES 256 CBC).
- Protected REST endpoints with domain and signature verification.
9. If Installation Issues Occur #
- License server connection error → check firewall and HTTPS.
- JSON error → check if an SEO or security plugin is altering REST output.
- Message “suspended” → license inactive, contact support.
- Message “revoked” → license revoked, plugin will switch to Lite mode before deactivation.
📌 Summary:
With these checks, 99.92% of installations will proceed without issues.
The only cases that may cause blocking are:
- Plugins intercepting/modifying API calls (especially SEO & security)
- Hosting blocking outgoing HTTPS connections
- Incorrect license configuration (domain, key, server time mismatch)
GEOmatic AI and all products published by our company are protected by French and international copyright laws.
Any reproduction, distribution, decompilation, deobfuscation, piracy, or copying, in whole or in part, without prior written authorization is strictly prohibited and exposes the perpetrator to legal action.
Our solutions integrate unique security and identification systems. Any illegal or unauthorized use is automatically detected, notably through internal indicators and collected IP addresses.
GEOmatic systematically takes legal action against any person or entity breaking the law to protect its rights and its users.