Getting Started

First of all, thank you for purchasing Byblog WordPress theme. We would also like to congratulate you on your purchase and we hope that this will boost up your business!

This documentation covers the installation, usage and customization of theme in detail. The main aim of this documentation is to walk you through the various salient features of the theme and how to install and use them. We have covered everything in as much detail as possible. However, if you still need assistance with something that is not covered here, do not hesitate to contact us, we will be happy to help you.

Theme Requirements

To use this theme, you need the latest version of WordPress. If you are running older version of WordPress, we recommend you to update it to latest version to avoid any issues. If you don't already have WordPress, you can download it from official WordPress website.

Recommended Image Size

Image size depends on type of layout and featured sections you are using throughout your WordPress website. Post images are required not only for showing on posts but also on slider and other featured sections and widgets.

Minimum 1170x585 If you are using full width layout or slider as featured section
Minimum 835x412 If you are using standard layout without slider
Note: If you are going to use this theme on an old blog or website with existing content, then the first thing you need to do is, install the Force Regenerate Thumbnails WordPress plugin. Then go to Tools -> Force Regenerate Thumbnails.

Theme Installation

A WordPress theme is easy to install. Installation includes two steps - Uploading the theme and theme activation. You can either upload the theme ZIP file using WordPress dashboard (Recommended) or you can upload the unzipped theme folder using FTP. Once the theme is uploaded, you can easily activate it from WordPress dashboard.

Install Theme

Download your purchased theme ZIP file and extract it. In the extracted folder, you will find another ZIP file called byblog.zip. The is the file that you need to upload using any of the following 2 methods.

Method 1: Using WordPress Dashboard

This is the recommended and easy way to install the theme. Here are the steps you need to follow.

  1. Login to your WordPress admin panel.
  2. Now navigate to Appearance -> Themes.
  3. Click on Add New button at the top.
  4. Click on Upload Theme button.
  5. Click on Browse and select the byblog.zip file from within the extracted folder
  6. Click on Install Now button.
  7. Wait for the upload process to finish and then click on Activate.

Method 2: Using FTP

If, for any reason, you like to install the theme using FTP, here are the steps you need to follow.

  1. Extract the byblog.zip file into a folder.
  2. Sign in to your web server using FTP client.
  3. Now upload the extracted folder to /wp-content/themes/ directory.
  4. Once the upload process is complete, navigate to Appearance -> Themes.
  5. Now look for Byblog and click on Activate.

Install Plugins

The theme requires and recommends few plugins to install.

Required plugins are:

  • Redux Framework: For adding theme options
  • Meta Box: For adding custom post options

Recommended plugins are:

  • Envato Market: For updating the theme
  • One Click Demo Import: For importing theme demos
You can disable the One Click Demo Import plugin after importing the demo data.

Here are the steps to follow to install these plugins:

  1. Immediately after activating the theme, you will be given a notification to install the plugins. Click on Begin installing plugins to start the installation process.

  2. Select all the plugins you wish to install. Now from the Bulk Actions dropdown menu, choose Install and click on Apply button.

  3. All your selected plugins will be installed. Now again select the plugins and from Bulk Actions dropdown menu, choose Activate.

Updating the Theme

Theme can be either updated automatically (Recommended) from WordPress dashboard or manually.

Method 1: Automatic Updates with Envato Market plugin

The Envato Market plugin is required to update the themes and plugins purchased from ThemeForest and CodeCanyon using your WordPress dashboard. Once installed and details are added, it becomes easier to update the themes and plugins.

  • Download and install the Envato Market plugin.
  • Activate the plugin and you will see Envato Market link in your WordPress dashboard.
  • Navigate to Envato Market page and follow the instructions there to generate your Global OAuth Personal Token.
  • Once Global OAuth Personal Token is generated, copy and paste it in your WordPress dashboard.
  • Now you can see all items purchased from Envato Marketplace on Envato Market page.

Method 2: Manually Update the Theme from Dashboard

We don't recommend this method but if you wisth to manually update the theme, you can follow the following steps.

  • Deactivate and delete the current version of theme.
  • Download latest version of theme from your ThemeForest account.
  • Upload the latest version in the same way as you installed the theme for first time and then activate it. Now you have the latest version of the theme.

Method 3: Manually update the Theme using FTP/SFTP

This method is also not recommended but it is possible to update the theme using FTP/SFTP. This method is preferred if you wish to replace only a few files in theme's folder.

  • Download the latest version of theme from ThemeForest
  • Now connect to your server using FTP/SFTP.
  • Browse the wp-content/themes/ directory and replace the theme files there.

Setup Demo Data

