Major upgrade for both A1 Web Form and A1 Live Chat widgets. The form widget gains full visual styling controls, a standard-fields repeater (toggle\/relabel\/reorder the 10 CRM fields), a custom-fields repeater (add arbitrary fields of any type), an SMS-consent block with TCPA-friendly legal-trail storage, and an optional "I'm not a robot" checkbox. The chat widget gains pre-chat form configurability and full window-container styling. The CRM client renders all of the new data in the dispatcher detail panel. Requires A1 Tools 5.3.166 or later on the server side (the DB schema adds three new columns).<\/p>","2.5.1":"
Critical fix for 2.5.0: the Web Form + Live Chat widgets were reading the wrong WordPress option for the CRM company ID, so on sites that already had the legacy form integration configured, the new widgets rendered with company_id=0 and the chat button was clickable but unresponsive. Update immediately if you've placed the new widgets on any live page.<\/p>","2.5.0":"
Adds two new Elementor widgets: A1 Web Form (structured lead intake) and A1 Web Chat (live chat with floating + inline modes that share one conversation). Submissions and chats flow into the reworked Web Leads tab in the CRM. Requires A1 Tools 5.3.160 or later on the server side.<\/p>","2.4.3":"
Franchise widget now uses stored coordinates correctly and aligns cards in the grid even when titles wrap to a second line.<\/p>","2.4.2":"
Fixes a transient TTL bug where "No caching" stored a permanent transient and every other duration was 60\u00d7 too long. Cached payloads (city pages, site variables, franchises, etc.) are flushed automatically on upgrade.<\/p>","1.4.0":"
Added auto-updates support for WordPress.<\/p>","1.3.2":"
Fixed WordPress.org compliance issues with inline styles and added Google Maps documentation.<\/p>","1.3.1":"
Fixed Plugin Check errors. Font Awesome is no longer auto-loaded - ensure your theme includes it or install a Font Awesome plugin.<\/p>","1.3.0":"
Important:<\/strong> All shortcode names have changed from New Social Icons Widget with full styling customization. Enhanced shortcode with style, shape, size, and hover effect options.<\/p>","1.1.0":" Added 6 new social media platforms: Pinterest, BBB, Nextdoor, Houzz, Angi, Thumbtack.<\/p>","1.0.9":" Added settings page with configurable cache duration and manual cache clear button. Default cache reduced to 5 minutes.<\/p>","1.0.8":" Added city name, state, and Google Maps location fields with new shortcodes.<\/p>","1.0.0":" Initial release of A1 Tools plugin.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3453106,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3453106,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3453106,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.10.0","1.3.2","1.4.0","1.4.1","1.4.10","1.4.11","1.4.12","1.4.13","1.4.14","1.4.2","1.4.3","1.4.4","1.4.5","1.4.6","1.4.7","1.4.8","1.4.9","1.5.0","1.5.1","1.5.2","1.5.3","1.5.4","1.5.5","1.5.6","1.5.7","1.5.8","1.5.9","1.6.0","1.6.1","1.6.2","1.6.3","1.6.4","1.6.5","1.6.6","1.6.7","1.6.8","1.6.9","1.7.0","1.7.1","1.7.2","1.7.3","1.7.4","1.7.5","1.7.6","1.7.7","1.7.8","1.7.9","1.8.0","1.8.1","1.8.2","1.8.3","1.8.4","1.8.5","1.8.6","1.9.0","1.9.1","1.9.2","1.9.3","1.9.4","1.9.5","1.9.6","1.9.7","1.9.8","1.9.9","2.0.0","2.0.1","2.0.2","2.0.4","2.0.5","2.0.6","2.0.7","2.1.5","2.1.6","2.2.0","2.3.0","2.4.0","2.4.1","2.4.2","2.4.3","2.5.0","2.5.10","2.5.2","2.5.20","2.5.26","2.5.3","2.5.4","2.5.5","2.5.6","2.5.7","2.5.8","2.5.9"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Site Variables management in A1 Tools dashboard","2":"Using shortcodes in the WordPress editor","3":"Elementor dynamic tags integration"}},"plugin_section":[],"plugin_tags":[25998,1092,2686,357,255157],"plugin_category":[43,51],"plugin_contributors":[255158],"plugin_business_model":[],"class_list":["post-278012","plugin","type-plugin","status-publish","hentry","plugin_tags-business-information","plugin_tags-contact-info","plugin_tags-multi-site","plugin_tags-shortcodes","plugin_tags-site-variables","plugin_category-customization","plugin_category-multisite","plugin_contributors-a1tools","plugin_committers-a1tools"],"banners":{"banner":"https:\/\/ps.w.org\/a1-tools\/assets\/banner-772x250.png?rev=3453106","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/a1-tools\/assets\/icon-128x128.png?rev=3453106","icon_2x":"https:\/\/ps.w.org\/a1-tools\/assets\/icon-256x256.png?rev=3453106","generated":false},"screenshots":[],"raw_content":"\n 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.<\/p>\n\n Perfect for businesses with multiple websites<\/strong> - update your phone number, address, or social media links once in the A1 Tools dashboard, and all your connected sites update automatically.<\/p>\n\n 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.<\/p>\n\n What it is:<\/strong> 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.<\/p>\n\n What data is sent:<\/strong> 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.<\/p>\n\n When data is sent:<\/strong>\n- When a page containing A1 Tools shortcodes is loaded\n- When the plugin's admin settings page is accessed\n- When the cache expires and fresh data is needed (configurable, default 5 minutes)<\/p>\n\n What data is received:<\/strong> 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.<\/p>\n\n Service Provider:<\/strong> A1 Chimney Service\nAPI Endpoint:<\/strong> https:\/\/tools.a-1chimney.com\/api\/website_variables.php\nTerms of Service:<\/strong> https:\/\/a-1chimney.com\/terms-of-service\/\nPrivacy Policy:<\/strong> https:\/\/a-1chimney.com\/privacy-policy\/<\/p>\n\n What it is:<\/strong> Google Maps is a web mapping service developed by Google. This plugin can embed Google Maps iframes to display your business location.<\/p>\n\n What data is sent:<\/strong> When using the When data is sent:<\/strong>\n- Only when a page containing the What data is received:<\/strong> Google Maps returns the embedded map showing your business location. Google may collect visitor data according to their privacy policy.<\/p>\n\n Service Provider:<\/strong> Google LLC\nEmbed URL:<\/strong> https:\/\/www.google.com\/maps\/embed\/v1\/place\nTerms of Service:<\/strong> https:\/\/www.google.com\/intl\/en_us\/help\/terms_maps\/\nPrivacy Policy:<\/strong> https:\/\/policies.google.com\/privacy<\/p>\n\n\n A1 Tools is a business management platform. Contact A1 Chimney Service for access information.<\/p><\/dd>\n 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.<\/p><\/dd>\n 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.<\/p><\/dd>\n 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.<\/p><\/dd>\n 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.<\/p><\/dd>\n\n<\/dl>\n\n\n[a1_*]<\/code> to [a1tools_*]<\/code>. Please update your shortcodes after upgrading. Example: [a1_var]<\/code> is now [a1tools_var]<\/code>.<\/p>","1.2.0":"Features<\/h4>\n\n
\n
[a1tools_var key=\"phone_primary\"]<\/code><\/li>\nAvailable Variables<\/h4>\n\n
\n
Shortcode Examples<\/h4>\n\n
[a1tools_var key=\"phone_primary\"] - Display primary phone number\n\n[a1tools_var key=\"facebook_url\" link=\"true\"] - Display Facebook URL as clickable link\n\n[a1tools_address format=\"full\"] - Display complete formatted address (multi-line)\n\n[a1tools_full_address] - Display full address in a single line (e.g., \"123 Main St, Suite 101, Miami, FL 30001\")\n\n[a1tools_hours format=\"table\"] - Display operating hours as a table\n\n[a1tools_social_links] - Display all configured social media icons\n\n[a1tools_social_links style=\"default\" shape=\"circle\" size=\"50\"] - Styled social icons\n\n[a1tools_city_name] - Display the city name for geo-targeting\n\n[a1tools_state] - Display the state name for geo-targeting\n\n[a1tools_google_map type=\"link\"] - Display Google Maps link\n\n[a1tools_google_map type=\"embed\" width=\"100%\" height=\"400\"] - Embed Google Maps iframe\n<\/code><\/pre>\n\nRequirements<\/h4>\n\n
\n
External Services<\/h3>\n\n
A1 Tools API<\/h4>\n\n
Google Maps Embed API<\/h4>\n\n
[a1tools_google_map type=\"embed\"]<\/code> 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.<\/p>\n\n[a1tools_google_map type=\"embed\"]<\/code> shortcode is loaded\n- The embed is loaded client-side by the visitor's browser directly from Google<\/p>\n\n\n
a1-tools<\/code> folder to the \/wp-content\/plugins\/<\/code> directory<\/li>\n\n
How do I get an A1 Tools account?<\/h3><\/dt>\n
Why are my variables not showing?<\/h3><\/dt>\n
\n
How often do variables update?<\/h3><\/dt>\n
Can I use this with Elementor?<\/h3><\/dt>\n
Is this plugin free?<\/h3><\/dt>\n
What data does this plugin send to external services?<\/h3><\/dt>\n
2.5.26<\/h4>\n\n
\n
POST \/wp-json\/a1-tools\/v1\/invalidate-cache<\/code>. 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.<\/li>\n<\/ul>\n\n2.5.25<\/h4>\n\n
\n
\n
a1tools_fetch_api_data()<\/code>: 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<\/code> timeout (15s) so a dying request can't hold the lock indefinitely.<\/li>\n[a1tools_var]<\/code> tags, for example) now hit the transient backend exactly once per page render instead of once per shortcode.<\/li>\na1tools_cache_expiry = 0<\/code> to the new default on plugin upgrade.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n2.5.24<\/h4>\n\n
\n
2.5.23<\/h4>\n\n
\n
border-color 180ms ease<\/code>) 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.<\/li>\n<\/ul>\n\n2.5.22<\/h4>\n\n
\n
justify-content: stretch<\/code> (which isn't a valid value for justify-content<\/code> \u2014 only align-items<\/code>\/align-content<\/code> accept it, so browsers silently dropped it and fell back to flex-end<\/code>) paired with a [data-align=\"full\"]<\/code> attribute selector for the width: 100%<\/code> 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<\/code>, --submit-width<\/code>) that Elementor emits on the .a1tools-web-form__actions<\/code> 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.<\/li>\n<\/ul>\n\n2.5.21<\/h4>\n\n
\n
<input type=\"time\"><\/code>). 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<\/code> cleanly.<\/li>\n2.5.20<\/h4>\n\n
\n
2.5.18<\/h4>\n\n
\n
lat,lng<\/code> 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.<\/li>\nmin-height: 2.5em<\/code> + line-height: 1.25<\/code> on the title and margin-top: auto<\/code> 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.<\/li>\n<\/ul>\n\n2.5.17<\/h4>\n\n
\n
2.5.16<\/h4>\n\n
\n
body input { background: #000; color: #fff }<\/code> rule that loads after the plugin's stylesheet and wins on cascade order. Hardened .a1tools-web-chat-window__prechat input, textarea<\/code> with !important<\/code> 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<\/code> element yet; it's now under the same shield for safety.<\/li>\n<\/ul>\n\n2.5.15<\/h4>\n\n
\n
sender='visitor'<\/code> message in the conversation, between \"Chat started by \u2026\" 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.<\/li>\n<\/ul>\n\n2.5.14<\/h4>\n\n
\n
auto<\/code> sender type added to crm_web_chat_messages.sender<\/code> ENUM. Distinct from system<\/code> so the dispatcher's CRM inbox and the visitor widget can both render auto-replies as chat bubbles while keeping the centered-italic styling exclusively for true session metadata (\"Chat started by \u2026\", \"Chat marked resolved by \u2026\", etc.).<\/li>\n<\/ul>\n\n2.5.13<\/h4>\n\n
\n
$hour >= 9 && $hour < 17<\/code>).<\/li>\n<\/ul>\n\n2.5.12<\/h4>\n\n
\n
.a1tools-web-chat<\/code> placement), so they fall through to the contact form \/ phone instead of pinging an unstaffed inbox. The cutoff is hard-coded for now \u2014 if you need configurable hours per widget, let us know.<\/li>\n<\/ul>\n\n2.5.11<\/h4>\n\n
\n
?ver=<\/code> query string on the asset URLs so browsers fetch the new JS\/CSS, alongside an Elementor CSS-cache flush + SiteGround dynamic-cache purge as part of this deploy.<\/li>\n<\/ul>\n\n2.5.10<\/h4>\n\n
\n
bottom: 20px<\/code> to bottom: 70px<\/code> so it doesn't collide with sticky footers, floating CTAs, or mobile safe-area indicators. Top-corner placements unchanged.<\/li>\n<\/ul>\n\n2.5.9<\/h4>\n\n
\n
a1tools_get_wp_city_pages()<\/code> now matches display_name LIKE '%city%' OR LIKE '%location%'<\/code> (still excluding %seo%<\/code>). Sites that use the Single Location<\/code> naming convention (e.g., ct.a-1chimney.com) will now surface ~all location pages alongside city pages. The page-type detection further down keys off \"location\" in the name, so the location_city<\/code> vs single_city<\/code> classification still works correctly regardless of which keyword matched.<\/li>\n<\/ul>\n\n2.5.8<\/h4>\n\n
\n
handleSessionClosed()<\/code>, but the same poll payload that signals the close ALSO carries the attended_by_dispatcher<\/code> field (the server keeps it populated on the row for record-keeping), and the subsequent updateAttended()<\/code> call would immediately un-hide the banner that was just hidden. Now updateAttended()<\/code> is gated on session_status === 'open'<\/code>; when the session is closed the banner is forcibly cleared and stays cleared.<\/li>\n.a1tools-web-chat-window<\/code> parent prefix to both selectors so they reach specificity 0,2,0 and keep their padding + shadow + transitions. Restart button is now a primary orange button (was an outlined secondary) to match the call-to-action role.<\/li>\n<\/ul>\n\n2.5.7<\/h4>\n\n
\n
[hidden]<\/code> (most do \u2014 div { display: block }<\/code> etc. at higher specificity than HTML5's user-agent default). Visitor saw the \"Start chat\" button alongside an active conversation and the \"Start a new chat\" button at the same time. Fixed with a scoped .a1tools-web-chat-window [hidden] { display: none !important }<\/code> rule so theme cascade can't defeat the state machine.<\/li>\nsvg { fill: <brand-color> }<\/code> at higher specificity than our scoped fill: currentColor<\/code>. Same-color-on-same-color = invisible icon. Strengthened the chat-window SVG rule with !important<\/code> on fill: currentColor<\/code>, visibility<\/code>, and opacity<\/code>.<\/li>\nhandleSessionClosed()<\/code> now clears the attended-by banner + typing-dots + state.attendedBy<\/code> alongside flipping the resolved view on. The banner re-renders fresh if the visitor starts a new chat that gets attended.<\/li>\n<\/ul>\n\n2.5.6<\/h4>\n\n
\n
data-company-id=\"0\"<\/code> on every site that hadn't been manually configured, so the chat button did nothing and form submissions rejected. The CRM company id is now auto-resolved from the server<\/strong> when the WP-Admin option is still at the default 0. The plugin hits tools.a-1chimney.com\/api\/website_variables.php?action=public&url=<site_url><\/code> (which already does the wordpress_sites \u2192 wordpress_groups.company_id<\/code> JOIN), reads the returned company_id<\/code>, and persists it back into the option so subsequent renders don't re-fetch. Admin overrides win \u2014 manual edits in the settings UI are never overwritten. The 41 customer sites running 2.5.5 were back-filled directly via wp-cli during this release; new installs from here on configure themselves on first widget render.<\/li>\n<\/ul>\n\n2.5.5<\/h4>\n\n
\n
since_message_id<\/code> from localStorage<\/code> and then polling id > since_id<\/code>, which returned no rows because the watermark already covered every prior message. Resolved by forcing since_message_id=0<\/code> + an in-memory isInitialRestore<\/code> flag on the page-load fetch so the entire thread reloads \u2014 including the visitor's own bubbles (which were skipped during live polling as \"already optimistically rendered\" but ARE legitimately needed after a reload because the optimistic DOM is gone).<\/li>\ndisplay: flex<\/code> which beat HTML5's default [hidden] { display: none }<\/code> when site themes overrode the hidden default. Added explicit [hidden] !important<\/code> rule.<\/li>\nfirst_name last_name<\/code> via a batched lookup against a1tools_users<\/code> in poll \/ resume \/ list-sessions \/ session-messages responses (single SQL query per request, no N+1). Visitor JS prefers the new sender_display_name<\/code> \/ attended_by_dispatcher_display_name<\/code> fields and falls back to username transparently.<\/li>\n<\/ul>\n\n2.5.4<\/h4>\n\n
\n
2.5.3<\/h4>\n\n
\n
button { background: gold; color: gold; }<\/code> made every SVG with fill: currentColor<\/code> disappear into the same-coloured background). Resolved by introducing a chat-window-scoped CSS reset and bumping selector specificity on the close \/ attach \/ send buttons so theme styles can't leak in.<\/li>\na-1chimney.com<\/code> (and its www.<\/code> subdomain). The widget POSTs to tools.a-1chimney.com\/api\/web_chat.php<\/code> \/ web_forms.php<\/code> from