Getting started

First of all, we would like to thank you for purchasing our Theme. If you have any questions that are beyond the scope of this help, please feel free to email us via our user page contact form here.

We'd be glad to help you if you have any questions related to this theme. No guarantees, but we'll do our best to assist. If you have a more general question relating to our themes you might consider visiting our support forum.


Installing the Theme

Please follow these simple steps to install the theme, recommended plugins and import the demo content in just few clicks.

  1. Go to the WP admin panel › Appearance › Themes
  2. Click the Add New button


  1. Find the bimber.zip file inside the package you've downloaded from ThemeForest
  2. Upload it


  1. After few seconds the theme will be installed.
  2. Click the Activate button


  1. You'll be redirected to the Welcome page
  2. Here you can choose your site style, plugins to install and whether or not to import the demo content
  3. Click the Proceed button


  1. After about a minute the whole process should complete
  2. You'll be redirected to the Congratulations page



By default the theme displays the site title in the Header Theme Area. You can easily change it and display the logo image instead by following these simple steps:

  1. Open the WordPress Admin › Appearance › Customize panel
  2. Switch to the Site Identity section
  3. Upload the desktop logo and set its width and height

What about Retina devices?

To make your logo look sharp on high-resolution screens, please upload double-sized Logo HDPI in the same section as the standard logo. The theme detects which version to use to make the best viewing experience.

Home Page

By default, the home page will display latest posts from your blog using a two-column layout, where the right column is reserved for the sidebar.

To customize it, please follow these simple steps:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Static Front Page section
  3. Choose preferred template, pagination type and elements visibility
  4. Show/hide featured entries
  5. Decide if newsletter and ad should be automatically inserted as collection items

Auto-injected newsletter

To use this option, you need a plugin that handles newsletter subscription process for you. We recommend the MailChimp for WordPress plugin. After theme activation you should be asked to install it or you can do that later, manually via the WordPress Admin › Appearance › Install Plugins page.

Read more about about the plugin integration.

Auto-injected ad

To use this option you need a plugin for ads. We recommend the WP QUADS plugin. After theme activation you should be asked to install it or you can do that later, manually via the WordPress Admin › Appearance › Install Plugins page.


Global Setup

Easily customize all elements that are visible throughout the site.

The global featured entries are located under the nav bar. It's a list of maximum 6 posts you want to promote across the site. These might be the most shared posts from the last week or posts tagged by you, for some special reason (let's say "WOW" posts).



To define your criteria, please follow these steps:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Featured Entries section
  3. Define where the entries should be visible. If you want to keep them just on your homepage, uncheck the Single post option
  4. Choose the preferred type and time range

The Most Shared type

To use this option you need a plugin that counts social shares on your site. We recommend the Mashshare Share Buttons plugin. After theme activation you should be asked to install it or you can do that later, manually via the WordPress Admin › Appearance › Install Plugins page.

Read more about the plugin integration.

The Most Viewed type

To use this option you need to a plugin that counts post views on your site. We recommend the Wordpress Popular Posts plugin. After theme activation you should be asked to install it or you can do that later, manually via the WordPress Admin › Appearance › Install Plugins page.

Read more about the plugin integration.


Define views and comments visibility thresholds

Views/comments threshold is for hiding views/comments element if the defined threshold value is not reached.

No one likes to see 0 (zero) numbers all across the site. It's a typical situation for new sites but it's not very encouraging for visitors.
You should rather avoid it. To do so, please follow these simple steps:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Posts › Global section
  3. Set threshold values for the Hide views and Hide comments options

The Footer stamp is not a typical element you can find on all sites. But that's the point. It's something unique and surprising that should attract your visitors attention and in the end increase their engagement.
Probably you'll ask why it's in the footer if it is so great. That's another tricky part. It should be there to give user a chance to find it when he/she doesn't expect it. The stamp can have really positive impact if you use it in right way. Check our live preview site to see it in action.

How to set up your own stamp?

To use the stamp in your site's footer, please follow these simple steps:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Site Identity section
  3. Upload the stamp image and set its width and height
  4. Set its label and URL address

To change the text in the footer, please do as follows:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Site Identity section
  3. Add your copyright info or other text into the Footer Text field

Single Post Setup

Easily customize the most important part of any viral site and start creating your key content using images, gifs, self hosted videos and of course embeds.

How to hide author, comments and other elements

On a post page you can show/hide almost every single element.

Global setup

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Posts › Single section
  3. Under the Hide Elements choose all unwanted elements

