Genesis Bootstrap Carousel vs Genesis Connect for WooCommerce

Note: This plugin only supports Genesis child themes. If you don’t know what that is, don’t download this plugin. Genesis Bootstrap Carousel (GBC) allows you to create a simple responsive image carousel that displays the featured image, along with the title and excerpt from each post. GBC is based off of the Genesis Responsive Slider and uses a lot of the same code. The main difference is that the Genesis Bootstrap Carousel uses the Carousel jquery plugin created by the open source Twitter Bootstrap Project. The carousel.js in this plugin is roughly 1/4 the size of the jquery flexslider.js used by the Genesis Responsive Slider. The CSS in this plugin is about half the size of the Genesis Responsive Slider plugin. Genesis Bootstrap Carousel also includes options to easily disable the CSS and JS of the plugin, allowing you to move scripts or styles into a combined file inside your theme. GBC also uses CSS for the next/previous arrows, avoiding an HTTP request and allowing easy customization via CSS. You may also choose what specifc post/page IDs the carousel JS and CSS get loaded on. This way you can avoid loading assets on pages that are not using the Carousel and avoid unnecessarily increasing page load time. It includes options for the maximum dimensions of your slideshow, allows you to choose to display posts, pages, custom post types, what category to pull from, and even the specific post IDs of the posts you want to display. It includes next/previous arrows that can be turned on or off. Finally, you can place the carousel into a widget area. The image carousel is also responsive and will automatically adjust for the screen it is being displayed on. You can get information on how the carousel.js works by visiting the Carousel Section of the Twitter Bootstrap site. Live example Demo Child Theme Integration To adjust the carousel defaults for a child theme use a filter simiar to the following: add_filter( 'bootstrap_carousel_settings_defaults', 'my_child_theme_bootstrap_carousel_defaults' ); function my_child_theme_bootstrap_carousel_defaults( $defaults ) { $defaults = array( 'post_type' => 'post', 'posts_term' => '', 'exclude_terms' => '', 'include_exclude' => '', 'post_id' => '', 'posts_num' => 5, 'posts_offset' => 0, 'orderby' => 'date', 'carousel_interval' => 5000, 'carousel_arrows' => 1, 'carousel_no_link' => 0, 'carousel_width' => '940', 'carousel_height' => '380', 'carousel_excerpt_content' => 'excerpts', 'carousel_excerpt_content_limit' => 150, 'carousel_more_text' => 'Continue Reading', 'carousel_excerpt_show' => 1, 'carousel_excerpt_width' => 100, 'location_vertical' => 'bottom', 'location_horizontal' => 'left', 'carousel_hide_mobile' => 1, 'html5_docytpe' => 0, 'disable_css' => 0, 'disable_js' => 0 ); return $defaults; }

This plugin replaces WooCommerce’s built-in shop templates with its own Genesis-ready versions, specifically the single-product.php, archive-product.php and taxonomy.php templates needed to display the single product page, the main shop page, and Product Category and Product Tag archive pages. To allow easy customization of these templates, and ensure that you do not lose your customizations when the plugin is updated, you can place your own copies of these templates in your child theme’s ‘woocommerce’ folder and customize these copies as much as you like. You can also create your own taxonomy-{taxonomy}.php and taxonomy-{taxonomy}-{term}.php templates in the same location and this plugin will find them and use them to display your shop’s Product Category and Product Tag archives. See the Template Hierarchy to learn more about naming requirements for taxonomy templates. Additionally, the plugin makes Genesis Simple Sidebars and Genesis Simple Menus compatible with WooCommerce. This version is compatible with WooCommerce 3.3+ Technical Info For more technically minded users, this is what the plugin does: Unhooks the WooCommerce template loader function Adds its own template loader function to control the templates used by the single product, archive product and Product Category and Product Tag (taxonomy) archive pages. Adds Genesis Layouts and SEO support to the WooCommerce Product custom post type Provides three Genesis-ready templates to display the shop pages, located in the plugin’s templates folder: single-product.php archive-product.php taxonomy.php These templates use WooCommerce core functions to display the shop loops which: unhook WooCommerce’s built-in breadcrumbs unhook the Genesis Loop and replace it with the relevant WooCommerce shop loop remove WooCommerce’s #container and #content divs, which are not required or wanted by Genesis The shop loop function in each template is heavily based on its WooCommerce counterpart, but has been modified to accommodate certain Genesis features such as the Taxonomy term headings and descriptions feature. The templates contain the genesis(); function and therefore are fully customisable using Genesis hooks and filters. The template loader allows users to use their own templates in the child theme’s ‘woocommerce’ folder. These user templates, if they exist in the child theme’s `woocommerce’ folder, will be loaded in place of the supplied Genesis Connect for WooCommerce templates Using appropriate filters, modifies the Genesis breadcrumbs output to mimic the breadcrumb structure provided by WooCommerce’s built-in breadcrumbs. More about breadcrumbs By default, the Genesis breadcrumbs do not provide the same breadcrumb structure as those built-in to WooCommerce. Genesis Connect for WooCommerce modifies the normal Genesis Breadcrumbs output on shop pages to mimic the structure of those built-in to WooCommerce. Note that the templates provided in this plugin automatically unhook WooCommerce’s built-in breadcrumbs via this code in each template: remove_action( ‘woocommerce_before_main_content’, ‘woocommerce_breadcrumb’, 20 ); Filters This plugin provides some filters which may be useful for developers. genesiswooc_custom_query Located in gencwooc_single_product_loop() in templates/single-product.php. The filter callback function should return a query object or false. gencwooc_product_archive_crumb Located in gencwooc_get_archive_crumb_filter() in lib/breadcrumb.php. Allows further modification of the single product page breadcrumbs. gencwooc_single_product_crumb Located in gencwooc_get_single_crumb() in lib/breadcrumb.php. Allows further modification of the product archive (shop page) breadcrumbs. More info about WooCommerce CSS handling For the benefit of theme developers and customizers, here is a summary of possible scenarios for dealing with WooCommerce CSS: Case 1: If the WooCommerce > General settings > Enable WooCommerce CSS option is checked, the default stylesheet supplied with WooCommerce will be loaded (see wp-content/plugins/woocommerce/assets/css/woocommerce.css). Case 2: If WooCommerce > General settings > Enable WooCommerce CSS option is unchecked, no stylesheet is loaded. Case 3: If the user (or theme developer) sets define( 'WOOCOMMERCE_USE_CSS', true ); in the child theme functions.php the options setting is ignored and the default WooCommerce stylesheet is loaded, ie has same effect as checking the settings box. Case 4: If the user (or theme developer) sets define( 'WOOCOMMERCE_USE_CSS', false ); in the child theme functions.php the options setting is ignored and NO stylesheet is loaded, ie has same effect as unchecking the settings box. Note: the value of WOOCOMMERCE_USE_CSS always takes precedence over the WooCommerce Settings page option! If either Case 1 or Case 3 applies, if themes/my-child-theme/woocommerce/styles.css exists it will be loaded in place of the default woocommerce stylesheet (plugins/woocommerce/assets/css/woocommerce.css). If either Case 2 or 4 applies, as no built-in stylesheet is loaded, all WooCommerce CSS styles need to be added to the theme’s main style.css stylesheet Note for Genesis child theme developers: For new themes, theme developers can use define( 'WOOCOMMERCE_USE_CSS', false ); and place all WooCommerce styles in the theme’s main stylesheet, or do nothing and let the user handle this via Case 1 or 3. The above information is based on WooCommerce 1.4.4