=== Bliss ===
Author: Mardesco
Author URI: http://www.mardesco.com
Donate link: http://www.mardesco.com/payments/
Theme URI: http://www.mardesco.com/themes/bliss/
Tags:  blue,custom-header,custom-background,custom-logo,custom-width,green,grey,featured-images,left-sidebar,maroon,mobile,options,responsive,responsive-layout,right-sidebar,theme-options
Requires at least: 3.7
Tested up to: 4.3
Stable tag: trunk
License: Bliss WordPress theme, copyright 2014 by Mardesco.  Bliss is distributed under the terms of the GNU GPLv2


A blissful website experience.  "Bliss" is a mobile-friendly, responsive WordPress theme.  Featuring theme options, to simplify your life.   Easily add a site logo, select a color scheme, create slideshows, and more.  

== Description == 

A blissful website experience.  "Bliss" is a mobile-friendly, responsive WordPress theme.  Built-in theme options let you easily add a site logo, select a color scheme, create slideshows, and more.

* Flexible and simple. Appropriate for beginners and advanced users alike.
* Theme option to easily add your company's logo to the header bar
* Integrated slideshows with theme options: no additional plugin required
* Mobile-friendly design responds to screen size of viewing device
* Easily select one of the five blissful built-in theme color schemes.
* Theme option for setting maximum container width
* Integrates custom-header and custom-background for easy customization.