Show | hide the Featured Image on per-post basis

  1. Go to the WordPress Admin › Posts › Target Post edit screen
  2. Below the content editor you will find the Single Page section
  3. For the Featured image set inherit (to use global setting) or hide | show to override global setting

Sticky ShareBar

The Sticky ShareBar allows you to share current post while scrolling down the page. It's enabled by default. All you need to do is to install and configure the Mashshare Share Buttons plugin.

How to turn it off?

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Posts › Single section
  3. Set the Sticky ShareBar option to disabled

Share Buttons

The Share Buttons allow your visitors to share your content on social networks. To use that buttons, you need to first install and configure the Mashshare Share Buttons plugin.

How to turn on buttons above and below post content?

  1. Go to the WordPress Admin › Mashshare › Visual › Location & Position panel
  2. Choose your preference from the Position field
  3. Save Changes

How to turn on buttons for post images?

  1. Go to the WordPress Admin › Mashshare › Visual › Location & Position panel
  2. From the Position field choose Top, Bottom or Top and Bottom. Don't select the Manual option.
  3. Save Changes
  4. Now you need to set "center" alignment for your images. If you don't know how to center images, please take a look at the Image Alignment section in the Wordpress Codex.

Customize the sidebar

A single post has its own predefined sidebar for widgets. To configure your favourite widgets, please do as follows:

  1. Go to the WordPress Admin › Appearance › Widgets panel
  2. Find the Single Posts sidebar
  3. Add your widgets to it

If you need to define a different sidebar just for some special posts, please read how to Manage your sidebars with the Custom Sidebars plugin.


Use 3rd party content via embeds

Nowadays embedded content is a crucial and most important part of any viral site.

If you take a quick look at stats, for example 300 hours of videos uploaded to YouTube every single minute, you will get realised that creating your own content in most cases doesn't make a lot of sense and it's just a waste of time. You should be smarter and do what most successful viral sites do, reuse existing content!

Please check the Embeds chapter from the WordPress Codex (the online manual for WordPress) to learn how to use embeds.


Display an ad before | inside | after post content

All theme ads are handled via WP QUADS plugin. Please read about its configuration in the section below.

Display ads from content discovery platforms like Taboola, Content.ad, Outbrain

You can use the WP QUADS plugin to embed all kind of ads on your site. Regardless to the plugin name, it can be used to embed any kind of HTML content:

  • custom codes (script, iframe) for Google Ads, Taboola, Content.ad etc
  • static images (img)
  • plain texts (p, div)

How to add the Taboola ad?

As an example we'll use the Taboola ad but you can do the same with almost every kind of content discovery platform.
To add your Taboola ad after a post content, please follow these simple steps:

  1. Go to the WordPress Admin › WP Quads.
  2. Choose the AdSense Code subtab, under the General tab.
  3. Put your Taboola code inside first free slot e.g. Ad 5.
  4. Now go back to the General Settings subtab (under the General tab).
  5. Choose the Ad 5 for the Before "You May Also Like" section postion (choose other if you like).
  6. Save Changes

Paginated viral story

Paginated post can be useful throughout a long post to make two or more pages out of a single post. This technique is commonly used to serve different ad on subpages or to show post in gallery-like style.

How to set it up?

You can split a single post up into different web pages just by typing <!--nextpage--> in your post.
To add this so called the Page-Link tag, place your cursor in the spot where you want a page break to appear in your post and type <!--nextpage--> (you need to use the text mode of the editor to do so).

Pagination types

The theme offers two different pagination types:

  • Page links 1, 2 ,3, 4
  • Page 1 of 7

There are also few styles available for the Next and Previous links.
Please check all available variations under the WordPress Admin › Appearance › Customize › Posts › Single › Pagination section.

Gallery post with one image per page

To generate more page views on your site, you definitely should use a single image gallery instead of one page list/slideshow.

How to set it up?

To replace default WordPress gallery with set of individual images with navigation, please do as follows:

  1. Create a new post
  2. Choose for it the "Gallery" post format
  3. Upload few images to this post (use the "Add Media" button).
  4. Insert the [gallery] code into the post content, via WP Editor
  5. That's all. The theme does the rest

Archive

Archive pages setup

Archive page options are located under the WordPress Admin › Appearance › Customize > Posts > Archive section.
For more information about individual settgins, please refer to the Setting up your homepage section. Homepage is also an archive page so it has the same options.

NSFW

What is NSFW?

Not safe/suitable for work is a term used to mark posts which contain nudity, intense sexuality, or other sensitive content, which the viewer may not wish to be seen accessing in a public such as in a workplace.
In the theme, all images belog to NSFW posts will NOT be visible on any listings. User needs to open a single post to see them.

