Groups are areas of space used for grouping the fields and showing them in one coherent way. Bello comes with five groups and eight widgets that you can use right from the go. However, if you want, you can create more groups and more widgets. Each new widget can be easily sorted via native WordPress Appearance / Widgets section, however you want. But new groups can at the moment only appear underneath the main column content for each of the listing, but above the Amenities group. Hierarchy in the main column is such, that any new group other than the ones named belo will be shown below main content (text), excerpt, Media, MediaVideo and FAQ, but above the Amenties.
Existing group names | How it looks in sidebar | How it looks at main column | Example (slug;name;field_type;group_or_widget) |
---|---|---|---|
Amenities | As a checkbox list in a single colum | As a checkbox list in four columns | amenities_free_wifi;Free Wi-Fi;checkbox;Amenities |
Media | As a carousel gallery, one after another if they’re grouped in a Media group | As a carousel or grid gallery, within their separate tabs if they’re grouped in a Media group | media_images_featured;Featured images;image_advanced;Media |
MediaVideo | As embedded video files, one below another if they’re grouped in MediaVideo | As embedded video files, one below another if they’re grouped in MediaVideo | media_video_2;Video 2;oembed;MediaVideo |
MediaAudio | As embedded audio files from Soundcloud or Mixcloud, one below another if they’re grouped in MediaAudio | As embedded audio files from Soundcloud or Mixcloud, one below another if they’re grouped in MediaAudio | media_audio;Soundcloud file;audio;MediaAudio |
FAQ | As a contained showing HTML content for FAQ group | As a contained showing HTML content for FAQ group | faq;FAQ;wysiwyg;FAQ |
widget_location | As a map with a pin, with get directions, review, make a call options | As a map with a pin, with get directions, review, make a call options | location_position;Location;map;widget_location |
widget_working_time | As list of days ans working hours, and whether it’s currently open | As list of days ans working hours, and whether it’s currently open | working_time;Working time;working_time;widget_working_time |
widget_contact_details | As list of fields grouped for contact information | As list of fields grouped for contact information | contact_description;Location description;text;widget_contact_details |
widget_social_networks | As a list of social media links with their icons | As a list of social media links with their icons | social_facebook;Facebook URL;social;widget_social_networks |
widget_opentable | As a form used for booking via OpenTable | As a form used for booking via OpenTable | opentable;Open Table;opentable;widget_opentable |
widget_timekit | As a form used for booking via TimeKit | As a form used for booking via TimeKit | timekit;TimeKit;timekit;widget_timekit |
widget_resurva | As a button for launching the Resurva booking popup | As a button for launching the Resurva booking popup | resurva;Resurva;resurva;widget_resurva |
widget_contact_form | As a booking form | As a booking form | contact_form_email;Contact form email;email;widget_opentable |
Description of the examples:
slug – Used for identifying a metabox field, these must be unique, not only within a category, but also within parent and child caregories
name – Used for the label of the field
field_type – Field type being used
group_or_widget – Where the field will be shown – if it’s one of the existing groups (Amenities, Media, MediaViceo, FAQ) or a new group (can’t be named as one of the existing groups), if it’s a widget, you need to enter widget_ and then the widget slug that you need to enter in the BT Listing widget, in the field slug
Fields are used to gather information from the user and show them on the listing search results or listing page. You can select which field you need, order them properly for the user interface (note that however you lay out the fields in the category will be the order user will see when they add their listings), and decide where to show them, as well in which subscription packages. There are some Bello specific field types that are not native to Metabox, but most of them are Metaboxes, as shown below. You can see how you can writhe them, what they’re used for, and what they transform to when they’re shown in a WordPress or user backend, listing details or in search.
Please note that once you setup the categories, you do setup the field visibility in each of the packages, even if you only have the Default package (which comes with the import). If you don’t setup the visibility you might end up with widgets not showing up or fields not showing up how you want to. Click here to find out more about custom field settings and their visibility in the packages.
Field type name | Note | What’s it for | What it transforms to at WP / user backend | What it transforms to at listing details | What it transforms in search |
---|---|---|---|---|---|
price * | Only one field for all categories filed supported | For price from – to input | To 2 input number fields, for price from and price to | To a price tag | Into two fields for search, price from and price to |
Example | price;Item;price; | This field won’t be shown in any group or widget) | |||
working_time * | – | For working hours input | Into a seven-day input field – from and to (twice) and 24h checkbox | To an unordered list of working time for each day | Into a checkbox for NOW OPEN |
Example | working_time;Store working time;working_time;widget_working_time | This field will be shown in a widget with slug working_time | |||
social_ * | For supported social networks, view below | For social network input links | To input url field | To an icon with a social network icon | Into a checkbox, that will check whether the field has a value or not |
Example | social_facebook;Facebook;social;widget_social_networks | This field will be shown in a widget with slug social_networks | |||
opentable * | – | For entering opentable values | To two input fields (opentable id and country) | To OpenTable form | Into a checkbox, that will check whether the field has a value or not |
Example | opentable;Open Table;opentable;widget_opentable | This field will be shown in a widget with slug opentable | |||
timekit * | – | For entering timekit values | To six input fields (name, email, app, api token, calendar or widget id) | To TimeKit embedded widget | Into a checkbox, that will check whether the field has a value or not |
Example | timekit;Time Kit;timekit;widget_timekit | This field will be shown in a widget with slug timekit | |||
resurva * | – | For entering resurva values | To input url field for resurva booking | To a button, when clicked opens Resurva widget | Into a checkbox, that will check whether the field has a value or not |
Example | resurva;Resurva;resurva;widget_resurva | This field will be shown in a widget with slug resurva | |||
audio * | – | For audio embed URLs – Soundcloud and Mixcloud only | To input text field for embedding audio files | To an embedded audio player | Into a checkbox, that will check whether the field has a value or not |
Example | audio;Recorded sounds;audio;Sounds | This field will be shown in a group named Sounds | |||
map | – | For map location input | To a map control with no location search | To a google map with a pin | Into a field for location search (autocomplete and distance) or region search, depending on customizer settings |
Example | location_position;Location;map;widget_location std -6.233406,-35.049906 api_key AIzaSyDDM_OQX_hwM0Zz1sctnTQlsYZCEc2mGNA address_field boldthemes_theme_listing-contact_address |
This field will be shown in a widget with slug location, more on this field on this link – https://docs.metabox.io/fields/map/ Please note the spaces before std, api_key and address_field and two spaces before it’s values. The last setting address_field is used to allow users to find the position on the map with a click of a button by using the value from the field with the slug contact_address in our example. |
|||
taxonomy | – | For listing categorization (Region) | To a region select in WP admin, and to a select list on user admin | Nothin, used only for search if selected in customizer | Into a region select list if Listing / Autocomplete search location is not checked |
Example | region;Region;taxonomy | Uses values from Listings > Regions, only used for constructing add listing interface | |||
text | – | For text input | To input text field | To text | Into a checkbox, that will check whether the field has a value or not |
Example | contact_description;Site description;text;widget_contact_details | This field will be shown in a widget with slug contact_details | |||
– | For emals input | To input email field | To email link or contact form, widget dependent | Into a checkbox, that will check whether the field has a value or not | |
Example | contact_email;Email address;email;widget_contact_details | This field will be shown in a widget with slug contact_details | |||
url | – | For weblinks input | To input url field | To a link with a small globe icon | Into a checkbox, that will check whether the field has a value or not |
Example | contact_website;Website;url;widget_contact_details | This field will be shown in a widget with slug contact_details | |||
wysiwyg | – | For HTML editor input | To WP HTML editor | To a container showing HTML content | Into a checkbox, that will check whether the field has a value or not |
Example | faq;FAQ;wysiwyg;FAQ |
This field will be shown in a widget with slug contact_details | |||
checkbox | – | For checking / dechecking values | To unordered checkbox list | To a list item with a checkbox icon | Into an unordered list of checkboxes |
Example | amenities_free_wifi;Free Wi-Fi;checkbox;Amenities | This field will be shown in a widget with slug contact_details | |||
image_advanced | – | For multiple images input | To WP file chooser field | To a gallery with or without tabs, group dependent | Into a checkbox, that will check whether the field has a value or not |
Example | media_images_featured;Featured images;image_advanced;Media | This field will be shown in a widget with slug contact_details | |||
oembed | – | For embedding video files | To input url field | To youtube or vimeo embed | Into a checkbox, that will check whether the field has a value or not |
Example | media_video_1;Video 1;oembed;MediaVideo | This field will be shown in a widget with slug contact_details | |||
single_image | – | For single image input | To a file browser control | To a single image with lightbox when it’s clicked | Into a checkbox, that will check whether the field has a value or not |
Example | media_single_image;Featured image;single_image;Featured | This field will be shown in a group named Featured | |||
time | – | For time input | To input time field | To text with a small clock icon | Into a checkbox, that will check whether the field has a value or not |
Example | time_added;Listing time added;time;widget_added | This field will be shown in a widget with slug added | |||
date | – | For date input | To input date field | To text with a small calendar icon | Into a checkbox, that will check whether the field has a value or not |
Example | date_added;Listing date added;date;widget_added | This field will be shown in a widget with slug added | |||
datetime | – | For date and time input | To input datetime field | To text with a small calendar icon | Into a checkbox, that will check whether the field has a value or not |
Example | date_time_added;Listing date & time added;datetime;widget_added | This field will be shown in a widget with slug added | |||
number | – | For number input | To input number field | To text | Into a checkbox, that will check whether the field has a value or not |
Example | listing_exmployees;Number of employees;number;widget_contact_details | This field will be shown in a widget with slug contact_details | |||
textarea | – | For larger text input | To textarea field | To text | Into a checkbox, that will check whether the field has a value or not |
Example | listing_description;Longer description;textarea;Description | This field will be shown in a group named Description | |||
phone | – | For phone number input | To input phone field | To a link with a small phone icon | Into a checkbox, that will check whether the field has a value or not |
Example | listing_phone;Phone number;phone;widget_contact_details | This field will be shown in a widget with slug contact_details | |||
heading | Used for formatting WP and user backend | For showing headlines | To h4 tag | Noting, used only for WP and user backend | Nothing |
Example | heading_photo_gallery;Photo Gallery;heading | This field will be shown only in user’s frontend, it’s used for constructing add listing interface | |||
desc | Has special way of input | For showing description | To paragraph which shows field desription | Noting, used only for WP and user backend | Nothing |
Example | desc To set your location on desired place, simply drag the map pin to the position on the map. Use Google map controls for zooming in and out to move around the map faster. |
This field will be shown only in user’s frontend, it’s used for constructing add listing interface Please note spaces before desc and two spaces before it’s value |
|||
divider | Used for formatting WP and user backend | For spacing within elements | To horizontal line | Noting, used only for WP and user backend | Nothing |
Example | first_divider;Divider;divider | This field will be shown only in user’s frontend, it’s used for constructing add listing interface | |||
Anything that’s not a control | Anything extraordinaty / or unsupported | As a fallback to a typo | To input text field | To text showing the content of the field | Into a checkbox, that will check whether the field has a value or not |
* Denotes custom Bello control. For more Metabox controls and their options, visit: Metabox website.
Supported social network icons | |||
---|---|---|---|
Behance | social_behance | Trip Advisor | social_tripadvisor |
ssocial_facebook | Tumblr | social_tumblr | |
Flickr | social_flickr | social_twitter | |
Foursquare | social_foursquare | Vimeo | social_vimeo |
Google+ | social_googleplus, social_google_plus | Vine | social_vine |
social_instagram | Vkontakte | social_vkontakte | |
Linked In | social_linkedin | social_wechat | |
Pay Pal | social_paypal | social_whatsapp | |
social_pinterest | Wikipedia | social_wikipedia | |
social_reddit | WordPress | social_wordpress | |
ShapChat | social_shapchat | Yahoo | social_yahoo |
Skype | social_skype | Yelp | social_yelp |
Sound Cloud | social_soundcloud | You Tube | social_youtube |
Stumbleupon | social_stumbleupon |
When using social network field type make sure to properly format the field, example: social_social_network_name, for instance: social_youtube or social_twitter.
Unsupported field types | ||
---|---|---|
autocomplete | background | button |
button_group | checkbox_list | color |
custom_html | fieldset_text | file |
file_advanced | file_input | file_upload |
hidden | image | image_select |
image_upload or plupload_image | key_value | password |
post | radio | range |
select | select_advanced | slider |
taxonomy_advanced | text_list | user |
video |