Blooog.

This is the theme help documentation file. Please search this before contacting the Bean Support Center. Note that we do not support theme customizations beyond it's original functionality & appearance.

Live Theme Demo View on ThemeForest

1. Getting Started

A bit on getting started with your WordPress project, package files & the Bean Support Center.

1.1 Included Files

After downloading the theme package open the folder named “Blooog Package (Version)” and un-zip the folder, if it is not already so. Inside the package you will find the following files:

  • Help
  • Licensing
  • PSD
  • Sources
  • Theme
    • blooog
    • blooog.zip
    • blooog-child.zip

1.2 Installation Options

To install your brand new WordPress theme (that you’ve already downloaded and un-packed) you have two primary options: FTP or WordPress Upload. Learn a bit more on each below in Sections 1.3 and 1.4.

1.3 WordPress Upload

To upload through your WordPress Dashboard, select “Appearance” and then “Themes” (located on the Dashboard sidebar). Next, select the “Install Themes” tab at the top of the page and then select the “Upload” link, right above the search field. Choose your file and select “Install Now”. Once the theme is fully uploaded and installed, click “Activate” to activate the WordPress theme.

Note: The theme files will be stored on your server in the following location: /wp-content/themes/

When uploading your theme through the Dashboard, please ensure you are uploading the theme .zip file, not the entire package you downloaded. In this case, you will be uploading blooog.zip. If you upload the wrong file (the package) you will get an error stating “Error: missing style.css stylesheet.”

1.4 FTP Upload

To manually upload your new WordPress theme, login with your credentials to your website and locate the wp-content folder in your WordPress install files. Upload the un-zipped Blooog folder into the: wp-content/themes folder.

Note: Again, please ensure you are uploading the un-zipped theme folder, not the entire package downloaded.

Once uploaded, activate the theme by heading to the “Themes” menu in the WordPress Dashboard. Locate the Blooog theme and hit “Activate”.

1.5 Compatible Plugins

This theme is compatible with just about the full array of ThemeBeans developed WordPress Plugins. To download the free plugins, head to http://themebeans.com/plugins and grab a few.

1.6 Bean Support Center

If you’re a problem with the theme or found a bug please let us know on the Bean Support Center . We take pride in our customer support and we will do what we can to assist you. It is impossible to test every plugin developed for WordPress and unfortunately there are a good number that pose issues to many themes in general. If you are experiencing a theme issue, please first turn off all third party plugins to see if the problem persists. If so, we will be glad to help.

We are happy to help with setup & bugs you may stumble upon though we cannot support CSS customizations.

2. The Home Page

Initial set-up procedures to get your website’s home page running and theme menus.

2.1 Reading Settings

The first step is to set your home page as your latest posts in WordPress. To do this, head back into your WordPress Dashboard and from the sidebar links, hover on “General Settings” and click on “Reading”. Choose to have your front page displayed as “Latest Posts” and save.

2.2 Navigation Menu

To set up your site navigation, head to the “Appearance” tab from the dashboard sidebar and then “Menus”. Click on the “Create a new Menu” near the top to create a new menu.

After saving, you can add the menus via the Theme Customizer to set the Primary Navigation. This navigation element is persistent throughout the theme and should be added.

2.3 Overlay Header / Navigation Bar

The optional header is turned on via the Theme Options Panel - General Options. You may select either to display a full width header (which provides one large widget area - typically for a text widget or a social counter widget), a split header (which provides a navigation element to the left and a widget area to the right ) and lastly an option to turn the header completely off. This overlay header is loaded upon scrolling the page, and remains pinned top the top.

3. The Blog

A few tips on creating your blog page, blog setup and standard post publishing in our theme.

3.1 Adding a Blog Post

From within your WordPress Dashboard, navigate to the “Posts” tab (located in the Dashboard sidebar) and click on “Add New”. Select the post format on the right sidebar and the format specific meta fields will appear below the editor.

3.2 Gallery Post Format

To publish a gallery post format, upload as many photos as you’d prefer into the media uploader and DO NOT set a post featured image. If you do, it will override the gallery slideshow.

Note: The recommended default size for featured images is 870px by 653px.

3.3 Other Post Formats

This theme has built in functionality for many other alternative post formats: audio, video, aside, link and quote formats. To use them, again you would select them from the Format meta box beneath the Publish box.

3.4 Post Meta Options

From the theme options panel, you may select to display the post Author, Date, Category, Comment Count, Tags, View Count, Word Count, Post Likes & even a neat “New” post tag. All of these options are in the Blog Settings of the Theme Options Pane - selectable via a checklist.

3.5 Changing the Post Author

To change the post author - which is a default WordPress functionality - select the “Author” checkbox from the “Screen Options” tab, located at the top right of the WordPress editor.

4. The Portfolio

Setting up your theme’s portfolio using the Bean Portfolio Post Type Plugin (FREE).

4.1 Installing the Plugin

To install the plugin, head over to our website and simply download the free Bean Portfolios Plugin. Once you’ve successfully downloaded the zip file, head to your WordPress Dashboard and select “Plugins > Add New > Upload.” Add the zipped file in the field there and click “Upload.”

Upon a successful upload, you’ll be prompted to activate the plugin. You’ll then see a new “Portfolio” tab in your WordPress Dashboard Sidebar.Creating portfolio posts is done exactly the same as standard posts.

4.2 Creating your Portfolio Page

You need to first create a page using the “Portfolio” template. This template will realize that you have the Bean Portfolio Post Type Plugin activated and will pull your portfolio posts.

4.3 Featured Images

We utilized 870px by 653px for an optimal retina display of images.

5. Theme Widgets

An overview of the included widgets and how to’s on managing the widget areas throughout this theme.