How to enable?

To activate NSFW option:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Open to the Posts › NSFW section
  3. Check the Enabled option
  4. Now choose the categories for your NSFW posts

Popular | Hot | Trending

About lists

Lists are your site's most valuable rankings. You want to spread your posts virally across the web, right? Lists are best way to attrack your visitors.

First list, the Lastest, is well known list of your most recent posts. Almost every blog uses it. Other types are unique and typical for viral sites. They are generated based on post views so the more visited your story is the higher it will be in the rankings:

  • Trending - most viewed posts from last day
  • Hot - most viewed posts from last month
  • Popular - most viewed posts of all time (something like "Hall of Fame")


Setup

To set up your special links, please do as follows:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Posts › Global section
  3. Use the Top in menu option to choose type of your links:
    • single - all links will be grouped under one link
    • separate - links will be displayed separately

If you chose the single option:

  1. To show the Top link, please select the corresponding page for it

If you chose the separate option:

  1. Check the Latest posts page to show the link to your blog page
  2. To show the Popular link, please select the corresponding page for it
  3. To show the Hot link, please select the corresponding page for it
  4. To show the Trending link, please select the corresponding page for it

How the "Top" page works?

The Top page groups all your enabled lists on a one page. The difference is also in their naming convention. Now, lists labels will be generated based on corresponding dates:

  • Today for Trending
  • This week for Hot
  • All time for Popular

Changing link labels

For the Popular, Hot, Trending and Top links, their labels are taken from the corresponding page titles.

For the Latest link, the situation is a little bit more tricky, due to lack of existing posts page (in default configuration).
To change that label, please follow these steps:

  1. Create a new page with your preferred title (eg. "Recent stories").
  2. Open the WordPress Admin › Appearance › Customize panel
  3. Go to the Static Front Page section
  4. Change the Front page displays option to A static page
  5. For Posts Page choose the previously created "Recent stories" page
  6. Change back the Front page displays option to Your latest posts

FAQ


Sidebar

The theme is based on a two-column layout, where the right column is reserved for the optional sticky sidebar.

Show popular posts in your sidebar

Popular posts is a collection of the most viewed posts from the last month. To list these posts in your sidebar you can use the Bimber Posts widget. Please follow these simple steps to configure it:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Widgets section
  3. Sidebars are context aware so you need to first choose page on which you want to add your widget
  4. When your target sidebar shows up in the panel on right, choose it
  5. Now click the Add a Widget button and choose from the list the Bimber Posts widget
  6. Fill the widget title, let's say "Hot stuff"
  7. Choose how many posts you want to show and which template will be best for your list
  8. Now the important part, set the Sort by option to "view" and the Time range to "last 30 days"
  9. Optionally, limit posts to some specific categories or hide elements that won't be visible

Use Facebook Page widget in your sidebar

Thanks to Facebook page widget you can show your Facebook stats (friends, likes) directly on your site. To add it to your sidebar, please do as follows:

  1. Open the WordPress Admin › Appearance › Customize panel
  2. Go to the Widgets section
  3. Sidebars are context aware so you need to first choose page on which you want to add your widget
  4. When your target sidebar shows up in the panel on right, choose it
  5. Now click the Add a Widget button and choose from the list the Bimber Facebook Page widget
  6. Fill the widget title, by default it's "Find us on Facebook"
  7. Put your Facebook page url
  8. Customize the look (small header, show/hide facepile, posts)

Use sticky sidebar

Sticky sidebar is a floating box that stuck to the browser's top when you scroll. To configure it to work with your sidebar, please do as follows:

  1. Open the WordPress Admin › Appearance › Customize panel
  2. Go to the Widgets section
  3. Sidebars are context aware so you need to first choose page on which you want to add your widget
  4. When your target sidebar shows up in the panel on right, choose it
  5. Now click the Add a Widget button and choose from the list the Bimber Sticky Start Point widget
  6. Now grab it and drag before a widget that should be a first widget inside a sticky container. All succeeding widgets will be sticky as well

Manage your sidebars with the Custom Sidebars plugin

To create your own widgetized areas and choose on which pages they show up we recommend the Custom Sidebars plugin.
It's easy to use, highly trusted and popular plugin. For a quick start, please watch this video guide.

Design

The theme takes advantage of the WordPress Live Customizer, where you can tweak all design-related settings and see the effect of the changes on the fly.

Setting up header composition

