Title: A1 Tools
Author: a1tools
Published: Февраль 3, 2026-ж.
Last modified: Август 14, 2026-ж.
---
Плагиндерди издөө
# A1 Tools
Автору [a1tools](https://profiles.wordpress.org/a1tools/)
[Жүктөө](https://downloads.wordpress.org/plugin/a1-tools.3.3.5.zip)
* [Кенен маалымат](https://ky.wordpress.org/plugins/a1-tools/#description)
* [Сын-пикирлер](https://ky.wordpress.org/plugins/a1-tools/#reviews)
* [Орнотуу](https://ky.wordpress.org/plugins/a1-tools/#installation)
* [Development](https://ky.wordpress.org/plugins/a1-tools/#developers)
[Колдоо](https://wordpress.org/support/plugin/a1-tools/)
## Сүрөттөө
A1 Tools connects your WordPress site to the A1 Tools platform, enabling centralized
management of business information that can be displayed anywhere on your site using
simple shortcodes.
**Perfect for businesses with multiple websites** – update your phone number, address,
or social media links once in the A1 Tools dashboard, and all your connected sites
update automatically.
#### Features
* **Centralized Management** – Manage all your site variables from one dashboard
* **Simple Shortcodes** – Display any variable with `[a1tools_var key="phone_primary"]`
* **Address Formatting** – Multiple address display formats available
* **Operating Hours** – Display business hours as tables or lists
* **Social Media Links** – Output all social icons with one shortcode or widget
* **Social Icons Widget** – Customizable widget with style, shape, size, and hover
effects
* **Elementor Support** – Dynamic tags for Elementor page builder
* **Performance Optimized** – Configurable caching (default 5 minutes)
* **Developer Friendly** – PHP functions available for theme developers
#### Available Variables
* Business name, city name, state/location name, tagline
* Google Maps URL for location
* Primary and secondary phone numbers
* Primary and secondary email addresses
* Full address (line 1, line 2, city, state, ZIP, country)
* Social media URLs (Facebook, Instagram, YouTube, Twitter, LinkedIn, TikTok, Yelp,
Google Business)
* Operating hours for each day of the week
#### Shortcode Examples
```
[a1tools_var key="phone_primary"] - Display primary phone number
[a1tools_var key="facebook_url" link="true"] - Display Facebook URL as clickable link
[a1tools_address format="full"] - Display complete formatted address (multi-line)
[a1tools_full_address] - Display full address in a single line (e.g., "123 Main St, Suite 101, Miami, FL 30001")
[a1tools_hours format="table"] - Display operating hours as a table
[a1tools_social_links] - Display all configured social media icons
[a1tools_social_links style="default" shape="circle" size="50"] - Styled social icons
[a1tools_city_name] - Display the city name for geo-targeting
[a1tools_state] - Display the state name for geo-targeting
[a1tools_google_map type="link"] - Display Google Maps link
[a1tools_google_map type="embed" width="100%" height="400"] - Embed Google Maps iframe
```
#### Requirements
* Your WordPress site must be registered in the A1 Tools platform
* An active A1 Tools account with site variables configured
* Font Awesome 6 for social icons (most themes include this; if not, use a Font
Awesome plugin)
### External Services
This plugin relies on a third-party service to retrieve site variables (business
information, contact details, social media URLs, etc.) that you configure in the
A1 Tools dashboard.
#### A1 Tools API
**What it is:** A1 Tools is a business management platform operated by A1 Chimney
Service that allows businesses to centrally manage their contact information, addresses,
operating hours, and social media links across multiple websites.
**What data is sent:** When this plugin is activated and the site loads (or when
a shortcode is used), the plugin sends your WordPress site URL to the A1 Tools API
to retrieve the site variables you have configured for that specific site.
**When data is sent:**
– When a page containing A1 Tools shortcodes is loaded –
When the plugin’s admin settings page is accessed – When the cache expires and fresh
data is needed (configurable, default 5 minutes)
**What data is received:** The plugin receives only the site variables you have
configured in your A1 Tools dashboard, such as business name, phone numbers, email
addresses, physical address, operating hours, and social media URLs.
**Service Provider:** A1 Chimney Service
**API Endpoint:** https://app.a-1chimney.
com/api/website_variables.php **Terms of Service:** https://a-1chimney.com/terms-
of-service/ **Privacy Policy:** https://a-1chimney.com/privacy-policy/
#### Google Maps Embed API
**What it is:** Google Maps is a web mapping service developed by Google. This plugin
can embed Google Maps iframes to display your business location.
**What data is sent:** When using the `[a1tools_google_map type="embed"]` shortcode,
your visitor’s browser loads an iframe from Google Maps containing your business
address or place ID that you configured in the A1 Tools dashboard.
**When data is sent:**
– Only when a page containing the `[a1tools_google_map type
="embed"]` shortcode is loaded – The embed is loaded client-side by the visitor’s
browser directly from Google
**What data is received:** Google Maps returns the embedded map showing your business
location. Google may collect visitor data according to their privacy policy.
**Service Provider:** Google LLC
**Embed URL:** https://www.google.com/maps/embed/
v1/place **Terms of Service:** https://www.google.com/intl/en_us/help/terms_maps/**
Privacy Policy:** https://policies.google.com/privacy
## Орнотуу
1. Upload the `a1-tools` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Ensure your site is registered in your A1 Tools dashboard under Integrations >
WordPress Sites
4. Configure your site variables in A1 Tools under Marketing Tools > Web Management
> Site Variables
5. Use the shortcodes in your pages, posts, or widgets
## FAQ.KG
### How do I get an A1 Tools account?
A1 Tools is a business management platform. Contact A1 Chimney Service for access
information.
### Why are my variables not showing?
1. Verify your site URL in A1 Tools matches your WordPress site URL exactly (including
https://)
2. Check that you have saved variables for this site in A1 Tools
3. Go to A1 Tools in your admin menu and click “Clear Cache Now” to fetch fresh data
### How often do variables update?
Variables are cached based on your settings (default 5 minutes). You can configure
the cache duration or disable caching entirely in the A1 Tools settings page. To
force an immediate update, use the “Clear Cache Now” button on the settings page.
### Can I use this with Elementor?
Yes! The plugin registers dynamic tags that appear under the “A1 Tools” group in
Elementor. You can also use the Shortcode widget with any of the available shortcodes.
### Is this plugin free?
The plugin is free and open source. However, it requires an A1 Tools account to
function, as it retrieves data from the A1 Tools platform.
### What data does this plugin send to external services?
See the “External Services” section above for complete details. In summary, the
plugin sends your site URL to the A1 Tools API to retrieve the site variables you
have configured. No personal user data from your visitors is collected or transmitted.
## Сын-пикирлер
There are no reviews for this plugin.
## Contributors & Developers
“A1 Tools” is open source software. The following people have contributed to this
plugin.
Мүчөлөрү
* [ a1tools ](https://profiles.wordpress.org/a1tools/)
[Translate “A1 Tools” into your language.](https://translate.wordpress.org/projects/wp-plugins/a1-tools)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/a1-tools/), check out
the [SVN repository](https://plugins.svn.wordpress.org/a1-tools/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/a1-tools/) by [RSS](https://plugins.trac.wordpress.org/log/a1-tools/?limit=100&mode=stop_on_copy&format=rss).
## Өзгөртүүлөр
#### 3.3.5
* A1 Contact Info: business hours now fit whatever space they are given, instead
of forcing a sideways scrollbar. When there is room, a day and its time sit on
one line. When there is not, the whole time range drops onto its own line directly
under that day — never beside it, never under the next day, and never split in
the middle of a time. If even that is too tight, only the hours text shrinks,
down to a readable floor, leaving your phone, email, address, titles and icons
at their normal size. This adapts to how wide the widget itself is, not how wide
the screen is, so hours placed in a narrow column behave correctly on a large
monitor. Your saved Day and Time typography stays the normal size and is never
overwritten.
* A1 Contact Info: removed the colon after each day name, so rows read “Monday
8:00 AM – 10:00 PM”.
#### 3.3.4
* A1 Web Chat: the widget now tells A1 Tools when a visitor closes the chat or
leaves the page, so the dispatcher answering them can see whether anyone is still
on the other end. A live chat has no hangup — a visitor who shuts the tab leaves
a conversation that looks exactly like one where they are still waiting, and
dispatchers were composing careful replies to people who had left hours earlier.
Uses the browser’s beacon API, which costs nothing on the page and does not delay
it unloading. Nothing to configure, and the chat behaves exactly as before for
the visitor.
#### 3.3.3
* A1 Gallery: the **View Our Projects** button now sits below the Our Work pagination
instead of above the grid, and **Back to Our Work** likewise sits at the bottom
of the Projects view. Both are centered at every screen size, and both got the
same larger treatment — bigger bold text, roomier padding, square corners, yellow
with black text, turning orange on hover and on keyboard focus. Switching views,
filtering, search, the lightbox, and pagination all work exactly as before.
* A1 Contact Info: business hours now read as one compact line per day — `Monday:
8:00 AM - 10:00 PM` — instead of a day column separated from the time by a large
gap. A time can no longer wrap onto a second line. The old **Day Column Width**
slider is gone, since it was the control that created that gap; existing widgets
pick up the new layout with nothing to re-save.
* A1 Contact Info: Phone, Email, and Location each gained an **Additional …** repeater,
so a site can list several numbers, addresses, or offices under one icon and
heading. Each entry takes an optional label (“Sales”, “Warehouse”) and its own
click-to-call / mailto / Google Maps toggle. The value from A1 Tools stays the
first entry; extras stack underneath it in the order you set and inherit the
widget’s existing typography, colors, and link styling. A new **Value Spacing**
control in the Layout section sets the gap. Widgets with no extra entries render
exactly as before.
* A1 Team: bios reliably appear when **Show Bio** is on. Sites still holding a
team payload cached from before bios were served showed none of them, which looked
like the switch was broken; this update refreshes that cache on upgrade.
* Fix: the plugin’s internal version constant said 3.3.1 while the plugin header
said 3.3.2, so WordPress and the plugin disagreed about which version was installed
and the upgrade routine re-ran on every page load. Both now read the same value.
#### 3.3.2
* A1 Tools moved to a new address. Every endpoint this plugin calls now points
at app.a-1chimney.com instead of tools.a-1chimney.com. Nothing changes on your
site and no settings need updating — the old address still forwards, but this
update means your site stops depending on that forward.
#### 3.3.1
* Fix: Edits made in A1 Tools now reach the live site immediately instead of being
delayed by up to 5 minutes. The API serves its public endpoints with a 5-minute
edge cache (deliberately — it keeps every page render across the fleet off PHP-
FPM), which meant clearing the plugin’s own transient just refetched the same
URL and got the same stale JSON straight back. The plugin now carries a cache
epoch in the request URL that moves only when the platform invalidates data,
so the edge misses exactly once per real change and then caches normally again.
Steady-state request volume is unchanged — this is not a per-request cache buster.
* Fix: Clearing the cache now also purges the HOST page cache (SiteGround Optimizer,
plus WP Rocket / LiteSpeed / W3TC / WP Super Cache), not just the plugin’s own
transients. Previously the plugin refetched fresh data but the server kept serving
already-rendered HTML, so a changed phone number or address did not appear on
the live site until that cache expired on its own — making “Refresh live cache”
in A1 Tools look like it had done nothing. This applies to both the manual refresh
and the automatic invalidation that fires on every save, so edits now reach the
live site without anyone opening Site Tools. Every third-party call is guarded,
so a site with no caching plugin is unaffected.
#### 3.3.0
* Feature: Phone numbers now resolve through a three-tier cascade instead of two.
A site can set one number for ALL city pages and another for ALL location pages(
Information tab in A1 Tools), sitting between the individual page’s own phone
and the site’s Primary Phone. Order: the page’s own phone -> the all-cities /
all-locations default -> Primary Phone, with every blank tier skipped. This lets
a site route every city page to a single tracking number without editing each
city, while any individual city can still claim its own. Every consumer inherits
it — [a1tools_phone], [a1tools_city_phone], [a1tools_location_phone], the Elementor
dynamic tag, and the Contact Info / Info Box / CTA widgets. Fully additive: a
site that sets neither default behaves exactly as before.
* Fix: A1 Info Box no longer prints “(Not configured)” on the live site when its
variable is empty — an unconfigured value now renders nothing at all (no icon,
no title, no wrapper). Previously a site with, for example, no state set displayed
that placeholder to visitors, leaking the CMS’s internal state. The Elementor
editor still shows the placeholder so the widget stays selectable while building
a page.
#### 3.2.12
* Improvement: A1 Gallery — the “Our Work” landing tiles now have a controllable
height. New “Our Work Image Height” responsive slider (default 360px desktop /
300 tablet / 240 mobile) drives the work-item height, with CSS defaults so existing
galleries render at a consistent 360px cover-fit until adjusted. Completes the
two-view Our Work / Our Projects reference. Fully additive; no existing setting
changes. (#142, Toula)
#### 3.2.11
* Improvement: A1 Gallery widget now supports an optional “Our Work” landing gallery
in addition to the existing Projects gallery, giving the widget two views. New“
Our Work Landing Gallery” Elementor section adds an Our Work Images gallery (
shown first, no search/filters), an Our Work images-per-page count, and customizable
Projects/Back button labels. Visitors land on Our Work, tap “View Our Projects”
to reach the existing search/category/before-after Projects view, and return
with “Back to Our Work”. Both views use compact pagination (first/last + neighbors
with ellipses) instead of listing every page. Fully additive — the widget, its
name, and every existing setting (Images, Bulk Add by Category, layout, search/
filter, lightbox, pagination) are unchanged, so with no Our Work images selected
the gallery renders exactly as before. (#141, Toula)
#### 3.2.10
* Improvement: review-URL fallback chain in a1tools_resolve_review_url() (shared
by the A1 Review Funnel and A1 Smiley Reviews). Resolution is now: widget override
site review_url variable google_business_url variable new a1tools_fallback_review_url
option (a-1chimney.com hosts only, host-gated) the main A-1 Chimney Google review
link. Sites without their own Google listing always render the “Leave a Review
on Google” button instead of a bare thank-you; non-chimney brands are unaffected(
the last step matches the exact apex or a real subdomain only). Folds the fleet-
deployed 3.2.9 behaviour into the canonical source. (3.2.9 was a fleet-only roll
of this code with no other changes.)
#### 3.2.8
* New: A1 Smiley Reviews Elementor widget — a happy-face / sad-face review gate.
Happy face reveals a positive panel (“So glad we hit the mark!” + a Leave-a-Review-
on-Google button using the same review-URL resolution as the A1 Review Funnel);
sad face reveals the private feedback form (name/phone/email/feedback) that POSTs
to the same REST proxy with rating=1 / outcome=private_feedback, landing in the
A1 Tools CRM. After private feedback the public review link is still offered (
FTC / Google review-gating compliant). Classic outlined SVG smileys (green/red,
currentColor) or emoji, sad-left/happy-right default with a swap toggle, perfect-
circle disc construction, full Elementor style controls, honeypot + minimum-fill-
time spam guards. Own namespace/assets — the Review Funnel is untouched. Folds
the cle-tested 3.2.7 widget into the canonical source so wordpress.org auto-updates
ship it fleet-wide.
#### 3.2.2
* New: A1 Gallery Elementor widget — a searchable, filterable image grid. Two inputs
feed one grid: a per-image repeater (image + category + optional before/after
split) and a “Bulk Add by Category” repeater (multi-select gallery, drop many
images at once per category). Frontend: a live search box + an auto-populated
category dropdown (apply together), responsive columns, pagination, category
hover-highlight, image hover zoom, and click-to-enlarge lightbox. Independent
Style sections for the Search vs Filter bar (Normal/Hover/Active states + responsive
width). All client-side (no AJAX), no jQuery, Elementor Free and Pro. Folds the
cle-tested widget into the canonical source so wordpress.org auto-updates ship
it fleet-wide.
#### 3.2.0
* New: A1 Video Carousel Elementor widget — a self-contained, dependency-free vertical(
9:16) YouTube Shorts carousel. Real YouTube IFrame players (overlay visible,
one-video-at-a-time playback coordination), responsive slides-per-view, arrows/
dots/drag, autoplay, custom thumbnails with an auto-filled YouTube-style title
bar (title/channel/avatar via oEmbed, no API key). Folds the previously hand-
deployed 2.7.x widget into the canonical source so wordpress.org auto-updates
no longer drop it.
#### 3.1.0
* New: reusable content blocks. Author a named snippet in the SEO app’s Content
tab and print it on any page with [a1tools_content key=””]. Rich text / safe
HTML (wp_kses_post), nested shortcodes supported, optional wpautop=”no”. Fetched
from site_content_blocks.php and cached like other entities; cleared on cache
invalidation.
#### 3.0.1
* A1 Contact Info widget: added an optional License item (icon + title + license
number), pulling the same value as [a1tools_licence]. Shown by default; toggle
off per instance.
#### 3.0.0
* Major version rollup — no functional change over 2.8.0. Consolidates the SEO
shortcode release: per-field franchise/service shortcodes (2.7.0) and context-
aware base widgets that show a City/Location page’s own value with fallback to
the main-phase value (2.8.0).
#### 2.8.0
* New: Context-aware base widgets/shortcodes. On a City or Location page that has
its own value assigned, base widgets now display THAT page’s value instead of
the main-phase value, and fall back to the main value where the page leaves a
field blank. Example: [a1tools_phone] (and the A1 Phone / Contact Info / Info
Box widgets and the “A1 Site Variable” dynamic tag) shows Stamford’s phone on
the Stamford page, but the company’s main phone everywhere else — no per-page
shortcode swap needed.
* Applies to every base field that has a City/Location equivalent: phone (phone_primary),
full address (full_address + address_line1/line2/city/state/zip), city, and state.
A page is always exclusively a City page OR a Location page (distinct author
accounts), so there is never any ambiguity about which record supplies the value.
* Unchanged: the WordPress admin preview and the /site-variables REST endpoint
still return the site-global (main-phase) values.
#### 2.7.0
* New: Per-field shortcodes for Franchise and Service data, so every editable field
in the A1 Tools Web Management SEO tabs has a matching shortcode (surfaced inline
with a copy button next to each field).
* New (Franchise, id-keyed — franchises render as cards with no dedicated page):[
a1tools_franchise_name], [a1tools_franchise_phone] (link=”yes” = tel:), [a1tools_franchise_address](
full multi-line), [a1tools_franchise_address_line1], [a1tools_franchise_address_line2],[
a1tools_franchise_city], [a1tools_franchise_state], [a1tools_franchise_zip], [
a1tools_franchise_country], [a1tools_franchise_maps_url] (link=”yes” = Get Directions),[
a1tools_franchise_latitude], [a1tools_franchise_longitude]. All require id=”X”(
the franchise record id) and accept default and class.
* New (Service, auto-detecting like [a1tools_city__]/[a1tools\_location\__] — service
pages are WordPress pages): [a1tools_service_title], [a1tools_service_description],[
a1tools_service_phone] (link=”yes” = tel:), [a1tools_service_icon], [a1tools_service_image].
Detect the current page via get_the_ID(); optional page_id=”X” targets a specific
service page. Accept default and class.
#### 2.6.9
* New: Seven value-shortcodes for served SEO data — [a1tools_business_name] (business_name),[
a1tools_tagline] (tagline), [a1tools_phone] (phone_primary), [a1tools_phone_secondary](
phone_secondary), [a1tools_email] (email_primary), [a1tools_email_secondary] (
email_secondary), and [a1tools_review_link] (review_url). Phones support link
=”yes” (tel:), emails support link=”yes” (mailto:, scraper-obfuscated), and [
a1tools_review_link] supports link=”yes” with an optional text=”…” label. All
accept default and (text shortcodes) class attributes and output nothing when
the value is empty.
#### 2.6.8
* Fix: A1 Team widget – “Center Rows” was forcing every group to 3 columns regardless
of the Columns setting. The centered (flex) layout reads the `--a1-team-cols`
CSS variable, but in Elementor that variable was never emitted (Elementor doesn’t
reliably output per-element custom properties), so it fell back to the hard-coded
default of 3. The variable is now set inline in the rendered markup as the single
source of truth, so 4 (or any value) is honored. Also added responsive breakpoints
to the centered layout (2 columns on tablet, 1 on phones), which it previously
lacked entirely. Supersedes the incomplete 2.6.6 attempt.
#### 2.6.7
* Fix (compliance): Review funnel no longer gates by rating. Low (1-3) ratings
keep the private “make it right” feedback form, and on submit are ALSO offered
the public Google review — the public option is never hidden based on rating.
Removes the review-gating pattern targeted by the FTC’s 2024 Consumer Review
Rule and FTC Act Section 5.
#### 2.6.6
* Fix: A1 Team widget – “Center Rows” now shows the full column count (was 1 short).
Responsive Columns now apply correctly on tablet/mobile (were collapsing to 1
column). Added a Width (%/px) control for square photos, so photo width is settable
in % on either shape.
#### 2.6.5
* New: A1 Team widget – Photo Size now supports % width (stays circular via aspect-
ratio). Columns now default to responsive 4 / 2 / 1 (desktop / tablet / mobile).
New “Center Rows” toggle centers an incomplete last row (e.g. 3 cards under 4
columns).
#### 2.6.4
* Improve: Review funnel (4-5★) — submitting the positive form now _replaces_ it
with a clean “Thank you! 🎉 / Leave a review in Google” step instead of showing
the prompt below the form. Removed the duplicated message; the pre-submit form
now has its own “So glad we hit the mark!” header.
#### 2.6.3
* Change: A1 Review Funnel — the positive (4-5) “Send” no longer auto-opens Google.
After submitting, a thank-you shows with an optional “Leave a review” button
the visitor clicks to open Google (their note is still copied so they can paste
it).
* Change: A1 Review Funnel — a CRM row is now created only when the form is submitted,
not on the star tap. Abandoned star taps no longer create “Anonymous” rating-
only rows; submitting saves the rating + contact + comment in one step.
#### 2.6.2
* New: A1 Review Funnel — high ratings (4-5) now open a short form (name, phone,
email, comment) too. On submit the details are saved to the CRM (Customer Experience)
and the visitor is taken to Google to post their review; their comment is copied
to the clipboard to paste in. (Google does not allow pre-filling the star rating
or review text via a link, so they pick their stars and paste on Google.)
* Change: A1 Review Funnel — every field on both the positive and negative forms
is now required.
* Change: A1 Review Funnel — the “Or leave a public review” link no longer appears
on the low-rating (1-3 star) feedback form. The public-review link now shows
only on high ratings (4-5); low ratings see the private feedback form only. (
Note: routing only happy customers to public reviews is “review gating”, which
can conflict with Google’s review policy and the FTC’s 2024 review rule — this
is an intentional change at the site owner’s request.) Also removed the now-unused“
Show public-review link on low ratings” toggle, the secondary-link text control,
and its style control + CSS.
#### 2.6.1
* Fix: A1 Review Funnel – the rating stars rendered as padded yellow buttons and
sat left of center on Elementor sites. The active theme’s Elementor global-kit
button styling out-specified the widget’s star reset (`.elementor-kit-N button`
beats a bare `.a1tools-review__star`), so each star inherited the theme button’s
background and 15px 50px padding, which also pushed the star row wider than its
container and broke the centering. The star rules are now scoped under `.a1tools-
review` so they win on specificity alone (no !important needed), with a full
button-property reset – stars render as clean glyphs and center correctly across
themes.
#### 2.6.0
* New: A1 Review Funnel — a star-rating widget that turns happy customers into
public reviews and unhappy ones into private feedback. Visitors pick 1-5 stars;
high ratings get a thank-you with a button to your public review link, while
low ratings open a private feedback form (name / phone / email / comment) that
lands in the A1 Tools CRM under the new “Customer Experience” tab.
* New: Available as the “A1 Review Funnel” Elementor widget (full styling controls—
stars, panels, inputs, buttons, colors, typography) and the [a1tools_review_widget]
shortcode.
* New: Optional site-wide floating “Rate us” button (A1 Tools Reviews) that opens
the funnel in a popup on every page — no page editing required. Configurable
position, label, prompt, and threshold.
* New: Review Link (review_url) site variable (Site Variables Social Media) for
the public review destination, with automatic fallback to the Google Business
URL.
* Compliance: the funnel never blocks unhappy customers from leaving a public review—
low ratings always keep a secondary public-review link. Hiding it (“review gating”)
violates Google’s review policies and the FTC’s 2024 review-suppression rule,
so the option to do so is intentionally not provided.
* Privacy/anti-spam: submissions are signed server-side (HMAC) via a REST proxy,
with an in-form honeypot and minimum-fill-time guard. No third-party review service
is used.
#### 2.5.31
* Fix: Live Chat widget — visitors no longer see “no chat button” on pages cached
during off-hours. Earlier versions (2.5.12 – 2.5.30) had PHP render zero HTML
outside business hours so the widget never appeared; SiteGround SuperCacher /
Cloudflare / WP Rocket would cache that empty version and re-serve it to business-
hours visitors, who saw nothing. The JS-side gate added in 2.5.27 couldn’t rescue
it — it can only hide existing widget HTML, not materialise widget HTML PHP never
rendered. New architecture: PHP ALWAYS renders the widget HTML (cache-safe),
styled `display:none` initially with a `data-bh-gate="1"` attribute. The JS at
init checks the visitor’s clock (converted to Miami time via `Intl.DateTimeFormat`
with `timeZone: 'America/New_York'`), and either reveals the placement (within
hours) or removes it from the DOM (outside hours / weekend). Elementor editor
and preview modes bypass the gate so admins can always style the widget regardless
of the current hour.
* Change: Live Chat business-hours cutoff rolled back to 4 PM Miami time (was extended
to 5 PM in 2.5.13 at user’s earlier request, now reverted per current user request).
Schedule is now Monday – Friday, 9:00 AM – 3:59 PM America/New_York. At 4:00
PM the widget disappears.
#### 2.5.30
* Fix: Web Chat widget continued polling after the dispatcher resolved/abandoned
a session. `handleSessionClosed` aborted the in-flight fetch, but `state.sessionId`
was never nulled, so the `while (state.sessionId && state.windowOpen)` loop re-
entered immediately, fetched again, got back `status=abandoned`, sleep, repeat—
the actual driver of the 255k-request runaway under 2.5.28. Nulling `state.sessionId`
in `handleSessionClosed` flips the loop condition false on the next iteration
and the loop exits cleanly. The 2.5.29 poll-interval is still in place as defense
in depth.
#### 2.5.29
* Fix: Web Chat widget poll loop had no sleep between successful iterations — once
a visitor opened the chat the browser hammered `?action=poll` ~3 times per second
forever (one customer logged 255,033 requests in 24 hours before SiteGround’s
WAF served the anti-bot challenge to the whole host). Added a 3-second interval
between successful polls + made the sleep abort-aware so closing the chat tears
down immediately instead of waiting the full interval.
#### 2.5.28
* Improve: Web Form widget — custom fields of type “Date” or “Time” now render
with a proper popup picker (powered by the bundled flatpickr 4.6.13 library,
MIT) instead of the native HTML5 input. The browser-native time input puts AM/
PM as a hidden third tab-stop that visitors don’t realise they need to focus,
so they type a time, hit submit, and the form carries an ambiguous meridian.
Flatpickr renders AM/PM as a clearly labeled toggle pill inside a popup — impossible
to miss. Date inputs get a clean month calendar. Both pickers work consistently
across browsers and mobile devices. Fails open: if the flatpickr JS doesn’t load
for any reason (CSP, slow network, etc.), the native HTML5 input keeps working
as the fallback.
#### 2.5.27
* Fix: Live Chat business-hours gate now also closes on Saturday and Sunday. The
2.5.12 implementation only checked the 9 AM – 5 PM hour window and ignored day-
of-week, so the chat rendered on weekends as long as the hour fell inside the
staffed window. Now Monday – Friday, 9 AM – 5 PM Miami time (America/New_York,
automatically tracking EST/EDT).
* Fix: Live Chat business-hours gate now survives page caching. The PHP gate alone
was being bypassed on every site running SiteGround SuperCacher / WP Rocket /
Cloudflare full-page cache — once a page was cached during business hours, every
later visitor (off-hours, weekend, whenever) got the cached HTML with the chat
button visible. The widget JS now re-checks the schedule on every page load using`
Intl.DateTimeFormat` with `timeZone: 'America/New_York'` and strips the chat
placement from the DOM if outside hours, so cached pages honour the schedule
too.
#### 2.5.26
* New: real-time cache invalidation via webhook (Layer C of the 2026-05-25 outage
hardening pass). On activation/upgrade the plugin now generates a per-site 256-
bit HMAC secret, registers it with the central A1 Tools server, and exposes `
POST /wp-json/a1-tools/v1/invalidate-cache`. When an admin saves any variable/
store / franchise / city page / service / review / before-after / team member/
FAQ / SEO location on the central server, that server pushes an HMAC-signed ping
here within milliseconds and the matching transient is cleared on the spot. End
result: variable edits propagate to live customer pages in seconds instead of
waiting up to 30 minutes for the cache to expire. The 30-min cache TTL + 5-min
CDN cache remain in place as the safety net if a ping is missed.
#### 2.5.25
* Performance / reliability: hardening pass on the data-fetch layer triggered by
the 2026-05-25 central-server outage. The outage was caused by sites with caching
disabled hammering the upstream API on every page render until the central PHP-
FPM pool exhausted. Three coordinated changes here:
- Stampede protection in `a1tools_fetch_api_data()`: when N concurrent Apache
workers on the same site hit an expired transient at the same instant, a short
lock transient now lets exactly one worker refill the cache while the others
return the stale fallback. Lock TTL (20s) > `wp_remote_get` timeout (15s)
so a dying request can’t hold the lock indefinitely.
- Per-request memoization via a static array in the same function. Pages with
many shortcodes/widgets that each call into the data layer (a header with
8 `[a1tools_var]` tags, for example) now hit the transient backend exactly
once per page render instead of once per shortcode.
- The “No caching (always fresh)” and “1 minute” options were removed from the
Cache Duration dropdown. They were the root cause of the upstream overload—
a few sites with caching disabled generated enough volume to bring the central
server down. Default cache duration bumped 5 min 30 min. A migration coerces
any existing `a1tools_cache_expiry = 0` to the new default on plugin upgrade.
#### 2.5.24
* New: Web Form widget Title & Subtitle style section gains per-breakpoint Alignment
controls (Desktop / Tablet / Mobile, with Left / Center / Right options). Lets
editors center the hero title on desktop while keeping it left-aligned on mobile(
or any combination). Default empty inherits whatever the parent column dictates,
so existing forms render unchanged.
#### 2.5.23
* New: Web Form widget Container style section gains a “Border color (hover)”
control, sitting directly below the normal Border group. Pairs a fade transition(`
border-color 180ms ease`) on the wrap so the swap is smooth instead of snapping.
Matches the existing Submit Button’s Normal / Hover pattern so editors expecting
hover states on bordered elements get a consistent experience.
#### 2.5.22
* Fix: Web Form widget — Submit Button “Full width” alignment now actually renders
full-width. The 2.5.2 implementation used `justify-content: stretch` (which isn’t
a valid value for `justify-content` — only `align-items`/`align-content` accept
it, so browsers silently dropped it and fell back to `flex-end`) paired with
a `[data-align="full"]` attribute selector for the `width: 100%` rule (which
never matched in Elementor’s live editor preview because the editor only re-injects
CSS, not HTML, until you save + reload). Both alignment and width now flow through
CSS variables (`--submit-justify`, `--submit-width`) that Elementor emits on
the `.a1tools-web-form__actions` wrapper, so the button responds in real time
to the alignment toggle in the editor sidebar AND on the published page. Left/
Center / Right also pick up the same variable plumbing for consistency.
#### 2.5.21
* New: Web Form widget — Custom Fields type whitelist gains a “Time” option (renders
an ``). Useful alongside the existing Date type for appointment-
preference or booking-window forms. Server-side validator in the A1 Tools CRM
API extended in lock-step so the new type round-trips into `crm_web_form_submissions.
custom_fields` cleanly.
* New: Web Form widget — per-field responsive Column Width control on BOTH Standard
Fields and Custom Fields repeaters. Each row exposes a Desktop / Tablet / Mobile
dropdown (100% / 75% / 66% / 50% / 33% / 25%) so editors can lay out e.g. First
Name + Last Name side-by-side on desktop while remaining stacked on mobile. Tablet
inherits Desktop, Mobile inherits Tablet, unless explicitly set. Under the hood
the form switches from single-column flex to a 12-column CSS grid; existing forms
render unchanged (each field defaults to full-width).
#### 2.5.20
* Maintenance: WP.org publish baseline catch-up. The wordpress.org SVN tags had
drifted behind by 9 versions (2.5.11–2.5.19 were never tagged on the public plugin
marketplace; sites updating from wordpress.org therefore still saw 2.5.10 as
the latest available build). 2.5.20 republishes the current trunk so customer
sites pick up everything between 2.5.10 and current in a single update. No behavioral
changes vs 2.5.18 — see prior entries below for what shipped over the catch-up
window (Web Leads / Live Chat overhaul, multi-tenant CRM scoping, franchise grid
stabilization, etc.).
#### 2.5.18
* Improve: Franchise grid shortcode — when a franchise card has no street/city/
state/zip fields populated, the embedded map now falls back to `lat,lng` coordinates
instead of using the franchise name as the search query (which would otherwise
resolve to an unrelated “A1 Chimney” listing in another state). If neither address
nor coordinates exist, the map is omitted entirely.
* Fix: Franchise grid card layout — cards become flex columns with `min-height:
2.5em` + `line-height: 1.25` on the title and `margin-top: auto` on the directions
link. Stops the map iframe from jumping rows when one card has a single-line
title and the neighbor has two lines.
#### 2.5.17
* Tweak: Live Chat default greeting copy — “Hi! Thanks for reaching out — a team
member will be with you in just a moment.” “Hi! Thanks for reaching out, a team
member will be with you as soon as possible.” Dropped the em-dash for a comma-
joined single thought, and softened the “moment” promise into “as soon as possible.”
Per-widget override still wins — existing Elementor placements that already saved
the old wording need to be edited (or cleared) in the widget admin to pick up
the new default. A one-time migration on plugin activation also rewrites any
saved Elementor postmeta values still carrying the old phrase to the new one.
#### 2.5.16
* Fix: Live Chat pre-chat form — name + phone-or-email fields rendered with the
customer site’s theme-default “dark form” styling (black background, white text)
instead of the plugin’s intended white-with-dark-text. Some Astra / Hello-Elementor
child themes ship a `body input { background: #000; color: #fff }` rule that
loads after the plugin’s stylesheet and wins on cascade order. Hardened `.a1tools-
web-chat-window__prechat input, textarea` with `!important` on background + color
+ border to defeat the theme cascade (same pattern as the 2.5.7 SVG-fill fix).
The new “How can we help?” textarea was visually correct out of the box in 2.5.15
only because no theme had targeted a bare `textarea` element yet; it’s now under
the same shield for safety.
#### 2.5.15
* New: Live Chat pre-chat form — added a third field, “How can we help?” (label
+ required-flag + placeholder all configurable in the Elementor widget admin).
The visitor types their first question or message before starting the chat. Server-
side: the question is stored as the first `sender='visitor'` message in the conversation,
between “Chat started by …” and the auto-greeting, so the flow reads as: (1)
system header, (2) visitor’s question, (3) auto-reply / “team member will be
with you shortly.” Dispatchers viewing the chat in the CRM Web Leads inbox see
the visitor’s intent immediately instead of having to ask “what brings you here?”
once they pick up.
#### 2.5.14
* Improve: Live Chat …
## Мета
* Нуска **3.3.5**
* Акыркы жаңыртуу **3 күн мурун**
* Активдүү орнотуулар **100+**
* WordPress нускасы ** 5.0 же андан жогору **
* Tested up to **6.9.7**
* PHP нускасы ** 7.4 же андан жогору **
* Тил
* [English (US)](https://wordpress.org/plugins/a1-tools/)
* Тег:
* [Business Information](https://ky.wordpress.org/plugins/tags/business-information/)
[contact info](https://ky.wordpress.org/plugins/tags/contact-info/)[multi-site](https://ky.wordpress.org/plugins/tags/multi-site/)
[shortcodes](https://ky.wordpress.org/plugins/tags/shortcodes/)[site variables](https://ky.wordpress.org/plugins/tags/site-variables/)
* [Advanced View](https://ky.wordpress.org/plugins/a1-tools/advanced/)
## Рейтинг
Азырынча эч кандай сын-пикир жок.
[Your review](https://wordpress.org/support/plugin/a1-tools/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/a1-tools/reviews/)
## Мүчөлөрү
* [ a1tools ](https://profiles.wordpress.org/a1tools/)
## Колдоо
Комментарийлер барбы? Жардам керекпи?
[Колдоо форумун көрүү](https://wordpress.org/support/plugin/a1-tools/)