Installing the theme demo is really easy. With just one click, you can make your website look similar to the demo.

Your website may not look exactly like the demo if you are importing the demo content on an old website with content. Therefore, it is recommended to install the demo content on a clean installation.

This theme uses One Click Demo Import plugin to import the theme demo content. This plugin is already installed on your server if you had installed all the required and recommended plugins.

Before proceeding with demo import process, it is recommended to create a backup of your site. So if anything goes wrong during the process, you can easily restore your website.

To install the demo content, follow the steps given below:

  1. Once you have installed and activated the theme and all the required plugins, go to Appearance -> Import Demo Data.

  2. Select your preferred demo and click on Import button.

  3. Click on Yes, import! button for confirmation.

  4. Wait for some time and demo data will be imported.

  5. You will see the message when demo data is imported.

Theme Options

All the options to customize this theme are found in Theme Options panel. To access the theme options, go to Dashboard -> Theme Options and start customizing your theme. Theme Options link can be found at bottom left corner of your WordPress dashboard. You can make style changes, change typography settings, control ads and do many more things.

After making changes, do not forget to click on Save Changes button at the top right corner of options panel, else your changes will not be saved.

General Settings

In this section, you can change the following settings.

Custom Logo Upload your own custom logo
Retina Logo Upload logo for retina displays
Pagination Type Posts on blog page or archives pages are divided into pages. Pagination is used to access other pages. You can select the numbered or next/previous style pagination.
Scroll to Top Button Use this option to show or hide the scroll to top button.
Lightbox Here you can enable or disable the lightbox effect for images.
Facebook Open Graph Tags Turn on the Facebook Open Graph tags.
RTL Language Click the Yes button if your blog is in RTL language
Remove Emoji Support WordPress adds support for emoji smileys by default. Choose this option to remove support for emoji to slightly improve the performance of your blog.

Layout Settings

In this section you can change the layout of theme.

Responsive Layout

Using this option, you can enable or disable the responsive layout. Responsive layout is enabled by default. When this option is disabled, your website will look like its desktop version on mobile devices.

Layout Type

Choose between boxed or wide layout. By default wide layout is enabled. In boxed layout, site content including header and footer is shown in fixed width and is aligned to center. In wide layout, header and footer are spread over full width of screen.

Homepage Layout

Homepage layout option is applied to recent posts shown on front page of your blog. 8 blog styles are available to choose from in this theme. With just a click, you will get different style for your blog.

Archives Layout

Using this option you can change layout of archives pages. Categories, tags, author, month, date, year are all examples of archives pages.

Search Results Page Layout

Using this option you can change layout of search results page.

Single Layout

This option is applied to detail posts of your website or blog. You can choose right sidebar, left sidebar or no sidebar layout for detail posts.

Styling Options

In this section, you can make all the changes related to style like text color, background color, border color. All styling options are divided into sections for easy navigation.

Styling options section is further divided into sub-sections.

1. Primary Color

In this section you can change the primary color of theme.

2. Body

In this section you can change body background color and image.

Body Text Color Change background color of body
Body Background Using this option you can change background color and background image of body
Background Pattern This theme comes with some patterns for your use. You can choose any pattern to use as body background

3. Navigation Menu

In this section you can style primary menu, top menu and mobile menu.

Navigation Background Color Change background color of navigation menu
Navigation Link Color Change color of links of navigation menu
Mobile Menu Button Color A button is shown in header when on mobile phones to access the mobile menu. Using this option, you can change the color of this button.
Navigation Menu Margin Change distance from top and bottom of main navigation menu.

4. Header

In this section you can change color and background properites of site header.

Header Background Change background color and background image of site header
Logo Margin Change top and bottom margin of logo
Logo Color Change color of text logo
Header Tagline Color Change color of tagline

5. Content

In this section you can change color and background properites of posts.

Posts Main Text Color Change text color of post content
Posts Meta Color Change color of meta elements of posts
Posts Title Color Change color of posts title
Page Title Color Change color of page title

6. Sidebar

In this section you can change color and background properites of sidebar.

Sidebar Widgets Text Color Change text color of sidebar widgets
Sidebar Widgets Link Color Change links color of sidebar widgets
Sidebar Widgets Meta Color Change color of meta elements of posts of sidebar widgets
Sidebar Widgets Title Color Change color of widgets titles

7. Footer

In this section you can change color and background properites of side footer.

Footer Background Color Change background color of site footer
Footer Link Color Change regular and hover color of links of site footer
Footer Widget Title Color Change title color of footer widgets
Credit/Copyright Background Color Change background color of copyright area of footer
Credit/Copyright Text Color Change text color of copyright area of footer

