A1 Tools

[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

Changelog

2.3.0

• Added: licence field to site variables
• Added: [a1tools_licence] shortcode for displaying licence number

2.2.0

• New: Blog Sync REST endpoints for cross-site post management
• New: /blog-posts endpoint for listing posts with metadata and Yoast SEO
• New: /blog-posts/{id} endpoint for full post content with SEO data
• New: /blog-sync/create endpoint for creating synced posts with categories, tags, featured images, and Yoast SEO
• New: /blog-sync/update/{id} endpoint for updating synced posts
• New: Image sideloading helper for featured image sync across sites

2.1.6

• Fixed: SEO location shortcode names in app reference had incorrect seo prefix
• New: SEO Location Shortcodes section on A1 Tools settings page with sample values and copy buttons
• New: Expandable “View all locations” table on settings page for multi-location sites

2.1.3

• Fixed: All Plugin Check errors and warnings resolved
• Fixed: Output escaping on social icon HTML
• Fixed: Added translators comment for Elementor widget
• Fixed: Replaced rename() with WP_Filesystem::move()
• Fixed: Added wp_unslash() to all $_POST/$_SERVER inputs
• Fixed: Prefixed global variables in uninstall.php

2.1.2

• Fixed: Plugin zip packaging for WordPress compatibility

2.1.1

• Fixed: Syntax error in media management module

2.1.0

• Security: Full security and standards audit per WordPress Plugin Directory review
• Removed: Update URI header (per WordPress.org guidelines)
• Fixed: Output escaping in city address inline format
• Fixed: REST API permission callback now uses WP_REST_Request instead of getallheaders()
• Fixed: All database queries now use $wpdb->prepare()
• Fixed: Replaced @unlink() with wp_delete_file()
• Fixed: error_log() calls now wrapped in WP_DEBUG checks
• Improved: Uninstall handler now cleans up all plugin options and transients
• Updated: Tested up to WordPress 6.9

2.0.10

• New: City, Full Address, and State fields for SEO location pages
• New: [a1tools_location_city], [a1tools_location_address], [a1tools_location_state] shortcodes
• Improved: [a1tools_location_web] link text now uses full address, [a1tools_city_web] uses city name, [a1tools_state_web] uses state name

2.0.9

• New: SEO Locations system — manage phone, URLs, map address, and Street View embed per SEO City page
• New: 7 shortcodes — [a1tools_location_phone], [a1tools_location_web], [a1tools_city_web], [a1tools_state_web], [a1tools_map_address], [a1tools_viewpoint], [a1tools_location_list]
• New: Data fetchers for SEO City author pages (separate from regular City Pages)

2.0.8

• Refactor: Split monolithic plugin file into logical modules for maintainability
• New: Cache invalidation REST endpoint for programmatic cache busting
• Improved: Plugin architecture — shortcodes, data fetching, admin, forms, REST API, Elementor, and Yoast integration now in separate include files

2.0.7

• New: [a1tools_post_title] shortcode — outputs the current post/page title with optional tag, class, before/after text

2.0.6

• Improved: CRM leads now capture service requested, appointment date/time, and state from form submissions
• Improved: Leads stored with separate service_need, preferred_date, preferred_time fields

2.0.5

• Maintenance: Version bump to sync latest plugin updates

2.0.2

• New: CRM Lead Integration — form submissions now optionally create CRM leads
• New: CRM Company ID and CRM Franchise ID settings for targeting leads to specific CRM locations

2.0.1

• New: Replace File button — swap a media file with a new upload while keeping the same attachment ID, URL, and post references
• Replaces physical file, regenerates all thumbnails, updates MIME type and metadata automatically

2.0.0

• Improved: Unified Save button — renames file (if changed) and saves all meta in one click
• New: Delete button to permanently remove media files
• Improved: Full-width input fields for better usability
• Improved: Update refs checkbox moved to actions row with Save and Delete

1.9.9

• New: Media Management — Title, Caption, and Description fields matching WordPress Media editor
• Improved: Aligned field labels (File Name, Alt Text, Title, Caption, Description) for clean layout
• Improved: Single “Save Details” button saves all meta fields at once

1.9.8

• New: SEO score badges (0-4) per media item — filename quality, alt text, file size, usage
• New: Inline alt text editor — edit image alt text directly from the media list
• New: Smart SEO filters — Needs Rename, Missing Alt Text, Large Files, Unused Media, SEO Optimized
• New: Random filename detection — automatically flags camera/screenshot/gibberish filenames
• New: Usage tracking — shows how many posts reference each media file
• New: File size warnings — badges for oversized files (>500KB)
• New: Bulk rename with pattern — select multiple files, rename with auto-incrementing pattern
• New: Bulk alt text — set alt text for multiple images at once (supports {filename} variable)
• New: Undo rename — revert a rename with one click
• New: Duplicate file detection — finds identical files uploaded multiple times
• New: Sort options — sort by date or filename, ascending or descending

1.9.7

• Improved: Media Management — wider rename input field and MIME type filter dropdown
• New: Media Management — click any image thumbnail to preview full-size in a lightbox

1.9.4

• New: Media Management tool — browse and rename media files with SEO-friendly names
• New: Renames physical files, thumbnails, updates metadata, and optionally updates post references
• New: Photo shape option for Team widget — circle or square (fill card)
• Fix: Team widget card background is now transparent by default (customizable in Style tab)
• Fix: Elementor editor now live-updates when changing Team widget content settings
• Improvement: Columns max increased from 4 to 6

1.9.3

• Fix: City link and state link shortcodes now correctly receive URL data from API
• Fix: API public endpoint now returns city_url and state_url fields

1.9.2

• New: [a1tools_city_link] shortcode — outputs city name as a clickable link
• New: [a1tools_state_link] shortcode — outputs state name as a clickable link
• New: City Link URL and State Link URL fields in site Information tab
• Both shortcodes support text, target, and class attributes
• Falls back to plain text when no URL is configured

1.9.1

• New: Team member categories — assign members to categories (e.g., Management, Technicians, Office)
• New: Team members grouped by category with section headings on the website
• New: Category display order control via Elementor widget or shortcode attribute
• New: Category Heading style controls in Elementor (typography, color, border color, spacing)
• New: [a1tools_team category=”Management”] — filter to a single category
• New: [a1tools_team category_order=”Management, Technicians”] — set category display order
• Fix: Services tab now correctly discovers WordPress service pages

1.9.0

• New: A1 Services Elementor widget and [a1tools_services] shortcode — display site-specific service cards loaded from WordPress pages
• New: A1 Reviews Elementor widget and [a1tools_reviews] shortcode — display customer reviews with star ratings in grid, carousel, or list layout
• New: A1 Before/After Elementor widget and [a1tools_before_after] shortcode — comparison slider or grid of before/after project photos
• New: A1 Team Elementor widget and [a1tools_team] shortcode — display team member cards with photo, role, bio, and certifications
• New: A1 FAQ Elementor widget and [a1tools_faq] shortcode — accordion FAQ with Schema.org FAQPage JSON-LD structured data
• New: Services tab in site view — loads WordPress pages by “Large Service” author for per-site service management
• New: Reviews, Before/After, Team, and FAQ tabs in group settings view for cross-site content management
• Five new API endpoints for full CRUD operations on all new content types
• All new shortcodes support layout options (grid/list/carousel/slider), column controls, featured-only filtering, and custom CSS classes
• Elementor widgets include full content and style controls with responsive settings

1.8.4

• New: Accordion/collapsible groups — collapse city lists under clickable group headings
• New: Accordion settings — default state (collapsed/expanded), open behavior (multiple/single), arrow indicator
• New: Search bar — live-filter search box that filters cities as you type, auto-expands matching accordion groups
• New: City count badge — display number of cities per group in the heading
• New: Elementor style controls for accordion (arrow color, size, animation speed), search bar (typography, colors, border, padding), and count badge color
• Keyboard accessible accordion (Enter/Space to toggle)

1.8.6

• Fix: Mobile/tablet responsive columns now work correctly in Elementor widget
• Fix: Inline column styles no longer override Elementor responsive breakpoint settings

1.8.5

• Fix: Ungrouped cities now show “Ungrouped” heading instead of no heading
• Fix: Ungrouped section supports accordion expand/collapse and city count badge

1.8.3

• Fix: City List widget now shows ALL city pages, not just ones with saved data
• Fix: Exclude “SEO City” author pages from city lists (both widget and app)
• Fix: Rewrote city page discovery using $wpdb + WP_Query for reliability across all WP versions
• Fix: Connection Status now shows all city pages from WP database (not just API-saved ones)
• New: WordPress-side city page discovery — queries local WP database for complete page list

1.8.1

• New: A1 City List Elementor widget — displays linked city page lists with optional group headings
• New: [a1tools_city_list] shortcode — renders grouped or flat city lists with permalinks
• New: City page grouping — assign cities to groups (e.g., counties) from the A1 Tools app
• Widget supports: single/multi-column layout, group filtering, type filtering, state suffix
• Full Elementor styling: container, group heading, list items (Normal/Hover), column gap
• Group headings support typography, colors, background, padding, border, and spacing controls

1.8.0

• New: City Pages management — assign unique phone numbers and addresses to individual city pages
• New: [a1tools_city_phone] shortcode — auto-detects current page and outputs city-specific phone number
• New: [a1tools_city_phone link=”yes”] — outputs phone as a clickable tel: link
• New: [a1tools_city_address] shortcode — outputs city-specific address (supports format=”inline” and format=”full”)
• New: City Pages section in Connection Status showing all configured cities with their data
• City shortcodes fall back to site primary phone and address when no city-specific data is assigned

1.7.8

• Fix: Icons in A1 Contact Info and A1 Business Hours widgets now align to the top of their content
• Hours widget icon aligns to flex-start instead of center to prevent visual gaps
• Added more specific CSS selector to prevent theme overrides on icon vertical alignment

1.7.7

• New: Parent Page selector on Import — assign all imported pages as children of a specific page
• Import now respects the selected parent page for both new inserts and existing page updates

1.7.6

• New: Interactive store locator powered by Google Maps JavaScript API with custom markers
• New: Professional split-panel layout with scrollable store cards (with images) and interactive map
• New: Custom marker icon support (set via Plugin Settings or Elementor widget)
• New: Google Maps API Key setting in Plugin Settings page
• New: Store editor now includes Full Address auto-fill, Google Maps URL field, and auto lat/lng extraction
• New: google_maps_url field added to group_stores database table
• Store cards now show images, phone, email, directions link, and website link
• Map pans and zooms when clicking store cards; info windows show on marker click
• Search filters both card list and map markers simultaneously
• Falls back to iframe embeds gracefully when no Google Maps API key is configured

1.7.5

• Fix: Google Maps embeds now show place info instead of “Place info couldn’t load”
• Maps now use business name + address for embed queries instead of raw coordinates
• Franchise and Store Locator maps both fixed for proper place resolution
• Maps can now display even without lat/lng as long as address data is available

1.7.4

• New: Show/Hide Title toggle for franchise widget and shortcode (show_title attribute)
• New: Alignment controls for Address, Phone, and Directions Button sections
• All text elements in the franchise widget can now be independently aligned (left/center/right)

1.7.3

• Enhanced: A1 Franchise Location widget — full styling controls: border, border hover, box shadow, hover shadow, typography groups, button normal/hover tabs, spacing, alignment
• Enhanced: A1 Store Locator widget — full styling controls: border, border hover, box shadow, hover shadow, typography groups, link hover colors, card spacing, search/filter styling
• Both widgets now match the styling depth of the Info Box and CTA widgets

1.7.2

• Fix: Franchise locations not loading on frontend (fixed site_id column resolution in API)
• New: Franchise Locations table in admin Connection Status page
• New: Store Locator table in admin Connection Status page
• Franchise and Store shortcode references with copy buttons on settings page

1.7.1

• Updated: [a1tools_franchise] shortcode now supports multiple franchise locations per site
• New: columns attribute (1-3) for grid layout of franchise cards
• New: id attribute to display a specific franchise by ID
• New: show_address attribute to toggle address display
• New: Dedicated site_franchises API for per-site franchise CRUD
• Updated: A1 Franchise Location Elementor widget with Columns and Franchise ID controls
• Updated: Franchise data now cached separately with its own transient
• Franchise locations include full address (line1, line2, city, state, zip, country)

1.7.0

• New: Store Locator Elementor widget (A1 Store Locator) — displays searchable store locations with map embeds
• New: Franchise Location Elementor widget (A1 Franchise Location) — displays site-specific location card with name, phone, and map
• New: [a1tools_store_locator] shortcode with search, state filter, and Google Maps embeds
• New: [a1tools_franchise] shortcode with phone link and map embed
• New: Latitude and Longitude dynamic tags for Elementor
• New: Group stores data fetch with transient caching
• Added latitude/longitude fields to site variables for map embeds

1.6.9

• Added author selection dropdown to Import section — choose which author imported pages are assigned to

1.6.8

• Fixed author filter AJAX — class now initializes on plugin load so AJAX endpoints are registered during admin-ajax.php requests

1.6.7

• Fixed Import/Export page list loading — pages now render instantly on page load (server-side)
• Added animated spinner for author filter changes
• Added progress bar with indeterminate animation for export and import operations
• Improved error handling and user feedback throughout

1.6.6

• Added Import/Export functionality for WordPress pages with full Elementor data preservation
• New submenu page: A1 Tools > Import / Export
• Export pages as JSON or WordPress XML (WXR) format
• Import pages from JSON or WXR files with duplicate handling (Skip, Create New, Update Existing)
• Author-based filtering for page exports with Select All / Deselect All
• Preserves all Elementor builder data, page settings, and template types during import

1.6.4

• Fixed icon padding inconsistency between Elementor editor and live frontend — added explicit margin, padding, and sizing resets to icon elements ( and ) inside info-box and hours widgets

1.6.3

• Fixed icon disappearing when button animations are active — replaced transition: all with explicit property transitions to prevent conflict with animation transforms

1.6.2

• A1 CTA widget now supports three actions: Call Phone, Send Email, or Custom URL
• Custom URL action includes full Elementor URL control (link, new tab, nofollow)
• Button displays the phone number, email, or URL by default — custom text overrides the display

1.6.1

• Added Glow Color picker for the Glow animation on A1 CTA widget

1.6.0

• Added 10 button animations to A1 CTA widget: Pulse, Heartbeat, Bounce, Shake, Glow, Wiggle, Flash, Swing, Rubber Band, Tada
• Animation speed control (Slow / Normal / Fast)
• “Only on Hover” option — animation plays continuously or only when hovered

1.5.9

• Added A1 CTA Elementor widget — click-to-call button with icon, custom text option, and full styling
• Supports icon position (before/after text), full-width mode, alignment, Normal/Hover color tabs
• Button always links to the primary phone number; custom text replaces the display while keeping the call function

1.5.8

• Added border hover color control to Box Style section for Phone, Email, Location, and Contact Info widgets
• Smooth border color transition on hover

1.5.7

• Added vertical alignment control (Top / Middle / Bottom) for info-box widgets (Phone, Email, Location, Contact Info)
• Allows centering text content relative to the icon

1.5.6

• Added icon border controls (type, color, width) to Phone, Email, Location, Business Hours, and Contact Info widgets
• Added background color, padding, border radius controls to Business Hours and Contact Info icon sections (parity with info-box widgets)
• Changed icon padding to dimensions control (top/right/bottom/left) for all icon widgets

1.5.4

• Added link wrapper to info-box widgets — entire box (icon + title + value) is now clickable
• Added underline control (None / Always / On Hover) for linked info-box widgets
• Added hover color controls for icon, title, and value on linked info-box widgets
• Applied link wrapper and hover controls to combined A1 Contact Info widget
• Smooth color transitions on hover for all linked elements

1.5.3

• Added A1 Phone Elementor widget with icon picker, click-to-call link, and full styling
• Added A1 Email Elementor widget with icon picker, mailto link, and full styling
• Added A1 Location Elementor widget with icon picker, Google Maps link, and full styling
• Added A1 Contact Info Elementor widget (combined Phone + Email + Location + Hours)
• All info-box widgets support icon background, border radius, typography, and box styling

1.5.2

• Added A1 Business Hours Elementor widget with full styling controls
• Supports list, table, and inline layouts
• Customizable icon, colors, typography, dividers, box styling, and alignment
• Option to hide closed days and customize closed text

1.5.1

• Deferred form submission API call to PHP shutdown to avoid interfering with Elementor form actions (MailChimp, email, etc.)
• Form forwarding now only active when enabled in settings (prevents unintended interference)
• Changed form hook priority to 99 so other actions run first

1.5.0

• Added [a1tools_website_url] shortcode to display the site URL
• Added form submission integration settings for Sunday board
• Supports link=”true” for clickable links and text=”” for custom link text

1.4.13

• Fixed shortcodes not resolving inside link href attributes (e.g., tel:[a1tools_var key=”phone_primary”])
• Added content filter to process A1 Tools shortcodes in href values before rendering

1.4.12

• Added standalone Full Address field (full_address) for [a1tools_full_address] shortcode
• [a1tools_full_address] now uses stored value if set, falls back to assembled parts
• Fixed Connection Status table showing “(not set)” for Full Address (single line)

1.4.11

• Fixed X (Twitter) icon not displaying (fa-x-twitter is Font Awesome 6 only)
• Added inline SVG support for icons not available in Font Awesome 5
• X icon now renders as proper SVG that scales with icon size settings

1.4.10

• Fixed icons being pushed upwards in header containers
• Changed container from font-size:0 hack to proper flexbox layout
• Spacing now uses CSS gap instead of margin (eliminates unwanted bottom margin)
• Alignment now uses justify-content for proper flex positioning

1.4.9

• Fixed icons being pushed upwards in their container
• Moved base CSS to properly enqueued stylesheet (loads once, works in editor and frontend)
• Removed inline style block from widget render for cleaner output
• Added style-class approach for non-custom style presets

1.4.8

• Rewrote Elementor widget to use Elementor’s selectors system for all color controls
• Fixed Elementor global colors not applying (colors were empty when using global color picker)
• Fixed alignment control not working in editor or frontend
• Fixed icons shifting position when widget is not selected in editor
• Hover effects now use CSS class-based approach (prefix_class) for reliability in both editor and frontend
• Size, spacing, shape, and icon size controls now use Elementor selectors for instant preview updates

1.4.7

• Fixed hover effects (scale, lift, rotate, pulse) not showing in Elementor editor preview
• Fixed custom hover colors not applying in Elementor editor preview
• Editor preview now matches frontend hover behavior

1.4.6

• Fixed icon color not applying on frontend (was same color as background)
• Fixed Elementor global colors not working with Custom Colors style
• Fixed icons being pushed upwards on live site
• Improved CSS specificity to ensure custom styles override theme styles

1.4.5

• Rewrote Elementor Social Icons widget to render CSS directly for proper styling
• Editor preview now shows actual configured social platforms instead of hardcoded samples
• Added “Available platforms” info panel in Elementor widget settings
• Fixed CSS not applying on frontend when using Elementor widget

1.4.4

• Fixed Elementor Social Icons widget not displaying on frontend
• Ensured CSS styles are properly registered and enqueued when shortcode runs

1.4.3

• Added HomeAdvisor social platform support

1.4.2

• Stability improvements

1.4.1

• Maintenance release for WordPress.org auto-updates compatibility

1.4.0

• Added Update URI header for WordPress auto-updates support

1.3.2

• Fixed inline style output to use wp_add_inline_style() for WordPress.org compliance
• Added Google Maps Embed API to External Services documentation
• Widget styles now properly enqueued through WordPress enqueue system

1.3.1

• Fixed output escaping issues in Social Icons Widget for WordPress.org compliance
• Removed external CDN dependency for Font Awesome (now requires theme or plugin to provide)
• Added PHPCS ignore comments for legitimate unescaped outputs
• Fixed non-prefixed hook warning for Yoast SEO integration

1.3.0

• Updated all function, class, and constant prefixes to use a1tools_ (4+ characters) for WordPress.org compliance
• Added External Services documentation for third-party API usage disclosure
• Updated all shortcode names to use a1tools_ prefix (e.g., [a1tools_var], [a1tools_address])
• Fixed uninstall.php to properly clean up all plugin options and transients
• Added missing variables to Elementor dynamic tags
• Improved Font Awesome loading to prevent duplicate enqueuing

1.2.0

• Added Social Icons Widget with full styling customization
• Widget options: Style (Official Colors, Outline, Minimal, Light, Dark)
• Widget options: Shape (Rounded, Circle, Square)
• Widget options: Size, Icon Size, Spacing, Alignment
• Widget options: Hover Effects (Scale, Lift, Rotate, Pulse)
• Widget options: Custom Color override
• Enhanced social links shortcode with styling parameters
• Automatic Font Awesome 6 loading for social icons
• Added full address shortcode for single-line address display
• Added A1 Social Icons Elementor widget

1.1.0

• Added 6 new social media platforms: Pinterest, BBB, Nextdoor, Houzz, Angi, Thumbtack
• Settings page now shows all available fields with their shortcodes
• Updated social links shortcode to include all platforms

1.0.9

• Added admin settings page under A1 Tools menu
• Configurable cache duration (No caching, 1 min, 5 min, 10 min, 30 min, 1 hour, 24 hours)
• Manual “Clear Cache Now” button for instant updates
• Connection status display showing current values from A1 Tools
• Changed default cache from 1 hour to 5 minutes

1.0.8

• Added new geo-targeting fields: City Name and State
• Added Google Maps URL field for location linking/embedding
• New shortcodes: city name, state, google map
• Google Maps shortcode supports both link and embed modes

1.0.0

• Initial release
• Site variables shortcodes
• Elementor dynamic tags integration
• REST API endpoints for variable retrieval
• Caching for performance
• Yoast SEO meta field integration via REST API