=== Genesis Layout Extras ===
Contributors: daveshine, deckerweb
Donate link: http://genesisthemes.de/en/donate/
Tags: genesis, genesiswp, genesis framework, layout, layouts, layout manager, post, page, singular, attachment, search, taxonomoy, 404 error, 404 page, bbPress, CPT, AgentPress Listings, agentpress, deckerweb
Requires at least: 3.2
Tested up to: 3.4
Stable tag: 1.3
License: GPLv2 or later
License URI: http://www.opensource.org/licenses/gpl-license.php

This plugin for Genesis Framework allows modifying of default layouts for homepage, various archive, attachment, search, 404 pages via theme options.

== Description ==

With this **lightweight plugin** for the popular Genesis Framework you can very **easily modify** the **default layouts** for homepage, singular pages (for posts and pages), various archive sections, author pages, attachment pages, search results pages, the 404 page - all done via a new theme options page. Just look for it at the submenu: Genesis > "Layout Extras".

As a smart bonus the plugin also includes the layout setting for the new bbPress 2.x forum plugin which itself is compatible to Genesis. Also added is the layout setting for other plugins from the Genesis ecosystem or other third-party authors: for example "AgentPress Listings" which includes the custom post type "listings" and the taxonomy "features". See below listings for full explanation:

= Included regular WordPress Sections for a Default Layout Setting =
* Home Page (works with home.php or static page as front page)
* Search Results Page (if there are results)
* Search not found Page (if there are NO results) [new since v1.3]
* 404 Error Page
* "Post" Page (singular post views)
* "Page" Page (singular page views)
* Attachment Page (singluar attachment views)
* Author Page
* Date Archive Page (optional with setting for Year, Month, Day)
* Category Page
* Tag Page
* Taxonomy Page