Custom CSS

If you want to make some CSS changes to your blog or website, you can add your CSS code here.

Never edit your theme files for any changes. For making small CSS changes, you can add them in Custom CSS option and for making complex CSS or other changes, always use child themes. If you edit theme files, you will lose the changes once you update the theme.

Typography

This section controls the typography options of theme. You can change font family, font size, font weight and other settings related to typography.

Body Font

This option applies to body of the website.

Main Navigation Font

This option applies to main navigation menu.

Headings Font

This option applies to all the headings of theme.

Post Title Font

This option applies to post title.

Post Content Font

This option applies to content of posts and pages.

Post Meta Font

This option applies to post meta (post author, post comments etc).

Widget Title Font

This option applies to widget titles.

Sidebar Widgets Font

This option applies to sidebar widgets text.

Logo Font

This option applies to text logo in header.

Home

This section controls the blog page that shows most recent posts and also the archives pages. Blog page is the front page by default but it can be set to a different page from settings. Archives pages are category, tag, author pages.

Following options are avaiable for blog page:

1. Home Content

By default post excerpt is shown on main blog page but you can use this option to show full post content. You can choose None option to hide the content.

1.1) Show Latest Posts by Category

By default main blog page shows most recent posts of your blog. Choose this option if you want to relpace most recent posts with posts from selected category/categories. When you click the Yes button, you will see option to select the categories.

1.2) Home Content Type

Choose what you want to show on homepage - Post excerpt or Full post content. By default post excerpt is shown.

1.3) Excerpt Length

Excerpt Length option controls the length of post excerpt shown on blog and archives pages. This option shows only when Excerpt is chosen in Home Content Type option.

1.4) Read More Button Text

Here you can change the read more button text.

2. Post Meta

Use this option to show or hide all or selected post meta items.

3. Share Buttons

In this sub section you can find options related to social share buttons for blog and archives pages.

3.1) Share Buttons

Use this option to show or hide social media share buttons on your posts on blog and archives pages.

3.2) Select Share Buttons

Use this option to select the social share buttons that you want to show on posts. You can also rearrange the position of buttons. Click the checkbox next to button name to show or hide the button and drag the move icon on right side to rearrange the position of button.

Featured Section

Byblog has a beautifully designed slider that is used to highlight the best posts of your blog. You can also show custom slides in the slider if you don't want to show the posts.

Slider is shown only on homepage and main blog page of your blog.

Show Slider

Click the Show button to show the slider and Hide button to hide the slider.

Slider Width

As per your pereference you can choose full width or boxed slider.

What to show in slider

You can show custom slides, posts by categories, selected posts or latest posts in slider.

  • Custom Slides: When this option is selected slides option will appear.

    • Slides Options: Using this option, you can add custom slides to the slider. Options as shown in following screenshot are available for custom slide.

  • Posts by Category/Categories: When this option is selected, the following options will appear:

    • Slider Category: Use this option to choose category or categories for slider.
    • Number of Slider Posts: You can control number of posts that you want to show.
    • Post Meta: Choose which post meta items you want to show.
  • Selected Posts: When selected posts option is chosen the following options appear:

    • Select Posts: Using this option you can manually select the posts for slider.
    • Post Meta: Choose which post meta items you want to show.
  • Latest Posts: Choose this option to show most recent posts of your blog in slider. When this option is selected the following options appear:

    • Number of Slider Posts: You can control number of posts that you want to show.
    • Post Meta: Choose which post meta items you want to show.

Single Post Options

Single Post section provides options that applies to detail post page of your blog.

Single post is the page that opens up when you click on the post title or thumbnail on blog page or in widgets.

Single Posts Layout

Using this option you can show or hide different post elements and you can also rearrange their position. To hide an element drag that element to disabled side. To rearrange the position of elements, simply drag and drop the elements at respective postions.

Breadcrumbs

Use this option to show or hide breadcrumbs on pages.

Show Featured Content

Use this option to show or hide featured content on posts. Featured content is shown before post content on all posts. Different post formats have different featured content. It is shown in table below:

Post Format Featured Content
Standard Featured Image
Audio Audio Player
Video Video Player
Image Featured Image
Quote Quotation
Link Link Box
Status Facebook or Twitter Status
Aside Featured Image

Single Post Meta

Use this option to show or hide the post meta on detail posts. Post meta includes poat author, post date, post category, post tags, post comments count.

Number of Related Posts

Control the number of posts to be shown as related posts.

Filter Related Posts By

You can show related posts by categories, tags or author.

Social Media Share Buttons

Use this option to show or hide social media share buttons on your posts to let users easily share your content.

