Olymp Tools

By olympagency

0+ active installationsVersion 1.2.0

Marketing tools: Google Tag Manager with Consent Mode (Complianz), Google Reviews and visitor-location shortcodes, AI-image disclosure.

Description

Olymp Tools is a lightweight container for standalone marketing features. Each tool has its own submenu under the Olymp Tools admin menu. Use as much or as little as you need. A second menu, Olymp Portal, holds the tools for customers of the web agency Olymp Agency (see below).

Google Reviews — Display your Google rating and review count anywhere via shortcodes:

  • [olymp_google_reviews_average] → average rating, e.g. “4.6”
  • [olymp_google_reviews_count] → total review count, e.g. “128”

The values are fetched server-side from the Google Places API and cached; your API key never reaches the browser and the shortcodes keep serving the last known-good numbers if a refresh fails.

Visitor Location — Insert the current visitor’s location into your copy for location-personalised marketing (e.g. “Best offers near [olymp_visitor_city]”):

  • [olymp_visitor_city default="..."], [olymp_visitor_region ...], [olymp_visitor_country ...], [olymp_visitor_country_code ...]
  • [olymp_visitor_location field="city,country" separator=", " default="..."]

Lookups are 100% local against a DB-IP Lite City database stored on your server — the visitor’s IP never leaves your site. Rendering is client-side, so it works correctly behind full-page caching.

AI-Image Marker — Mark images as AI-generated and disclose it to visitors with a badge overlaid on every use of the image (transparency obligations such as the EU AI Act):

  • Mark images one by one in the attachment details, in bulk in the Media Library list view (with an “AI” column and filter), or automatically on upload.
  • Configurable text or custom-image badge — position, size, colors, tooltip, link, exclusion selectors — with a live preview; optional alt-text disclosure for screen readers.

The mark is stored with the image in the library — never baked into the image file — so the badge is configured once and applies everywhere. Rendering is client-side on the final DOM, so it works with any theme or page builder and behind full-page caching.

Google Tag Manager — Load your Google Tag Manager container and pass the consent visitors give in your cookie banner plugin on to Google Consent Mode v2:

  • Choose the consent source: currently Complianz, or “None” if your banner plugin sends Consent Mode itself.
  • Sends the consent default (everything denied except strictly necessary storage) at the very top of <head>, followed by the container.
  • Applies a returning visitor’s stored choice before any Google tag runs — no race against the load time of the consent banner.
  • Picks up accepting, rejecting and withdrawing consent on the current page immediately.
  • No consent logic in the container, no Complianz Script Center entries and no separate GTM plugin needed.

The consent part only reads the banner plugin’s consent cookies in the visitor’s browser. Disabled by default.

Olymp Portal (for customers of Olymp Agency) — Connect the site to the Olymp Portal, the customer portal of the web agency Olymp Agency, with the address and API key you receive from the agency (Olymp Portal > Settings). The portal tools use this connection:

  • Lead Tracking — Sends the entries of the Gravity Forms forms you select to the portal, where they appear as leads and can be marked as won or lost. Every hour the entries of the last 7 days are sent; “Sync now” sends everything from a chosen date, e.g. to transfer older entries once. The portal skips entries it already has, so nothing is stored twice. Spam and entries in the trash are never sent, of uploads only the file names; single fields can be left out per form. All forms are off by default. Requires Gravity Forms.
  • Traffic — Counts the visitors of the site for the portal: page views, time on page, scroll depth, where visitors come from, and conversions (clicks on phone, email and WhatsApp links, sent Gravity Forms forms). A small script reports straight from the visitor’s browser to the portal — no cookies, nothing stored in the browser, no load on your server, works with page caches. Needs only the portal address, not the API key. Off by default; logged-in editors and administrators are not counted.
  • Heartbeat — Reports the state of the WordPress installation to the portal, so the agency sees when something needs attention: versions of WordPress, PHP and the database, available updates, plugins and themes, search engine visibility, debug settings, whether WP-Cron runs, and the state of the other portal tools. Every hour and a minute after changes; “Send now” also tests the connection. No personal data. Off by default.

Without an Olymp Portal account these tools have no use; the tools in the Olymp Tools menu work without it.

External services

Olymp Tools connects to four external services: Google, DB-IP and Google Tag Manager are each used by one tool, the Olymp Portal by the tools in the Olymp Portal menu. Nothing is contacted until you set up and use the tool in question. The AI-Image Marker makes no external connections.

