=== Genesis Layout Extras - Default Layouts in Genesis for WordPress === Contributors: daveshine, deckerweb, wpautobahn Donate link: https://www.paypal.me/deckerweb 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.4 plus Genesis 1.8+ Tested up to: 5.0 Requires PHP: 5.6 Stable tag: 2.0.0 License: GPL-2.0-or-later License URI: https://opensource.org/licenses/GPL-2.0 For Genesis Framework: Allows modifying of default layouts for homepage, various archives, taxonomies, post types, attachment, search, 404 pages. == Description == **Among the Top 7 most downloaded Genesis plugins ever :) Thank you!** = Set Default Layots in Genesis = With this **lightweight plugin** for the popular Genesis Framework you can very **easily modify** the (registered) **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*. Version 2.0.0 is a complete rewrite regarding code optimizations and also new features: The plugin now optionally adds up to nine (9!) additional layouts. Also, you can optionally add Layouts meta box support for post types inpost screens which don't have it yet. Plus, Genesis Archive Settings for post types could be enabled as well. As a smart bonus the plugin also includes the layout setting for the *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'. Just have a look on the below listings for full explanation. **Please note:** The plugin requires the *Genesis Theme Framework* (GPL-2.0+), a paid premium product released by StudioPress/ WPEngine, Inc. (via studiopress.com). = Video of Plugin's Settings Walkthrough (v2.0.0): = [youtube https://www.youtube.com/watch?v=WchU8FOJYyY] [**original video link**](https://www.youtube.com/watch?v=WchU8FOJYyY) *by plugin developer David Decker* = 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) * 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 = Plugins: 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) - plus "Topics" - Integration plugin recommended: [bbPress Genesis Extend](https://wordpress.org/plugins/bbpress-genesis-extend/) * Plugin: **WooCommerce**: for all taxonomy pages for "Product Categories" and "Product Tags" - Integration plugin recommended: [Genesis Connect for WooCommerce](https://wordpress.org/plugins/genesis-connect-woocommerce/) * Plugin: **Jigoshop**: for all taxonomy pages for "Product Categories" and "Product Tags" - Integration plugin recommended: [Genesis Connect for Jigoshop](https://www.jigoshop.com/product/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](https://wordpress.org/plugins/genesis-connect-edd/) * Plugin: **Sugar Events Calendar**: Archive Page for Custom Type "Events" - plus taxonomy "Event Categories" = Child Themes: Supported Custom Post Types set by Child Themes = * Child Theme: **Minimum 2.0** by StudioPress: Archive Page for Custom Post Type "Portfolio" * Child Theme: **Executive 2.0** by StudioPress: Archive Page for Custom Post Type "Portfolio" * These 10 Child Themes by **ZigZagPress brand**: *Bijou*, *Engrave*, *Eshop*, *Megalithe*, *Neo*, *Prestige*, *Single*, *Solo*, *Tequila*, *Vanilla* -- Archive Page for Custom Post Type "Portfolio" - plus taxonomy "Portfolio Category" for all these. * 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" = *Translations = * English (default, `en_US`) - always included * German (`de_DE`) - always included * French (`fr_FR`) - user-submitted, thanks to [Grégoire Noyelle](https://www.gregoirenoyelle.com/) - 50% complete for v2.0.0 :) * Italian (`it_IT`) - user-submitted, thanks to Marco Rosselli - currently 36% complete for v2.0.0 * Hindi (`hi_IN` - for India) - user-submitted, thanks to Love Chandel - currently 44% complete for v2.0.0 * Spanish (`es_ES`) - user-submitted - currently 11% complete for v2.0.0 * Swedish (`sv_SE`) - user-submitted - currently 11% complete for v2.0.0 * `.pot` file (`genesis-layout-extras.pot`) for translators is also always included :) * Easy plugin translation platform with GlotPress tool: [Translate "Genesis Layout Extras"...](https://translate.wordpress.org/projects/wp-plugins/genesis-layout-extras) = Personal Note from Developer (2018) = **Please note**, this plugin lives on, it is far from "dead"! I could not maintain it the last 5 years (August 2013 until August 2018), as I had personal issues keeping me from it. However, the plugin worked very well in almost all cases over the years, that is due to the super stable Genesis Framework. **UPDATE Will Come!** Yes, an update v2.1.0 is in the works since August 2018 and will release when it is ready (soon). So stay tuned. This will mostly be a maintenance release, though. But I am back and you will get further updates. That's what matters, right? ;-) = Check out my other Genesis Plugins = * [**Genesis Widgetized Not Found & 404**](https://wordpress.org/plugins/genesis-widgetized-notfound/) - be prepared for the edge cases * [**Genesis What's New Info**](https://wordpress.org/plugins/genesis-whats-new-info/) - show the what's new overview page via left-hand admin menu * [Genesis Shortcode UI (for Shortcake)](https://github.com/deckerweb/genesis-shortcode-ui) * [Genesis Elementor Canvas](https://github.com/deckerweb/genesis-elementor-canvas) * [Genesis Featured Page Extras](https://wordpress.org/plugins/genesis-featured-page-extras/) - more options for the featured page widget * [Genesis Prose Extras](https://wordpress.org/plugins/genesis-prose-extras/) - add-on for Prose child theme * [Genesis Printstyle Plus](https://wordpress.org/plugins/genesis-printstyle-plus/) - just print it out - only what's needed * [Genesis Widgetized Archive](https://wordpress.org/plugins/genesis-widgetized-archive/) - easily set up content for your Archive page (template) * [Genesis Widgetized Footer](https://wordpress.org/plugins/genesis-widgetized-footer/) - easily set up your copyright/ credits/ back to top * [Genesis Extra Settings Transporter](https://wordpress.org/plugins/genesis-extra-settings-transporter/) - addionally export Genesis specific plugin & child theme settings * [Genesis Connect for Easy Digital Downloads](https://wordpress.org/plugins/genesis-connect-edd/) - plugin for easy & elegant integration == My Other WordPress Plugins == * [**Toolbar Extras for Genesis & Elementor - WordPress Admin Bar Enhanced**](https://wordpress.org/plugins/toolbar-extras/) * [**Builder Template Categories - for WordPress Page Builders**](https://wordpress.org/plugins/builder-template-categories/) * [**Polylang Connect for Elementor – Language Switcher & Template Tweaks**](https://wordpress.org/plugins/connect-polylang-elementor/) * [**Simple Download Manager for WP Document Revisions**](https://wordpress.org/plugins/wpdr-simple-downloads/) * [Multisite Toolbar Additions](https://wordpress.org/plugins/multisite-toolbar-additions/) * [Cleaner Plugin Installer](https://wordpress.org/plugins/cleaner-plugin-installer/) = 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](https://twitter.com/deckerweb) on Twitter == Installation == = Minimum Requirements = * WordPress version 4.7 or higher * **NOTE:** Only works with *Genesis Framework* (GPL-2.0+) as the parent theme. This is a paid premium product by StudioPress/ WPEngine, Inc., [available via studiopress.com](https://deckerweb.de/go/genesis/) * PHP version 5.6 or higher * MySQL version 5.0 or higher * Administrator user with capabilities `manage_options` and `edit_theme_options` who is logged-in = We Recommend Your Host Supports at least: = * PHP version 7.0 or higher * MySQL version 5.6 or higher / or MariaDB 10 or higher = Installation = 1. Install using the WordPress built-in Plugin installer (via **Plugins > Add New** - search for `genesis layout extras`), or extract the ZIP file and drop the contents in the `wp-content/plugins/` directory of your WordPress installation. 2. Activate the plugin through the 'Plugins' menu in WordPress. 3. In your left-hand **Genesis Theme Settings > 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*. = Video of Plugin's Settings Walkthrough (v2.0.0): = [youtube https://www.youtube.com/watch?v=WchU8FOJYyY] [**original video link**](https://www.youtube.com/watch?v=WchU8FOJYyY) *by plugin developer David Decker* = Choose from one of the following layouts = *1) Up to 6 default layouts of Genesis - when registered:* * 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 *2) Currently up to 9 additional layouts of this plugin (Genesis Layout Extras):* * Sidebars below Content *) * Primary below Content * Primary above Content * Header+Nav/Content/Sidebar (experimental!) * Content/Sidebar-Alt *) * Sidebar-Alt/Content *) * Content/Sidebar-Alt/Sidebar * Sidebar/Sidebar-Alt/Content * Sidebar/Content/Sidebar-Alt *) = Not with my ["Genesis Prose Extras" plugin](https://wordpress.org/plugins/genesis-prose-extras/) - that brings those layouts on its own, but with more optimized CSS :) PLEASE NOTE: These 9 additional layouts were added in 2013 under a different situation of the overall market and Genesis. Looking back it was a mistake to do that, as the whole CSS for Child Themes is just unmanageable! Therefore the support for these layouts cannot and will not be given any longer! But rest assured: for backwards compatibility and for the users that somehow used them, I will keep their registering functions and their CSS in the plugin for as long as possible. However, I might be hide the options from the settings page in the future (again this will not affect your usage!). To be clear: I will NOT remove features that were in it for 5 years and of course are used in the wild. I serve my users and the community. But please understand that I cannot longer offer support in any way for THESE ADDITIONAL layout options. You can always register your own options and maintain the CSS for your special use case. No problem at all! :-) --- Thanks for your support! = Additional Post Type Support: = * For public custom post types, enable Genesis Inpost Options (Layouts, SEO, Scripts) * For public custom post types with archive support, enable Genesis Archive Settings == Frequently Asked Questions == = Why up to 9 new layout options, aren't the default one's enough? = Good question, hehe :) -- Since you are absolutely not forced to use the new options you can disable all and set the settings meta box to not display (via "Screen options" tab on top right corner), so you won't even see them on the plugin's settings page. If, however, you want some new - simplyfied or tweaked - *flavors of existing layouts*, then you might try one of the new options. So for example, the "Primary below Content" layout option is perfect for minimalistic one-column sites. Or the "Sidebars below Content" is great for content-oriented blogs and/or sites that want to drop the bloat from the SIDEbar and only offer a bit more stuff *below* the main content - in a nice 2-column outfit. *PLEASE see next FAQ entry:* = 2018: Still Support for the additional layout options? = PLEASE NOTE: These 9 additional layouts were added in 2013 under a different situation of the overall market and Genesis. Looking back, it was a mistake to do that, as the whole CSS for Child Themes is just unmanageable! Therefore the support for these layouts cannot and will not be given any longer (as of writing, August 2018)! But rest assured: for backwards compatibility and for the users that somehow used them, I will keep their registering functions and their CSS in the plugin for as long as possible. However, I might be hide the options from the settings page in the future (again this will not affect your usage!). To be clear: I will NOT remove features that were in it for 5 years and of course are used in the wild. I serve my users and the community. But please understand that I cannot longer offer support in any way for THESE ADDITIONAL layout options. You can always register your own options and maintain the CSS for your special use case. No problem at all! :-) --- Thanks for your support! = I don't see the new layout options in the plugin settings, what's up? = This could only be the case if your child theme (or another plugin or some code snippet...) has *un-registered* both Genesis default sidebars. Those two are needed for the layout options, so, if they are not there, you just cannot see and use my plugin's layout options. = Are the alternate layouts responsive? = Yes, they are! All is working like it should with minimal additions on CSS style rules (only what's really needed). = Help, the new layouts look not good on my site (CSS...), what can I do? = This may depend on the used CSS rules loaded via the plugin. Those rules are NOT based on specific child themes but use a "middle-of-the-road" general concept that is based on *percentage CSS values*. This way I can save a lot of (child theme specific) overhead. This approach may work with a lot of the official child themes by StudioPress. Sure, not all! Just try, and if needed, add additional CSS rules to your child theme style sheet to tweak the plugin styles. Also, you are free to not load the plugin styles at all (see plugin settings!). In that case you might add completely custom CSS styles to your child theme (or wherever, via another plugin or what...). = 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 (layout section) 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.) = What does the Additional Post Type support do? = Nothing spectacular... a) It just would add the inpost metaboxes of Genesis for layouts (whoa!), SEO (only if no SEO plugin is used) and Scripts (since Genesis 2.0+). --- That only works for post types that are "public" which means, viewable on the frontend! b) Also possible, is the activation of the new Genesis Archive Settings (for post types; since Genesis 2.0+). So you can for example, edit the Archive Page Title, SEO Options and Layout Options for a 'download' archive page (or a 'books' archive, 'portfolio' archive...). --- That only works for post types that are "public" which means, viewable on the frontend AND have support enabled for `'has_archive' => true` in their post type registration! Note: The layout settings for archives done via these Genesis Archive settings and/or the content archive settings of THIS plugin *do just the same*. So you decide which one you use. Nothing could break, and it does no harm. So, enjoy your content archives (settings)! = What means Reset of settings? = a) Layouts: Actually it just restores the default layout setting which is always defined in regular layout settings on the Genesis Theme Settings page. b) All other settings are set to their default state. = 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 activate" this plugin? = Yes, you could. -- Still, a per site use is recommended. -- Network activation makes the most sense if *all* sub sites are using Genesis! On the other hand, if your Multisite install has 10 sites and only 3 may run with Genesis, network activation is not recommended! = How could I add my own layout option to the select drop-down menu? = That's possible since plugin version 2.0.0! Handy feature for custom child theme development as well as for plugin developers, hehe :) Just use this sample code and modify/ enhance to your needs: ` /** * Adding additional custom layouts to the layout select drop-down for plugin * "Genesis Layout Extras". * * NOTE: This requires the Genesis Framework, plus the plugin "Genesis Layout * Extras" (available via: https://wordpress.org/plugins/genesis-layout-extras/) * * @author David Decker - DECKERWEB.de * @link https://deckerweb.de/twitter */ if ( defined( 'GLE_SETTINGS_FIELD' ) && function_exists( 'genesis_get_layout' ) ) { add_action( 'gle_layouts_drop_down', 'custom_gle_select_layout_option', 10, 1 ); /** * Helper function to add additional