Home 3. Theme Customization

INTRODUCTIONTheme Customization

Theme uses native WordPress Customizer for General theme options. In order to access WordPress Customizer please select ‘Appearance > Customize’ in wp-admin console.

On the left side of the screen you will see the menu with various options and on the right side you will see website preview. Any settings you change in the Customizer will affect entire website, which means all posts and pages, so we are referring to them as global customization settings.

Each change you make will automatically update website preview (page will be refreshed). When you are satisfied with the result click ‘Save & Publish’ and do not forget to make final preview outside customization frame and logged out of WordPress to see how the site would look like to your visitors.

The important feature of Bello is that any global setting can be overridden on any single post or page using setting keys which you will find in preformatted text below setting names on the following sections.

Preformatted text present possible values of setting keys. You will learn more about this overriding soon. Now, let’s explore customization settings.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/customization.jpg

SECTION 01General Settings – WordPress Customizer

On General settings panel you will find the following options:
http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/general-settings.jpg

Logo 

Attachment ID or URL

Here you should select main website logo. It is displayed on pages next to the menu, on preloader screen and on sticky header.

Alternate Sticky Header Logo

Attachment ID or URL

Here you should select website alternative logo.

This is usually light version of logo (which is supposed to be used on dark backgrounds). The logic is this:

  1. If you do not have Alternative logo defined, main logo will be used in all cases
  2. If you have Alternative logo defined, it will be used on top of the page when Content Below Menu and Sticky Header options are activated. This set up will also change the color of menu and widgets to light.
http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/alt-logo.jpg

Primary Accent Color

Hexadecimal color code or color picker

Accent color is used as a color for links, icons, etc. If you define it, the accent color will influence the general color scheme of the site.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/accent-color.jpg

Secondary Accent Color

Hexadecimal color code or color picker

Another color which influences general color scheme of the site is alternate color. Alternate color can be assigned as a color for buttons, icons, etc. If you define it, all elements with assigned alternate color will be affected.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/alternate-color.jpg

Page Background

Attachment ID or URL

Page background image is a static image which serves as a site background if defined.

Hide Default Headline

True / False

This option enables you to display navigation breadcrumbs at the top of the screen. In most user scenarios this option should be set to true (checked).

Template skin

True / False

This is another option which influences general color scheme of the site. Bello features two general skin styles – light and dark. The light skin has white colored background and dark colored main font and other ui elements. On the other hand, dark skin has dark colored background and light colored fonts.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/dark-skin.jpg

Sidebar

No Sidebar / Left / Right

This option enables you to define if the sidebar will be visible globally or not.
By customizing this option, user can globally enable (place it on the right or left side) or disable sidebar. Sidebar content can be edited under Appearance > Widgets (from main WordPress menu).

You can choose one of three predefined sidebar layouts:

  1. No Sidebar – No sidebar is displayed
  2. Left – Sidebar is displayed on the left side of main content
  3. Right – Sidebar is displayed on the right side of main content.

Page Width

Default / Boxed

This option enables you to define if the page width will be full width (default) or boxed.

Use Dash in Template Headlines

True / False

This option enables you to define if separator will be used below the widget titles or not. By changing this option, users can globally enable or disable the separator in widgets. Please check this option if you want to use separator in widgets.

Disable Preloader

True / False

This option enables you to define if the preloading animation will be displayed globally throughout the site or not. By changing this option, users can globally enable or disable the preloader animation.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/preloader.jpg

Preloader Text 

Any text

This option enables you to define the text on preloading screen. The preloader needs to be enabled in order to see the effect of this option.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/preloader-text.jpg

Custom JS

Custom JS code

This option enables you to define global Custom JS code. Enter any JS code you want here and it will be embedded in the <head> element of all pages throughout the site.

This is where you should paste your custom site wise JavaScript, such as Google Analytics script.

Reset Theme Settings

This is not really a setting, so no override. Reset button will just reset all global settings to default values.

SECTION 02Site Identity

Under “Site Identity” panel in Customizer, you can set Site Title, Tagline and Site Icon. When working with site icon, please pay attention to recommended Icon size.
http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/site-identity.jpg

