' . $output . '';
}
add_shortcode( 'a1tools_city_address', 'a1tools_shortcode_city_address' );
/**
* Shortcode: [a1tools_city_list]
* Renders a linked list of city pages, optionally grouped by group_name.
* Uses get_permalink() for page URLs. Groups are assigned in the Flutter app.
*
* Attributes:
* - layout: 'list' (single column) or 'columns' (multi-column CSS columns)
* - columns: Number of columns (1-4, default 3, used when layout=columns)
* - show_groups: 'yes' or '' — show group headings
* - group: Filter to a specific group name
* - type: 'all', 'single_city', or 'location_city'
* - show_bullets: 'yes' or '' — show list bullets
* - target: Link target: '_self' or '_blank'
* - append_state: 'yes' to append state suffix after city name
* - state: State suffix text (e.g., 'NJ')
* - class: Additional CSS class for the wrapper
*
* @since 1.8.1
* @param array $atts Shortcode attributes.
* @return string Shortcode output.
*/
function a1tools_shortcode_city_list( $atts ) {
$atts = shortcode_atts(
array(
'layout' => 'list',
'columns' => '3',
'show_groups' => 'yes',
'group' => '',
'type' => 'all',
'show_bullets' => 'yes',
'target' => '_self',
'append_state' => '',
'state' => '',
'class' => '',
'accordion' => '',
'accordion_default' => 'collapsed',
'accordion_mode' => 'multiple',
'accordion_icon' => 'yes',
'accordion_speed' => '300',
'show_count' => '',
'show_search' => '',
'search_placeholder' => 'Search cities...',
'_elementor' => '',
),
$atts,
'a1tools_city_list'
);
// Get ALL WordPress city pages from the local WP database (includes every
// published page by "Single City" / "Location City" authors, excludes "SEO City").
$wp_city_pages = a1tools_get_wp_city_pages();
// Get saved data from the A1 Tools API (phone, address, group — only for
// cities that have been edited in the app). Keyed by wp_page_id.
$saved_data = a1tools_get_site_city_pages();
if ( ! is_array( $saved_data ) ) {
$saved_data = array();
}
// Merge: start with all WP pages, overlay saved data (phone/address/group).
// If WP query returned results, use it as the base (shows ALL city pages).
// Otherwise fall back to API-only data (only pages with saved data).
$base_pages = ! empty( $wp_city_pages ) ? $wp_city_pages : $saved_data;
if ( empty( $base_pages ) ) {
return '';
}
$cities = array();
foreach ( $base_pages as $wp_page_id => $wp_data ) {
$permalink = get_permalink( intval( $wp_page_id ) );
if ( empty( $permalink ) ) {
continue; // Skip cities whose WP page no longer exists.
}
// Overlay saved data if this city has been edited in the app.
if ( ! empty( $wp_city_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;
$cities[] = $wp_data;
}
// Filter by type.
if ( 'all' !== $atts['type'] && ! empty( $atts['type'] ) ) {
$filter_type = $atts['type'];
$cities = array_filter(
$cities,
function ( $c ) use ( $filter_type ) {
return isset( $c['page_type'] ) && $c['page_type'] === $filter_type;
}
);
}
// Filter by specific group.
if ( ! empty( $atts['group'] ) ) {
$filter_group = $atts['group'];
$cities = array_filter(
$cities,
function ( $c ) use ( $filter_group ) {
return isset( $c['group_name'] ) && $c['group_name'] === $filter_group;
}
);
}
if ( empty( $cities ) ) {
return '';
}
// Sort by group_order, group_name, then page_title.
usort(
$cities,
function ( $a, $b ) {
$ao = intval( $a['group_order'] ?? 0 );
$bo = intval( $b['group_order'] ?? 0 );
if ( $ao !== $bo ) {
return $ao - $bo;
}
$gn = strcasecmp( $a['group_name'] ?? '', $b['group_name'] ?? '' );
if ( 0 !== $gn ) {
return $gn;
}
return strcasecmp( $a['page_title'] ?? '', $b['page_title'] ?? '' );
}
);
// Parse settings.
$show_groups = 'yes' === $atts['show_groups'];
$show_bullets = 'yes' === $atts['show_bullets'];
$target = esc_attr( $atts['target'] );
$is_columns = 'columns' === $atts['layout'];
$accordion = 'yes' === $atts['accordion'] && $show_groups;
$acc_expanded = 'expanded' === $atts['accordion_default'];
$acc_mode = $atts['accordion_mode'];
$acc_icon = 'yes' === $atts['accordion_icon'];
$acc_speed = max( 0, intval( $atts['accordion_speed'] ) );
$show_count = 'yes' === $atts['show_count'] && $show_groups;
$show_search = 'yes' === $atts['show_search'];
// List style attributes.
$list_style = $show_bullets ? '' : ' style="list-style:none;padding-left:0;"';
$from_elementor = 'yes' === $atts['_elementor'];
$col_style = '';
if ( $is_columns && ! $from_elementor ) {
// Standalone shortcode: apply columns via inline style.
// When rendered by the Elementor widget, Elementor's responsive
// selectors handle columns + column-gap (supports mobile/tablet
// breakpoints), so we must NOT add an inline style that would
// override them due to CSS specificity.
$columns = max( 1, min( 4, intval( $atts['columns'] ) ) );
$col_style = ' style="columns:' . $columns . ';column-gap:20px;"';
}
// Wrapper class and data attributes.
$wrapper_class = 'a1tools-city-list-wrapper';
if ( ! empty( $atts['class'] ) ) {
$wrapper_class .= ' ' . sanitize_html_class( $atts['class'] );
}
$data_attrs = '';
if ( $accordion ) {
$data_attrs .= ' data-accordion="1"'
. ' data-accordion-mode="' . esc_attr( $acc_mode ) . '"'
. ' data-accordion-speed="' . esc_attr( $acc_speed ) . '"';
}
if ( $show_search ) {
$data_attrs .= ' data-search="1"';
}
$output = '';
// Search bar.
if ( $show_search ) {
$placeholder = ! empty( $atts['search_placeholder'] ) ? $atts['search_placeholder'] : 'Search cities...';
$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 '
' . 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 .= '
'; // .a1tools-city-group
}
// Render ungrouped at the end with "Ungrouped" heading.
if ( ! empty( $ungrouped ) ) {
$ug_count = count( $ungrouped );
$output .= '
';
}
} else {
// Flat list.
$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 .= '
';
}
// ── Two-panel layout ──
$output .= '
'; // .a1tools-sl-layout
$output .= '
';
foreach ( $services as $service ) {
$title = isset( $service['page_title'] ) ? $service['page_title'] : '';
$output .= '
'; // .a1tools-service-card
}
$output .= '
';
foreach ( $reviews as $review ) {
$output .= '
'; // .a1tools-review-card
}
$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 .= '
';
} else {
// Grid mode: side-by-side image pairs.
$output .= '
';
}
}
$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 .= '
'
. '';
foreach ( $cat_faqs as $faq ) {
$output .= a1tools_render_faq_item( $faq, $acc_icon, $schema_items );
}
$output .= '
';
}
// 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 .= '
';
// Search bar.
if ( $show_search ) {
$placeholder = ! empty( $atts['search_placeholder'] ) ? $atts['search_placeholder'] : 'Search locations...';
$output .= '
'
. ''
. '
';
}
// 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 '
' . 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 .= '
'; // .a1tools-city-group
}
// Render ungrouped at the end with "Ungrouped" heading.
if ( ! empty( $ungrouped ) ) {
$ug_count = count( $ungrouped );
$output .= '
';
}
} else {
// Flat list.
$output .= '
';
}
$output .= '
', $parts ) . ''; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- parts escaped above.
}
$key_map = array(
'name' => 'name',
'phone' => 'phone',
'address_line1' => 'address_line1',
'address_line2' => 'address_line2',
'city' => 'city',
'state' => 'state',
'zip' => 'zip',
'country' => 'country',
'maps_url' => 'google_maps_url',
'latitude' => 'latitude',
'longitude' => 'longitude',
);
if ( ! isset( $key_map[ $field ] ) ) {
return esc_html( $atts['default'] );
}
$value = isset( $franchise[ $key_map[ $field ] ] ) ? (string) $franchise[ $key_map[ $field ] ] : '';
if ( '' === $value ) {
return esc_html( $atts['default'] );
}
if ( 'yes' === $atts['link'] && 'phone' === $field ) {
$clean = preg_replace( '/[^0-9+]/', '', $value );
return '' . esc_html( $value ) . '';
}
if ( 'yes' === $atts['link'] && 'maps_url' === $field ) {
return '' . esc_html__( 'Get Directions', 'a1-tools' ) . '';
}
$value_out = ( 'maps_url' === $field ) ? esc_url( $value ) : esc_html( $value );
if ( ! empty( $atts['class'] ) ) {
return '' . $value_out . '';
}
return $value_out;
}
foreach ( array(
'a1tools_franchise_name',
'a1tools_franchise_phone',
'a1tools_franchise_address',
'a1tools_franchise_address_line1',
'a1tools_franchise_address_line2',
'a1tools_franchise_city',
'a1tools_franchise_state',
'a1tools_franchise_zip',
'a1tools_franchise_country',
'a1tools_franchise_maps_url',
'a1tools_franchise_latitude',
'a1tools_franchise_longitude',
) as $a1tools_ff_tag ) {
add_shortcode( $a1tools_ff_tag, 'a1tools_shortcode_franchise_field' );
}
/**
* Per-field service shortcodes (auto-detecting).
*
* Service pages are WordPress pages (keyed by wp_page_id in the A1 Tools API),
* so — like [a1tools_city_*] / [a1tools_location_*] — these detect the current
* page via get_the_ID(). Use the optional `page_id` attribute to target a
* specific service page from elsewhere.
*
* Registered tags -> field:
* a1tools_service_title -> page_title (falls back to the WP page title)
* a1tools_service_description -> description
* a1tools_service_phone -> phone (link="yes" wraps in tel:)
* a1tools_service_icon -> icon
* a1tools_service_image -> image_url
*
* @since 2.7.0
* @param array $atts Shortcode attributes (page_id, default, link, class).
* @param string $content Unused.
* @param string $tag Invoked shortcode tag.
* @return string Shortcode output.
*/
function a1tools_shortcode_service_field( $atts, $content, $tag ) {
$atts = shortcode_atts(
array(
'page_id' => '',
'default' => '',
'link' => '',
'class' => '',
),
$atts,
$tag
);
$page_id = ! empty( $atts['page_id'] ) ? intval( $atts['page_id'] ) : intval( get_the_ID() );
$field = str_replace( 'a1tools_service_', '', $tag );
$services = a1tools_get_site_services();
$data = ( is_array( $services ) && isset( $services[ $page_id ] ) ) ? $services[ $page_id ] : array();
$key_map = array(
'title' => 'page_title',
'description' => 'description',
'phone' => 'phone',
'icon' => 'icon',
'image' => 'image_url',
);
if ( ! isset( $key_map[ $field ] ) ) {
return esc_html( $atts['default'] );
}
$value = isset( $data[ $key_map[ $field ] ] ) ? (string) $data[ $key_map[ $field ] ] : '';
// Title falls back to the current WordPress page title.
if ( 'title' === $field && '' === $value ) {
$value = get_the_title( $page_id );
}
if ( '' === $value ) {
return esc_html( $atts['default'] );
}
$class_attr = ! empty( $atts['class'] ) ? ' class="' . esc_attr( $atts['class'] ) . '"' : '';
if ( 'phone' === $field && 'yes' === $atts['link'] ) {
$clean = preg_replace( '/[^0-9+]/', '', $value );
return '' . esc_html( $value ) . '';
}
if ( 'image' === $field ) {
$value_out = esc_url( $value );
} elseif ( 'icon' === $field ) {
$value_out = wp_kses_post( $value );
} else {
$value_out = esc_html( $value );
}
if ( ! empty( $atts['class'] ) ) {
return '' . $value_out . '';
}
return $value_out;
}
foreach ( array(
'a1tools_service_title',
'a1tools_service_description',
'a1tools_service_phone',
'a1tools_service_icon',
'a1tools_service_image',
) as $a1tools_sf_tag ) {
add_shortcode( $a1tools_sf_tag, 'a1tools_shortcode_service_field' );
}