Select Share Buttons

Easily select which share buttons you want to show by clicking on eye button in front of button name. You can also drag and drop the button on right side to rearrange the button position.

Ad Management

This section controls different ad positions and ad blocker feature available in this theme.

Ad below Content and Sidebar

This ad is shown below main container and above footer on all pages.

Blog and Archives Ad Code

This ad is shown on blog and archives pages. You can choose after how many posts you want to show the ad.

Header Ad

This ad is shown in site header.

Note: Header ad is shown only in header style 1.

Below Post Title Ad

This ad is shown below psot title and before post content on detail post pages.

Below Post Content Ad

This ad is shown below post content on detail post pages.

Social Profiles

In this section, you can add links to your social profiles. Social icons can be shown in header and footer area of the theme. You can show social links in site header from Header options and to show them in site footer, go to Footer options.

Image Sizes

In this section, you can manage the size of entry and widget images.

1. Crop Featured Images Clicking on Yes button will crop the featured images to fit them properly in the featured image area. When you click the No button, original size of images will be used as featured images.
2. Entry Image Width Using this option, you can resize the width of featured images of posts shown in blog and archives pages.
3. Entry Image Height Using this option, you can resize the height of featured images of posts shown in blog and archives pages.
4. Widgets Thumbnail Width Using this option, you can resize the width of featured images of posts shown in widgets. Only small size images are affected with this change.
5. Widgets Thumbnail Height Using this option, you can resize the height of featured images of posts shown in widgets. Only small size images are affected with this change.

WooCommerce

This theme supports WooCommerce plugin. Following options are available for WooCommerce.

Shop Layout

You can choose a layout for shop pages that is different from blog pages.

Number of Products

Here you can control the number of products to be shown on shop pages.

Cart Icon on Header

Using this option you can show or hide the shopping cart icon in site header.

Import/Export

In this tab of Theme Options panel, you can import and export the settings of theme options panel. When you change some settings of theme and want to import the same settings on other website, you can export the settings from here.

Theme Customizer

Some of theme's settings are controlled through theme customizer. To access the theme customizer go to Appearance -> Customize.

After making changes, do not forget to click on Save & Publish button at the top right corner, else your changes will not be saved.

Site Identity

In this section, you can basically change settings related to site's identity and these settings are:

Site Title

You can change your site title here. Site title appears in title bar of the browser and also in place of logo if you haven't added the custom logo.

Tagline

Change your site tagline here.

Site Icon (Favicon)

Change your site icon here. It is also known as favicon and it appears in the page title bar in browser.

Menus

In the menus section, you can create menus, add items to menus, add menus to different locations but we recommend you to do all these from Menus page. Everything about menus is explained in further section in this documentation.

For detailed instructions on how to add, edit, remove or rearrange menu items, go to Menus Section.

Widgets

In this section, you can add widgets to widgets areas, change options of already added widgets, remove the widgets or reorder the postion of widgets.

To add a widget, go to Widgets section and select any widget area where you want to add the widgets. Now click on Add a Widget and select the widget from widget list.

For detailed instructions on how to add, edit, remove or rearrange widgets, go to Widgets Section.

Static Front Page

When you activate the theme, by default it shows most recent posts. You may want to use a static page as your front page (homepage).

Navigate to Static Front Page section and select the A Static page option. Now select the page from dropdown that you want to set as front page.

Use the Posts page dropdown to change the blog page of your website.

You can find detailed information about creating static front page on WordPress codex.

Additional CSS

In this section, you can add custom CSS and see the changes live as you add the code.

Adding CSS here is recommend only if the changes are minor. For complex changes you must always use a Child Theme.

Widgets

Byblog comes with 5 widget areas and it offers 21 custom widgets to add different features and functionalities to theme without using any plugins or editing the code of theme. All the widgets have little description to make you understand the usage of widget.

You can change the column count of footer widgets using WordPress customizer.

WordPress makes it really easy to add, remove or reorder the widgets with just drag and drop. Procedure is given in the following sections.

Adding Widgets

To add a widget, go to Appearance -> Widgets and click on any widget that you want to add. Now select the desired widget area where you want the selected widget to appear and then click on Add Widget. You can also simply drag and drop the widget to desired widget area.

Now refresh your website and you will see your added widget.

Removing Widgets

To remove a widget, go to widget area and click the down arrow on right side of widget name. Now you will see Delete text written in red color at the bottom of widget options. Just click on it and it will be removed.

Reorder Widgets

To reorder a widget, simply click and drag it to new position or widget area.

Post Management

To create your first post, navigate to Posts -> Add New and start writing it.

