Shortcodes and Widgets
Place directory and business content anywhere on your site.
Shortcodes
Section titled “Shortcodes”The plugin registers three shortcodes.
Business Directory
Section titled “Business Directory”[bp-business-listing]| Attribute | Default | Options | Description |
|---|---|---|---|
per_page |
10 | Any number | Businesses per page |
category |
(all) | Category slug | Filter by category |
view |
grid | grid, list, map | Display layout |
Examples:
[bp-business-listing per_page="20" view="list"][bp-business-listing category="restaurants"][bp-business-listing view="map"]Search Filter
Section titled “Search Filter”[search-business-listing]Renders the search and filter form. Place it above your business listing so visitors can filter it.
Claim Button
Section titled “Claim Button”[business_claim_button business_id="123"]| Attribute | Description |
|---|---|
business_id |
ID of the business to claim |
Usually you do not need this shortcode, because the claim button appears automatically on unclaimed business pages when claiming is enabled.
Where shortcodes work
Section titled “Where shortcodes work”Pages, posts, text/shortcode widgets, and page builders that accept shortcodes. If a shortcode shows as plain text, confirm the plugin is active and the shortcode is spelled correctly.
Widgets
Section titled “Widgets”The plugin provides seven widgets. In classic widget areas they appear under names prefixed with the plugin.
| Widget | Displays |
|---|---|
| Business Info | Contact details: email, phone, WhatsApp, website, address |
| Business Hours | Weekly operating hours and open/closed status |
| Business Social | Social profile links |
| Business Team | Team members with avatars, names, and roles |
| Business List | A configurable list of businesses |
| Business Search Filter | The search and filter form |
| Business Claim | The claim button on unclaimed businesses |
The single-business widgets (Info, Hours, Social, Team) show only on business pages, and business owners can toggle their visibility from their business Settings > Sidebar options. Widgets automatically hide when there is no data to show.
The Business List, Search Filter, and Claim widgets have shortcode equivalents ([bp-business-listing], [search-business-listing], [business_claim_button]).