';
// Search bar.
if ( $show_search ) {
$placeholder = ! empty( $atts['search_placeholder'] ) ? $atts['search_placeholder'] : 'Search cities...';
$output .= '' . esc_html( $label ) . ' ';
};
if ( $show_groups ) {
// Group cities by group_name.
$groups = array();
$ungrouped = array();
foreach ( $cities as $city ) {
$gn = isset( $city['group_name'] ) ? $city['group_name'] : '';
if ( ! empty( $gn ) ) {
if ( ! isset( $groups[ $gn ] ) ) {
$groups[ $gn ] = array();
}
$groups[ $gn ][] = $city;
} else {
$ungrouped[] = $city;
}
}
// Render each group.
foreach ( $groups as $group_name => $group_cities ) {
$city_count = count( $group_cities );
$output .= '
';
// Base styles (output once per page via static flag).
static $styles_output = false;
if ( ! $styles_output ) {
$output .= '';
$styles_output = true;
}
// Inline JS for accordion + search (output once per page).
static $js_output = false;
if ( ! $js_output && ( $accordion || $show_search ) ) {
$output .= '';
$js_output = true;
}
return $output;
}
add_shortcode( 'a1tools_city_list', 'a1tools_shortcode_city_list' );
// ============================================================================
// FRANCHISE LOCATION & STORE LOCATOR SHORTCODES
// ============================================================================
/**
* Shortcode: [a1tools_franchise]
* Outputs franchise location cards with name, phone, address, and map embed.
* Supports multiple franchises per site in a responsive grid layout.
*
* Attributes:
* show_phone - yes/no (default: yes)
* show_address - yes/no (default: yes)
* show_map - yes/no (default: yes)
* show_directions - yes/no (default: yes)
* map_height - pixels (default: 300)
* map_zoom - 1-20 (default: 15)
* columns - 1-3 grid columns (default: 1)
* id - show only a specific franchise by ID (optional)
* class - custom CSS class (default: a1tools-franchise-card)
*
* @since 1.7.0
* @updated 1.7.1 Multi-franchise support with grid layout.
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_franchise( $atts ) {
$atts = shortcode_atts(
array(
'show_title' => 'yes',
'show_phone' => 'yes',
'show_address' => 'yes',
'show_map' => 'yes',
'show_directions' => 'yes',
'map_height' => '300',
'map_zoom' => '15',
'columns' => '1',
'id' => '',
'class' => 'a1tools-franchise-card',
),
$atts,
'a1tools_franchise'
);
$franchises = a1tools_get_site_franchises();
if ( empty( $franchises ) ) {
return '';
}
// If a specific franchise ID is requested, filter to just that one.
if ( ! empty( $atts['id'] ) ) {
$target_id = intval( $atts['id'] );
$franchises = array_filter(
$franchises,
function ( $f ) use ( $target_id ) {
return intval( $f['id'] ) === $target_id;
}
);
if ( empty( $franchises ) ) {
return '';
}
}
$columns = max( 1, min( 3, intval( $atts['columns'] ) ) );
// Grid wrapper.
$output = ''
. ''
. '
';
}
// Helper to render a single city link.
$render_link = function ( $city ) use ( $atts, $target ) {
$label = isset( $city['page_title'] ) ? $city['page_title'] : '';
if ( 'yes' === $atts['append_state'] && ! empty( $atts['state'] ) ) {
$label .= ', ' . $atts['state'];
}
return '';
// Group heading (with optional accordion + count).
$h_class = 'a1tools-city-group-heading';
$h_attrs = '';
if ( $accordion ) {
$h_class .= ' a1tools-accordion-toggle';
$h_attrs = ' role="button" tabindex="0" aria-expanded="' . ( $acc_expanded ? 'true' : 'false' ) . '"';
}
$output .= '
'; // .a1tools-city-group
}
// Render ungrouped at the end with "Ungrouped" heading.
if ( ! empty( $ungrouped ) ) {
$ug_count = count( $ungrouped );
$output .= ''; if ( $accordion && $acc_icon ) { $output .= ''; } $output .= esc_html( $group_name ); if ( $show_count ) { $output .= ' (' . intval( $city_count ) . ')'; } $output .= '
'; // Wrap list in accordion content div when accordion is enabled. if ( $accordion ) { $display = $acc_expanded ? '' : ' style="display:none;"'; $output .= '';
}
$output .= '
'; // .a1tools-accordion-content
}
$output .= '- ';
foreach ( $group_cities as $city ) {
$output .= $render_link( $city );
}
$output .= '
';
// Heading (with optional accordion + count, same as grouped).
$ug_class = 'a1tools-city-group-heading';
$ug_attrs = '';
if ( $accordion ) {
$ug_class .= ' a1tools-accordion-toggle';
$ug_attrs = ' role="button" tabindex="0" aria-expanded="' . ( $acc_expanded ? 'true' : 'false' ) . '"';
}
$output .= '
';
}
} else {
// Flat list.
$output .= ''; if ( $accordion && $acc_icon ) { $output .= ''; } $output .= esc_html__( 'Ungrouped', 'a1-tools' ); if ( $show_count ) { $output .= ' (' . intval( $ug_count ) . ')'; } $output .= '
'; if ( $accordion ) { $display = $acc_expanded ? '' : ' style="display:none;"'; $output .= '';
}
$output .= '
';
}
$output .= '- ';
foreach ( $ungrouped as $city ) {
$output .= $render_link( $city );
}
$output .= '
- ';
foreach ( $cities as $city ) {
$output .= $render_link( $city );
}
$output .= '
';
foreach ( $franchises as $franchise ) {
$name = isset( $franchise['name'] ) ? $franchise['name'] : '';
$phone = isset( $franchise['phone'] ) ? $franchise['phone'] : '';
$lat = isset( $franchise['latitude'] ) ? $franchise['latitude'] : '';
$lng = isset( $franchise['longitude'] ) ? $franchise['longitude'] : '';
$maps_url = isset( $franchise['google_maps_url'] ) ? $franchise['google_maps_url'] : '';
if ( empty( $name ) ) {
continue;
}
// Build address string.
$address_parts = array();
if ( ! empty( $franchise['address_line1'] ) ) {
$address_parts[] = $franchise['address_line1'];
}
if ( ! empty( $franchise['address_line2'] ) ) {
$address_parts[] = $franchise['address_line2'];
}
$city_state_zip = array();
if ( ! empty( $franchise['city'] ) ) {
$city_state_zip[] = $franchise['city'];
}
if ( ! empty( $franchise['state'] ) ) {
$city_state_zip[] = $franchise['state'];
}
if ( ! empty( $franchise['zip'] ) ) {
$city_state_zip[] = $franchise['zip'];
}
if ( ! empty( $city_state_zip ) ) {
$address_parts[] = implode( ', ', $city_state_zip );
}
$full_address = implode( '
', array_map( 'esc_html', $address_parts ) ); $output .= '
'; // .a1tools-franchise-grid
// Inline styles (output once).
$output .= '';
return $output;
}
add_shortcode( 'a1tools_franchise', 'a1tools_shortcode_franchise' );
/**
* Shortcode: [a1tools_store_locator]
* Interactive store locator with Google Maps JS API, custom markers, and split-panel layout.
* Falls back to iframe embeds when no Google Maps API key is configured.
*
* @since 1.7.0
* @updated 1.7.6 Google Maps JS API with custom markers, image cards, professional layout.
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_store_locator( $atts ) {
$atts = shortcode_atts(
array(
'map_height' => '500',
'show_search' => 'yes',
'show_filters' => 'yes',
'show_images' => 'yes',
'marker_icon' => '',
'api_key' => '',
'class' => 'a1tools-store-locator',
),
$atts,
'a1tools_store_locator'
);
$stores = a1tools_get_group_stores();
if ( empty( $stores ) ) {
return '', array_map( 'esc_html', $address_parts ) ); $output .= '
';
// Title.
if ( 'yes' === $atts['show_title'] ) {
$output .= '
'; // .a1tools-franchise-card
}
$output .= '' . esc_html( $name ) . '
'; } // Address. if ( 'yes' === $atts['show_address'] && ! empty( $full_address ) ) { $output .= '' . $full_address . '
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped above via esc_html per part.
}
// Phone.
if ( 'yes' === $atts['show_phone'] && ! empty( $phone ) ) {
$phone_clean = preg_replace( '/[^0-9+]/', '', $phone );
$output .= '';
$output .= '' . esc_html( $phone ) . '';
$output .= '
';
}
// Map embed — use name + address so Google resolves the actual place & shows info.
if ( 'yes' === $atts['show_map'] ) {
$embed_parts = array();
if ( ! empty( $name ) ) {
$embed_parts[] = $name;
}
if ( ! empty( $franchise['address_line1'] ) ) {
$embed_parts[] = $franchise['address_line1'];
}
if ( ! empty( $franchise['city'] ) ) {
$embed_parts[] = $franchise['city'];
}
if ( ! empty( $franchise['state'] ) ) {
$embed_parts[] = $franchise['state'];
}
if ( ! empty( $franchise['zip'] ) ) {
$embed_parts[] = $franchise['zip'];
}
$embed_query = implode( ', ', $embed_parts );
// Fallback to lat/lng if no address info available.
if ( empty( $embed_query ) && ! empty( $lat ) && ! empty( $lng ) ) {
$embed_query = $lat . ',' . $lng;
}
if ( ! empty( $embed_query ) ) {
$embed_url = 'https://maps.google.com/maps?q=' . urlencode( $embed_query ) . '&z=' . esc_attr( $atts['map_zoom'] ) . '&output=embed';
$output .= '';
$output .= '';
$output .= '
';
}
}
// Get Directions link.
if ( 'yes' === $atts['show_directions'] && ! empty( $maps_url ) ) {
$output .= '';
$output .= '' . esc_html__( 'Get Directions', 'a1-tools' ) . '';
$output .= '
';
}
$output .= '' . esc_html__( 'No store locations found.', 'a1-tools' ) . '
'; } // Resolve API key and marker icon (shortcode attr > WP option > empty). $api_key = ! empty( $atts['api_key'] ) ? $atts['api_key'] : get_option( 'a1tools_google_maps_api_key', '' ); $marker_icon = ! empty( $atts['marker_icon'] ) ? $atts['marker_icon'] : get_option( 'a1tools_marker_icon_url', '' ); $use_js_api = ! empty( $api_key ); // Collect unique states for filter dropdown. $states = array(); foreach ( $stores as $store ) { if ( ! empty( $store['state'] ) && ! in_array( $store['state'], $states, true ) ) { $states[] = $store['state']; } } sort( $states ); // Build JSON data for JavaScript. $stores_json = array(); foreach ( $stores as $store ) { $addr_parts = array(); if ( ! empty( $store['address_line1'] ) ) { $addr_parts[] = $store['address_line1']; } if ( ! empty( $store['address_line2'] ) ) { $addr_parts[] = $store['address_line2']; } $csz = array(); if ( ! empty( $store['city'] ) ) { $csz[] = $store['city']; } if ( ! empty( $store['state'] ) ) { $csz[] = $store['state']; } if ( ! empty( $store['zip'] ) ) { $csz[] = $store['zip']; } if ( ! empty( $csz ) ) { $addr_parts[] = implode( ', ', $csz ); } $stores_json[] = array( 'id' => intval( $store['id'] ?? 0 ), 'name' => $store['name'] ?? '', 'address' => implode( ', ', $addr_parts ), 'city' => strtolower( $store['city'] ?? '' ), 'state' => strtolower( $store['state'] ?? '' ), 'zip' => $store['zip'] ?? '', 'phone' => $store['phone'] ?? '', 'email' => $store['email'] ?? '', 'website' => $store['website_url'] ?? '', 'mapsUrl' => $store['google_maps_url'] ?? '', 'image' => $store['image_url'] ?? '', 'lat' => ! empty( $store['latitude'] ) ? floatval( $store['latitude'] ) : null, 'lng' => ! empty( $store['longitude'] ) ? floatval( $store['longitude'] ) : null, ); } $unique_id = 'a1sl-' . wp_unique_id(); $map_height = intval( $atts['map_height'] ); $output = '';
// ── Search & Filters ──
if ( 'yes' === $atts['show_search'] || 'yes' === $atts['show_filters'] ) {
$output .= '
'; // .a1tools-store-locator
// ── Inline styles ──
$output .= '';
// ── JavaScript ──
$stores_js = wp_json_encode( $stores_json );
$marker_js = $marker_icon ? "'" . esc_js( $marker_icon ) . "'" : 'null';
if ( $use_js_api ) {
// Enqueue Google Maps JS API (only once per page).
$output .= '';
}
$output .= '';
return $output;
}
add_shortcode( 'a1tools_store_locator', 'a1tools_shortcode_store_locator' );
// ============================================================================
// SERVICES, REVIEWS, BEFORE/AFTER, TEAM & FAQ SHORTCODES
// ============================================================================
/**
* Shortcode: [a1tools_services]
* Outputs a grid or list of service cards with title, description, phone, and icon/image.
*
* Merges local WP service pages (by "Large Service" authors) with API data,
* following the same merge pattern as the city list shortcode.
*
* @since 1.9.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_services( $atts ) {
$atts = shortcode_atts(
array(
'layout' => 'grid',
'columns' => '3',
'show_description' => 'yes',
'show_icon' => 'yes',
'show_image' => 'yes',
'show_phone' => 'yes',
'featured_only' => 'no',
'target' => '_self',
'class' => '',
'_elementor' => '',
),
$atts,
'a1tools_services'
);
// Get ALL WordPress service pages from local WP database.
$wp_service_pages = a1tools_get_wp_service_pages();
// Get saved data from the A1 Tools API (description, icon, phone, image).
$saved_data = a1tools_get_site_services();
if ( ! is_array( $saved_data ) ) {
$saved_data = array();
}
// Merge: start with all WP pages, overlay saved data.
$base_pages = ! empty( $wp_service_pages ) ? $wp_service_pages : $saved_data;
if ( empty( $base_pages ) ) {
return '';
}
$services = array();
foreach ( $base_pages as $wp_page_id => $wp_data ) {
$permalink = get_permalink( intval( $wp_page_id ) );
if ( empty( $permalink ) ) {
continue;
}
// Overlay saved data if this service has been edited in the app.
if ( ! empty( $wp_service_pages ) && isset( $saved_data[ $wp_page_id ] ) ) {
$wp_data = array_merge( $wp_data, $saved_data[ $wp_page_id ] );
}
$wp_data['wp_page_id'] = $wp_page_id;
$wp_data['permalink'] = $permalink;
$services[] = $wp_data;
}
// Filter featured only.
if ( 'yes' === $atts['featured_only'] ) {
$services = array_filter(
$services,
function ( $s ) {
return ! empty( $s['featured'] );
}
);
}
if ( empty( $services ) ) {
return '';
}
// Sort alphabetically by page_title.
usort(
$services,
function ( $a, $b ) {
return strcasecmp( $a['page_title'] ?? '', $b['page_title'] ?? '' );
}
);
// Parse settings.
$show_desc = 'yes' === $atts['show_description'];
$show_icon = 'yes' === $atts['show_icon'];
$show_image = 'yes' === $atts['show_image'];
$show_phone = 'yes' === $atts['show_phone'];
$target = esc_attr( $atts['target'] );
$is_list = 'list' === $atts['layout'];
$columns = max( 1, min( 4, intval( $atts['columns'] ) ) );
$from_elementor = 'yes' === $atts['_elementor'];
$wrapper_class = 'a1tools-services-grid';
if ( $is_list ) {
$wrapper_class = 'a1tools-services-list';
}
if ( ! empty( $atts['class'] ) ) {
$wrapper_class .= ' ' . sanitize_html_class( $atts['class'] );
}
$grid_style = '';
if ( ! $is_list && ! $from_elementor ) {
$grid_style = ' style="grid-template-columns:repeat(' . $columns . ',1fr);"';
}
$output = '';
if ( 'yes' === $atts['show_search'] ) {
$output .= '
';
}
// ── Two-panel layout ──
$output .= '';
$output .= '';
$output .= '';
$output .= '
';
}
if ( 'yes' === $atts['show_filters'] && ! empty( $states ) ) {
$output .= '';
}
$output .= '';
// Left: Store cards (scrollable).
$output .= '
'; // .a1tools-sl-layout
$output .= '';
$output .= '
'; // .a1tools-sl-list
// Right: Interactive map.
$output .= '' . esc_html__( 'Results', 'a1-tools' ) . '
';
foreach ( $stores_json as $idx => $s ) {
$data_attrs = ' data-idx="' . $idx . '"'
. ' data-name="' . esc_attr( strtolower( $s['name'] ) ) . '"'
. ' data-city="' . esc_attr( $s['city'] ) . '"'
. ' data-state="' . esc_attr( $s['state'] ) . '"'
. ' data-zip="' . esc_attr( $s['zip'] ) . '"';
$output .= '';
// Store image.
if ( 'yes' === $atts['show_images'] && ! empty( $s['image'] ) ) {
$output .= '![' . esc_attr( $s['name'] ) . '](' . esc_url( $s['image'] ) . ')
';
}
$output .= '
'; // .card
}
$output .= '';
$output .= '
'; // .card-content
$output .= '' . esc_html( $s['name'] ) . '
'; if ( ! empty( $s['address'] ) ) { $output .= '' . esc_html( $s['address'] ) . '
'; } if ( ! empty( $s['phone'] ) ) { $phone_clean = preg_replace( '/[^0-9+]/', '', $s['phone'] ); $output .= '' . esc_html__( 'Phone:', 'a1-tools' ) . ' ' . esc_html( $s['phone'] ) . '
'; } if ( ! empty( $s['email'] ) ) { $output .= '' . esc_html__( 'Email:', 'a1-tools' ) . ' ' . esc_html( $s['email'] ) . '
'; } // Links. $dir_url = ''; if ( ! empty( $s['mapsUrl'] ) ) { $dir_url = $s['mapsUrl']; } elseif ( null !== $s['lat'] && null !== $s['lng'] ) { $dir_url = 'https://www.google.com/maps/search/?api=1&query=' . $s['lat'] . ',' . $s['lng']; } $output .= '';
if ( ! empty( $dir_url ) ) {
$output .= '' . esc_html__( 'Get directions', 'a1-tools' ) . '';
}
if ( ! empty( $s['website'] ) ) {
$output .= '' . esc_html__( 'Visit Website', 'a1-tools' ) . '';
}
$output .= '
';
$output .= '';
$output .= '';
$output .= '
';
$output .= '';
foreach ( $services as $service ) {
$title = isset( $service['page_title'] ) ? $service['page_title'] : '';
$output .= '
';
// Inline CSS (output once per page).
static $services_styles_output = false;
if ( ! $services_styles_output ) {
$output .= '';
$services_styles_output = true;
}
return $output;
}
add_shortcode( 'a1tools_services', 'a1tools_shortcode_services' );
/**
* Shortcode: [a1tools_reviews]
* Outputs a grid of review cards with star rating, reviewer name, review text, and source badge.
*
* @since 1.9.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_reviews( $atts ) {
$atts = shortcode_atts(
array(
'layout' => 'grid',
'columns' => '3',
'show_stars' => 'yes',
'show_source' => 'yes',
'show_date' => 'yes',
'show_image' => 'yes',
'featured_only' => 'no',
'limit' => '0',
'class' => '',
),
$atts,
'a1tools_reviews'
);
$reviews = a1tools_get_group_reviews();
if ( empty( $reviews ) || ! is_array( $reviews ) ) {
return '';
}
// Filter featured only.
if ( 'yes' === $atts['featured_only'] ) {
$reviews = array_filter(
$reviews,
function ( $r ) {
return ! empty( $r['featured'] );
}
);
}
// Apply limit.
$limit = intval( $atts['limit'] );
if ( $limit > 0 ) {
$reviews = array_slice( $reviews, 0, $limit );
}
if ( empty( $reviews ) ) {
return '';
}
// Parse settings.
$show_stars = 'yes' === $atts['show_stars'];
$show_source = 'yes' === $atts['show_source'];
$show_date = 'yes' === $atts['show_date'];
$show_image = 'yes' === $atts['show_image'];
$columns = max( 1, min( 4, intval( $atts['columns'] ) ) );
$wrapper_class = 'a1tools-reviews-grid';
if ( ! empty( $atts['class'] ) ) {
$wrapper_class .= ' ' . sanitize_html_class( $atts['class'] );
}
$output = '';
// Icon or image.
if ( $show_image && ! empty( $service['image_url'] ) ) {
$output .= ' . ')
';
} elseif ( $show_icon && ! empty( $service['icon'] ) ) {
$output .= '';
}
// Title as link.
$output .= '
'; // .a1tools-service-card
}
$output .= '' . esc_html( $title ) . '
'; // Description. if ( $show_desc && ! empty( $service['description'] ) ) { $output .= '' . esc_html( $service['description'] ) . '
'; } // Phone. if ( $show_phone && ! empty( $service['phone'] ) ) { $output .= ''; } $output .= '';
foreach ( $reviews as $review ) {
$output .= '
';
// Inline CSS (output once per page).
static $reviews_styles_output = false;
if ( ! $reviews_styles_output ) {
$output .= '';
$reviews_styles_output = true;
}
return $output;
}
add_shortcode( 'a1tools_reviews', 'a1tools_shortcode_reviews' );
/**
* Shortcode: [a1tools_before_after]
* Outputs before/after comparison items as interactive sliders or side-by-side grid.
*
* Slider mode uses CSS clip-path with a JS drag handle for interactive comparison.
* Grid mode shows before/after image pairs side by side with labels.
*
* @since 1.9.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_before_after( $atts ) {
$atts = shortcode_atts(
array(
'layout' => 'slider',
'columns' => '2',
'show_title' => 'yes',
'show_description' => 'yes',
'class' => '',
),
$atts,
'a1tools_before_after'
);
$items = a1tools_get_group_before_after();
if ( empty( $items ) || ! is_array( $items ) ) {
return '';
}
$show_title = 'yes' === $atts['show_title'];
$show_desc = 'yes' === $atts['show_description'];
$is_slider = 'slider' === $atts['layout'];
$columns = max( 1, min( 4, intval( $atts['columns'] ) ) );
$wrapper_class = $is_slider ? 'a1tools-ba-slider-wrapper' : 'a1tools-ba-grid-wrapper';
if ( ! empty( $atts['class'] ) ) {
$wrapper_class .= ' ' . sanitize_html_class( $atts['class'] );
}
$grid_style = '';
if ( ! $is_slider ) {
$grid_style = ' style="grid-template-columns:repeat(' . $columns . ',1fr);"';
}
$output = '';
// Reviewer image.
if ( $show_image && ! empty( $review['image_url'] ) ) {
$output .= '![' . esc_attr( $review['name'] ?? '' ) . '](' . esc_url( $review['image_url'] ) . ')
';
}
// Star rating.
if ( $show_stars && isset( $review['rating'] ) ) {
$rating = max( 0, min( 5, intval( $review['rating'] ) ) );
$stars = str_repeat( "\xE2\x98\x85", $rating ) . str_repeat( "\xE2\x98\x86", 5 - $rating );
$output .= '
'; // .a1tools-review-card
}
$output .= '' . $stars . '
';
}
// Reviewer name.
if ( ! empty( $review['name'] ) ) {
$output .= '' . esc_html( $review['name'] ) . '
'; } // Review text. if ( ! empty( $review['text'] ) ) { $output .= '' . esc_html( $review['text'] ) . '
'; } // Source badge. if ( $show_source && ! empty( $review['source'] ) ) { $output .= '' . esc_html( $review['source'] ) . ''; } // Date. if ( $show_date && ! empty( $review['date'] ) ) { $output .= '' . esc_html( $review['date'] ) . ''; } $output .= '';
foreach ( $items as $index => $item ) {
$before_url = isset( $item['before_image'] ) ? $item['before_image'] : '';
$after_url = isset( $item['after_image'] ) ? $item['after_image'] : '';
$title = isset( $item['title'] ) ? $item['title'] : '';
if ( empty( $before_url ) || empty( $after_url ) ) {
continue;
}
if ( $is_slider ) {
// Slider mode: interactive comparison slider.
$output .= '
';
// Inline CSS (output once per page).
static $ba_styles_output = false;
if ( ! $ba_styles_output ) {
$output .= '';
$ba_styles_output = true;
}
// Inline JS for slider interaction (output once per page).
static $ba_js_output = false;
if ( ! $ba_js_output && $is_slider ) {
$output .= '';
$ba_js_output = true;
}
return $output;
}
add_shortcode( 'a1tools_before_after', 'a1tools_shortcode_before_after' );
/**
* Shortcode: [a1tools_team]
* Outputs a grid or list of team member cards with photo, name, role, bio, contact info,
* and certification badges.
*
* @since 1.9.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_team( $atts ) {
$atts = shortcode_atts(
array(
'layout' => 'grid',
'columns' => '3',
'show_photo' => 'yes',
'photo_shape' => 'circle',
'show_role' => 'yes',
'show_bio' => 'yes',
'show_phone' => 'yes',
'show_email' => 'yes',
'show_certifications' => 'yes',
'featured_only' => 'no',
'category' => '',
'category_order' => '',
'show_category_heading' => 'yes',
'class' => '',
'_elementor' => '',
),
$atts,
'a1tools_team'
);
$members = a1tools_get_group_team();
if ( empty( $members ) || ! is_array( $members ) ) {
return '';
}
// Filter featured only.
if ( 'yes' === $atts['featured_only'] ) {
$members = array_filter(
$members,
function ( $m ) {
return ! empty( $m['featured'] );
}
);
}
if ( empty( $members ) ) {
return '';
}
// Filter by category if specified.
if ( ! empty( $atts['category'] ) ) {
$cat_filter = strtolower( trim( $atts['category'] ) );
$members = array_filter(
$members,
function ( $m ) use ( $cat_filter ) {
return isset( $m['category'] ) && strtolower( trim( $m['category'] ) ) === $cat_filter;
}
);
}
if ( empty( $members ) ) {
return '';
}
// Parse settings.
$show_photo = 'yes' === $atts['show_photo'];
$photo_shape = in_array( $atts['photo_shape'], array( 'circle', 'square' ), true ) ? $atts['photo_shape'] : 'circle';
$show_role = 'yes' === $atts['show_role'];
$show_bio = 'yes' === $atts['show_bio'];
$show_phone = 'yes' === $atts['show_phone'];
$show_email = 'yes' === $atts['show_email'];
$show_certs = 'yes' === $atts['show_certifications'];
$is_list = 'list' === $atts['layout'];
$columns = max( 1, min( 6, intval( $atts['columns'] ) ) );
$show_cat_heading = 'yes' === $atts['show_category_heading'];
$category_order = array_filter( array_map( 'trim', explode( ',', $atts['category_order'] ) ) );
$is_elementor = 'yes' === ( $atts['_elementor'] ?? '' );
$wrapper_class = $is_list ? 'a1tools-team-list' : 'a1tools-team-grid';
if ( ! empty( $atts['class'] ) ) {
$wrapper_class .= ' ' . sanitize_html_class( $atts['class'] );
}
$grid_style = '';
if ( ! $is_list && ! $is_elementor ) {
// Only output inline grid columns for non-Elementor usage.
// Elementor handles columns via its own selectors to support responsive breakpoints.
$grid_style = ' style="grid-template-columns:repeat(' . $columns . ',1fr);"';
}
// Group members by category.
$grouped = array();
foreach ( $members as $member ) {
$cat = ( ! empty( $member['category'] ) ) ? trim( $member['category'] ) : 'Uncategorized';
if ( ! isset( $grouped[ $cat ] ) ) {
$grouped[ $cat ] = array();
}
$grouped[ $cat ][] = $member;
}
// Sort categories: use category_order if provided, else by category_sort_order, else alphabetical.
if ( ! empty( $category_order ) ) {
$sorted_groups = array();
foreach ( $category_order as $cat_name ) {
if ( isset( $grouped[ $cat_name ] ) ) {
$sorted_groups[ $cat_name ] = $grouped[ $cat_name ];
unset( $grouped[ $cat_name ] );
}
}
// Append remaining categories.
foreach ( $grouped as $cat_name => $cat_members ) {
$sorted_groups[ $cat_name ] = $cat_members;
}
$grouped = $sorted_groups;
} else {
// Sort by category_sort_order from the first member in each group.
uksort(
$grouped,
function ( $a, $b ) use ( $grouped ) {
if ( 'Uncategorized' === $a ) {
return 1;
}
if ( 'Uncategorized' === $b ) {
return -1;
}
$a_order = isset( $grouped[ $a ][0]['category_sort_order'] ) ? intval( $grouped[ $a ][0]['category_sort_order'] ) : 0;
$b_order = isset( $grouped[ $b ][0]['category_sort_order'] ) ? intval( $grouped[ $b ][0]['category_sort_order'] ) : 0;
if ( $a_order !== $b_order ) {
return $a_order - $b_order;
}
return strcasecmp( $a, $b );
}
);
}
$output = '';
if ( $show_title && ! empty( $title ) ) {
$output .= '
';
} else {
// Grid mode: side-by-side image pairs.
$output .= '' . esc_html( $title ) . '
'; } $output .= ''
. ' . ')
'
. ' . ')
'
. '
';
if ( $show_desc && ! empty( $item['description'] ) ) {
$output .= ''
. '
' . esc_html( $item['description'] ) . '
'; } $output .= '';
if ( $show_title && ! empty( $title ) ) {
$output .= '
';
}
}
$output .= '' . esc_html( $title ) . '
'; } $output .= ''
. '
';
if ( $show_desc && ! empty( $item['description'] ) ) {
$output .= 'Before
'
. 'After
'
. '' . esc_html( $item['description'] ) . '
'; } $output .= '';
$only_uncategorized = ( count( $grouped ) === 1 && isset( $grouped['Uncategorized'] ) );
foreach ( $grouped as $category_name => $cat_members ) {
// Category heading.
if ( $show_cat_heading && ! $only_uncategorized && 'Uncategorized' !== $category_name ) {
$output .= '
'; // .a1tools-team-wrapper
// Inline CSS (output once per page).
static $team_styles_output = false;
if ( ! $team_styles_output ) {
$output .= '';
$team_styles_output = true;
}
return $output;
}
add_shortcode( 'a1tools_team', 'a1tools_shortcode_team' );
/**
* Shortcode: [a1tools_faq]
* Outputs an accordion of FAQ items with optional category filtering
* and FAQPage JSON-LD structured data.
*
* Reuses the same accordion CSS classes and JS pattern from the city list shortcode.
*
* @since 1.9.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_faq( $atts ) {
$atts = shortcode_atts(
array(
'category' => '',
'show_category' => 'yes',
'accordion_icon' => 'yes',
'schema' => 'yes',
'class' => '',
),
$atts,
'a1tools_faq'
);
$faqs = a1tools_get_group_faq();
if ( empty( $faqs ) || ! is_array( $faqs ) ) {
return '';
}
// Filter by category.
if ( ! empty( $atts['category'] ) ) {
$filter_cat = $atts['category'];
$faqs = array_filter(
$faqs,
function ( $f ) use ( $filter_cat ) {
return isset( $f['category'] ) && $f['category'] === $filter_cat;
}
);
}
if ( empty( $faqs ) ) {
return '';
}
$show_cat = 'yes' === $atts['show_category'];
$acc_icon = 'yes' === $atts['accordion_icon'];
$schema = 'yes' === $atts['schema'];
$wrapper_class = 'a1tools-faq-wrapper a1tools-city-list-wrapper';
if ( ! empty( $atts['class'] ) ) {
$wrapper_class .= ' ' . sanitize_html_class( $atts['class'] );
}
$output = '' . esc_html( $category_name ) . '
'; } $output .= '';
foreach ( $cat_members as $member ) {
$name = isset( $member['name'] ) ? $member['name'] : '';
$card_class = 'a1tools-team-card';
if ( 'square' === $photo_shape && $show_photo ) {
$card_class .= ' a1tools-team-card--square-photo';
}
$output .= '
'; // .a1tools-team-grid or .a1tools-team-list
}
$output .= '';
// Photo.
if ( $show_photo ) {
$photo_class = 'a1tools-team-photo a1tools-team-photo--' . $photo_shape;
if ( ! empty( $member['photo_url'] ) ) {
$output .= ' . ')
';
} else {
$initials = '';
$name_parts = explode( ' ', $name );
foreach ( $name_parts as $part ) {
if ( ! empty( $part ) ) {
$initials .= mb_strtoupper( mb_substr( $part, 0, 1 ) );
}
}
$output .= '
'; // .a1tools-team-card
}
$output .= '' . esc_html( $initials ) . '
';
}
}
// Wrap text content for square photo layout (padding on text, not on photo).
$is_square = ( 'square' === $photo_shape && $show_photo );
if ( $is_square ) {
$output .= '';
}
// Name.
$output .= '
'; // .a1tools-team-card-content
}
$output .= '' . esc_html( $name ) . '
'; // Role. if ( $show_role && ! empty( $member['role'] ) ) { $output .= '' . esc_html( $member['role'] ) . '
'; } // Bio. if ( $show_bio && ! empty( $member['bio'] ) ) { $output .= '' . esc_html( $member['bio'] ) . '
'; } // Contact info. if ( $show_phone && ! empty( $member['phone'] ) ) { $output .= '' . esc_html( $member['phone'] ) . '
'; } if ( $show_email && ! empty( $member['email'] ) ) { $output .= '' . esc_html( $member['email'] ) . '
'; } // Certifications. if ( $show_certs && ! empty( $member['certifications'] ) && is_array( $member['certifications'] ) ) { $output .= '';
foreach ( $member['certifications'] as $cert ) {
$output .= '' . esc_html( $cert ) . '';
}
$output .= '
';
}
if ( $is_square ) {
$output .= '';
// Schema data collector.
$schema_items = array();
// Group by category if show_category is enabled.
if ( $show_cat ) {
$categories = array();
$uncategorized = array();
foreach ( $faqs as $faq ) {
$cat = isset( $faq['category'] ) && ! empty( $faq['category'] ) ? $faq['category'] : '';
if ( ! empty( $cat ) ) {
$categories[ $cat ][] = $faq;
} else {
$uncategorized[] = $faq;
}
}
// Render categorized FAQs.
foreach ( $categories as $cat_name => $cat_faqs ) {
$output .= '
';
// FAQPage JSON-LD schema.
if ( $schema && ! empty( $schema_items ) ) {
$schema_data = array(
'@context' => 'https://schema.org',
'@type' => 'FAQPage',
'mainEntity' => $schema_items,
);
$output .= '';
}
// Inline CSS for FAQ-specific styles (output once per page).
// Reuses accordion classes from city list.
static $faq_styles_output = false;
if ( ! $faq_styles_output ) {
$output .= '';
$faq_styles_output = true;
}
// Inline JS reuses the city list accordion JS. Output a small init
// that delegates to the same pattern (only if city list JS has not loaded).
static $faq_js_output = false;
if ( ! $faq_js_output ) {
$output .= '';
$faq_js_output = true;
}
return $output;
}
/**
* Helper: Render a single FAQ accordion item.
*
* @since 1.9.0
* @param array $faq FAQ data with 'question' and 'answer' keys.
* @param bool $acc_icon Whether to show accordion icon.
* @param array &$schema_items Reference to schema items array for JSON-LD.
* @return string HTML for the FAQ item.
*/
function a1tools_render_faq_item( $faq, $acc_icon, &$schema_items ) {
$question = isset( $faq['question'] ) ? $faq['question'] : '';
$answer = isset( $faq['answer'] ) ? $faq['answer'] : '';
if ( empty( $question ) ) {
return '';
}
// Collect for schema.
$schema_items[] = array(
'@type' => 'Question',
'name' => $question,
'acceptedAnswer' => array(
'@type' => 'Answer',
'text' => $answer,
),
);
$html = ''
. '
';
}
// Render uncategorized.
foreach ( $uncategorized as $faq ) {
$output .= a1tools_render_faq_item( $faq, $acc_icon, $schema_items );
}
} else {
// Flat list.
foreach ( $faqs as $faq ) {
$output .= a1tools_render_faq_item( $faq, $acc_icon, $schema_items );
}
}
$output .= '' . esc_html( $cat_name ) . '
'; foreach ( $cat_faqs as $faq ) { $output .= a1tools_render_faq_item( $faq, $acc_icon, $schema_items ); } $output .= '';
$html .= '
';
return $html;
}
add_shortcode( 'a1tools_faq', 'a1tools_shortcode_faq' );
// ============================================================================
// POST TITLE SHORTCODE
// ============================================================================
/**
* Shortcode: [a1tools_post_title]
*
* Outputs the current post/page title. Useful in templates, Elementor,
* or anywhere a shortcode can be used.
*
* Attributes:
* tag - HTML tag to wrap the title (default: none, outputs plain text)
* Example: tag="h1", tag="h2", tag="span"
* class - CSS class(es) for the wrapper tag (default: none)
* id - Specific post ID to get the title for (default: current post)
* before - Text/HTML to prepend before the title
* after - Text/HTML to append after the title
*
* @since 2.0.7
*/
function a1tools_shortcode_post_title( $atts ) {
$atts = shortcode_atts(
array(
'tag' => '',
'class' => '',
'id' => 0,
'before' => '',
'after' => '',
),
$atts,
'a1tools_post_title'
);
$post_id = absint( $atts['id'] );
if ( $post_id > 0 ) {
$title = get_the_title( $post_id );
} else {
$title = get_the_title();
}
if ( empty( $title ) ) {
return '';
}
$title = esc_html( $title );
$output = $atts['before'] . $title . $atts['after'];
// Wrap in tag if specified
if ( ! empty( $atts['tag'] ) ) {
$tag = sanitize_key( $atts['tag'] );
$class = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
$output = '<' . $tag . $class . '>' . $output . '';
}
return $output;
}
add_shortcode( 'a1tools_post_title', 'a1tools_shortcode_post_title' );
// ============================================================================
// SEO LOCATION SHORTCODES
// ============================================================================
/**
* Shortcode: [a1tools_location_phone]
* Outputs the SEO location-specific phone number for the current page.
* Falls back to site primary phone if no location-specific phone is set.
*
* Attributes:
* - default: Fallback text if no phone found
* - link: 'yes' to wrap in tel: link
* - class: CSS class for the element
* - page_id: Override automatic page ID detection
*
* @since 2.1.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_location_phone( $atts ) {
$atts = shortcode_atts(
array(
'default' => '',
'link' => 'no',
'class' => '',
'page_id' => '',
),
$atts,
'a1tools_location_phone'
);
$page_id = ! empty( $atts['page_id'] ) ? intval( $atts['page_id'] ) : get_the_ID();
$locations = a1tools_get_seo_locations();
// Get location-specific phone.
$phone = '';
if ( ! empty( $locations ) && isset( $locations[ $page_id ] ) ) {
$phone = isset( $locations[ $page_id ]['phone'] ) ? $locations[ $page_id ]['phone'] : '';
}
// Fallback to default or site primary phone.
if ( empty( $phone ) ) {
if ( ! empty( $atts['default'] ) ) {
return esc_html( $atts['default'] );
}
// Use the site's primary phone as fallback.
$phone = a1tools_get_variable( 'phone_primary', '' );
if ( empty( $phone ) ) {
return '';
}
}
// Output as tel: link if requested.
if ( 'yes' === $atts['link'] ) {
$clean = preg_replace( '/[^0-9+]/', '', $phone );
$class_attr = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
return '' . esc_html( $phone ) . '';
}
if ( ! empty( $atts['class'] ) ) {
return '' . esc_html( $phone ) . '';
}
return esc_html( $phone );
}
add_shortcode( 'a1tools_location_phone', 'a1tools_shortcode_location_phone' );
/**
* Shortcode: [a1tools_location_web]
* Outputs the SEO location-specific website URL for the current page.
*
* Attributes:
* - default: Fallback text if no URL found
* - link: 'yes' to wrap in anchor tag
* - text: Custom link text (used when link=yes)
* - target: Link target attribute (default: _blank)
* - class: CSS class for the element
* - page_id: Override automatic page ID detection
*
* @since 2.1.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_location_web( $atts ) {
$atts = shortcode_atts(
array(
'default' => '',
'link' => 'no',
'text' => '',
'target' => '_blank',
'class' => '',
'page_id' => '',
),
$atts,
'a1tools_location_web'
);
$page_id = ! empty( $atts['page_id'] ) ? intval( $atts['page_id'] ) : get_the_ID();
$locations = a1tools_get_seo_locations();
$url = '';
if ( ! empty( $locations ) && isset( $locations[ $page_id ] ) ) {
$url = isset( $locations[ $page_id ]['location_web'] ) ? $locations[ $page_id ]['location_web'] : '';
}
if ( empty( $url ) ) {
return esc_html( $atts['default'] );
}
if ( 'yes' === $atts['link'] ) {
// Priority: text attribute > full_address field > URL.
$label = '';
if ( ! empty( $atts['text'] ) ) {
$label = esc_html( $atts['text'] );
} elseif ( ! empty( $locations[ $page_id ]['full_address'] ) ) {
$label = esc_html( $locations[ $page_id ]['full_address'] );
} else {
$label = esc_html( $url );
}
$class_attr = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
return '' . $label . '';
}
return esc_html( $url );
}
add_shortcode( 'a1tools_location_web', 'a1tools_shortcode_location_web' );
/**
* Shortcode: [a1tools_city_web]
* Outputs the SEO location-specific city website URL for the current page.
*
* Attributes:
* - default: Fallback text if no URL found
* - link: 'yes' to wrap in anchor tag
* - text: Custom link text (used when link=yes)
* - target: Link target attribute (default: _blank)
* - class: CSS class for the element
* - page_id: Override automatic page ID detection
*
* @since 2.1.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_city_web( $atts ) {
$atts = shortcode_atts(
array(
'default' => '',
'link' => 'no',
'text' => '',
'target' => '_blank',
'class' => '',
'page_id' => '',
),
$atts,
'a1tools_city_web'
);
$page_id = ! empty( $atts['page_id'] ) ? intval( $atts['page_id'] ) : get_the_ID();
$locations = a1tools_get_seo_locations();
$url = '';
if ( ! empty( $locations ) && isset( $locations[ $page_id ] ) ) {
$url = isset( $locations[ $page_id ]['city_web'] ) ? $locations[ $page_id ]['city_web'] : '';
}
if ( empty( $url ) ) {
return esc_html( $atts['default'] );
}
if ( 'yes' === $atts['link'] ) {
// Priority: text attribute > city field > URL.
$label = '';
if ( ! empty( $atts['text'] ) ) {
$label = esc_html( $atts['text'] );
} elseif ( ! empty( $locations[ $page_id ]['city'] ) ) {
$label = esc_html( $locations[ $page_id ]['city'] );
} else {
$label = esc_html( $url );
}
$class_attr = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
return '' . $label . '';
}
return esc_html( $url );
}
add_shortcode( 'a1tools_city_web', 'a1tools_shortcode_city_web' );
/**
* Shortcode: [a1tools_state_web]
* Outputs the SEO location-specific state website URL for the current page.
*
* Attributes:
* - default: Fallback text if no URL found
* - link: 'yes' to wrap in anchor tag
* - text: Custom link text (used when link=yes)
* - target: Link target attribute (default: _blank)
* - class: CSS class for the element
* - page_id: Override automatic page ID detection
*
* @since 2.1.0
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_state_web( $atts ) {
$atts = shortcode_atts(
array(
'default' => '',
'link' => 'no',
'text' => '',
'target' => '_blank',
'class' => '',
'page_id' => '',
),
$atts,
'a1tools_state_web'
);
$page_id = ! empty( $atts['page_id'] ) ? intval( $atts['page_id'] ) : get_the_ID();
$locations = a1tools_get_seo_locations();
$url = '';
if ( ! empty( $locations ) && isset( $locations[ $page_id ] ) ) {
$url = isset( $locations[ $page_id ]['state_web'] ) ? $locations[ $page_id ]['state_web'] : '';
}
if ( empty( $url ) ) {
return esc_html( $atts['default'] );
}
if ( 'yes' === $atts['link'] ) {
// Priority: text attribute > state field > URL.
$label = '';
if ( ! empty( $atts['text'] ) ) {
$label = esc_html( $atts['text'] );
} elseif ( ! empty( $locations[ $page_id ]['state'] ) ) {
$label = esc_html( $locations[ $page_id ]['state'] );
} else {
$label = esc_html( $url );
}
$class_attr = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
return '' . $label . '';
}
return esc_html( $url );
}
add_shortcode( 'a1tools_state_web', 'a1tools_shortcode_state_web' );
/**
* Shortcode: [a1tools_location_city]
* Outputs the city name for the current SEO City page.
*
* Attributes:
* - default: Fallback text if no city found
* - class: CSS class for the wrapper span
* - page_id: Override automatic page ID detection
*
* @since 2.1.1
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_location_city( $atts ) {
$atts = shortcode_atts(
array(
'default' => '',
'class' => '',
'page_id' => '',
),
$atts,
'a1tools_location_city'
);
$page_id = ! empty( $atts['page_id'] ) ? intval( $atts['page_id'] ) : get_the_ID();
$locations = a1tools_get_seo_locations();
$city = '';
if ( ! empty( $locations ) && isset( $locations[ $page_id ] ) ) {
$city = isset( $locations[ $page_id ]['city'] ) ? $locations[ $page_id ]['city'] : '';
}
if ( empty( $city ) ) {
$city = ! empty( $atts['default'] ) ? $atts['default'] : a1tools_get_variable( 'city_name', '' );
}
if ( empty( $city ) ) {
return '';
}
$class_attr = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
return ''; if ( $acc_icon ) { $html .= ''; } $html .= esc_html( $question ); $html .= '
'; $html .= ''; $html .= '';
// Search bar.
if ( $show_search ) {
$placeholder = ! empty( $atts['search_placeholder'] ) ? $atts['search_placeholder'] : 'Search locations...';
$output .= '' . esc_html( $label ) . ' ';
};
if ( $show_groups ) {
// Group locations by group_name.
$groups = array();
$ungrouped = array();
foreach ( $locations as $loc ) {
$gn = isset( $loc['group_name'] ) ? $loc['group_name'] : '';
if ( ! empty( $gn ) ) {
if ( ! isset( $groups[ $gn ] ) ) {
$groups[ $gn ] = array();
}
$groups[ $gn ][] = $loc;
} else {
$ungrouped[] = $loc;
}
}
// Render each group.
foreach ( $groups as $group_name => $group_locs ) {
$loc_count = count( $group_locs );
$output .= '
';
// Note: Base styles and JS for accordion/search are already output by
// a1tools_shortcode_city_list() since both use the same CSS classes.
// If the city_list shortcode is not present on the page, output them here.
static $loc_styles_output = false;
if ( ! $loc_styles_output ) {
$loc_styles_output = true;
$output .= '';
}
// Inline JS for accordion + search (output once per page).
static $loc_js_output = false;
if ( ! $loc_js_output && ( $accordion || $show_search ) ) {
$loc_js_output = true;
$output .= '';
}
return $output;
}
add_shortcode( 'a1tools_location_list', 'a1tools_shortcode_location_list' );
'
. ''
. '
';
}
// Helper to render a single location link.
$render_link = function ( $loc ) use ( $atts, $target ) {
$label = isset( $loc['page_title'] ) ? $loc['page_title'] : '';
if ( 'yes' === $atts['append_state'] && ! empty( $atts['state'] ) ) {
$label .= ', ' . $atts['state'];
}
return '';
// Group heading (with optional accordion + count).
$h_class = 'a1tools-city-group-heading';
$h_attrs = '';
if ( $accordion ) {
$h_class .= ' a1tools-accordion-toggle';
$h_attrs = ' role="button" tabindex="0" aria-expanded="' . ( $acc_expanded ? 'true' : 'false' ) . '"';
}
$output .= '
'; // .a1tools-city-group
}
// Render ungrouped at the end with "Ungrouped" heading.
if ( ! empty( $ungrouped ) ) {
$ug_count = count( $ungrouped );
$output .= ''; if ( $accordion && $acc_icon ) { $output .= ''; } $output .= esc_html( $group_name ); if ( $show_count ) { $output .= ' (' . intval( $loc_count ) . ')'; } $output .= '
'; // Wrap list in accordion content div when accordion is enabled. if ( $accordion ) { $display = $acc_expanded ? '' : ' style="display:none;"'; $output .= '';
}
$output .= '
'; // .a1tools-accordion-content
}
$output .= '- ';
foreach ( $group_locs as $loc ) {
$output .= $render_link( $loc );
}
$output .= '
';
// Heading (with optional accordion + count, same as grouped).
$ug_class = 'a1tools-city-group-heading';
$ug_attrs = '';
if ( $accordion ) {
$ug_class .= ' a1tools-accordion-toggle';
$ug_attrs = ' role="button" tabindex="0" aria-expanded="' . ( $acc_expanded ? 'true' : 'false' ) . '"';
}
$output .= '
';
}
} else {
// Flat list.
$output .= ''; if ( $accordion && $acc_icon ) { $output .= ''; } $output .= esc_html__( 'Ungrouped', 'a1-tools' ); if ( $show_count ) { $output .= ' (' . intval( $ug_count ) . ')'; } $output .= '
'; if ( $accordion ) { $display = $acc_expanded ? '' : ' style="display:none;"'; $output .= '';
}
$output .= '
';
}
$output .= '- ';
foreach ( $ungrouped as $loc ) {
$output .= $render_link( $loc );
}
$output .= '
- ';
foreach ( $locations as $loc ) {
$output .= $render_link( $loc );
}
$output .= '