Skip to content

First steps after activating the theme

If you’re performing a fresh installation of the theme, upon activation you’ll be redirected to the theme’s welcome page where you’ll find a quick start guide to get your theme up and running, a collection of useful F.A.Q. and a list of the major theme features.

An help page containing the quick start guide and all of the F.A.Q. will always be available by clicking on the "Help" link in the upper right hand corner of the "Appearance > Theme Options" and "Appearance > Framework settings" pages.

Theme options are organized in tabs, each one of them covering a specific section or function of the website, and each option contained in a tab often comes with a little help text to clarify its usage.

If you want to return to the main options panel at a later time, you can find it under Appearance > Theme options, in the WordPress admin side menu.

Required plugins

A notice message above the theme options page will let you know what plugins are required for the theme, and give you a quick way to install or activate them.

If you want to access the suggested plugins page for the theme at a later time, you can find it under Appearance > Install Plugins, in the WordPress admin side menu.

Suggested plugins

A notice message above the theme options page will let you know what plugins are suggested for the theme, and give you a quick way to install or activate them.

You can dismiss the suggested plugins message by clicking on the "Dismiss this notice" link inside the message box.

If you want to access the suggested plugins page for the theme at a later time, you can find it under Appearance > Install Plugins, in the WordPress admin side menu.

The theme has been designed to work best with the following plugins:

After the activation of the WooCommerce plugin a new tab specific for the plugin will be created in the "Theme options" panel with some dedicated options.

If you need assistance concerning the manual installation of plugins, you can refer to the official WordPress Codex page.

How to replicate the demo content

To load the demo content in your website, make sure to install the official WordPress Importer plugin.

After the plugin has been installed, go to the "Tools > Import > WordPress" page, and upload the dummy content XML file provided in the theme package.

Pub demo

To import the dummy content of the Pub demo, go and use the XML file you can find in the "Dummy/pub demo" folder of the main theme package you’ve downloaded.

After that, you’ll also need to import the provided backup file in the same folder, that sets up a series of global settings and customizations. You can do so by uploading the thb-dummy-pub.thb-backup file using the control located under Appearance > Framework settings > Import in the WordPress administration.

Restaurant demo

To import the dummy content of the Restaurant demo, go and use the XML file you can find in the "Dummy/restaurant demo" folder of the main theme package you’ve downloaded.

After that, you’ll also need to import the provided backup file in the same folder, that sets up a series of global settings and customizations. You can do so by uploading the thb-dummy-restaurant.thb-backup file using the control located under Appearance > Framework settings > Import in the WordPress administration.

After the dummy content has been uploaded, you’ll need to associate a menu to the theme defined menu locations (the main menu is usually called "Primary").

You can then set a static page to be your website’s home: head over to the "Settings > Reading" options panel, then choose your new front-page from the "A static page" select option.

How to update your theme

Important: before beginning the update procedure, make sure to make a backup of the theme folder inside your WordPress themes folder, located in /wp-content/themes/your-theme.

Also, before downloading the updated package, make sure to read the version changelog and the list of changed files.

We strongly suggest to use the provided child theme, as it would not break the theme compatibility with future updates.

When updating, or when switching from a previous WordPress installation, we warmly recommend that you regenerate the theme’s Media Library items thumbnails: you can do that automatically, using a plugin like "Force Regenerate thumbnails". Unused image sizes will also be cleared from your media library.

Note
We suggest to use a plugin like "Easy theme and plugin upgrades" that can upgrade easily your theme and optionally make a backup.

If you want to manually upgrade your theme you can follow these guidelines:

To update the your theme, re-download the theme, extract the zip file’s contents, find the extracted theme folder, and upload it using a FTP client to the /wp-content/themes/your-theme folder in your server. Beware: this will overwrite the old files! That’s why it’s important to backup any changes you’ve made to the theme files beforehand.

If you didn’t make any changes to the theme files, you are free to overwrite them with the new files without risk of losing theme settings, pages, posts, etc. Backwards compatibility is guaranteed.
If you have made changes to the theme files, you will need to compare your changed files to the new files listed in the changelog below and merge them together.

