{"id":47,"date":"2026-05-03T01:15:55","date_gmt":"2026-05-03T01:15:55","guid":{"rendered":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/2026\/05\/03\/listing-pages\/"},"modified":"2026-05-03T01:15:55","modified_gmt":"2026-05-03T01:15:55","slug":"listing-pages","status":"publish","type":"post","link":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/2026\/05\/03\/listing-pages\/","title":{"rendered":"Listing Pages Explained"},"content":{"rendered":"\n

Listing Pages Explained<\/h1>\n\n\n

A walkthrough of every component on the single listing page \u2014 what it shows, where the data comes from, and how to customize each piece.<\/p>\n\n\n

The listing page is a two-column layout: gallery on the left, sticky info card on the right.<\/p>\n\n

\n\n

Anatomy of the page<\/h2>\n\n\n\n \n Home \u203a Vehicles \u203a 2018 Honda Civic Sport \u2014 One Owner<\/text>\n\n \n Featured image (4:3, large)<\/text>\n A<\/text>\n\n \n \n \n \n B<\/text>\n\n \n Share<\/text>\n \n Report<\/text>\n\n \n \u2014 DESCRIPTION \u2014<\/text>\n C<\/text>\n\n \n Listing Title<\/text>\n (2 lines)<\/text>\n $14,800<\/text>\n or best offer<\/text>\n \n\n Condition<\/text>\n Like New<\/text>\n Location<\/text>\n Brooklyn, NY<\/text>\n Posted<\/text>\n 3 days ago<\/text>\n Listing ID<\/text>\n #52<\/text>\n\n \n Show Contact Email<\/text>\n \n Show Phone Number<\/text>\n\n \n \n ftadmin<\/text>\n Member since 2026 \u00b7 1 listing<\/text>\n\n D<\/text>\n<\/svg>\n\n\n
\n\n\n\n\n\n\n
Letter<\/th>\nSection<\/th>\nSource<\/th>\n<\/tr><\/thead>
A<\/strong><\/td>\nFeatured image<\/td>\nPost’s featured image, sized to best-classifieds-listing-large<\/code> (1200\u00d7800)<\/td>\n<\/tr>\n
B<\/strong><\/td>\nGallery thumbs [Pro]<\/em><\/td>\n_bc_gallery<\/code> post meta (array of attachment IDs)<\/td>\n<\/tr>\n
C<\/strong><\/td>\nDescription<\/td>\nThe post content<\/td>\n<\/tr>\n
D<\/strong><\/td>\nSidebar info card<\/td>\n_bc_price<\/code>, _bc_condition<\/code>, _bc_location<\/code>, post date, post ID, contact meta<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n
\n\n

The gallery [Pro]<\/em><\/h2>\n\n\n

The free theme shows only the featured image. Pro adds a multi-image gallery driven by the _bc_gallery<\/code> post meta \u2014 an array of attachment IDs.<\/p>\n\n\n

When the gallery has 2+ images:<\/p>\n\n\n

    \n
  1. The first image becomes the large hero photo.<\/li>\n
  2. Thumbnails appear in a row below.<\/li>\n
  3. Clicking a thumbnail swaps the hero photo (no page reload).<\/li>\n
  4. Click the hero photo to open a fullscreen lightbox with arrow-key nav.<\/li>\n<\/ol>\n\n\n

    The WOW Feeder writes 3 photos per listing by default (configurable 1\u20136).<\/p>\n\n

    \n\n

    Sidebar info card<\/h2>\n\n\n

    Sticky on desktop (stays in view as you scroll the description), static on mobile.<\/p>\n\n\n

    Price<\/h3>\n\n\n

    _bc_price<\/code> post meta. Three accepted formats:<\/p>\n\n\n

    \n\n\n\n\n\n\n\n
    Stored value<\/th>\nRenders as<\/th>\n<\/tr><\/thead>
    14800<\/code><\/td>\n$14,800 (currency-symbol prefix, comma-formatted)<\/td>\n<\/tr>\n
    $14,800<\/code><\/td>\n$14,800 (verbatim \u2014 pre-formatted strings preserved)<\/td>\n<\/tr>\n
    $1,800\/mo<\/code><\/td>\n$1,800\/mo (verbatim)<\/td>\n<\/tr>\n
    $60 \/ hr<\/code><\/td>\n$60 \/ hr (verbatim)<\/td>\n<\/tr>\n
    Contact for price<\/code><\/td>\nContact for price (verbatim)<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\n

    The detection uses is_numeric()<\/code> plus a check for the currency symbol. If your stored value contains $<\/code> or any non-numeric character, it’s rendered as-is<\/strong>. Otherwise, the symbol gets prepended.<\/p>\n\n\n

    Condition<\/h3>\n\n\n

    _bc_condition<\/code> post meta. Free text. Common values: New, Like New, Used – Excellent, Used – Good, Used – Fair.<\/p>\n\n\n

    Location<\/h3>\n\n\n

    _bc_location<\/code> post meta. Free text. Used here AND on the listing card and breadcrumb.<\/p>\n\n\n

    Posted<\/h3>\n\n\n

    The post date, formatted via human_time_diff()<\/code> (e.g. “3 days ago”). To show the absolute date instead:<\/p>\n\n\n

    add_filter( 'best_classifieds_listing_posted_format', function() {\n    return 'absolute'; \/\/ or 'relative' (default)\n} );<\/code><\/pre>\n\n\n
    Listing ID<\/h3>\n\n\n
    The post ID, prefixed with #<\/code>. Useful for users referencing a listing in support emails or messaging.<\/p>\n\n
    \n\n
    Contact reveal buttons<\/h2>\n\n\n
    The two buttons under the info \u2014 “Show Contact Email” and “Show Phone Number” \u2014 use a two-click reveal pattern<\/strong>:<\/p>\n\n\n
      \n
    1. First click:<\/strong> the encoded value is decoded and shown in the button itself, with a soft pop animation. The button switches to monospace font for clean alignment.<\/li>\n
    2. Second click:<\/strong> opens mailto:<\/code> (mail composer) or tel:<\/code> (dialer \/ Skype \/ FaceTime).<\/li>\n<\/ol>\n\n\n
      The encoded format is base64 in a data-encoded<\/code> attribute. This isn’t strong protection \u2014 sophisticated scrapers can defeat it \u2014 but it stops naive view-source<\/code> regex sweeps. For real anti-scraping, gate the contact section behind login (Pro setting).<\/p>\n\n
      \n\n
      Seller card<\/h2>\n\n\n
      Shows the post author’s gravatar + display name + member-since date + total listing count. Clicking it goes to the seller’s archive page (\/author\/{username}\/<\/code>) which shows all their listings.<\/p>\n\n\n
      To customize the seller card layout, override the partial in a child theme: template-parts\/listing-seller.php<\/code>.<\/p>\n\n
      \n\n
      OSM map [Pro]<\/em><\/h2>\n\n\n
      If the listing has both _bc_lat<\/code> and _bc_lng<\/code> meta, Pro renders an embedded OpenStreetMap below the description. No API key needed (we use OSM tiles via Leaflet, which is GPL-friendly and free).<\/p>\n\n\n
      The marker is the listing’s location; the zoom level defaults to 14. To change defaults:<\/p>\n\n\n
      add_filter( 'best_classifieds_map_zoom', function() { return 12; } );\nadd_filter( 'best_classifieds_map_tile_url', function() {\n    return 'https:\/\/your-tile-server.example.com\/{z}\/{x}\/{y}.png';\n} );<\/code><\/pre>\n\n\n
      If you prefer Google Maps, contact us \u2014 there’s a paid Pro extension for that.<\/p>\n\n
      \n\n
      Similar listings [Pro]<\/em><\/h2>\n\n\n
      Below the description, a “Similar listings” section shows up to 4 other listings from the same sub-category. Excludes the current listing.<\/p>\n\n\n
      To turn it off or change the count:<\/p>\n\n\n
      add_filter( 'best_classifieds_similar_listings_count', function() {\n    return 6; \/\/ or 0 to disable\n} );<\/code><\/pre>\n\n
      \n\n
      Comments \/ Reviews<\/h2>\n\n\n
      The free theme uses standard WordPress comments. Pro replaces this with 5-star reviews<\/strong> (writes one review per user per listing, with a moderation queue at Classifieds Pro \u2192 Reviews<\/strong>).<\/p>\n\n\n
      To force standard comments even with Pro active:<\/p>\n\n\n
      add_filter( 'best_classifieds_use_pro_reviews', '__return_false' );<\/code><\/pre>\n\n
      \n\n
      Hooks for adding your own sections<\/h2>\n\n\n
      The single listing template fires these action hooks where you can inject custom content from a child theme or plugin:<\/p>\n\n\n
      \n\n\n\n\n\n\n
      Hook<\/th>\nPosition<\/th>\nUsed by<\/th>\n<\/tr><\/thead>
      best_classifieds_after_listing_image<\/code><\/td>\nBelow the gallery<\/td>\nPro: gallery thumbnails, action buttons<\/td>\n<\/tr>\n
      best_classifieds_after_listing_content<\/code><\/td>\nBelow the description<\/td>\nPro: OSM map, similar listings<\/td>\n<\/tr>\n
      best_classifieds_after_listing_sidebar<\/code><\/td>\nBelow the sidebar info card<\/td>\nPro: messaging widget, reviews summary<\/td>\n<\/tr>\n
      best_classifieds_listing_actions<\/code><\/td>\nInside the sidebar (replaces default actions)<\/td>\nPro: messaging button, save-to-favorites<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\n
      Example \u2014 add a custom “Make an offer” button:<\/p>\n\n\n
      add_action( 'best_classifieds_listing_actions', function( $post_id ) {\n    $price = get_post_meta( $post_id, '_bc_price', true );\n    if ( $price && false !== strpos( strtolower( $price ), 'offer' ) ) {\n        echo '<button class="bc-btn bc-btn-outline">Make an offer<\/button>';\n    }\n} );<\/code><\/pre>\n\n\n
      See Customizing & Hooks<\/a> for the full reference.<\/p>\n","protected":false},"excerpt":{"rendered":"
      A walkthrough of every component on the single listing page \u2014 what it shows, where the data comes from, and how to customize each piece.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-47","post","type-post","status-publish","format-standard","hentry","category-using-best-classifieds"],"_links":{"self":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/47","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/comments?post=47"}],"version-history":[{"count":0,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/47\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/media?parent=47"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/categories?post=47"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/tags?post=47"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}