bliss - wpm

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. It implements the Options Framework by Devin Price, and the Cycle2 jQuery slideshow animation by M. Alsup.

Installation

Download the theme files from the repository at http://wordpress.org/themes/bliss
Unzip the compressed folder
Copy the theme folder to your WordPress installation's themes folder, usually located at /wp-content/themes/
Activate the theme from your installation's Admin interface, Appearance > Themes

Suggested setup

Under Settings > Reading > Front page displays, select "A static page" and choose your homepage from the dropdown menu.
Under Appearance > Menus, create the menus that your website will use, and assign them to the appropriate positions on the "Manage Locations" tab.
Add a Featured Image to your homepage, or create a slideshow as described in the Frequently Asked Questions.
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

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

Frequently Asked Questions

Add icons

See the Font Awesome documentation for examples on adding icons to your website content.

Adding your logo image to the header

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

Changing the background color

From your site's wp-admin interface, select Appearance > Theme Options
Select the "Basic Settings" tab if it is not already selected
From the "Primary Color" section, select your desired background color from the dropdown menu.
Click "Save Options."
Your website now displays the background color of your choice.
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.

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.

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

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".

Creating a slideshow

From your site's wp-admin interface, select Appearance > Theme Options
Select that "Slideshow Settings" tab
Check the select box that says, "Create and Use Slideshow 1"
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.
Click "Save Options"
Within your site's wp-admin, navigate to edit the page where you want the slideshow to appear (Pages > All pages > selected page > Edit)
Locate the form field marked, "Your custom inputs" below the text editor.
Next to "Slideshow options" is a dropdown menu.
Select "Use Slideshow 1" from the dropdown menu.
Click "Update"
Your selected page now displays your slideshow with a fancy animation.

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:

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

Changelog

1.2.0 Numerous bug fixes and improvements. * Improved color schemes, resolved CSS conflicts * Fixed Cusomizer integration for background color and background image * TODO: when "use slideshow" is UN-checked it should remove that option!! * TODO: add Font selector to Theme Options. Users will be able to select from a choice of several font faces. 1.1.1 Makes margins a little wider, body grey a little lighter. Corrected hover state color for button links in brown color scheme. 1.1.0 *Color scheme now defaults to "New Blue". If you have been running Bliss for a while but you have NEVER clicked the "Save Options" button on the "Bliss Theme Options" menu (really?), we recommend clicking that button once prior to installing this update. If you have already made the update, you can easily get back to the old look by selecting the "Light Grey" color scheme from the "Primary Color" dropdown menu on the "Bliss Theme Options" page. *"Display search form in header bar" now defaults to false. Control the search form display by (un)checking the box under Appearance > Bliss Theme Options > "Show search form in header bar". Be sure to click "Save Options" when you're done. 1.0.15 Additional CSS fixes & new color scheme wrap, preparatory to release on WordPress.org. Add .map file for minified cycle2.js to stop 404 errors when viewing on dev / edge builds (eg Chrome Canary).
1.0.14 Fix relative path for admin.css @import rule. 1.0.13 Begin theme upgrade. Introduce new color schemes with improved contrast. Retains old color scheme selections for legacy installation support.
1.0.12 Change "read more" link icon to right arrow (instead of right arrow in a circle) and similar for prev/next post icons. 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 (version 1.9.1) 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.

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.

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.

Plugin compatibility

When running "Bliss" with the plugins "Event Organiser" and "Yoast SEO," if you notice the event taxonomy archive pages have a title that says "0" improperly and the "body" element has class "eo-tc-page," you can fix this by simply changing the Event Organiser plugin option to "Enable template handling" under Settings > Event Organiser > Templates.

License

Bliss theme

"Bliss" theme for WordPress is copyright 2014-2016 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 for Mardesco, and are licensed under the GPLv2.

Additional resources

The theme also incorporates the following scripts and resources.

Cycle2

Options Framework

Merriweather Bold Italic font face

Merriweather is copyright 2013 by Eben Sorkin and licensed under the SIL open font license v1.1. 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

Simple Breadcrumb Navigation

This theme incorporates the Simple Breadcrumb Navigation plugin, copyright 2008 by Christian "Kriesi" Budschedl and licensed under the GPLv3. 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.

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

Collapsing Nav Menu

HTML5 Boilerplate

Modernizr

Comments

Bundled images

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.