You’ll see the changes in the preview pane to the right. When you’re done, click Save and Publish.

SECTION 04Typography

On Typography settings panel you will find the following options:

Body Font

No Change / Any Google font

Body text font. Using this setting you can set the main font family that’ll be applied throughout the website. Bello uses Google webfonts.

Heading Font

No Change / Any Google font

Heading text font. Using this setting you can set the font family for Main Headings.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/heading-font.jpg

Heading Supertitle Font

No Change / Any Google font

Heading Supertitle text font. Using this setting you can set the font family for supertitles in Main Headings.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/heading-supertitle.jpg

Heading Subtitle Font

No Change / Any Google font

Heading Subtitle text font. Using this setting you can set the font family for subtitles in Main Headings.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/heading-subtitle.jpg

Menu Font

No Change / Any Google font

Using this setting you can set the font family for menus.

Button Shape

Hard Rounded / Soft Rounded / Square

1. Hard Rounded:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/buttons-hard-rounded.jpg

2. Soft Rounded:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/buttons-soft-rounded.jpg

3. Square:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/buttons-square.jpg

SECTION 05Blog

On Blog settings panel you will find the following options:

Grid Gallery Columns

2 / 3 / 4 / 5 / 6

Here you can define the number of columns for grid gallery on single posts. On this example, three columns were set.

You can set the post grid gallery format by choosing Gallery as Post format, add the images to the post in the settings panel and check the Grid Gallery setting.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/blog-grid-gallery.jpg

Grid Gallery Gap

No gap / Small / Normal / Large

You can define gap between grid gallery items in pixels using this setting. In the example above the gap is 10px. If you choose 0, the images will be “glued” to each other without any gap in between.

Archive Layout

Standard / Columns / Simple

Bello offers three layouts for blog archive pages – standard, columns and simple. Please take a look at the following examples of these layouts:

  1. Standard Layout
  2. Columns Layout
  3. Simple Layout

This setting lets you choose default layout for all Blog archive pages.

Single Post Layout

Standard / Columns

Bello offers two layouts for single blog post pages – standard and columns. Standard layout features post content in one column while columns layout introduces two columns – one for featured image / grid gallery / video, and one for the content itself.

Here is the example of standard layout:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/blog-single-standard.jpg

Here is the example of columns layout:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/blog-single-columns.jpg

Show Author Name

True / False

This option enables you to set whether to display author name under post title or not.

Show Post Date

True / False

This option enables you to set whether to display post date under post title or not.

Show Author Avatar in List

True / False

Show Author Info in Post

True / False

Show information about author in single posts (you can add or update the text in Users > Your Profile > Biographical Info from main WordPress menu).

Share on Facebook

True / False

Share on Twitter

True / False

Share on Google Plus

True / False

Share on LinkedIn

True / False

Share on VK

True / False

Sharing options for single posts. If checked, the share icons will be present in posts.

Use Dash in Headlines

True / False

Bello offers two types of headlines on blog archive pages and individual post pages.

Check to use dash separator in headlines.

Settings Page Slug

Page slug

Bello has a unique way of enabling you to create custom templates for single post pages. You can create a static page, add content to it and set desired global settings overrides. Then you can use it as a template for single post pages.

The field Setting page slug should contain the slug of your page which serves as a template for blog posts. Once you add the slug to this field, all blog posts will inherit settings and shortcodes of the referenced page.

So, in order to change template elements on blog posts, please locate the page with the slug entered in Settings Page Slug field and edit it.

SECTION 06Bello General Options

General settings for listings.

Listing Default Image

Attachment ID or URL

Default image will display if the Listing does not have featured image added to it.

Listings Currency symbol

Any currency symbol

Show Currency after Price

True / False

Price Thousand Separator

None / Comma / Dot

Required Title

True / False

Required Content

True / False

Required Excerpt

True / False

Required Thumbnail

True / False

When checked, fields will make mandatory for a user to fill in these fields in a Listing.

Show Author Review Summary

True / False

Enable Ratings in Comments

True / False

Show Social Logins

True / false

Enables login via Nextend Social login plugin.

Root Category Slug

Category slug

This field should contain the slug of the main Listings category.

Settings Page Slug