Google Places API (Google Reviews tool)

The Google Reviews tool needs this service to show your business’s Google rating and review count via the [olymp_google_reviews_average] and [olymp_google_reviews_count] shortcodes.

  • What is sent: the Place ID and the Google API key you entered under Olymp Tools > Google Reviews, along with the standard data of any HTTP request made by your server (its IP address and the WordPress user agent, which contains your site’s URL). The request asks only for the rating and userRatingCount fields. No data about your visitors is sent.
  • When: only from your server, never from the visitor’s browser — when you save the tool’s settings, and when a page with one of the shortcodes (or the tool’s settings page) is displayed and the stored values are older than one week. Otherwise the stored values are served without contacting Google.
  • Endpoint: https://places.googleapis.com/v1/places/{place_id}
  • Provider: Google LLC — Google Maps Platform, Places API (New)
  • Terms of service: https://cloud.google.com/maps-platform/terms
  • Privacy policy: https://policies.google.com/privacy

DB-IP (Visitor Location tool)

The Visitor Location tool needs the free “IP to City Lite” database from DB-IP to resolve a visitor’s city, region and country. The plugin downloads this database file to your server (wp-content/uploads/olymp-tools/); all lookups then run locally against that file.

  • What is sent: a plain file download request by your server, with the standard data of any HTTP request (your server’s IP address and the WordPress user agent, which contains your site’s URL). No visitor data and no visitor IP address is ever sent to DB-IP.
  • When: the first time a page with a Visitor Location shortcode is viewed and no database is present yet, then about every 30 days to refresh it, and whenever you click Refresh database now under Olymp Tools > Visitor Location.
  • Endpoint: https://download.db-ip.com/free/dbip-city-lite-{YYYY-MM}.mmdb.gz
  • Provider: DB-IP — “IP Geolocation by DB-IP”, database licensed under Creative Commons Attribution 4.0 (license details)
  • Terms of service: https://db-ip.com/tos.php
  • Privacy policy: https://db-ip.com/privacy.php

Google Tag Manager (Google Tag Manager tool)

The Google Tag Manager tool loads the Google Tag Manager container you configure, so the tags you manage there (e.g. Google Analytics, Google Ads) can run on your site.

  • What is sent: when a page is viewed, the visitor’s browser loads the container script from Google, which transmits the standard data of any web request (the visitor’s IP address, user agent and the page URL) and your container ID. What the tags inside the container send afterwards depends on how you configure them in Google Tag Manager; Google tags receive the visitor’s consent state via Google Consent Mode and respect it.
  • When: on every page view, only while the tool is enabled and a container ID is entered under Olymp Tools > Google Tag Manager. Without a container ID, no connection to Google is made.
  • Endpoints: https://www.googletagmanager.com/gtm.js (and https://www.googletagmanager.com/ns.html for visitors without JavaScript)
  • Provider: Google LLC — Google Tag Manager
  • Terms of service: https://marketingplatform.google.com/about/analytics/tag-manager/use-policy/ and https://policies.google.com/terms
  • Privacy policy: https://policies.google.com/privacy

Olymp Portal (Lead Tracking tool)

The Lead Tracking tool sends form entries to the Olymp Portal, the customer portal of the web agency Olymp Agency, so the site owner can follow up on and evaluate inquiries there.

  • What is sent: for each entry of the forms selected under Olymp Portal > Lead Tracking: the entry ID, the time of submission, the form title, the URL of the page the form was sent from, and every field not deselected on that page with its label, field type and the value the visitor entered (for example name, email address, phone number and message; of uploaded files only the file name). Each request also carries your site’s domain and the API key entered under Olymp Portal > Settings, along with the standard data of any HTTP request made by your server (its IP address and the WordPress user agent). Spam and entries in the trash are not sent.
  • When: only from your server, never from the visitor’s browser — once an hour while at least one form is selected (the entries of the last 7 days), and when you click Sync now (the entries from the chosen date).
  • Endpoint: {portal address}/api/olymp-tools/leads — the portal address you enter under Olymp Portal > Settings; nothing is sent while it is empty.
  • Provider: Olymp Agency
  • Terms of service: https://olympagency.com/agb/
  • Privacy policy: https://olympagency.com/datenschutz/

Olymp Portal (Traffic tool)