= Supported Custom Post Types set by Plugins =
* Plugin: **AgentPress Listings**: Archive Page for Custom Post Type "Listings" - plus taxonomy "Features"
* Plugin: **Genesis Media Project**: Archive Page for Custom Type "Video" - plus taxonomies "SlideShows", "Video Categories", "Video Tags"
* Plugin: **bbPress 2.x Forum** (all areas) - Integration plugin recommended: [bbPress Genesis Extend](http://wordpress.org/extend/plugins/bbpress-genesis-extend/)
* Plugin: **WooCommerce**: for all taxonomy pages for "Product Categories" and "Product Tags" - Integration plugin recommended: [Genesis Connect for WooCommerce](http://wordpress.org/extend/plugins/genesis-connect-woocommerce/)
* Plugin: **Jigoshop**: for all taxonomy pages for "Product Categories" and "Product Tags" - Integration plugin recommended: [Genesis Connect for Jigoshop](http://jigoshop.com/extend/genesis-connect-for-jigoshop/)
* Plugin: **Easy Digital Downloads**: Archive Page for Custom Type "Downloads" - plus taxonomies "Download Categories" and "Download Tags" - Integration plugin recommended: [Genesis Connect for Easy Digital Downloads](http://wordpress.org/extend/plugins/genesis-connect-edd/)

= Supported Custom Post Types set by Child Themes =
* Child Theme: **Clip Cart** by Themedy Themes: Archive Page for Custom Post Type "Products" - plus taxonomy "Product Categories"
* Child Theme: **Stage** by Themedy Themes: Taxonomy "Photo Galleries"

= Localization =
* English (default) - always included
* German - always included
* French - user-submitted, thanks to [Grégoire Noyelle](http://www.gregoirenoyelle.com/) - currently 79% complete for v1.3
* Italian - user-submitted, thanks to [Marco Rosselli](http://www.prenotazionetraghetti.com/) - currently 79% complete for v1.3
* .pot file (`genesis-layout-extras.pot`) for translators is also always included :)
* Easy plugin translation platform with GlotPress tool: [Translate "Genesis Layout Extras"...](http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-layout-extras)
* *Your translation? - [Just send it in](http://genesisthemes.de/en/contact/)*

**Please note: The plugin requires the Genesis Theme Framework**
The plugin has been tested with WordPress 3.2, 3.3+ and 3.4-beta3 without any issues. It also works within Multisite installs - single activated and also network activated. Running with latest versions of Genesis and WordPress is always recommended.

Credit where credit is due: This plugin here is based on the work of WPChildThemes for the great "Genesis Layout Manager" Plugin.

[A plugin from deckerweb.de and GenesisThemes](http://genesisthemes.de/en/)

= Check out my other Genesis Plugins =
* [Genesis Social Profiles Menu](http://wordpress.org/extend/plugins/genesis-social-profiles-menu/) - get social
* [Genesis Toolbar Extras](http://wordpress.org/extend/plugins/genesis-toolbar-extras/) - one plugin to rule them all :)
* [Genesis Dashboard News](http://wordpress.org/extend/plugins/genesis-dashboard-news/) - #GenesisWP news right there in your dashboard!
* [Genesis Printstyle Plus](http://wordpress.org/extend/plugins/genesis-printstyle-plus/) - just print it out - only what's needed
* [Genesis Single Post Navigation](http://wordpress.org/extend/plugins/genesis-single-post-navigation/) - browse your single posts
* [Genesis Widgetized Footer](http://wordpress.org/extend/plugins/genesis-widgetized-footer/) - easily set up your copyright/ credits/ back to top
* [Genesis Widgetized Not Found & 404](http://wordpress.org/extend/plugins/genesis-widgetized-notfound/) - be prepared for the edge cases
* [Genesis Connect for Easy Digital Downloads](http://wordpress.org/extend/plugins/genesis-connect-edd/) - plugin for easy & elegant integration

= Feedback =
* I am open for your suggestions and feedback - Thank you for using or trying out one of my plugins!
* Drop me a line [@deckerweb](http://twitter.com/#!/deckerweb) on Twitter
* Follow me on [my Facebook page](http://www.facebook.com/deckerweb.service)
* Or follow me on [+David Decker](http://deckerweb.de/gplus) on Google Plus ;-)

= More =
* [Also see my other plugins](http://genesisthemes.de/en/wp-plugins/) or see [my WordPress.org profile page](http://profiles.wordpress.org/users/daveshine/)
* Tip: [*GenesisFinder* - Find then create. Your Genesis Framework Search Engine.](http://genesisfinder.com/)

== Installation ==

1. Upload the entire `genesis-layout-extras` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. In your "Genesis Theme Settings" menu go to "Layout Extras", setup your default layouts and you're good to go :).
4. General usage: Set layout options DIFFERENT from the Genesis default *for special sections*.

= Choose from one of the following layouts =
* Genesis Default (your default setting from Genesis Theme settings)
* Content-Sidebar
* Sidebar-Content
* Content-Sidebar-Sidebar
* Sidebar-Sidebar-Content
* Sidebar-Content-Sidebar
* Full Width Content

**Note:** This plugin has been tested with WordPress 3.2, 3.3+, 3.4-beta without any issues. It also works within Multisite installs - single activated and network activated, too. Remember, running with latest versions of Genesis and WordPress is always recommended.

**Also Note:** Installed/active Genesis Framework, version 1.7 or higher (1.8+ recommended!), is required for this plugin in order to work!

**Own translation/wording:** For custom and update-secure language files please upload them to `/wp-content/languages/genesis-layout-extras/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like `genesis-layout-extras-en_US.mo/.po` to achieve that (for creating one see the tools on "Other Notes").

== Frequently Asked Questions ==

= You can modify the layout of the plugin's AgentPress Listings post type. What does this mean? =
Nothing spectacular, you just can set the layout option for the archive pages of the "listings" post type, plus for all terms of its built-in "features" taxonomy. - Of course, the plugin (and so the setting in there) could be used with the AgentPress child theme and also with any other Genesis child theme, so this setting might come in really handy ;-).

= I noticed that some settings have no effect at all, what happens here? =
This has to do with priorities. In general, if there's a template for a specific page (archive) type, for example `image.php` for image attachment display, then Genesis & WordPress will always use that first for the content output AS LONG AS there's an layout setting function or filter in there. Only if there are no templates with layout settings found, the layout option settings will take full effect. So, if our example `image.php` has a layout filter set in this then has the higher priority but if there's no layout filter in there then the plugin's layout setting will take effect! - Well, if you experience such cases just leave these fields on "Genesis Default" and you're good to go :-). (You might call that a limitation of the plugin or whatever but that's the intended behavior of WordPress & Genesis.)

= With my child theme some of the layout options have no effect, what happens here? =
This is the case when a child theme doesn't support one or more specific layout options. For example: When a child has unregistered the layout option "Sidebar-Sidebar-Content" then the plugin setting of "Sidebar-Sidebar-Content" will have no effect at all. This is absolutely logical behavior because the plugin can only set options which are supported by the active child theme. (You can call that a limitation of the plugin or whatever but that's the behavior as of now. You could change your child theme or just re-register the specific layout option you want in your child theme.)

= What means Reset of settings? =
Actually it just restores the default layout setting which is always defined in regular layout settings on the Genesis Theme Settings page.

= Which settings are effected when doing a reset? =
**ALL** available options are resetted to their defaults!
So if you for example only want to reset *one* option and leave all other as they are then only change this one section and then click the SAVE button and you're done.

= Is this plugin Multisite compatible? =
Yes, it is! :) Works really fine in Multisite invironment - here I just recommend to activate on a per site basis so to load things only where and when needed.

= In Multisite, could I "network enable" this plugin? =
Yes, you could. -- Still, a per site use is recommended.

== Screenshots ==

1. Genesis Layout Extras - admin options page - WordPress default section.
2. Genesis Layout Extras - admin options page - optional plugin support section (CPTs).
3. Genesis Layout Extras - admin options page - optional child theme support section (CPTs).
4. Genesis Layout Extras - admin options page - layout drop-down menu.
5. Genesis Layout Extras - screen options.
6. Genesis Layout Extras - help tabs.

== Changelog ==

= 1.3 (2012-05-01) =
* *New plugin features:*
 * NEW: Performance optimization - restructuring and splitting of code into several files, loading only where and if needed. Plugin support stuff only appears now if one of the supported plugins is active!
 * NEW: Added new option for 'Search not found' page - when there are NO search results (for example very handy to set a full-width layout for this case...).
 * NEW: Added support for more custom post type by plugins:
  * --> "Genesis Media Project" by Nick Croft (free)
  * --> "Easy Digital Downloads" by Pippins Williamson at PippinsPlugins.com (free)
  * --> "WooCommerce" by WooThemes (free)
  * --> "Jigoshop" by Jigowatt Ltd. (free)
 * NEW: Added support for custom post type by child themes: "Clip Cart" and "Stage" both by Themedy Themes brand.
 * NEW: Added support for "Features" taxonomy of the already supported AgentPress Listings plugin.
 * NEW: Up to three meta boxes on options page - draggable and settings via "Screen options"
 * NEW: Added "Save" button to each section in a meta box for easier handling - I guess this is much more user friendly :).
* UPDATE: Simplified Genesis detection on installation, making it much more future-proof and user-friendly.
* UPDATE: Improved the language files a lot, by optimizing and re-using a lot of strings and especially by removing almost all markup from the strings!
* UPDATE: Completely deprecated old contextual help system (from prior WordPress 3.3) - in favor of supporting the help tabs system, in a more extended form :)
* CODE: Beside new features, minor code/documentation tweaks and improvements.
* CODE: Successfully tested against Genesis 1.8+ plus WordPress 3.3 branch and new 3.4 branch. Also successfully tested in WP_DEBUG mode (no notices or warnings).
* UPDATE: Updated and optimized all screenshots, plus added some new ones.
* UPDATE: Updated, corrected and improved readme.txt file, especially the FAQ section.
* NEW: Added new French translation by [Grégoire Noyelle](http://www.gregoirenoyelle.com/)
* UPDATE: Updated German and Italian translations and also the .pot file for all translators!
* UPDATE: Extended GPL License info in readme.txt as well as main plugin file.
* NEW: Easy plugin translation platform with GlotPress tool: [Translate "Genesis Layout Extras"...](http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-layout-extras)

= 1.2 (2011-12-22) =
* Added new help tab system for WordPress 3.3 -- this time the plugin is also still compatible with old contextual help prior WP 3.3 but PLEASE NOT that I will remove this soon and then the plugin will require WordPress 3.3+ so please update now your WordPress installation!
* Bugfix: Wrapped conditional around `genesis_get_option` function to allow error-free theme changing (from Genesis to a non-Genesis theme) -- Please note: this also fixes the Multisite errors when plugin is network activated! -- Props to WP.org user "greghile" for reporting the Multisite issue!
* Minor code and code documentation improvements
* Wording: Changed strings "bbPress 2.0" to "bbPress 2.x" to reflect ongoing development & releases of that forum plugin
* Added new Italian translation by Marco Rosselli
* Updated German translation files
* Updated included .pot file (`genesis-layout-extras.pot`) for translators
* Added banner image on WordPress.org for better plugin branding :)

= 1.1 (2011-10-06) =
* Improved homepage layout setting with adding the conditional statement `is_front_page()` so also static pages set as homepage (in WordPress: Settings > Reading) are now supported!
* Added new specific date layout options for Year, Month, Day - please note, that the general date setting will overwrite the other three settings (these have lower priority) - so, when in doubt, only use the general setting or leave on default
* Updated help texts where needed
* Added new user questions to FAQ section here
* Updated German translation files
* Updated included .pot file (`genesis-layout-extras.pot`) for translators
* Some more minor code tweaks and cosmetic changes :)

= 1.0 (2011-10-01) =
* New and forked version of the plugin under new name and authorship by David Decker of deckerweb.de and GenesisThemes
* Updated, improved and documented code
* Added separate options page under the Genesis menu - no longer hooking in to regular Genesis settings - this is more user friendly and less confusing (See Genesis > Layout Extras)
* Added new layout options for attachment page, bbPress Forum and AgentPress Listing custom post type
* Added contextual help - tab on the top right corner of the options page
* Added settings link to the plugin page section
* Fully localized the plugin, working out of the box!
* Added German translations (English included by default)
* Improved and documented plugin code
* Tested & proved compatibility with WordPress 3.3-aortic-dissection :-)

= 0.1 =
* First release (former author "WPChildThemes")

== Upgrade Notice ==

= 1.3 =
Major additions & improvements: Added a new layout option; extended plugin & child theme support. Performance & code optimization. Updated all translations plus .pot file for translators.

= 1.2 =
Several changes - Bugfix regarding theme changes and Multisite installs. Updated help system to fit better into WordPress 3.3. Added Italian translation. Other minor tweaks and improvements. Also updated German translations and .pot file for all translators.

= 1.1 =
Several changes - Enhanced homepage and date archive settings, improved info, help and documentation texts (contextual help and plugin's readme.txt).

= 1.0 =
All changed - Actually a whole new plugin, updated all over the place. Also the plugin name and authorship changed.

= 0.1 =
First (and to date only) release under former plugin name and by former plugin author.

== Plugin Links ==
* [Translations (GlotPres)](http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-layout-extras)
* [User support forums](http://wordpress.org/tags/genesis-layout-extras?forum_id=10)

== Donate ==
Enjoy using *Genesis Layout Extras*? Please consider [making a small donation](http://genesisthemes.de/en/donate/) to support the project's continued development.

== Translations ==
* English - default, always included
* German: Deutsch - immer dabei! [Download auch via deckerweb.de](http://deckerweb.de/material/sprachdateien/genesis-plugins/#genesis-layout-extras)
* French: Français - user-submitted by [Grégoire Noyelle](http://www.gregoirenoyelle.com/)
* Italian: Italiano - user-submitted by [Marco Rosselli](http://www.prenotazionetraghetti.com/)
* For custom and update-secure language files please upload them to `/wp-content/languages/genesis-layout-extras/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that as well, just use a language file like `genesis-layout-extras-en_US.mo/.po` to achieve that.

**Easy plugin translation platform with GlotPress tool: [Translate "Genesis Layout Extras"...](http://translate.wpautobahn.com/projects/genesis-plugins-deckerweb/genesis-layout-extras)**

*Note:* All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome ["Codestyling Localization" plugin](http://wordpress.org/extend/plugins/codestyling-localization/) and for validating the ["Poedit Editor"](http://www.poedit.net/), which works fine on Windows, Mac and Linux.

== Check out my other Genesis Plugins ==
* [Genesis Social Profiles Menu](http://wordpress.org/extend/plugins/genesis-social-profiles-menu/) - get social
* [Genesis Toolbar Extras](http://wordpress.org/extend/plugins/genesis-toolbar-extras/) - one plugin to rule them all :)
* [Genesis Dashboard News](http://wordpress.org/extend/plugins/genesis-dashboard-news/) - #GenesisWP news right there in your dashboard!
* [Genesis Printstyle Plus](http://wordpress.org/extend/plugins/genesis-printstyle-plus/) - just print it out - only what's needed
* [Genesis Single Post Navigation](http://wordpress.org/extend/plugins/genesis-single-post-navigation/) - browse your single posts
* [Genesis Widgetized Footer](http://wordpress.org/extend/plugins/genesis-widgetized-footer/) - easily set up your copyright/ credits/ back to top
* [Genesis Widgetized Not Found & 404](http://wordpress.org/extend/plugins/genesis-widgetized-notfound/) - be prepared for the edge cases
* [Genesis Connect for Easy Digital Downloads](http://wordpress.org/extend/plugins/genesis-connect-edd/) - plugin for easy & elegant integration

== Additional Info ==
**Security:** The plugin uses the Genesis Sanitization class for checking and filtering all custom inputs. Further, the plugin uses WordPress and Genesis Framework APIs and coding standards to the highest possible extend. Just to make sure you get a quality, future-proof product.

**Idea Behind / Philosophy:** I had liked the general approach of the former plugin (I forked from) - which provided a simple and great way to set a few needed options. Since it seemed no longer to be developed and updated I just decided to make a fork of it and add some additional functionality like setting the layout setting for the (awesome!) bbPress 2.x forum plugin in Genesis. And, I wanted this all on an extra options page, divided from the general Genesis settings because that is much more user friendly IMHO. In addition I added full inline documentation including the contextual help function provided by WordPress itself to create a more seamless user experience.