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.

https://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:
https://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.
https://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.

https://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.

https://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).

Deafult Headline Supertitle Outside of H Tag

True / False

Select if supertitle in default headline will be in H tag or not.

Template skin

Dark / Light

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.

https://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.

https://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.

https://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 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.
https://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/site-identity.jpg

You’ll see the changes in the preview panel 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.

https://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.

https://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.

https://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:

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

2. Soft Rounded:

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

3. Square:

https://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.

https://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:

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

Here is the example of columns layout:

https://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 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

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/31/2018/03/single-header-standard.jpg
https://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:

https://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.

https://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

Show only _listing_root category

True / False

Check this field if you want to show only custom fields from root category, when ‘All Categories’ in search form is selected.

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.

Show Distance – Enables Distance to be shown for Listings

True / False

Select if you want to show distance in the listing box on search listings page.

Default Radius Value

Any number

Search Distance Max Value

Any number

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

Set Distance Slider value

True / False

This option allows you to set whether you’ll show maximum distance on 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

Choose Map Type in the Frontend

Google Map / Leaflet Map / OpenStreet Map

Select if you’ll show Google, Leaflet, or OpenStreet map on frontend.

Google Map Localization

Any Language

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

Choose Google Map Type in Listing Single View

Static Map / Dynamic Map

Select the type of Google map in single listing view. Static Map displays google map generated image with integrated pin, while Dynamic Map displays map widget with full google maps options.

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.

Enable Google Map Default UI

True / False

Enable Google Map Full Screen Control (if Default UI disabled)

True / False

Enable Google Map Scroll Wheel Zoom (if Default UI disabled)

True / False

Enable Google Map Street View Control (if Default UI disabled)

True / False

Enable Google Map Zoom Control (if Default UI disabled)

True / False

Enable Google Map Type Control (if Default UI disabled)

True / False

Enable Google Map dragging (if Default UI disabled)

True / False

Enable Google Map controls on the frontend.

Custom Google 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.

Hide Google Map Features

JS code

Hide Google Map features style in the Listing Search with Google Map. More info can be found on the following link.

Choose OSM and Leaflet Map Style

Custom OSM Style / Style 1 - Mapnik OSM / Style 2 - Wikimedia / Style 3 - OSM Hot / Style 4 - Stamen Watercolor / Style 5 - Stamen Terrain / Style 6 - Stamen Toner / Style 7 - Carto Dark / Style 8 - Carto Light

Set a OSM and Leaflet Map Style by choosing one of the predefined ones.

Custom OSM Map Style

Custom map URL

Set a custom OSM map style by using a custom map URLs. More info can be found on the following link.

SECTION 10Shop

These settings are used with WooCommerce plugin.

Share on Facebook

True / False

Share on Twitter

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 11Listing 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.

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

HOW TO 01Translation

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

Theme’s .pot file is located in /wp-content/themes/your-theme-name/languages folder.

Please use PoEdit – https://poedit.net/ to translate the .pot file and create respective .po and .mo files.

Please name .po and .mo files e.g. potname-nl_NL.po and potname-nl_NL.mo (nl_NL is the language code for dutch and potname is the name of the .pot file you have started from – it corresponds to text domain of the theme). For other languages’ codes, please refer to the following link: Internationalization.

In order to place .po and .mo files properly and not have them deleted when you update the theme, upload  them to \wp-content\languages\themes folder. If you don’t have languages folder in your wp-content directory, please proceed and create one. Then create themes folder, and paste the files in it.

Alternatively, you can upload the .po and .mo files to your theme’s /wp-content/themes/your-theme-name/languages folder. In that case name them only using the language code (for example nl_NL.mo and nl_NL.po)

Also make sure to translate the theme’s plugin .pot file, located in \wp-content\plugins\your-theme-name\languages folder.

The steps are the same as for the theme, except the files should be named bt_plugin-nl_NL.po and bt_plugin-nl_NL.mo (with appropriate language code).

For plugin’s .po and .mo files, you should place them in \wp-content\languages\plugins folder.

You can set the site language of your WordPress installation on Settings > General. WordPress will automatically use the right language files if they exist.

HOW TO 02Child Theme

If you want to use Child Theme, please follow these steps:
  1. First of all, make sure that you haven’t changed the parent theme’s folder name. It needs to remain the same.
  2. You should be able to find the folder your_theme_name-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.

HOW TO 03One 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:

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2021/06/one_page_01.jpg

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

For example: #about

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2021/06/one_page_02.jpg

HOW TO 04Update Theme

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

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

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2021/06/update-theme-preview.png

There are three ways to update the theme:

1) FTP Update

Download newest theme version from ThemeForest Download section. Since you already have the theme installed, you can download just ‘Installable WordPress file only’.

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2021/06/theme-forest-download.jpg

In case you want to use this method, we suggest that you use Filezilla to access your server. Here is the article that explains how Filezilla works.

You need to extract theme file from the zipped folder you downloaded, and upload it to /wp-content/themes folder on your server. You will be prompted to overwrite the existing files. Select ‘Yes’, and the theme will update.

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2021/06/update.jpg

*The example is the zip file from Medicare theme but the process is the same for all themes.

2) Update theme via ZIP file upload

This method is available since WP version 5.5. Please follow these steps:

  • From WP dashboard go to Appearance > Themes,
  • Click Add New button,
  • Click Upload Theme button,
  • Click Choose File to select previously downloaded zip archive, then click Install Now,
  • Wait for the upload to finish, then click Replace current with uploaded button.

3) Envato Market plugin

Enable automatic theme update with the Envato Market Plugin. Once you install and activate this plugin, every time a new theme version becomes available, you will be able to update it with just one click.

You will need to go to the WordPress Updates page and navigate to the Themes section. The new version will be included in the section just like the themes from the WordPress repository.

* Whichever of these three methods you use for theme update, you will have to update theme plugin (and possibly some other required plugins) as well.

For plugin updates, you will get notification on your dashboard when new version is available.

Please note…

If you made any changes in the source code you’ll need to reapply them to the new version of the theme or they will be lost.

To prevent this, you can use child theme.

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

HOW TO 05RTL Support

In order to ensure that the theme you purchased / want to purchase is RTL supported, you can check on our themes’ profiles on ThemeForest.

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2023/04/rtl-support.png

These themes have CSS defined for RTL layout, so when you change site’s language in Settings >General on your dashboard (or via language switch if you have multilingual site), the RTL layout will automatically apply to certain elements.

However!

Some elements in Bold Builder that have alignment option (such as Icons, Images, Columns, etc…) will need to be rearranged manually to fit the RTL layout.

https://documentation.bold-themes.com/bello/wp-content/uploads/sites/65/2023/04/rtl-align.png