=== 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.3 Requires PHP: 5.6 Stable tag: 2.1.2 License: GPL-2.0-or-later License URI: https://opensource.org/licenses/GPL-2.0 For Genesis powered Sites: Allows modifying of default layouts for homepage, various archives, taxonomies, post types, attachment, search, 404 pages. == Description == **Among the Top 10 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 admin settings page. Just look for it at the submenu: *Genesis > Layout Extras*. 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" Pages** (default singular post views) * **"Page" Pages** (default singular page views) * **Attachment Page** (default singular attachment views) * **Author Page** (default singular author views) * **Date Archive Page** (optional with setting for Year, Month, Day) (default views for date archives) * **Category Page** (default category archive views) * **Tag Page** (default tag archive views) * **Taxonomy Page** (default custom taxonomy views) = πŸ”Œ Plugins: Supported Custom Post Types set by Plugins = * **Genesis Portfolio Pro**: Archive Page for post type "Portfolio" - plus taxonomy "(Portfolio) Type" * **Genesis Author Pro**: Archive Page for post type "Book" - plus taxonomy pages for "(Book) Authors", "(Book) Series" and "(Book) Tags" * **AgentPress Listings**: Archive Page for post type "Listings" - plus taxonomy "(Listing) Features" * **Simple Listings for Genesis**: Archive Page for post type "Listings" - plus taxonomy "(Listing) Status" * **bbPress 2.x Forum**: all Forums (all areas) - plus "Topics" - *Integration plugin recommended: [bbPress Genesis Extend](https://wordpress.org/plugins/bbpress-genesis-extend/)* * **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/)* * **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/)* * **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/)* * **Sugar Events Calendar**: Archive Page for Custom Type "Events" - plus taxonomy "Event Categories" * (Legacy) **Genesis Media Project**: Archive Page for Custom Type "Video" - plus taxonomies "SlideShows", "Video Categories", "Video Tags" * ***Note:** Even more plugins and/ or custom post types (CPTs) may be added in future plugin versions* = 🀠 Child Themes: Supported Custom Post Types set by Child Themes = * Child Theme: **Minimum 2.0** by StudioPress: Archive Page for post type "Portfolio" * Child Theme: **Executive 2.0** by StudioPress: Archive Page for post type "Portfolio" * These 10 Child Themes by **ZigZagPress brand**: *Bijou*, *Engrave*, *Eshop*, *Megalithe*, *Neo*, *Prestige*, *Single*, *Solo*, *Tequila*, *Vanilla* -- Archive Page for post type "Portfolio" - plus taxonomy "Portfolio Category" for all of these. * Child Theme: **Clip Cart** by Themedy Themes: Archive Page for post type "Products" - plus taxonomy "Product Categories" * Child Theme: **Stage** by Themedy Themes: Taxonomy "Photo Galleries" = 🌎 Translations = * πŸ‡ΊπŸ‡Έ English (United States) - `en_US` = default, always included * πŸ‡©πŸ‡ͺ [German (informal, default)](https://translate.wordpress.org/locale/de/default/wp-plugins/genesis-layout-extras) - `de_DE` * πŸ‡©πŸ‡ͺ [German (formal)](https://translate.wordpress.org/locale/de/formal/wp-plugins/genesis-layout-extras) - `de_DE_formal` * All other user-submitted translation see at [language packs overview page](https://translate.wordpress.org/projects/wp-plugins/genesis-layout-extras) * `.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 Is Out!** Yes, the update v2.1.0 is finally out (you are on its readme just now). The plugin will get further maintenance and development. = 🌟 Be a Contributor = If you want to translate, [go to the Translation Portal at translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/genesis-layout-extras). You can also contribute code-wise via our [Genesis Layout Extras GitHub Repository](https://github.com/deckerweb/genesis-layout-extras) - and see where you can help. = 😁 Liked Genesis Layout Extras Plugin? = * [**Rate us 5 ⭐ stars on WordPress.org**](https://wordpress.org/support/plugin/genesis-layout-extras/reviews/?filter=5/#new-post) :) * [**Join our Newsletter for Site Builders** πŸ’―](https://eepurl.com/gbAUUn) - *get plugin insider info, and more interesting stuff for Genesis WordPress users* * Engage in our [Facebook Community User Group πŸ’¬]((https://www.facebook.com/groups/deckerweb.wordpress.plugins/). * [**Become a Patron** πŸ’œ](https://www.patreon.com/deckerweb) and support ongoing development, maintenance and support of this plugin = β™₯ This Plugin ... = * ... scratches my own itch! * ... is *Quality Made in Germany* * ... was created with β™₯ love (plus some β˜•οΈ coffee) :-) - [if you like it consider donating](https://www.paypal.me/deckerweb) = ⏰ Recommended Time Saver = Try [**Toolbar Extras for Genesis**](https://toolbarextras.com/) my other great plugin for Site Builders and admins: Building sites with Genesis or Elementor or both? [**Your work will get easier & faster with Toolbar Extras.**](https://wordpress.org/plugins/toolbar-extras/) With extended plugin & theme support baked right in. Of course, "Genesis Layout Extras" is integrated as well :) * [Plugin Page here on WordPress.org](https://wordpress.org/plugins/toolbar-extras/) * [Plugin's own website toolbarextras.com](https://toolbarextras.com/) * In your WordPress admin dashboard search for `toolbar extras` in the plugin installer ;-) = πŸ”Œ 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 Extra Settings Transporter**](https://wordpress.org/plugins/genesis-extra-settings-transporter/) - addionally export Genesis specific plugin & child theme settings * [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 Connect for Easy Digital Downloads](https://wordpress.org/plugins/genesis-connect-edd/) - plugin for easy & elegant integration * [*My plugins newsletter*](https://eepurl.com/gbAUUn) == πŸ”Œ My Other WordPress Plugins == * [**Toolbar Extras for Genesis & Elementor - WordPress Admin Bar Enhanced**](https://wordpress.org/plugins/toolbar-extras/) * [**Toolbar Extras for Give Donations (GiveWP) - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-givewp/) * [**Toolbar Extras for MainWP Dashboard - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-mainwp/) * [**Toolbar Extras for Oxygen Builder - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-oxygen/) * [**Builder Shortcode Extras – WordPress Shortcodes Collection to Save You Time**](https://wordpress.org/plugins/builder-shortcode-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/) * [*My plugins newsletter*](https://eepurl.com/gbAUUn) == 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 * For plugin settings: Administrator user with capabilities `manage_options` and `edit_theme_options` who is logged-in = πŸš€ We Recommend Your Host Supports at least: = * PHP version 7.2 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 == = 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 after December 18th, 2018 (which is the release date of v2.1.0 the "back to life" version)! 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 at some point 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! = 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. = 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...). = I only see 3 layouts in the select drop-down where are the others? = This means that your current active Child Theme or a plugin (or even some code snippet...) has **unregistered** some layouts. The select drop-down field of this plugin only represents what was registered before - this being the case via Genesis itself or a Child Theme or plugins. Note: The most recent "Sample" Child Theme from StudioPress, and many other newer Child Themes, only come with three (or even 2 only) layout options. = 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