This document covers the installation, set up, and use of this theme and provides answers and solutions to common problems. We encourage you to first read this document thoroughly if you are experiencing any difficulties before contacting our support team.
If you have any questions that are beyond the scope of this document, feel free to ask us via our dedicated help center.
After downloading the theme package open the folder named “emma-package”, un-zip the folder if it is not already so. Inside the theme package folder you will find the following files:
To upload through your Dashboard, select “Appearance” and then “Themes”. 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.
The theme files will be stored on your server in the
When uploading your theme with the installer, please ensure you are uploading the theme .zip file, not the entire package you downloaded. In this case, you will be uploading emma.zip.
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 Emma folder into the: wp-content/themes folder.
Once uploaded, activate the theme by heading to the “Themes” menu in the WordPress Dashboard. Locate the Emma theme and hit “Activate”.
Premium Theme Installation
If you're looking for WordPress theme installation and setup to look exactly like the live theme demo - then we're here to help. Fast & simple for only $49.
Our in-house team of professional developers will install the theme, upload the demo XML file, and setup your website exactly like the live demo. Frustration free. Complete your purchase of the Premium Installation service by clicking the link above and send us your deliverables.
- Domain name
- FTP information
- WordPress admin credentials
- Theme files or ThemeForest item purchase code
If you have a problem with the theme or found a bug, please let us know via our official Help Center. We take pride in our customer support and we will do what we can to assist you. If you are experiencing a theme issue, please first turn off all third party plugins to see if the problem persists.
We are happy to help with setup & bugs you may stumble upon though we cannot support CSS customizations.
To set up the Home Template, simply create a page using the “Home" template and publish it. Then in the WordPress Dashboard > General > Reading Settings - you must set your Posts page, which will be the default index page, and your home page (the page you just created).
Alternatively, you may select the page in the Theme Customizer.
The Home Template is unique in the fact that it draws up to five different sections of content, which are based on pages you create, simply by adding them via the Home Settings section of the Theme Customizer.
It is rather important to set your theme menu in the WordPress Dashboard. To do this, locate the Menu options by selecting the “Appearance” tab from the dashboard sidebar and then “Menus”.
Once you’re viewing the Menus, create a new menu and save it. After you’ve saved the menu, you can add it to a menu via the Menu Settings, below the Menu Structure area. Add your pages and links to the menu you just created in the Menu Structure area.
Dedicated Mobile Menu
To enable your custom mobile menu, simply create a new menu, save, and assign it to the Mobile Navigation menu location.
To create a new 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. Don't forget to upload your featured image!
Emma has the following templates built into the theme and can be applied by creating and saving a page in WordPress.
- Home Template
- RSVP Template
- Default Template
Page Featured Images
Don't forget to upload page featured images on your pages in order to use one in your fullscreen hero areas. You can add featured images via the Featured Image meta module, located below the Publish and Page Attributes metaboxes, on the right side of your page editor.
On each page you'll see a Page Meta Settings metabox, located below the page content editor. This metabox includes the options to display a page tagline (on page templates other than the Home Template), enable the feature image backround on the Home Template, and set a text color for the hero area (top of page).
- Flickr Photostream Widget
- Video Embed Widget
Bean Plugin Widgets
The following widgets are provided with our compatible array of free plugins.
- Bean Tweets Widget
- Bean Instagram Widget
- Bean Social Widget
- Bean Dribbble Widget
- Bean 500px Widget
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.
Widget Area Generator
To create a widget area, locate the "Widget Areas" link on the WordPress Dashboard, under the “Appearance” tab. Once you are in the manager, select “Add New”. Next, name the widget area, choose your conditions, select the current widget area to replace, then hit “Publish”.
Return to your Widgets Dasboard and you will find your new widget area has been added and is abiding by the conditions you have set. Add your widgets here and you will see them change based on the conditions (templates, pages, ect.) that you chose.
Accessing the Customizer
To access the live Theme Customizer, you may select the Customize button in the admin bar dropdown or select
"Customize" from the Dashboard menu. Note that you must be logged in as a site administrator in order to access the controls.
1. Site Title & Tagline
Set your site title and the tagline.
2. Theme Settings
Enable Retina.js and enable the Bean Framework SEO metaboxes.
3. General Settings
Upload your logo/login logo/favicon/apple touch icon, RSVP contact email address, and even add your Google analytics script.
4. Home Settings
Set your Home Template title tagline and add each of your pages as individual sections. You may add up to five sections on your home template.
Change up the theme's background by simply selecting an alternate color or uploading an image.
2. Custom Styles
Easily manipulate the theme accent color CSS elements throughout the theme with the color picker in this tab.
3. CSS3 Filter Options
Within the Custom Styles section of the Theme Customizer, you'll find a select field to set an optional CSS3 Filter value (grayscale & sepia). If activated, your posts and the home template will default with the selected filter active.
Note that these filters only function in modern versions of browsers.
4. 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. Get help learning the art of CSS →
CSS entered in the Custom CSS editor will override all other theme stylesheets. Deleting the styles inputted here will allow the stylesheets display.
Emma is compatible with many of our custom developed WordPress Plugins. Head over to our website and download our free plugins now →
- Bean Portfolio
- Bean Shortcodes
- Bean Tweets
- Bean Instagram
- Bean Social
- Bean 500px
- Bean Dribbble
- Bean Pricing Tables
- Bean Registry
Emma is compatible with our custom free plugin, Bean Registry. Utilize Bean Registry to include an array of registry locations for your speacial occassion.Check out Bean Registry on our website.
Once installed, simply click on the Bean Registry shortcode button, located on your WP Page/Post editor. You'll see a dropdown with a list of available shortcodes. Select a registry location and add your specific url to the URL value in the shortcode.
For example, a registry shortcode to amazon would look like this:
[bean_registry registry="amazon" url="http://example.com"]
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.
HD Retina Assets
Emma has particular @3x CSS located in mobile.css, which utilizes the images appended with @3x ex: firstname.lastname@example.org within the
/assets/images/retina folder on HiDPI screens.
If you'd like to add more @3x assets, simple save your image at 300% (we use Photoshop) and add it to the
/assets/images/retina folder. Then look for the following CSS at the bottom of mobile.css and add your CSS element with a background image pointing to your new image:
You may need to add the
background-sizeattribute to the element if you have not already added it to the standard retina query.
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: ex: email@example.com will replace logo.png
WordPress will modify the asset name of any identically named uploads. Make sure your retina assets are the named identically - with "@2x" appended.
If you've requested and entered your theme license key, then you'll automatically be notified of any theme updates as we push them. This is the most effective method for getting updates pushed to you quickly and effienctly. Read more about theme licenses.
Check for Updates
To check your theme version, click the live changelog link below and check the version number at the top of the changelog.txt file:
Relay the changelog version at the top of that changelog.txt file with the version in your WordPress Dashboard > Appearance > Themes section to see if your theme files are up to date.
If you are in need of the update, download the current build from the location you purchased the theme from (either ThemeForest, Creative Market or via your account dashboard) to install the updated theme.
If you have an active license key applied to your theme, you will receive live update notifications to which allows one-click updates directly from your WordPress dashboard.
If you have not customized the original theme files then you may simply drop the updated theme folder contents into the theme folder on your server – which is located in wp-content/themes/emma.
If you wish to upload the entire updated theme as a separate theme, ensure you:
- Rename the updated theme’s folder (different from the current theme)
- Drop the renamed theme folder into wp-content/themes
- Switch to the new theme via your WordPress Dashboard
If you choose to upload the whole theme and switch to it, you may lose your Theme Customizer data and will have to add those back in.
FTP Selective Updating
On the other hand, if you have customized some files in the core theme contents, you should consider selective updating, which simply means updating only the files that are pointed out in the theme’s changelog.
There are a couple programs out there that will allow you to compare versions of files, in order to catch customizations you may not remember. Some recommended programs are WinMerge (Windows), Kaleidoscope (OSX), and handy GitHub (OSX) & (Windows).
Overall, the safest and cleanest way to update your theme is to leave your currently modified theme on your server/site as is, rename the folder of the newly updated theme, upload the new theme, and modify that to match your original custom work. In this way, if something has gone wrong with the new version, you’re just a few clicks away from getting things back to how they originally were.
Please note that ThemeBeans is not responsible for content loss, database errors and such, which may happen to your WordPress install upon an incorrectly applied theme update.
Locating your Key
Below are the different locations you may purchase our themes and clarifying instructions on locating your license per each.
1. Purchased from ThemeBeans
You should have received an email purchase receipt with your theme license key attached. Be sure to check your spam mailbox, just in case the receipt was filtered on accident. That’s it!
2. Purchased from ThemeForest
Locate your item purchase code from ThemeForest and then complete the license request form. Once you’ve sent us your request, we’ll email you a license key for your verified theme purchase.
Please only submit one request per purchase code. It may take up to 24 hours to process your request and generate your license key.
Below is a graphic depicting how to find your item purchase code:
3. Purchased from Creative Market
Contact our support team with your Order ID (which is located on your purchased product’s invoice. Once again, after we’ve verified your purchase, we’ll email you a license key for your verified theme purchase. Below is a graphic depicting how to find your purchase order ID.
It is important to keep your license up to date in order to continue getting updates for your ThemeBeans WordPress theme and support for any issues you may encounter. Renewing your license grants you access to support and updates for another year, including all updates for bug fixes and feature introductions.
Once you've located your license key you may enter the key on the Theme License admin page, located on your
WP Dashboard > Appearance > Theme License. Once your license key is entered, hit the “Activate” button. Upon a successful activation you’ll see a green “Active” tag next to the input field.
If your key is not applied after hitting the Activate button, simply re-enter the key and try again. Sometimes it takes a few tries to properly establish a connection with the activation server.
Theme license key and update notification support only apply to our WordPress themes running our Bean Framework v2.2 and forward.
Bean Feature Setup
As a quick reference point, you may have noticed the
bean_feature_setup function at the top of your theme’s functions.php file. Within this function there are a few true/false statements – set to activate or deactivate various features and functionality within the theme.
We recommend that after installing the included child theme, activate it and then copy this function into your child functions.php file. This way you can turn off/on features from your the child - and your changes will never be overwritten.
The above is just an example of the
bean_feature_setupfucntion. You should grab the function from your downloaded theme package to copy into your child theme - DON'T use this one.
If you'd like to add another menu location to use in the theme, search for the
bean_theme_setup function in your theme's functions.php file and copy that whole function to your child theme.
bean_theme_setup function you'll see the standard register_nav_menus function. Simply create another copy/paste another line with a unique location identifiers and name. The code below creates two separate menus locations that are selectable via the
WP Dashboard > Appearance > Menu page.
Adding your menu to the theme.
Now that you've created the menu, you can use it in your theme's files. As always, we suggest utilizing a child theme to make file modifications.
The code below is an example of the wp_nav_menu function that displays your created navigation window. There is quite a few parameters associated with this function, so take a look at it's official reference to see all that you can do.
Add Image Sizes
If you'd like to add another image size for your WordPress instance to automatically size for, search for the
bean_theme_setup function in your theme's functions.php file and copy that whole function to your child theme (if you have not already done so).
You'll want to look for
add_image_size within the
bean_theme_setup function and copy/paste a new line in. Below is an example of the
Note that the first numeral value is the image's width and the second is the height. Read more about the parameters of the
add_image_size function on the WordPress reference site.
Using image_size in your theme.
It's pretty simple to utilize your new image size within your theme templates. Here's an example using the above
Note that you will need to regenerate your images if you're trying to create an image size for images already uploaded to your WordPress Media Library.
As part of our v2.0.5 Bean Framework update, we’ve added an option to completely whitelabel the theme framework. Set the
"whitelabel" value to
"true" within the
bean_feature_setup function and the default ThemeBeans favicon, logo and general references to ThemeBeans will be removed.
This is a great addition those developers out there who are customizing ThemeBeans themes for clients. There’s no need to dive in and “rip” out code.
Files & Sources
These are the primary CSS files used for general front-end styling. Use these to customize your theme even further.
- style.css primary stylesheet
- assets/css/mobile.css responsive stylesheet
- fitvids www.fitvidsjs.com
Template PSDs and image asset source files are included within the theme's
/sources folder. These files contain the necessary elements for customizing Emma even further.
Our Focus is to design & craft the most proficient and trustworthy themes and plugins available in the WordPress eco-system.
Our Philisophy is that each product our team builds is thoughtfully executed with a simplistic and intuitive focus, down to the last line of code.
We strive to maintain a strong symbiotic relationship with the core WordPress CMS and our team diligently updates each theme and plugin to ensure seamless update transitions. All in all, we like to keep our products well oiled and running smoothly.
Our latest premium WordPress themes. Each theme in our collection is meticulously crafted to afford the best user experience possible, for novices & developers alike.