{"id":53,"date":"2026-04-26T19:15:55","date_gmt":"2026-04-26T19:15:55","guid":{"rendered":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/2026\/04\/26\/customizing-and-hooks\/"},"modified":"2026-04-26T19:15:55","modified_gmt":"2026-04-26T19:15:55","slug":"customizing-and-hooks","status":"publish","type":"post","link":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/2026\/04\/26\/customizing-and-hooks\/","title":{"rendered":"Customizing & Hooks"},"content":{"rendered":"\n

Customizing & Hooks<\/h1>\n\n\n

For developers extending Best Classifieds. Reference list of every action and filter the theme + Pro plugin expose, plus the recommended customization pattern (child theme or small custom plugin).<\/p>\n\n

\n\n

Recommended approach<\/h2>\n\n\n

Don’t edit the theme directly<\/h3>\n\n\n

Edits to \/wp-content\/themes\/best-classifieds\/<\/code> get wiped when the theme updates. Use one of these instead:<\/p>\n\n\n

\n\n\n\n\n\n
Pattern<\/th>\nWhen to use<\/th>\n<\/tr><\/thead>
Child theme<\/strong><\/td>\nYou’re overriding template files (single.php, archive.php, etc.) or adding template-parts<\/td>\n<\/tr>\n
Small custom plugin<\/strong><\/td>\nYou’re adding hooks, filters, custom post types, REST endpoints. Most customizations belong here.<\/td>\n<\/tr>\n
Code Snippets plugin<\/strong><\/td>\nOne-off filter tweaks, no version control needed<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\n

Child theme starter<\/h3>\n\n\n
\/wp-content\/themes\/best-classifieds-child\/\n\u251c\u2500\u2500 style.css         (Template: best-classifieds)\n\u251c\u2500\u2500 functions.php     (load parent's main stylesheet)\n\u2514\u2500\u2500 single.php        (your override; copy from parent and edit)<\/code><\/pre>\n\n\n
style.css<\/code>:<\/p>\n\n\n
\/*\nTheme Name:  Best Classifieds Child\nTemplate:    best-classifieds\nVersion:     1.0.0\n*\/<\/code><\/pre>\n\n\n
functions.php<\/code>:<\/p>\n\n\n
<?php\nadd_action( 'wp_enqueue_scripts', function() {\n    wp_enqueue_style( 'best-classifieds-parent', get_template_directory_uri() . '\/style.css' );\n} );<\/code><\/pre>\n\n
\n\n
Theme action hooks<\/h2>\n\n\n
\n\n\n\n\n\n\n\n\n\n\n\n
Hook<\/th>\nPosition<\/th>\nArgs<\/th>\nPurpose<\/th>\n<\/tr><\/thead>
best_classifieds_before_header<\/code><\/td>\nBefore site header<\/td>\n\u2014<\/td>\nInject announcement bars<\/td>\n<\/tr>\n
best_classifieds_after_header<\/code><\/td>\nAfter site header<\/td>\n\u2014<\/td>\nInject sticky promos<\/td>\n<\/tr>\n
best_classifieds_after_card_image<\/code><\/td>\nAfter listing card image<\/td>\n$post_id<\/code><\/td>\nAdd badges to cards (Pro adds Featured\/Verified)<\/td>\n<\/tr>\n
best_classifieds_after_card_meta<\/code><\/td>\nAfter listing card meta<\/td>\n$post_id<\/code><\/td>\nAdd favorite button (Pro does this)<\/td>\n<\/tr>\n
best_classifieds_after_listing_image<\/code><\/td>\nAfter single listing’s main image<\/td>\n$post_id<\/code><\/td>\nAdd gallery thumbnails (Pro)<\/td>\n<\/tr>\n
best_classifieds_after_listing_content<\/code><\/td>\nAfter single listing’s description<\/td>\n$post_id<\/code><\/td>\nAdd map, similar listings (Pro)<\/td>\n<\/tr>\n
best_classifieds_after_listing_sidebar<\/code><\/td>\nAfter single listing’s sidebar info card<\/td>\n$post_id<\/code><\/td>\nAdd messaging widget, reviews (Pro)<\/td>\n<\/tr>\n
best_classifieds_listing_actions<\/code><\/td>\nInside sidebar info card<\/td>\n$post_id<\/code><\/td>\nReplace default contact buttons (Pro adds Message Seller)<\/td>\n<\/tr>\n
best_classifieds_before_footer<\/code><\/td>\nBefore site footer<\/td>\n\u2014<\/td>\nInject newsletter signup, ad slots<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n
\n\n
Theme filters<\/h2>\n\n\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Filter<\/th>\nDefault<\/th>\nPurpose<\/th>\n<\/tr><\/thead>
best_classifieds_listing_post_type<\/code><\/td>\npost<\/code><\/td>\nOverride the post type used for listings<\/td>\n<\/tr>\n
best_classifieds_listings_category_slug<\/code><\/td>\nlistings<\/code><\/td>\nSlug of the parent “Listings” category<\/td>\n<\/tr>\n
best_classifieds_post_ad_url<\/code><\/td>\ncustomizer value<\/td>\nThe “Post Free Ad” button URL (Pro filters this)<\/td>\n<\/tr>\n
best_classifieds_pro_active<\/code><\/td>\nfalse<\/td>\nTrue if a Pro license is active (Pro overrides)<\/td>\n<\/tr>\n
best_classifieds_is_listing<\/code><\/td>\nderived<\/td>\nWhether a given post should be rendered as a listing<\/td>\n<\/tr>\n
best_classifieds_price_html<\/code><\/td>\nformatted<\/td>\nFinal HTML for the price display<\/td>\n<\/tr>\n
best_classifieds_currency_code<\/code><\/td>\nUSD<\/code><\/td>\nISO currency code for schema.org JSON-LD<\/td>\n<\/tr>\n
best_classifieds_currency_symbol<\/code><\/td>\n$<\/code><\/td>\nSymbol used in price formatting<\/td>\n<\/tr>\n
best_classifieds_color_palettes<\/code><\/td>\n2 palettes<\/td>\nAdd custom palettes<\/td>\n<\/tr>\n
best_classifieds_category_icon<\/code><\/td>\nmapping<\/td>\nPer-slug Tabler icon<\/td>\n<\/tr>\n
best_classifieds_smart_icon_keywords<\/code><\/td>\nmapping<\/td>\nKeyword \u2192 icon for smart search results<\/td>\n<\/tr>\n
best_classifieds_search_post_types<\/code><\/td>\nlisting PT<\/td>\nPost types included in live search<\/td>\n<\/tr>\n
best_classifieds_search_listings_limit<\/code><\/td>\n8<\/td>\nListings returned by live search<\/td>\n<\/tr>\n
best_classifieds_search_categories_limit<\/code><\/td>\n4<\/td>\nCategories returned by live search<\/td>\n<\/tr>\n
best_classifieds_homepage_categories_args<\/code><\/td>\nget_terms args<\/td>\nModify the homepage Categories grid query<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n
\n\n
Pro plugin filters<\/h2>\n\n\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Filter<\/th>\nPurpose<\/th>\n<\/tr><\/thead>
best_classifieds_submission_post_args<\/code><\/td>\nModify post args before insert (frontend submission)<\/td>\n<\/tr>\n
best_classifieds_submission_validate<\/code><\/td>\nAdd custom validation rules<\/td>\n<\/tr>\n
best_classifieds_submission_locked_fields<\/code><\/td>\nLock fields after publish<\/td>\n<\/tr>\n
best_classifieds_after_submission<\/code><\/td>\nReact to a successful submission (action)<\/td>\n<\/tr>\n
best_classifieds_dashboard_tabs<\/code><\/td>\nAdd\/remove dashboard tabs<\/td>\n<\/tr>\n
best_classifieds_visible_custom_fields<\/code><\/td>\nFilter which custom fields render<\/td>\n<\/tr>\n
best_classifieds_render_custom_field<\/code><\/td>\nCustom HTML for a specific field<\/td>\n<\/tr>\n
best_classifieds_message_strip_patterns<\/code><\/td>\nRegex patterns to strip from messages<\/td>\n<\/tr>\n
best_classifieds_payment_gateways<\/code><\/td>\nRegister new gateways (PayPal, Square, etc.)<\/td>\n<\/tr>\n
best_classifieds_payment_amount<\/code><\/td>\nModify amount before charge (taxes, discounts)<\/td>\n<\/tr>\n
best_classifieds_use_pro_reviews<\/code><\/td>\nForce standard comments instead of Pro reviews<\/td>\n<\/tr>\n
best_classifieds_similar_listings_count<\/code><\/td>\nHow many similar listings to show<\/td>\n<\/tr>\n
best_classifieds_map_zoom<\/code><\/td>\nOSM map default zoom<\/td>\n<\/tr>\n
best_classifieds_map_tile_url<\/code><\/td>\nOSM tile server URL<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n
\n\n
Common customization recipes<\/h2>\n\n\n
Add a custom badge to listings<\/h3>\n\n\n
add_action( 'best_classifieds_after_card_image', function( $post_id ) {\n    if ( get_post_meta( $post_id, '_certified_dealer', true ) ) {\n        echo '<span class="bc-badge bc-badge-certified">Certified Dealer<\/span>';\n    }\n} );<\/code><\/pre>\n\n\n
Style it via your child theme’s CSS.<\/p>\n\n\n
Force a category for new submissions<\/h3>\n\n\n
add_filter( 'best_classifieds_submission_post_args', function( $args, $data ) {\n    \/\/ Auto-tag everything submitted on Mondays as "weekly-special"\n    if ( 1 === (int) date( 'N' ) ) {\n        $args['tax_input']['post_tag'] = array( 'weekly-special' );\n    }\n    return $args;\n}, 10, 2 );<\/code><\/pre>\n\n\n
Add a third color palette<\/h3>\n\n\n
add_filter( 'best_classifieds_color_palettes', function( $palettes ) {\n    $palettes['ocean-blue'] = array(\n        'label'      => 'Ocean Blue',\n        'primary'    => '#1E3A8A',\n        'accent'     => '#06B6D4',\n        'background' => '#F0F9FF',\n        'text'       => '#0F172A',\n    );\n    return $palettes;\n} );<\/code><\/pre>\n\n\n
The new palette appears in the customizer dropdown automatically.<\/p>\n\n\n
Inject a banner above the homepage hero<\/h3>\n\n\n
add_action( 'best_classifieds_before_header', function() {\n    if ( is_front_page() ) {\n        echo '<div class="bc-announcement">Black Friday: 50% off Featured slots!<\/div>';\n    }\n} );<\/code><\/pre>\n\n\n
Restrict Featured upgrades to specific user roles<\/h3>\n\n\n
add_filter( 'best_classifieds_packages_for_user', function( $packages, $user_id ) {\n    $user = get_user_by( 'id', $user_id );\n    if ( in_array( 'subscriber', $user->roles, true ) ) {\n        \/\/ Subscribers can't pay for Featured slots\n        unset( $packages['boosted'], $packages['premium'] );\n    }\n    return $packages;\n}, 10, 2 );<\/code><\/pre>\n\n
\n\n
Template overrides<\/h2>\n\n\n
To override a template part from a child theme, copy the file to the same path inside your child:<\/p>\n\n\n
\/wp-content\/themes\/best-classifieds-child\/template-parts\/hero.php<\/code><\/pre>\n\n\n
Best Classifieds checks the child theme first, then falls back to the parent. You can override any of:<\/p>\n\n\n
    \n
  • template-parts\/hero.php<\/code><\/li>\n
  • template-parts\/featured-categories.php<\/code><\/li>\n
  • template-parts\/latest-listings.php<\/code><\/li>\n
  • template-parts\/cta-banner.php<\/code><\/li>\n
  • template-parts\/trust-strip.php<\/code><\/li>\n
  • template-parts\/how-it-works.php<\/code><\/li>\n
  • template-parts\/testimonial.php<\/code><\/li>\n
  • template-parts\/listing\/card.php<\/code><\/li>\n
  • template-parts\/content.php<\/code><\/li>\n<\/ul>\n\n\n
    For top-level templates: single.php<\/code>, archive.php<\/code>, index.php<\/code>, header.php<\/code>, footer.php<\/code> \u2014 same pattern.<\/p>\n\n
    \n\n
    REST API extension<\/h2>\n\n\n
    The theme registers \/wp-json\/best-classifieds\/v1\/search<\/code>. To add your own endpoint with the same namespace:<\/p>\n\n\n
    add_action( 'rest_api_init', function() {\n    register_rest_route( 'best-classifieds\/v1', '\/popular', array(\n        'methods'             => 'GET',\n        'permission_callback' => '__return_true',\n        'callback'            => function() {\n            $query = new WP_Query( array(\n                'post_type'      => 'post',\n                'posts_per_page' => 5,\n                'meta_key'       => '_bc_views',\n                'orderby'        => 'meta_value_num',\n                'order'          => 'DESC',\n            ) );\n            $out = array();\n            foreach ( $query->posts as $p ) {\n                $out[] = array( 'id' => $p->ID, 'title' => $p->post_title );\n            }\n            return $out;\n        },\n    ) );\n} );<\/code><\/pre>\n\n\n
    Hit \/wp-json\/best-classifieds\/v1\/popular<\/code> to test.<\/p>\n","protected":false},"excerpt":{"rendered":"
    For developers extending Best Classifieds. Reference list of every action and filter the theme + Pro plugin expose, plus the recommended customization pattern (child theme or small custom\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-53","post","type-post","status-publish","format-standard","hentry","category-reference"],"_links":{"self":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/53","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=53"}],"version-history":[{"count":0,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/53\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/media?parent=53"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/categories?post=53"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/tags?post=53"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}