Bliss is built on the [Widgeon Advanced framework by Jesse Smith](https://github.com/mardesco/Widgeon-Advanced).  It implements the Options Framework by Devin Price, and the Cycle2 jQuery slideshow animation by M. Alsup.

== Disclaimer ==

These files are provided "as-is" with the express understanding that they are not fit for any use or purpose, much less merchantability.  Use them at your own risk.    

= Support =
If you require support or assistance, you will find that the WordPress forums are an amazing resource.  Unfortunately, the theme author is unable to provide a large amount of free technical support for this theme.  However, your constructive feedback and suggestions are welcome.  

= Bug reports & suggestions =
If you spot a bug; if you notice a browser display inconsistency; or if you have an idea you'd like to see incorporated into a future update: please feel welcome to [post to the theme wiki](https://github.com/mardesco/bliss/wiki).

= Known rendering issue =
Heading fonts render with edges that appear rough or pixelated on Chrome 39.x for Windows.  A future release of this theme will examine the possibility of self-hosting the font (or a different font), to prevent the Chrome browser from importing the poorly supported .woff file.  See http://stackoverflow.com/questions/11487427/is-there-any-font-smoothing-in-google-chrome for a description of the issue, or contact the theme author with suggestions.

== License ==

= Bliss theme =

"Bliss" theme for WordPress is copyright 2014 by Mardesco.  Bliss is distributed under the terms of the GNU GPLv2.  The theme design and original theme source code were created by [Jesse Smith](http://www.jesse-smith.net) for [Mardesco](http://www.mardesco.com), and are licensed under the GPLv2.

= Additional resources =

The theme also incorporates the following scripts and resources.

= Cycle2 =

The [Cycle2 slideshow animation](http://jquery.malsup.com/cycle2/) is copyright 2014 by M. Alsup, and dual licensed under the MIT and GPL licenses.

= Options Framework =

The Options Framework is copyright 2013 by [Devin Price](http://wptheming.com/options-framework-theme/), and licensed under the GPLv2.

= Merriweather Bold Italic font face =

[Merriweather](http://www.google.com/fonts/specimen/Merriweather) is copyright 2013 by [Eben Sorkin](https://plus.google.com/106288796449831139244/about) and licensed under the [SIL open font license v1.1](http://scripts.sil.org/OFL). The Merriweather font face is an externally linked library.  It is not distributed with the theme code: website visitors download the .css font file from the Google Fonts API. 

= Font Awesome icon typeface =

[Font Awesome](http://fortawesome.github.io/Font-Awesome/) is copyright 2014 by [Dave Gandy](https://twitter.com/davegandy).  The typeface is licensed under the [SIL Open Font License v1.1](http://scripts.sil.org/OFL) and its accompanying CSS code is licensed under the [MIT license](http://opensource.org/licenses/mit-license.html).

= Simple Breadcrumb Navigation = 

This theme incorporates the [Simple Breadcrumb Navigation plugin](http://www.kriesi.at/archives/wordpress-plugin-simple-breadcrumb-navigation), copyright 2008 by Christian "Kriesi" Budschedl and licensed under the [GPLv3](http://www.gnu.org/licenses/gpl.txt).  This version of the plugin includes some modifications by Jesse Smith, and by Denzel of the Karma development team. Re: GPLv3 plugin inclusion, see [this post by @nacin](https://make.wordpress.org/plugins/2012/05/11/cross-posted-from-the-main-development-blog-the/).

= Metaboxes =

The built-in slideshow, and the subtitle feature, both implement metaboxes.  This metaboxes script was based on tutorials by Rilwis and Justin Tadlock.  The finished product is copyright 2014 by Jesse Smith and licensed under the GPLv2.

= Pagination =

The original pagination function is copyright 2011 by [C.Bavota](http://bavotasan.com/2011/simple-pagination-for-wordpress/), and licensed under the GPLv2 per the author's Tweet on 6-3-2014.

= Collapsing Nav Menu =

The JavaScript collapsing navigation menu feature is copyright 2014 by Jesse Smith and released under the MIT license.

= HTML5 Boilerplate = 

This theme incorporates elements of the HTML5 Boilerplate, which is copyright 2013 by the HTML5 Boilerplate Team and licensed under the MIT license.

= Modernizr =

The theme employs Modernizr for cross-browser support and backwards compatibility for HTML5 in older browsers.  Modernizr is copyright 2013 by the Modernizr Team, and released under the MIT license.

= Comments =

The theme file comments.php is more or less taken verbatim from the TwentyTwelve theme, copyright 2012 by the WordPress team and licensed under the GPLv2.

= Bundled images =

The screenshot images bundled with this theme are original works, copyright 2014 by Mardesco and licensed under the GPLv2. 

The photograph of the trees and clouds used as the "featured image" in the theme's bundled screenshot images is an original work, copyright 2014 by Jesse Smith.  The version of the work that comes bundled with the Bliss screenshot images, is licensed under the GPLv2.  

== Installation ==

1. Download the theme files from the repository at `http://wordpress.org/themes/bliss`

2. Unzip the compressed folder

3. Copy the theme folder to your WordPress installation's themes folder,
	usually located at `/wp-content/themes/`
	
4. Activate the theme from your installation's Admin interface, Appearance > Themes

= Suggested setup =

1. Under Settings > Reading > Front page displays, select "A static page" and choose your homepage from the dropdown menu.  

2. Under Appearance > Menus, create the menus that your website will use, and assign them to the appropriate positions on the "Manage Locations" tab.

3. Add a Featured Image to your homepage, or create a slideshow as described in the Frequently Asked Questions.

4. Under Appearance > Theme Options > Basic Settings, for the "Header navigation menu style," select the option "Full-width solid-color navigation menu..." and click "Save"

= Removal =

1. Deactivate and uninstall the theme from your installation's Admin interface, Appearance > Themes

== Frequently Asked Questions ==

= Adding your logo image to the header =

1. From your site's wp-admin interface, select Appearance > Theme Options
2. Select the "Basic Settings" tab if it is not already selected
3. Under Branding > Your Logo, upload your logo or select it from your media library.
4. Click "Save Options"
5. Your logo now displays in the headerbar of your public-facing site. 

= Creating a slideshow =

1. From your site's wp-admin interface, select Appearance > Theme Options
2. Select that "Slideshow Settings" tab
3. Check the select box that says, "Create and Use Slideshow 1"
4. Upload images for your slideshow, or use images from your media library. 
	NOTE: the theme does not presently crop or resize the selected images.  
	It is recommended that you select images of a uniform size.
5. Click "Save Options"
6. Within your site's wp-admin, navigate to edit the page where you want the slideshow to appear
	(Pages > All pages > selected page > Edit)
7. Locate the form field marked, "Your custom inputs" below the text editor.   
	Next to "Slideshow options" is a dropdown menu.  
8. Select "Use Slideshow 1" from the dropdown menu.
9. Click "Update"
10. Your selected page now displays your slideshow with a fancy animation.	

= Changing the background color =

1. From your site's wp-admin interface, select Appearance > Theme Options
2. Select the "Basic Settings" tab if it is not already selected
3. From the "Primary Color" section, select your desired background color from the dropdown menu.
4. Click "Save Options."
5. Your website now displays the background color of your choice.
6. Note that for more fine-grained control you can also go to Appearance > Background and set a background (both color and image) with the WordPress background customization interface.
	
= Managing the sidebars to suit your layout =

Please note: the theme's homepage and "full-width" template pages do not display any sidebars, regardless of this custom setting.

By default, the Widgeon Advanced theme displays a sidebar on the right-hand side of most pages and posts.
However, you can optionally display a left-hand sidebar in addition to, or instead of, the right-hand sidebar;
and you can optionally remove both sidebars for a clean single-column layout.  
To change the sidebar display:

1. From your site's wp-admin interface, select Appearance > Theme Options
2. Select the "Advanced Settings" tab if it is not already selected
3. Under the "Sidebar Options" dropdown menu, select the sidebar option that best suits your website.
4. Click "Save Options."
5. Your website now displays the desired sidebars. 
	
= Changing the maximum container width =

The default maximum container width is 1024 pixels for screens larger than 1024 pixels.  
You can increase this value to better utilize the display area available on large screens.
Alternatively, you can eliminate the container width setting, for a layout that fills 100% of all screen widths.

1. From your site's wp-admin interface, select Appearance > Theme Options
2. Select the "Advanced Settings" tab if it is not already selected
3. Type a number in the box. Do not enter units of measurement.  (This setting currently only accepts an integer.)
4. Click "Save Options."
5. Your website's container element's width has been set.

= Add icons =

See the [Font Awesome documentation](http://fortawesome.github.io/Font-Awesome/examples/) for examples on adding icons to your website. 

= Content columns =

For responsive content columns as seen in this theme's screenshot.png, all you need is a container element with the CSS class name "halves" or "thirds" wrapped around corresponding content elements with the CSS class name "one-third" or "one-half".

== Changelog ==

1.0.11 Rename a function within Options Framework to resolve collision. Note that add_theme_page() was in fact properly implemented by the framework all along.
1.0.10 Update to latest version of Options Framework because the earlier change to add_theme_page() did not resolve the automatic theme check conflict. 
1.0.9 Correct new theme review requirements: add .screen-reader-text CSS class; change options framework admin page feature to implement the add_theme_page() function; replace placeholder text domain in options framework files.
1.0.8 Add textdomain for improved internationalization.
1.0.7 Improve styling for "sticky" posts. Make "Read More" link a button with arrow icon. Same for "Previous Post" and "Next Post" links on single blog post pages.  Use magnifying glass icon in place of the word "search" on the search form.  
1.0.6 Create recommended WooCommerce-specific content page.  Declare theme support for WooCommerce.
1.0.5 Fix for navigation menu styling when user selected a color scheme from theme options but no menu had been saved (was resulting in nav menu items same color as background: no good!)
1.0.4 Add style rules: borders & alignment for td, th & blockquote; responsive width for figure element.
1.0.3 Allow user to change the title of the sidebar navigation menus. Check whether user has saved a sidebar menu, before attempting to output each menu.
1.0.2 Add check for is_archive to /includes/slideshows.php to fix PHP error when a page does not have a post_id. Also resolve container naming conflict with WooCommerce: change container id from "container" to "bliss_container." For good measure, also change element id "main" to "bliss_main." Update CSS accordingly. 
1.0.1 Add theme support for HTML5 elements in comment forms, galleries, and widgets.
1.0.0 Updated theme is released on WordPress.org. 
0.1.6 Add widget areas to footer.  Add social icon menu with Font Awesome icons to footer. Make the "branding" text smaller. New screenshot.png
0.1.5 Change default menu style from legacy buttons to the full-width nav menu introduced in version 0.1.1 (will only affect users who have never saved their preference: primarily, new theme downloads).  Add brown color scheme option.  Add container margin on left & right for mobile device screens; reduce top/bottom container margins for same.  Some code cleaning.
0.1.4 Add "Font Awesome" icon set.  Make rounded corners optional, for people who prefer that square look.  Front page template now uses the_content instead of the_excerpt.  
0.1.3 Corrected additional ThemeCheck requirements.  This is the second version released on WordPress.org
0.1.2  New screenshot.
0.1.1 Add the full-width menu bar design feature.  Button links in the header navigation menu are now optional.  404 "Not Found" error notifications are now optional per user feedback.  Add support for 3-deep nested header nav dropdown menus.  Add featured images to blogroll presentation. Additional CSS fixes.    
0.1.0 Fix title tag display for custom homepage (as described at http://codex.wordpress.org/Function_Reference/wp_title#Covering_Homepage). Add blog name to title tag on all other pages.  Assorted minor CSS rendering fixes and adjustments.  
0.0.13 Change file name page-full-width.php to template-full-width.php <-- This version was the initial release on WordPress.org
0.0.12 Trac ticket changes: additional footer nav menu CSS fixes; remove custom template declarations from non-custom template files
0.0.11 Correct mistyped CSS rule for footer nav menu
0.0.10 Correct action hook to 'after_setup_theme'
0.0.9 Changes per theme review. Removed "template name" tag from archives & other places where it did not belong.  Removed "blogroll" page template file. Corrected the default value of $contact_width global variable.
0.0.8 Fixed additional code quality theme review requirements (see trac ticket for details)
0.0.7 Fixed error on search page
0.0.6 Fixed function name error & additional theme review fixes.
0.0.5 "Policy requirements: license" and "Code quality" fixes and tweaks per trac ticket theme review by nitkr
0.0.4 Fixed "headers already sent" error.
0.0.3 Numerous tweaks and fixes. Enumerated resources and their licenses. Cleaned code in preparation for initial release. Added screenshot images.
0.0.2 Implemented theme options and slideshow. Theme-specific CSS design. Updated textdomain, descriptions, etc.
0.0.1 Created the project as a port of the Widgeon Advanced framework by Mardesco.