Page slug

Bello has a unique way of enabling you to create custom templates for individual Listings item pages. You can create a static page, add content to it and set desired global settings overrides. Then you can use it as a template for Listings item pages.

Listing Packages Page Slug

Page slug

This field should contain the slug of the page that lists all packages. When the slug is added, the button ‘Get new package’ on My Account panel will link to that page.

Listing My Account Page Slug

Page slug

This field should contain the slug of the My Account page in order to allow listing creators to upload images to their listing galleries.

SECTION 07Single Listing

Settings for single listing pages.

Single List Header Layout

Standard / Standard and Review / Full Screen / Image and Map

Here you can define layout of the default headline in Single Listings. There are four layout options:

1. Standard

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/single-header-standard.jpg
http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/single-header-review.jpg

Gallery Type Design

Grid / Carousel

Here you can define if the image gallery in Listing items will display as a Grid or a Carousel.

1. Here you can see an example of Grid gallery:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/listing-gallery-grid.jpg

2. Here you can see an example of Carousel gallery.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/listing-gallery-carousel.jpg

Grid Gallery Columns

2 / 3 / 4 / 5 / 6

Here you can define the number of columns for grid gallery on Listing items. You can set the post grid gallery format by adding the images to the post in the settings panel and check the Grid Gallery setting.

Grid Gallery Gap

No gap / Small / Normal / Large

You can define gap between grid gallery items in pixels using this setting. If you choose 0, the images will be “glued” to each other without any gap in between.

Number of Nearby Listings

2 / 4 / 6 / 8 / 10

This field defines how many nearby listings will display in single Listings pages.

Nearby Listings from Category

Same as listing category / All listings categories

This field defines whether it will list nearby Listings from each category or from the same category as that Listing.

Enable Listing share on Facebook

True / False

Enable Listing share on Twitter

True / False

Enable Listing share on LinkedIn

True / False

Enable Listing share on Google Plus

True / False

Enable Listing share on VKontakte

True / False

Sharing options for Listings.

Use Dash in Headlines

True / False

SECTION 08Search Listings

Search settings for listings.

Listing Search Type

Ajax / Standard

Here you can define if the search results will load through AJAX, or use a standard page reload on each click.

Search Pagination

Ajax Load More / Standard Pages

Default Listing Results Layout

Grid view / List view

Here you can define if the search results page will display listings as a grid or standard list.

Listings Results Grid Layout Columns

1 / 2 / 3

Number of grid columns on search results page.

Listings Per Page

Any number

Autocomplete Search Location

True / False

Here you can define if the searches will autocomplete or not (requires API Key and https).

Show Subtitles in Listing Search Result

True / False

Display listing’s subtitle in search result page.

Default Radius Value

Any number

Search Distance Max Value

Any number

Defines maximum value for Distance slider on the Search Listings page.

Search Distance Unit

Miles / Kilometers

SECTION 09Listing Map

On Listing Map settings panel you will find the following options:

*Note that, in order for the nearby listings to appear properly, and to be able to see listings based on geolocation, your site needs to use HTTPS protocol.

Choose Search Layout

With Map / Without Map

There are two options for search archive layout:

1. With Map
2. Without Map

Google Map Localization

Any Language

Select the language in which you would like to show Google Map.

Google Map API Key

API key

Please refer to the following article on how to get API key –  Get your API key.

In order to be able to fully use all Bello theme’s Google Map features, once you get an API Key, you need to enable four different API services on Google Cloud.

Please enable the following services:

1. Places API – enable this API to use autocomplete search by locations in the search shortcode or main listing search – https://developers.google.com/places/web-service/intro.

2. Geocoding API – to convert the position by longitude and latitude and calculate distance from the visitor and listing location. This is the process of converting addresses (like “1600 Amphitheatre Parkway, Mountain View, CA”) into geographic coordinates (like latitude 37.423021 and longitude -122.083739), which you can use to place markers on a map, or position the map – https://developers.google.com/maps/documentation/geocoding/start.