5.1 Included Widgets

Blooog has the following widgets provided in the theme package:

  • Bean Stats Widget (Page Widget Area)
  • Custom Images Widget (125x125)
  • Custom Images Widget (250x250)
  • Dribbble Shots Widget
  • Flickr Photos Widget
  • Header Social Counter
  • Newsletter Widget
  • Skills Widget
  • Social Profiles Widget

This theme is compatible with the Bean Tweets & Bean Instagram Plugins, which generate widgets.

5.2 Using the Widgets

To employ a widget, simply go to your Widgets editor (located in your WordPress Dashboard in the “Appearance” menu) and drag your widgets into the specified widget areas.

5.3 Widget Area Generator

There is currently 1 widget area built into the theme base, although if you utilize our framework widget area generator, you can create alternative widget areas to replace current areas on certain pages, posts or even tags.

To create a widget area, locate the Widget Area Manager on the WordPress Dashboard, under the “Appearance” tab. Once you are in the generator, select “Add New”. Next, simply name the widget area, select the conditions, select the current widget area to replace, then hit “Publish”.

Return to your Widgets editor and you will find your new widget area has automatically been added and is currently following the conditions you have set. Add your alternative widgets here and you will see them change based on the conditions (templates, pages, ect.) that you chose.

6. Theme Options

A few tid-bits concerning your new theme’s powerful Theme Options Panel and the neat functionality behind it.

6.1 Accessing the Options

To manage your custom theme options, locate the “Theme Options” menu item, under the “Appearance” tab of your WordPress Dashboard sidebar.

6.2 The Options

A. General Options:Upload your logo/favicon/apple touch icon, customize the branding tagline (sidebar), footer copyright text and even add your analytics options. You can also opt to turn on the header overlay (selecting what layout as well).

B. Blog Settings: Here you may choose to show the post meta (author, new post tag, categories, comment counts, tags, views, word counts and even post likes). You also have the option to turn on blog pagination and even Facebook / Twitter social sharing.

C. Footer Settings: In the footer settings panel you have the option to choose between four different footer layouts, select your footer social media icons, modify the copyright text & set any footer analytics that you might utilize.

D. Site Archives Settings: Choose which (or select all) types of archive content to display on the Archives Template and customize the headings to each archive section.

E. 404 Error Page Settings: Completely manage and customize your website’s 404 Error Page in this tab, including the fullscreen background image, header, paragraph and back button text.

F. Theme Colors: Easily manipulate various CSS elements throughout the theme with the color pickers in this tab.

G. Custom CSS: Insert your own CSS into this block and it will be applied to your website. This overrides all default styles located throughout the theme.

H. Import / Export & Reset Options: Copy & download your current theme options settings, import a new set, or do a full manual reset of your current Theme Options.

7. Bean Form Builder

The Bean Form Builder enables you to craft various types of forms using text fields, text areas, checkboxes & more.

7.1 How Does it Work?

To access the form builder, just press the form icon in the WordPress page/post editor (beside the “Insert Media” icon) and the builder will pop-up, displaying a default form template that can be fully customized.

7.2 Inserting New Fields

To add a new field, simply click on the “Click here” sidebar link in the form builder pop-up (on the right). Then select the label for the field, the type of input you would like to use and choose if the field is a required entry. Finally, hit “Save this Field”

7.3 Editing Fields

When you hover over a field on the right side of the Bean Form Builder pop-up, you’ll notice a span of text reading “Edit”. By clicking “Edit”, the sidebar text field manager will be pulled up, displaying the same options presented during the initial field building. Once the edits are made, hit “Save the Field” to save your edits.

7.4 Moving & Removing

Also upon hovering over the fields, you will see a text span reading “Move”. Click, hold and move your cursor to drag the field into a different location. To remove a field, select the round minus icon located to the right of each field. The field will be automatically deleted.

7.5 Email Notifications

By clicking on the “Email Notification Setup” tab, located near the top of the Bean Form Builder pop-up, you will notice “Email Address” and “Subject Line” fields. Enter the address of who you would like to be notified of the responses to the form. After setting those options, hit “Save Settings” to return back to your custom form.

7.6 The Responses

Located in your WordPress Dashboard sidebar, you’ll see a “Responses” menu link tab. Upon clicking on this you will find a list of all responses to your forms.

8. Retina Displays

This theme is fully compliant with retina standards to look sharp on any display.

8.1 Image Asset Customization

Each graphical asset has an associated retina image that should be modified when customizing assets in this theme. You will find these retina assets in their respective image locations, in the “retina” folders.

Additionally, if the image size has changed, the background-size property of the associated class in /assets/css/mobile.css must be modified to reflect those changes.

8.2 Retina.js

This theme is retina.js ready - which means that any image will be replaced by a retina image if you’ve uploaded one into the same directory & have appended the “@2x” to the end. Example: logo@2x.png will replace logo.png

9. Files & Sources

This is dedicated to the theme templates, javascript files and other sources for our theme.

9.1 Theme Template

  • Archives Template
  • Default Template
  • Default, Bottom Widget Template (About Us) Template
  • Contact Template
  • Portfolio Template

9.2 CSS Files

These are the primary CSS files used for general front-end styling. Use these to customize your theme even further.

  • Style.css (Primary Stylesheet)
  • Mobile.css (Responsive Stylesheet)
  • Framework.css (Framework Stylesheet)

9.3 Javascript Sources

These are the various attribution inks to the Javascript files included or modified to work with in this theme.

  • Jplayer  www.jplayer.org 
  • Flexislider www.woothemes.com/flexslider
  • Auto Height www.github.com/alexdunphy/flexible-textareas
  • Modernizr Custom Build www.modernizr.com