Categories and Tags

It is possible to divide posts into categories and tags and you can add categories and tags to posts here. It can be found at right side of post editor.

This theme uses Featured Image option of WordPress to add featured images to posts. To add a featured image to a post, go to Posts -> Add New and you will see a box with title Featured Image at the bottom right corner of the screen. Click on Set featured image to upload an image there.

Post Formats

Byblog supports 9 post formats and each post format has its own set of options. You can choose any of these post formats while creating your posts. These post formats are listed below:

Options for each post format appears at the end of post editor.

Standard Post Format

Standard Post Format is the default post format and the options as shown in following screenshot are available for this post format.

Check the Hide Featured Image option if you want to hide it from single posts.

You can choose Gallery Post Format when you want to show some images in gallery format on top of post. Gallery images can be shown in slider or tiled format.

Click on Gallery radio button and the options as shown in following screenshot will appear at bottom of post editor. Upload your images and choose gallery type.

Check the Hide Gallery option if you want to hide it from single posts.

Link post format is used when you want to add link to another website or to webpage on your own website and you also want to highlight it.

Click on Link radio button and the options as shown in following screenshot will appear at bottom of post editor. Add your link in URL field. You can also change its background color.

Check the Hide Link Box option if you want to hide it from single posts.

Quote Post Format

Quote post format is for publishing quotes. To add a quote, click on Blockquote button in post editor and start writing the quote.

When you click on Quote radio button, the options as shown in following screenshot will appear at bottom of post editor.

Video Post Format

Video post format shows video at the top of post. When you click on Video radio button, the options as shown in following screenshot will appear at bottom of post editor.

To add a video, choose your video host from the dropdown and then add the video ID. For example: In this URL https://www.youtube.com/watch?v=RTNMLtDHqmI, the text in bold (RTNMLtDHqmI) is video ID. You can also upload your own video.

Check the Hide Video option if you want to hide it from single posts.

Image Post Format

Image post format is just like standard post format but its featured image can be opened in lightbox when a user clicks on it. You can check the Hide Featured Image option if you want to hide it from single posts.

Status Post Format

Status post format is used to show Twitter or Facebook status at the top of post. Select Twitter or Facebook from Status Type dropdown and add link to your status in Status Link field.

Check the Hide Status option if you want to hide it from single posts.

Audio Post Format

Audio post format can be used to show audio file from Soundcloud or Mixcloud on top of your post. It is also possible to upload your own audio file.

Choose audio file source from Audio File Source dropdown. Then add link to your audio file.

Check the Hide Audio option if you want to hide it from single posts.

Layout Options

You can change sidebar position of each post that can be different from one set in global layout options. Layout options for posts can be found at the bottom of post editor.

Styling Options

Each post has its own styling options. These options are shown at the bottom of post editor screen. Here you can change background color and background image for each post.

Page Management

To create your first page, navigate to Pages -> Add New and start writing it.

Layout Options

You can change sidebar position of each page that can be different from one set in global layout options. Layout options for pages can be found at the bottom of page editor.

Styling Options

Like posts, each page too has its own styling options. These options are shown at the bottom of page editor screen. Here you can change background color and background image for each page.

Translating the Theme

This theme is translation ready and you can translate it to any language supported by WordPress. There are many ways for translating WordPress themes and plugins but we recommend the following method for the translation.

  1. First download POEdit and install it.
  2. Now, open the byblog.pot file that you can find in languages folder of your theme.
  3. You can now translate each string in your desired language.
  4. Once you have translated all the strings, save the file. POEdit creates two files. You need to save the files using following naming convention:
    languagecode_countrycode
    If you are translating your strings to french language, your file names will look like:
    fr_FR.po
    fr_FR.mo
  5. There may be multiple language files in theme’s languages folder. You need to tell WordPress which file to use for your blog. To chose your translated file, go to Settings -> General and then chose the language from Site language dropdown list.

  6. Click the Save Changes button
You can read more about translating WordPress here.

Child Theme

A child theme is required when you want to make changes to the code of the theme. It is mostly used by developers. A child theme inherits the functionality and styling of its parent theme.

It is recommended to use child themes if you want to modify theme files as the changes may be lost when you update the theme.

A child theme is provided with your purchased theme. You will find the child theme file with the name of byblog-child.zip in the theme package. In case you need to make changes to code of theme, you can start using this child theme. To install it, follow the same instructions as defined in Install Theme section.

You can find detailed information about creating, editing and using child themes on WordPress codex.

Sources and Credits

Once again, thank you so much for purchasing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have a more general question relating to Byblog, please contact us from our ThemeForest profile contact form.