Builder/Release Notes/4.0.15 - Revision history

Gaarai at 22:09, January 31, 2013

2013-01-31T22:09:23Z

Gaarai at 23:05, January 30, 2013

2013-01-30T23:05:17Z

Gaarai: Created page with "'''Version:''' 4.0.15 '''Released:''' 2013-01-30 '''Release Type:''' Plugin Compatibility, Bug Fix '''Description:''' A bug that created the following warning is now fixe..."

2013-01-30T23:02:00Z

Created page with "'''Version:''' 4.0.15 '''Released:''' 2013-01-30 '''Release Type:''' Plugin Compatibility, Bug Fix '''Description:''' A bug that created the following warning is now fixe..."

New page

'''Version:''' 4.0.15

'''Released:''' 2013-01-30

'''Release Type:''' Plugin Compatibility, Bug Fix

'''Description:'''

A bug that created the following warning is now fixed. "Notice: Undefined offset: 16 in lib/tutorials/tutorials.php on line 156"

Many of Jetpack's features unfortunately require special consideration in order for themes to be compatible with them. This release adds a filter that prevents Jetpack's Carousel feature from silently disabling itself on Builder sites. The same type of code is also preventing the Tiled Galleries feature from functioning, but unlike Carousel, Tiled Galleries does not have a filter to prevent it from disabling itself. A solution for this issue is still in the works.

The technical reason for this happening is that Builder makes use of the <code>post_gallery</code> filter in order to make the gallery render more fluidly inside of Builder's content areas. Both the Carousel and Tiled Galleries features of Jetpack attach to this same filter and will simply not do anything if other code has made use of the filter. Thus, while Jetpack reports the features as active, they are in fact not functioning since Builder modifies the gallery. Fortunately, Carousel has a filter that allows other code to override this check as it still functions without issue in Builder if this check is bypassed. Unfortunately, Tiled Galleries does not have such a filter and simply decides to do nothing in such a situation, leaving the feature unusable.

A temporary workaround for the Tiled Galleries issue is to add the following to your <tt>functions.php</tt> file:

function custom_disable_builder_gallery() {
remove_filter( 'post_gallery', 'builder_custom_post_gallery', 10 );
}
add_action( 'builder_theme_features_loaded', 'custom_disable_builder_gallery' );

$content_width = 605;

Note that the <code>$content_width</code> variable has to be set to a value that refers to the pixel width of the area displaying the gallery. The <tt>605</tt> number refers to the total pixel width area of the Default child theme's Content Module without any Layout modifications (960 pixel wide Layout with a 320 pixel wide sidebar). Until a better solution can be found, this variable will have to be manually adjusted so that the gallery properly fills the content area. Fortunately, if you are running a responsive Builder child theme, you can set this value to be larger than required, and it will automatically shrink down (this may work in some non-responsive child themes as well, the results vary).

'''Files Updated:
* lib/builder-core/
* lib/tutorials/

[[Category:Builder/Release Notes]]

@@ Line 21: / Line 21: @@
   add_action( 'builder_theme_features_loaded', 'custom_disable_builder_gallery' );
-  $content_width = 605;
+  $content_width = 604;
-Note that the <code>$content_width</code> variable has to be set to a value that refers to the pixel width of the area displaying the gallery. The <tt>605</tt> number refers to the total pixel width area of the Default child theme's Content Module without any Layout modifications (960 pixel wide Layout with a 320 pixel wide sidebar). Until a better solution can be found, this variable will have to be manually adjusted so that the gallery properly fills the content area. Fortunately, if you are running a responsive Builder child theme, you can set this value to be larger than required, and it will automatically shrink down (this may work in some non-responsive child themes as well, the results vary).
+Note that the <code>$content_width</code> variable has to be set to a value that refers to the pixel width of the area displaying the gallery. The <tt>604</tt> number refers to the total pixel width area of the Default child theme's Content Module without any Layout modifications (960 pixel wide Layout with a 320 pixel wide sidebar). Until a better solution can be found, this variable will have to be manually adjusted so that the gallery properly fills the content area. Fortunately, if you are running a responsive Builder child theme, you can set this value to be larger than required, and it will automatically shrink down (this may work in some non-responsive child themes as well, the results vary).

@@ Line 14: / Line 14: @@
 The technical reason for this happening is that Builder makes use of the <code>post_gallery</code> filter in order to make the gallery render more fluidly inside of Builder's content areas. Both the Carousel and Tiled Galleries features of Jetpack attach to this same filter and will simply not do anything if other code has made use of the filter. Thus, while Jetpack reports the features as active, they are in fact not functioning since Builder modifies the gallery. Fortunately, Carousel has a filter that allows other code to override this check as it still functions without issue in Builder if this check is bypassed. Unfortunately, Tiled Galleries does not have such a filter and simply decides to do nothing in such a situation, leaving the feature unusable.
-A temporary workaround for the Tiled Galleries issue is to add the following to your <tt>functions.php</tt> file:
+A temporary workaround for the Tiled Galleries issue is to add the following to your child theme's <tt>functions.php</tt> file (after the <code>&lt;?php</code> line):
   function custom_disable_builder_gallery() {