The Traffic tool counts the visitors of the site in the Olymp Portal, the customer portal of the web agency Olymp Agency, so the site owner sees there which pages are read, how visitors find the site and which visits lead to an inquiry.

  • What is sent: while Count the visitors of this site is on under Olymp Portal > Traffic, a script on every page sends from the visitor’s browser: the address of the page, the address of the page the visitor came from (referrer), the screen width and number of touch points, a random ID of the page view, and — when the visitor leaves the page or switches tabs — how long the page was visible and how far it was scrolled; for clicks on phone, email and WhatsApp links the link, for sent Gravity Forms forms the form title. Like every request from a browser, it also carries the visitor’s IP address and user agent. The portal keeps of the page address only the path and the campaign parameters (utm_*), derives browser, operating system and approximate location (country, region, city) from IP address and user agent, and stores neither of them; visitors are counted by an identifier that changes daily. The script sets no cookies and stores nothing in the browser. Not sent for logged-in editors and administrators (unless enabled), in previews and in the Customizer.
  • When: on every page view, from the visitor’s browser (navigator.sendBeacon), never from your server.
  • Endpoint: {portal address}/api/olymp-tools/p — the portal address you enter under Olymp Portal > Settings; nothing is sent while it is empty.
  • Provider: Olymp Agency
  • Terms of service: https://olympagency.com/agb/
  • Privacy policy: https://olympagency.com/datenschutz/

Olymp Portal (Heartbeat tool)

The Heartbeat tool reports the state of the WordPress installation to the Olymp Portal, the customer portal of the web agency Olymp Agency, so the agency sees there when the site needs maintenance.

  • What is sent: while Report the state of this site to the Olymp Portal is on under Olymp Portal > Heartbeat: the site’s address (home URL) and WordPress address; the WordPress version and available update, language, time zone, search engine visibility, permalink structure, the debug and file editing settings, when the oldest pending WP-Cron event was due and how many are due, and the number of administrators; every installed plugin and theme with name, version, whether it is active, available update and whether it is updated automatically, must-use plugins and drop-ins by name; PHP and database version, web server software and memory limits; the version of Olymp Tools and the state of its Lead Tracking (number of forms selected, time and result of the last sync) and Traffic tools (on or off). Each request also carries the API key entered under Olymp Portal > Settings, along with the standard data of any HTTP request made by your server (its IP address and the WordPress user agent). No user names, email addresses or content are sent.
  • When: only from your server, never from the visitor’s browser — once an hour, a minute after updates, activated, deactivated or deleted plugins, another theme or changed search engine visibility or permalinks, when the tool is switched on, and when you click Send now. Switched off, nothing is sent.
  • Endpoint: {portal address}/api/olymp-tools/heartbeat — the portal address you enter under Olymp Portal > Settings; nothing is sent while address or API key is empty.
  • Provider: Olymp Agency
  • Terms of service: https://olympagency.com/agb/
  • Privacy policy: https://olympagency.com/datenschutz/

Installation

  1. Upload the olymp-tools folder to the /wp-content/plugins/ directory, or install directly through the WordPress plugin screen.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Open the Olymp Tools admin menu and configure the tools you want to use. Customers of Olymp Agency set up the portal connection under Olymp Portal > Settings.

FAQ

I used Olymp Tools inside SparkPlus before. Do I lose my settings?

No. Olymp Tools was previously bundled with SparkPlus (versions 1.1.5 – 1.1.8). The standalone plugin uses exactly the same settings, so your Google Reviews credentials, Visitor Location database and AI-Image Marker settings and marks carry over. While an older SparkPlus with the bundled copy is still active, this plugin stands down and shows a notice — update SparkPlus to switch over.

How do the Google Reviews shortcodes work?

Enter a Google Places API key and your business’s Place ID under Olymp Tools > Google Reviews. Then place [olymp_google_reviews_average] or [olymp_google_reviews_count] anywhere in your content. The values are fetched server-side and cached, so your API key is never exposed and the numbers keep showing even if a refresh temporarily fails.

Is the Visitor Location tool GDPR-friendly?

Yes. Visitor Location resolves the visitor’s city/region/country entirely on your own server using a locally-stored DB-IP Lite City database. The visitor’s IP address never leaves your site, and no third-party geolocation API is called at request time. Use shortcodes like [olymp_visitor_city default="your area"] for location-personalised copy.

Which cookie banner plugins does the Google Tag Manager tool support?