3. Maps Javascript API – To fully utilize google maps search, customization, etc. It lets you customize maps with your own content and imagery for display on web pages and mobile devices. The Maps JavaScript API features four basic map types (roadmap, satellite, hybrid, and terrain) which you can modify using layers and styles, controls and events, and various services and libraries – https://developers.google.com/maps/documentation/javascript/examples/.

4. Directions API – It’s a service that calculates directions between locations – https://developers.google.com/maps/documentation/directions/start.

Google Map Default Zoom Level

Any number

If there is only one location available, the map will be adjusted to that zoom level. The higher the number, the more will single location be zoomed in.

Default Latitude Value

Latitude value

Default Longitude Value

Longitude value

These fields should contain longitude and latitude of starting location, from which the radius will be calculated.

Google Map Pin

Attachment ID or URL

Google Map Pin Selected

Attachment ID or URL

Pins that will display when map location is not selected, and when it’s selected.

Custom map style array

Map code

On Snazzy Maps are available all kinds of Google Map styles. The required map code is possible to add to the Custom map style array field.

SECTION 10Shop

These settings are used with WooCommerce plugin.

Share on Facebook

True / False

Share on Twitter

True / False

Share on Google Plus

True / False

Share on LinkedIn

True / False

Share on VK

True / False

Sharing options for single products. If checked, the share icons will be present in products.

Use Dash in Headlines

True / False

Bello offers two types of headlines on blog archive pages and individual post pages. Header with the dash and header without it.

Check to use dash separator in headlines.

Settings Page Slug

Page slug

Bello has a unique way of enabling you to create custom templates for individual product pages. You can create a static page, add content to it and set desired global settings overrides. Then you can use it as a template for individual product pages.

The field Setting page slug should contain the slug of your page which serves as a template for WooCommerce products. Once you add the slug to this field, all shop items will inherit settings and shortcodes of the referenced page.

So, in order to change template elements on individual product pages, please locate the page with the slug entered in Settings Page Slug field and edit it.

SECTION 11Translation

In order to translate the theme, please follow the next steps.

POT file is in languages folder. You can use Poedit or some similar tool to translate the theme. Keep your .po and .mo files in the same folder (languages). If you are not sure how to do it take a look at the article: How to Translate a WordPress Theme.

Also, make sure to translate the Bello plugin as well. Repeat the steps as for the theme.

SECTION 12Child Theme

If you want to use Bello Child Theme, please follow these steps:
  1. First of all, make sure that parent theme folder is named: bello. Otherwise rename the folder.
  2. You should be able to find the folder bello-child in the package you have downloaded from ThemeForest.
  3. Please copy this folder to /wp-content/themes folder on your server.
  4. Go to Appearance > Themes in your wp-admin console and activate child theme. Please have in mind that all required plugins need to be activated.

For more info, refer to the article Child Theme.

SECTION 13One Page Site

In order to create one page site, please follow the instructions below:

The best way to start is to install demo content. If you want to install one page demo please refer to the article: Installing Demo Content. You will be able to see how all elements on the single page are set.

1. First of all, navigate to the Bold Page Builder and edit desired section. Insert in required Custom Tab Element ID attribute:

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2017/11/7550172792.jpg

2. Then in Appearance > Menus add a new Custom Link and as a URL insert custom ID atribute with #.

For example: #about

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2017/11/Screenshot_2.jpg

SECTION 14Update Theme

In order to update the theme, please follow the instructions below:

First, please make sure to download newest theme version from ThemeForest Download section.

Then, proceed to replace the old theme files with the new ones on your server via FTP (provided you haven’t made any changes in the source code. If you did, please reapply them to the new version of the theme or they will be lost).

Keep your eyes on potential required plugin update messages at wp-admin dashboard once you replace the files. You should update all required plugins if the updated theme suggests so.

All settings in Customize panel and your content will be preserved.

Note: Once new theme version is online, user who purchased the theme, should get email note from the Envato (ThemeForest).

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2017/11/update-theme-preview.png

SECTION 15Listing Comment Attachment

Adding images to comments in individual listings.

Listing Comments Attachments panel is located in Settings > Discussion.

The settings allow you to enable or disable comments’ attachments, and set the number of attachments to upload and number of attachments in comments view.

Available file types are JPG, PNG, and GIF.

http://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/08/bello-comments.jpg