=== Business Listing === Contributors: falcon13 Donate link: https://onthegridwebdesign.com/product/support-business-listing-wp-plugin/ Tags: business, listings, shortcode, thumbnail, directory, chamber of commerce, member directory Requires at least: 4.0 Tested up to: 7.0 Requires PHP: 5.6 Stable tag: 2.2.1 License: GPLv3 A filterable business directory plugin for WordPress. Display listings by region and category — perfect for chambers of commerce, tourism sites, and membership organizations. == License == Released under the terms of the GNU General Public License. == Description == Business Listing is a simple, lightweight plugin for displaying a filterable directory of businesses on your WordPress website. Visitors can browse all listings or narrow them down by region and category with a single click with no page reload required. Originally built for a florist website, it's flexible enough for any organization that needs to showcase a collection of businesses, members, posts or something else in a clean, visual format. The businesses are in boxes which show an image, the business name, city and state. While it was designed for businesses we found that it can be used for other things like a portfolio with other details in the city and state fields. = Who Is This For? = * Chambers of commerce and business associations * Tourism and visitor center websites * Local community and neighborhood directories * Regional shopping guides and retail directories * Membership organizations showcasing member businesses * Any website that needs a filterable business or vendor listing = How It Works = Add your businesses through the WordPress admin — each listing gets a name, image, city, state, website link, category, and region. Drop the shortcode anywhere on your site and visitors immediately see a visual grid of listings they can filtered by region and category. Both the region label and category label are fully customizable to fit your organization's terminology. = Features = * Shortcode for displaying listings anywhere on your site * Filterable by region and category with instant click-to-filter buttons * Each listing displays an image, business name, city, state and website link * Fully customizable region and category labels — call them neighborhoods, counties, districts, or anything else * Show or hide region and category filter buttons independently * Listings can be deactivated without deleting them * Clean, responsive layout that works on mobile and desktop = Use Cases = * Chamber of Commerce — Showcase member businesses organized by industry category and geographic region. Let visitors filter to find exactly what they're looking for. * Tourism Websites — Display local restaurants, shops, and attractions with region filters so visitors can find businesses near where they're staying. * Community Directories — Build a neighborhood business guide with category filters for retail, dining, services, and more. * Membership Organizations — Give your members visibility with a professional listing page that's easy to manage from the WordPress dashboard. = Customization = * Button colors can be overridden with CSS. Additional styling options are planned for a future release. DISCLAIMER: Under no circumstances do we release this plugin with any warranty, implied or otherwise. We cannot be held responsible for any damage that might arise from the use of this plugin. Back up your WordPress database and files before installation. == Installation == = Shortcode Usage = Shortcode: [otg_business_listing] = Options = There are no options in the shortcode, all settings are on the plugin's options page. You can show/hide region and category buttons and the name for the regions button. = Examples = [otg_business_listing] == Screenshots == 1. Shortcode with regions only used. 2. Setting up the regions admin 3. Short code with both regions and categories used. 4. Listing add/edit form in the admin. 5. Main admin page showing the listings. 6. Filterable business directory displayed on a live site. == Changelog == 2.2.1 (6/9/2026) - Updated Datatables Javascript library to version 2.3.8. - Changed table row styles to use even/odd psuedo classes due to the classes not always being added to tag when tbody is generated. - Added renaming instructions to regions and categories admin pages. 2.2.0 (9/10/2024) - Updated validation and filter helper functions, including splitting validation and filter functions into separate helper files. 2.1.2 (12/9/2022) - Validation, Filter and View helpers improvements and updates for PHP 8.2. 2.1.1 (12/6/2022) - Updated Datatables Javascript library - Tweaks and code improvements. 2.1 (2/7/2022) - Switched lists to use Datatables Javascript library - Added ability to rename categories and region from list 2.0 (5/11/2021) - First openly released version - Brought the plugin up to current standards - Moved shortcode functions into their own file - Updated way table names are handled - Run all user submitted data through filter functions - Added nonces to forms - Fixed adding new business - Moved images into outer container to handle different aspect ratios - Improved responsiveness 1.0 (5/5/2015) - Plugin created in April 2015 as custom plugin for specific site. - Originally called Store Listings == Frequently Asked Questions == = Can this be used for other things besides businesses? = * Yes, we actually use it for showing our portfolio with the state & city field repurposed for other info. = Is there a limit to the number of businesses added? = * There is not a limit, so use your judgment so it does not overload the pages it is on. = Can I change the button color? = * Right now you have to override the colors by CSS. In a future version it will be in the options. = Does it work with the block editor (Gutenberg, Elementor, Divi)? = * There are no Gutenberg, Elementor or Divi specific blocks, but you can use the shortcode in a text block. = Can listings link to pages on my own site instead of external websites? = * Yes, our portfolio page uses it to link to individual posts. Just enter the full page URL.