Currently Complianz; more can be added. Choose the consent source on the tool’s page. With “None”, the tool sends no Consent Mode signals and only loads the container — use this if your banner plugin sends Google Consent Mode itself; the container is then placed later in <head> so that plugin’s consent default comes first.

Does the Google Tag Manager tool need Complianz?

Only if Complianz is the selected consent source. Without Complianz the consent default (denied) is still sent first, but visitors cannot give consent: the tool reads the choice from the Complianz cookies. In Complianz, answer “Yes, but not with one of the above services” under Wizard → Consent → Statistics, so Complianz neither adds its own GTM snippet nor its own Consent Mode. Do not run another GTM plugin at the same time.

What is the Olymp Portal menu?

The tools in the Olymp Portal menu send data to the customer portal of the web agency Olymp Agency and need an API key from the agency. If you are not a customer of Olymp Agency, ignore this menu — nothing is sent unless the portal address is set and a tool is switched on (Lead Tracking: the key and at least one form; Traffic: Count the visitors of this site; Heartbeat: the key and Report the state of this site to the Olymp Portal).

Which form plugins does Lead Tracking support?

Gravity Forms. Select the forms whose entries are leads (e.g. contact and quote forms) under Olymp Portal > Lead Tracking; the page shows for each form which fields the portal files as name, email, phone and message and which it keeps as further details. Fields deselected there are never sent, e.g. to transfer only a few fields of a long multi-page form.

How does Traffic recognize a sent form?

By the form’s confirmation: a confirmation message appearing on the page (with or without AJAX), or a thank-you page on the same site opened right after the form. Olymp Portal > Traffic shows for every active Gravity Forms form how it is recognized. Redirects to the home page or to another website can’t be recognized.

Traffic counts fewer visitors with my caching plugin. Why?

Some optimization plugins delay all JavaScript until the visitor scrolls or clicks (e.g. “Delay JavaScript execution” in WP Rocket); visitors who leave without doing so are then never counted. Exclude the script olymp-tools/tools/traffic/assets/traffic.js from delaying — the Traffic page shows its full path.

Changelog

1.2.0

  • New admin menu Olymp Portal for customers of the web agency Olymp Agency: connect the site to the Olymp Portal with the portal address and API key under Olymp Portal > Settings. Without a portal account, nothing in this menu sends anything.
  • New tool: Lead Tracking. Sends the entries of the Gravity Forms forms you select to the Olymp Portal — every hour the entries of the last 7 days, “Sync now” everything from a chosen date. Spam and trashed entries are never sent; single fields can be left out per form. Off by default; requires Gravity Forms.
  • New tool: Traffic. Cookieless visitor statistics for the Olymp Portal: page views, time on page, scroll depth, referrers and campaigns, and conversions (clicks on phone, email and WhatsApp links, sent Gravity Forms forms). Reports straight from the visitor’s browser — no cookies, no load on your server, works behind page caches. Off by default; logged-in editors and administrators are not counted.
  • New tool: Heartbeat. Reports the state of the WordPress installation to the Olymp Portal every hour and a minute after changes: versions, available updates, plugins and themes, search engine visibility, debug settings and WP-Cron. No personal data. Off by default.
  • Scheduled tasks are removed when the plugin is deactivated.
  • The tools in the Olymp Tools menu and their settings are unchanged.

1.1.0

  • New tool: Google Tag Manager. Loads your Google Tag Manager container and passes the consent visitors give in the cookie banner on to Google Consent Mode v2 (consent source selectable: Complianz or none): sends the consent default at the top of <head>, applies a returning visitor’s stored choice before any Google tag runs, and picks up accepting, rejecting and withdrawing consent on the current page. Disabled by default.

1.0.0

  • Olymp Tools extracted from SparkPlus into its own plugin. Includes Google Reviews, Visitor Location and AI-Image Marker, unchanged in behaviour; settings are shared with the previously bundled version.
  • Own text domain olymp-tools.
  • Safe side-by-side operation with SparkPlus 1.1.8 and older: the bundled copy is detected and used instead, with an admin notice to update SparkPlus.
  • AI-Image Marker: the free-form “Custom CSS” setting has been removed; style .olymp-aiimgmark-badge via “Additional CSS” in the Customizer or Site Editor instead.
  • Visitor Location: test IPs are previewed through a form on the tool’s admin page; the ?test_ip= override on the front end has been removed.