To define your header style, please:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Design › Header section
  3. Choose your most prefered composition

Setting up site style

Style is a set of rules that gives your site a special look. E.g. the "Cards" style makes all your grid layouts look like built with boxed blocks.

To define your site style, please:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Design › Global section
  3. Choose your style

Enable boxed layout



To switch from the stretched to boxed layout, please do as follows:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Go to the Design › Global section
  3. Change the Layout option to boxed
  4. Optionally you can adjust the Boxed Layout Width and the Boxed Layout Background below

Customize the color scheme

There are plenty of color options included to meet your brand needs. Please do as follows, to quickly adjust all colors:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Switch to the Design › Global | Header | Footer section
  3. Use available color pickers to adjust color values

Use sticky header

To enable the sticky header, please do as follows:

  1. Go to the WordPress Admin › Appearance › Customize panel
  2. Go to the Design › Header section
  3. Change the Sticky Header option to enabled

Please remember that the sticky header won't work on a single post page if the sticky sharebar is enabled.
If you want to have the sticky header on a single post page, you need to disable the sticky sharebar.

Translation

The most common mistake is identifying translation with switching to different language. Translation allows you to change phrases for your current language too.

Translating with WP Customizer

Some most important phrases are available to change directly in the Customize panel. These phrases are:

  1. Latest stories title on home page, in Static Front Page section
  2. More stories title on home page, in Static Front Page section
  3. Latest stories title on archive pages, in Posts › Archive section
  4. More stories title on archive pages, in Posts › Archive section
  5. Newsletter titles and labels, in Newsletter section (available only if the Mailchimp plugin is activated)

Translation with Loco Translate plugin

The Loco Translate plugin is the best, in our opinion, tool for translating/changing all phrases in the theme. As stated above, you can use it to change phrases without changing your current language.

Requirements

In order to localize your theme and plugins, create a directory named "languages" inside of "wp-content", if it does not already exist. Make sure that your web server has write permissions to this directory. If you're not familiar with this subject, please first read about Wordpress file permissions.

