7. Groups and Field Types

Available Groups

Below are shown all special field groups and widgets in the Bello WordPress theme.

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

Field Types

Below are shown all supported field types in the Bello WordPress theme.

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.

Important note

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
email 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
Facebook ssocial_facebook Tumblr social_tumblr
Flickr social_flickr Twitter social_twitter
Foursquare social_foursquare Vimeo social_vimeo
Google+ social_googleplus, social_google_plus Vine social_vine
Instagram social_instagram Vkontakte social_vkontakte
Linked In social_linkedin WeChat social_wechat
Pay Pal social_paypal Whatsapp social_whatsapp
Pinterest social_pinterest Wikipedia social_wikipedia
Reddit 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

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