Update plugins

How to update our plugins:

In order to update a plugin bundled with our theme (for example "THB Portfolio") you’ve to follow these steps:

  1. Go to "Plugins > Installed plugins"
  2. Deactivate the plugin (for example "THB Portfolio")
  3. Delete the plugin
  4. Go to "Appearance > Install plugins" and install the required plugin (for example "THB Portfolio")
  5. Activate the plugin

You can then check that the version number has changed in the "Plugins > Installed plugins" page.

You can view a quick video about "how to update a plugin" on our YouTube channel.

Options presets

Upon installing the theme, a series of presets is automatically loaded. This presets include general theme options and the demo skin.

If you want to backup your options and import them at a later time, please refer to the "Framework settings" section of this document.

Refresh the website’s permalinks

In order to avoid 404 errors, we suggest that you refresh the website’s permalinks. You can do so, by going to the Settings > Permalinks page, and hit "Save changes".

Regenerating the media library thumbnails

This theme supports custom image sizes. Newly uploaded images are automatically resized, while previously uploaded ones aren’t.

If you come from a previous installation and have images in your Media Library, we warmly recommend that you regenerate the theme’s Media Library items thumbnails upon the theme installation or activation: this ensures that images used in the theme are sized properly according to the theme specifications.

To batch resize images in your Media Library according to the theme image sizes, you can use a plugin like “Force Regenerate thumbnails”. Unused image sizes will also be cleared from your Media Library.

Setting up the home page

By default the home page will display your latest posts. If you want to set a specific page to be your home page, you can do that in the WordPress reading settings (Settings > Reading), choosing the "static page" option.

In the WordPress reading settings (Settings > Reading) page, we recommend to leave the "Posts page" option under "Front page displays" set to blank, in order to avoid pagination isssues.

Images

Images will be imported into the Media library when you upload the dummy content xml.
All images are from Unsplash licensed under CC0 license

Image sizes

The theme define several image sizes that you can find in the config/config-general.php file:

  • add_image_size( ‘micro’, 80, 80, true ); // Used for related posts
  • add_image_size( ‘thumbnail’, 130, 130, true ); // system image size used also on page/post builder blocks and the food menu item
  • add_image_size( ‘large’, 930, null, true ); // system image size used also on page/post builder blocks and in the single attachment page
  • add_image_size( ‘large-cropped’, 930, 580, true ); // system image size used also on page/post builder blocks and in the single attachment page cropped with a 16:10 proportion
  • add_image_size( ‘medium’, 610, null, true ); // system image size used also on page/post builder blocks
  • add_image_size( ‘medium-cropped’, 610, 380, true ); // system image size used also on page/post builder blocks cropped with a 16:10 proportion
  • add_image_size( ‘full-width’, 1600, null, true ); // Used by the header extended and the blog extended layout

  • add_image_size( ‘grid-large’, 400, null ); // used by the grid layouts (photgallery, portfolio) on 3 and 4 columns configuration with the "variable" height option set
  • add_image_size( ‘grid-large-cropped’, 400, 400, true ); // used by the grid layouts (photgallery, portfolio) on 3 and 4 columns configuration with the "fixed" height option set
  • add_image_size( ‘grid-small’, 300, null ); // used by the grid layouts (photgallery, portfolio) on 5 columns configuration with the "variable" height option set
  • add_image_size( ‘grid-small-cropped’, 300, 300, true ); // used by the grid layouts (photgallery, portfolio) on 5 columns configuration with the "fixed" height option set

If you’d like to learn more about the add_image_size function, you can do so by reading its Codex page.

Please note that if you need to modify a specific image size value, or you’re experiencing weird looking blurred images (especially when using full width backgrounds or slides), you must remember to regenerate your Media Library thumbnails. You can do that automatically by using a plugin like "Force regenerate".

Retina support

The theme supports retina images out of the box only for the website’s logo, the splash page logo and the page loader logo. If you have other needs concerning the appearance of images in devices with higher density, you can use a plugin such as WP Retina 2x.