How to translate?

  1. Install the Loco Translate plugin.
  2. Go to the WP Admin Panel › Loco Translate.
  3. Find on the list your target theme/plugin (Screen 1, Point 1)

    Screen 1 Choose theme/plugin to translate

  4. Click "New language" (Screen 1, Point 2).
  5. Select your language (let's say "Spanish", code "es_ES"). Remember that this translation will be loaded only if your site language in WordPress Admin › Settings › General › Language is the same.
  6. Translate all phrases (Screen 2, Point 1 and 2) and click "Save" (Screen 2, Point 3) to generate all necessary translation files.

    Screen 2 Save translation

If everything goes well, you should find translation files under the directory:

For theme

wp-content/languages/themes/bimber-es_ES.po
wp-content/languages/themes/bimber-es_ES.mo

For plugin (e.g. G1 Socials)

wp-content/languages/plugins/g1_socials-es_ES.po
wp-content/languages/plugins/g1_socials-es_ES.mo

Keep translations safe after future updates

Because we don't use the theme/plugins related directories to store translations you have nothing to worry about. All custom translations are stored in the wp-content/languages directory so unless you reinstall the entire Wordpress installation, all is safe there. You can update the theme and each plugin without losing their translations. You don't even need to use the child theme.


FAQ


Tips & Tricks

Below you will find some practical tips and tricks to get the most out of your WordPress site. These are not mandatory, but highly recommended.

Securing your WordPress site

Security is the most neglected part of a WordPress site life cycle. Many people recall about it when it is too late, when their sites are already hacked. You probably won't be one of them so please take it really seriously. It costs nothing (there are free plugins) to fully protect your site against attackers and their malware software.

Use the WordFence plugin

From many good plugins (both free and paid) available on the market, we recommend the Wordfence Security plugin. As a good starting point, please check the How to Configure Wordfence Security Plugin for WordPress tutorial.

Keep plugins up to date

We all know that WordPress wouldn't exist without plugins. We all use them and thanks to them we can save a lot of time instead of building everything from scratch. All you need to do to keep your site safe is to remember about keeping all your plugins up to date. If you don't use a plugin anymore, just deactivate (or remove) it, but never leave it outdated. It's the easiest way to give any potential hacker access to your site.

Other good practices

The Wordfence Security plugin gives you almost ultimate protection. If this plugin detects any potential security issue you will be immediately notified about it. But it can't detect and solve all of them. Some are related to human nature, so we also strongly advise to stick to these rules:

  • Don't give the admin access to anyone
  • Make sure that users with access to your site have correct access level
  • Use strong passwords (Wordfence has an option to force your users to use strong passwords, use it!)

Speeding up your WordPress site

WordPress has to generate each page each time your visitor comes to it. This is always a costly operation, forcing your web server to waste its resources (mainly CPU and memory). You are probably aware of the fact that it is not necessary to do that. All visitors can (and should) see the same page version (for some defined period of time or at least until next modification). You should always cache your site and eliminate all additional components (e.g. plugins) that can slow down caching process (page will be generated only once but this also can take a while).

Use the WP Super Cache plugin

There are few good plugins for caching. We recommend the WP Super Cache plugin because it's very good (trusted by 1+ million of users) for most cases and relatively simple to configure. If you need more powerful solution, the W3 Total Cache plugin will be a better choice. It has much more options (e.g. CSS/JavaScript minifying) but it's also much more complicated.

If you are not familiar with the WP Super Cache plugin and you're looking for a quick start guide, please check the How to Install and Setup WP Super Cache for Beginners tutorial.

Uninstall unused plugins

Another good practice to provide best site performance is to use only the necessary plugins. Less plugins means less resources to process and faster site. Make sure that all your active plugins are really needed and if not please deactivate (or remove) them. Our theme is delivered with a lot of built in components so before you decide to use a 3rd party extension, please check if the theme doesn't provide it already.

Enable gzip compression

All modern browsers support and automatically negotiate gzip compression for all HTTP requests. Enabling gzip compression can reduce the size of the transferred response by up to 90%, which can significantly reduce the amount of time to download the resource, reduce data usage for the client, and improve the time to the first render of your page. See How to Optimize Your Site with GZIP Compression to learn more.


Using the Child Theme

A child theme is a theme that inherits the functionality and styling of another theme, called the parent theme. Child themes are the recommended way of modifying an existing theme. Read more about Child Themes in the WordPress Codex

Why should I use it?

You will probably want to modify this theme somehow. We strongly recommend to use the Child Theme then. That way, when the parent theme is updated, your modifications are preserved. You don't have to create your own child theme, just use the one from the zipped file downloaded from ThemeForest.

Where should I place my CSS modifications?

All your custom CSS rules should be added to the style.css file form the child theme. You can access it directly from the WP admin panel › Appearances › Editor.

Where should I place my JavaScript modifications?

All your custom JavaScript code should be added to the modifications.js file from the child theme. You can access it directly from the WP admin panel › Appearances › Editor.

Update Theme

Manual update

When new update will be released, the ThemeForest will notify you about that so you can download new package and install it manually. We don't recommend this approach. The more robust way is to use automatic updates.

Automatic update

To use automatic updates you need the Envato WordPress Toolkip plugin. If you haven't installed it yet, you can do that now via WordPress Admin › Appearance › Install Plugins panel.

For more information about its configuration, please read the Envato WordPress Toolkit Guide For Automatic Theme Updates

Demos

How to install?

Install during theme installation

Please refer to the Installing the theme section.

Install on existing site

If you already have set up your site, you can import new demo data by following these simple steps:

  1. Open the WordPress Admin › Appearance › Theme Options panel
  2. Switch to the Import/Export tab
  3. Look at the Import demo data section
  4. From here, you can choose demo style and type of import:
    • Content - import only posts, pages, images, menus
    • Theme Options - import only configuration settings (e.g. header composition, homepage template, colors)
    • Content + Theme Options - both above

Plugins

The theme makes use of several plugins to provide some additional features, like social sharing buttons, post view statistics or newsletter signup form.

Snax

Snax is the first viral content uploader for WordPress.

This plugin is not a part of the Bimber theme. You can buy it on the CodeCanyon (really soon), as a stand alone product.

Documentation

For all information about Snax (installation, configuration etc), please refer to the Snax online documentation.

How to set up the user navigation?

The user navigation you can see on the live preview site, is from the BuddyPress plugin, so first you will need to install and active that plugin. Then please follow these simple steps:

  1. Go to the WordPress Admin › Appearance › Menus
  2. Create a new menu, call it e.g. UserNav
  3. Add to this menu links from the BuddyPress panel (visible on the right side):
    - Profile
    - Posts
    - Submissions
    - Votes
    - Activity
    - Notifications
    - Settings
    - Log Out
  4. Save Menu
  5. Assign the UserNav menu to the User Navigation location in the WordPress Admin › Appearance › Menus › Manage Locations
  6. Save Changes

What's Your Reaction

What's Your Reaction plugin allows you to share your reaction to a post, using nice looking badges.

Installation

The plugin is built into the theme so after theme activation you will be asked to install it.

Setup

After activating the plugin, you can define your reaction under the WP Admin Panel › Posts › Reactions page.

How to Update?

After theme update, if new version of the plugin is available, you will be asked to update it (notice on top of the Dashboard).

If for somehow reason you can't see the notice, you can update the plugin manually.

To do that, go to the WP Admin Panel › Appearance › Install plugins, find the "What's Your Reaction" plugin on the list and click "Update" right below it.

Notice

If you can't find the Install plugins link in the WP Admin Panel › Appearance section, all your plugins are up to date and you don't need to update anything.


Mashshare Share Buttons plugin

Enable highly customizable social sharing buttons - Facebook, Twitter and more.

Share buttons locations

There are few locations to choose for your share buttons:

  • before or/and after a post content
  • in the top sticky ShareBar
  • for all images/videos embedded in a post content.
    Caution. For design purposes share buttons will be applied only for images/videos with center alignment.
    If you don't know how to center images, please take a look at the Image Alignment section in the Wordpress Codex.

Installation

The plugin is integrated into the theme so after theme activation you will be asked to install it. Or course this doesn't mean you have to use it. If you prefer other social sharing solution, feel free to use it.

Setup

After activating the plugin, its configuration page will be accessible in the WP Admin main menu.

For more information, please refer to the plugin page.

How to Update?

As any other plugin from wordpress.org site, if new version of the plugin is available, you will be notified about it.


Enable post view statistics and popular | hot | trendings lists.

Installation

The plugin is integrated into the theme so after theme activation you will be asked to install it. Or course this doesn't mean you have to use it. If you prefer other ads solution, feel free to use it.

Setup

After activating the plugin, its configuration page will be accessible in the WP Admin › Settings section.

For more information, please refer to the plugin page.

How to Update?

As any other plugin from wordpress.org site, if new version of the plugin is available, you will be notified about it.


MailChimp for WordPress

Subscribe your WordPress site visitors to your MailChimp lists, with ease.

Installation

The plugin is integrated into the theme so after theme activation you will be asked to install it. Or course this doesn't mean you have to use it. If you prefer other ads solution, feel free to use it. More info about switching to other ads plugin can be found here.

Setup

After activating the plugin, its configuration page will be accessible in the WP Admin main menu.

For more information, please refer to the plugin page.

How to update?

As any other plugin from wordpress.org site, if new version of the plugin is available, you will be notified about it.

How to change default texts?

If you want to change default phrases, like "Get the best viral stories straight into your inbox!",
you can do that via WordPress Admin › Appearance › Customize › Newsletter section.


WP QUADS plugin

Quickly place multiple ads on your viral site by utilizing the Google AdSense program or any other kind of ad codes.

Installation

The plugin is integrated into the theme so after theme activation you will be asked to install it. Or course this doesn't mean you have to use it. If you prefer other ads solution, feel free to use it. More info about switching to other ads plugin can be found here.

Setup

After activating the plugin, its configuration page will be accessible from the WP Admin › WP QUADS menu.

The plugin provides some default ad locations ready to insert ad codes (like "Beginning of Post" or "right before the last Paragraph"). Additionaly the theme registers the following locations:

# Location Ad format Notes
1 Before header theme area horizontal
2 Before content theme area horizontal
3 Before "Related Entries" section horizontal An ideal location to utilize some Content Discovery Platform, like Outbrain or Revcontent
4 Before "More From" section horizontal
5 Before comments area horizontal
6 Before "Don't miss" section horizontal
7 Inside grid collection rectangle, vertical
8 Inside list collection rectangle, horizontal


For more information on how to insert ad codes, please refer to the Official Plugin Page.

How to Update?

As any other plugin from wordpress.org site, if newer version of the plugin is available, you will be notified about it.


G1 Socials plugin

G1 Socials is a simple plugin that lets your users follow you via your social channels.

Installation

The plugin is built into the theme so after theme activation you will be asked to install it.

Setup

After activating the plugin its configuration page will be accessible under the WP Admin Panel › Settings page.

How to add new icon?

To add new icon you need to use the "g1_socials_items" hook. We strongly recommend to add all new icons via our child theme. Below the child theme functions.php file showing how to use the hook to add/remove icon.

<?php>
// Prevent direct script access
if ( !defined( 'ABSPATH' ) )
    die ( 'No direct script access allowed' );
/**
* Child Theme Setup
*
* Always use child theme if you want to make some custom modifications.
* This way theme updates will be a lot easier.
*/

function bimber_childtheme_setup() {
    add_filter( 'g1_socials_items', 'add_remove_g1_socials_item' );
}

add_action( 'after_setup_theme', 'bimber_childtheme_setup' );

function add_remove_g1_socials_item ( $icons ) {
    $child_theme_dir = get_stylesheet_directory_uri();

    // remove 'Facebook' icon
    unset( $icons['facebook'] );

    // add new icon, let's call it 'myicon'
    // 'color' -  defines icon background color
    // 'icon_dir' - defines where the folder with icon is located
    $icons['myicon'] = array(
        'color' => '#ff0000',
        'icon_dir' => $child_theme_dir . '/social-icons/'
    );

    return $icons;
}

Now, you need to add your icons to the folder you specified (via "icon_dir" parameter). You should add icons in all sizes: 16px, 24px, 32px and 48px. Icons should be in the png format.

Change Icons Order

The icon list interface is sortable. You can easily change an icon position just by dragging it (move mouse over a title) after/before other icon.

How to Update?

After theme update, if new version of the plugin is available, you will be asked to update it (notice on top of the Dashboard).

If for somehow reasons you can't see the notice, you can update the plugin manually.

To do that, go to the WP Admin Panel › Appearance › Install plugins, find the "G1 Socials" plugin on the list and click "Update" right below it.

Notice

If you can't find the Install plugins link in the WP Admin Panel › Appearance section, all your plugins are up to date and you don't need to update anything.

Other

Sources and Credits

Images, Illustrations, Videos & Icons

JavaScripts

  • jQuery - JavaScript Framework
  • enquire.js - Awesome Media Queries in JavaScript
  • Placeholders.js - polyfill for the HTML5 placeholder attribute
  • Timeago - convert date into fuzzy timestamps
  • Waypoints - Waypoints is the easiest way to trigger a function when you scroll to an element.
  • SuperGif - GIF parser and player
  • matchMedia.js - polyfill for testing media queries in JS
  • Modernizr - JavaScript library that detects HTML5 and CSS3 features in the user’s browser
  • Picturefill - A responsive image polyfill

Fonts


PSD files

The download package includes the following Adobe Photoshop .PSD files:

  • _home_grid_sidebar_v01.psd
  • _archive_grid_sidebar_v01.psd
  • _single_classic_sidebar_v01.psd

All fonts used in the template are available from the Google Fonts Directory for free. Every file is fully layered, well organized and contains grid helper lines for your convenience.


JavaScript files

The main power behind this theme is the famous javascript framework jQuery.

Except plugin files, the Theme uses:

  • front.js - theme specific functions and plugins initializations (frontend side)
  • menu.js - menu specific functions (frontend side)
  • admin.js - theme specific functions and plugins initializations (admin side)
  • theme-options.js - theme options panel specific functions

All used 3rd party scripts are listed on the Sources and Credits page.


CSS files

Reset Styles

The first rules in main.css file are generic reset rules. Many browser interpret the default behavior of html elements differently. By using a general reset styles, we can work round this.

General Styles

The main css file main.css is separated into sections:

  1. Settings
    1. Global
  2. Tools
    1. Functions
    2. Mixins
  3. Generic
    1. Reset
  4. Elements
    1. Default
    2. Forms
  5. Objects
    1. Grid
    2. Fluid wrapper
  6. Components

If you would like to edit a specific section of the site, simply find the appropriate label in the CSS file, and then scroll down until you find the appropriate style that needs to be edited. Sections are marked as follows:

/**
 * 1 . SAMPLE SECTION NAME
 */

Theme Folder Structure

After unzipping the file downloaded from the ThemeForest you'll see the following folder structure:

  • bimber - theme files - in case you want to upload the theme through the FTP
  • bimber.zip - zipped theme files - in case you want to upload the theme through the WordPress admin
  • bimber-child-theme - child theme files - in case you want to upload the child theme through the FTP
  • bimber-child-theme.zip - zipped child theme files - in case you want to upload the child theme through the WordPress admin
  • changelog.txt - releases history
  • Documentation - an entry point to the online documentation. Online version it's always up to date.
  • License - licensing files
  • Licensing - licensing files
  • PSD - PSD files

Custom Widgets

The Theme comes with some custom widgets ready to use. All custom widgets names start with the Bimber prefix.

All available widgets can be found in the WP Admin › Appearance › Widgets.

Advanced

Use other ads plugin

The theme by default uses the WP QUADS plugin for displaying ads on your site.
But of course we are aware that you may want to use other plugin, especially if you use it on your other sites.
Our plugin is not tightly coupled with the theme so you can easily replace it with your own.

How to integrate other plugin?

All you need to do is to override ad template files with your code (shortcode, widget, custom HTML/JS).
You will find all templates inside the THEME_ROOT_DIR/template-parts dir, each has the ad- prefix.

Example

Let's say you have ads plugin that delivers [my_ad] shortcode to display your ad.
Assume also that you want to replace the top most header ad. To do so, please follow these steps:

  1. install and activate the theme child theme (if you don't have it)
  2. copy the template-parts/ad-before-header-theme-area.php file to the child theme template-parts/ dir
  3. open the file and replace its entire content with this code <?php echo do_shortcode('[my_ad]'); ?>

Procedure for any other ad location (before content, inside grid etc) is exactly the same. Just the template to replace is different.


Use other newsletter plugin

The theme by default uses the MailChimp for WordPress plugin as a newsletter solution.
But of course we are aware that you may want to use other plugin, especially if you use mailing service other than MailChimp.
Our plugin is not tightly coupled with the theme so you can easily replace it with your own.

How to integrate other plugin?

All you need to do is to override ad template files with your code (shortcode, widget, custom HTML/JS).
You will find all templates inside the THEME_ROOT_DIR/template-parts dir, each has the newsletter- prefix.

Example

Let's say you have ads plugin that delivers [my_newsletter_form] shortcode to display your newsletter.
Assume also that you want to replace the newsletter after post content. To do so, please follow these steps:

  1. install and activate the theme child theme (if you don't have it)
  2. copy the template-parts/newsletter-after-content.php file to the child theme template-parts/ dir
  3. open the file and replace its entire content with this code <?php echo do_shortcode('[my_newsletter_form]'); ?>

Procedure for any other newsletter location (inside grid etc) is exactly the same. Just the template to replace is different.

Troubleshooting

The popular, hot and trending lists are based on post views. They differ in time range:

  • popular list shows most viewed posts of time. You can treat them as so called "Hall of Fame" collection
  • hot list is for most viewed posts from last month
  • trending list is for posts from last day that were mostly viewed

Here are some requirements you need to meet to collect data for these lists:

  1. the Wordpress Popular Posts plugin must be activated.
    WordPress doesn't count views for posts by default so we need to use 3rd party plugin for that.
  2. at least one post needs to be visited so its views counter can be initialized.
    Just click through few posts on your site to populate their views.

How often lists are updated?

Lists are updated once a day. You can change this interval by adding the code below to your child theme functions.php:

add_filter( 'bimber_update_lists_interval', 'bimber_change_update_lists_interval' );

function bimber_change_update_lists_interval( $interval ) {
    $interval = 60 * 60 * 12; // 12 hours = 60 sec * 60 min * 12 hours

    return $interval;
}

How to update lists manually?

If you are in a development phase of your site, you will probably want to see results faster, before first calculation is done. To do that please follow these simple steps:

  1. Open the WordPress Admin › Appearance › Theme Options panel
  2. Go to the Tasks tab
  3. Click the Run now button right next to the list you want to update

Post views counter is not visible

WordPress doesn't count views for posts by default so we need to use 3rd party plugin for that. To display post views, please install and activate the Wordpress Popular Posts plugin. Then go and visit one of your posts to increase its views counter. Now you should see current number of views for that post.

Set up views threshold

By default the theme doesn't show views counter if there is less than 10 views.
You can of change that setting in the WordPress Admin › Appearance › Customize › Posts › Global › Hide views section.


Don't Miss section is empty

The Don't Miss section is based on last month most viewed posts.

Here are some requirements you need to meet to collect data for this collection:

  1. the Wordpress Popular Posts plugin must be activated.
    WordPress doesn't count views for posts by default so we need to use 3rd party plugin for that.
  2. at least one post needs to be visited so its views counter can be initialized.
    Just click through few posts on your site and you should see them immediately here, in the Don't Miss section.

Static Front Page section missing

If you can't find the Static Front Page section in the WP Customizer panel, you probably don't have any published pages. Wordpress shows the Static Front Page section only if at least one published page exists in WP Admin » Pages.

Translation folder is not writable

Translation forbidden

If you see the warning above in the Loco Translate plugin, your web server can't save translation files to the /wp-content/languages/themes folder.
You need to set write file permissions on the folder /wp-content/languages/themes so web server can write to it.
If you're unsure how to set file permission on your server, ask your system administrator or hosting provider.