singleton.
*
* @since 2.0
*/
private function __construct() {
add_action(
'widgets_init',
array( $this, 'register_custom_sidebars' )
);
// Support translation via WPML plugin.
add_action(
'register_sidebar',
array( $this, 'translate_sidebar' )
);
if ( ! is_admin() ) {
// Frontend hooks.
add_action(
'wp_head',
array( $this, 'replace_sidebars' )
);
add_action(
'wp',
array( $this, 'store_original_post_id' )
);
}
}
/**
* Tell WordPress about the custom sidebars.
*/
public function register_custom_sidebars() {
$sb = self::get_custom_sidebars();
$sb = CustomSidebars::sort_sidebars_by_name( $sb );
foreach ( $sb as $sidebar ) {
/**
* Filter sidebar options for custom sidebars.
*
* @since 2.0
*
* @param array $sidebar Options used by WordPress to display
* the sidebar.
*/
$sidebar = apply_filters( 'cs_sidebar_params', $sidebar );
register_sidebar( $sidebar );
}
}
/**
* Stores the original post id before any plugin (buddypress) can modify this data, to show the proper sidebar.
*/
public function store_original_post_id() {
global $post;
if ( isset( $post->ID ) ) {
$this->original_post_id = $post->ID;
}
}
/**
* Replace the sidebars on current page with some custom sidebars.
* Sidebars are replaced by directly modifying the WordPress globals
* `$_wp_sidebars_widgets` and `$wp_registered_sidebars`
*
* What it really does it not replacing a specific *sidebar* but simply
* replacing all widgets inside the theme sidebars with the widgets of the
* custom defined sidebars.
*/
public function replace_sidebars() {
global $_wp_sidebars_widgets,
$wp_registered_sidebars,
$wp_registered_widgets;
$expl = CustomSidebarsExplain::do_explain();
$expl && do_action( 'cs_explain', '
Replace sidebars
', true );
do_action( 'cs_before_replace_sidebars' );
/**
* Original sidebar configuration by WordPress:
* Lists sidebars and all widgets inside each sidebar.
*/
$original_widgets = $_wp_sidebars_widgets;
$defaults = self::get_options();
/**
* Fires before determining sidebar replacements.
*
* @param array $defaults Array of the default sidebars for the page.
*/
do_action( 'cs_predetermine_replacements', $defaults );
// Legacy handler with camelCase
do_action( 'cs_predetermineReplacements', $defaults );
$replacements = $this->determine_replacements( $defaults );
foreach ( $replacements as $sb_id => $replace_info ) {
if ( ! is_array( $replace_info ) || count( $replace_info ) < 3 ) {
$expl && do_action( 'cs_explain', 'Replacement for "' . $sb_id . '": -none-' );
continue;
}
// Fix rare message "illegal offset type in isset or empty"
$replacement = (string) @$replace_info[0];
$replacement_type = (string) @$replace_info[1];
$extra_index = (string) @$replace_info[2];
$check = $this->is_valid_replacement( $sb_id, $replacement, $replacement_type, $extra_index );
if ( $check ) {
$expl && do_action( 'cs_explain', 'Replacement for "' . $sb_id . '": ' . $replacement );
if ( sizeof( $original_widgets[ $replacement ] ) == 0 ) {
// No widgets on custom sidebar, show nothing.
$wp_registered_widgets['csemptywidget'] = $this->get_empty_widget();
$_wp_sidebars_widgets[ $sb_id ] = array( 'csemptywidget' );
} else {
$_wp_sidebars_widgets[ $sb_id ] = $original_widgets[ $replacement ];
/**
* When custom sidebars use some wrapper code (before_title,
* after_title, ...) then we need to strip-slashes for this
* wrapper code to work properly
*/
$sidebar_for_replacing = $wp_registered_sidebars[ $replacement ];
if ( $this->has_wrapper_code( $sidebar_for_replacing ) ) {
$sidebar_for_replacing = $this->clean_wrapper_code( $sidebar_for_replacing );
$wp_registered_sidebars[ $sb_id ] = $sidebar_for_replacing;
}
}
$wp_registered_sidebars[ $sb_id ]['class'] = $replacement;
} else {
// endif: is_valid_replacement
$expl && do_action( 'cs_explain', 'Replacement for "' . $sb_id . '": -none-' );
}
} // endforeach
}
/**
* THIS IS THE ACTUAL LOGIC OF THE PLUGIN
*
* Here we find out if some sidebars should be replaced, and if it is
* replaced we determine which custom sidebar to use.
*
* @param array $options Plugin options with the replacement rules.
* @return array List of the replaced sidebars.
*/
public function determine_replacements( $options ) {
global $post, $sidebar_category;
$sidebars = self::get_options( 'modifiable' );
$replacements_todo = sizeof( $sidebars );
$replacements = array();
$expl = CustomSidebarsExplain::do_explain();
foreach ( $sidebars as $sb ) {
$replacements[ $sb ] = false;
}
// 1 |== Single posts/pages --------------------------------------------
if ( is_single() ) {
$post_type = get_post_type();
$post_type = apply_filters( 'cs_replace_post_type', $post_type, 'single' );
$expl && do_action( 'cs_explain', 'Type 1: Single ' . ucfirst( $post_type ) );
if ( ! self::supported_post_type( $post_type ) ) {
$expl && do_action( 'cs_explain', 'Invalid post type, use default sidebars.' );
return $options;
}
// 1.1 Check if replacements are defined in the post metadata.
$reps = self::get_post_meta( $this->original_post_id );
foreach ( $sidebars as $sb_id ) {
if ( is_array( $reps ) && ! empty( $reps[ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$reps[ $sb_id ],
'particular',
-1,
);
$replacements_todo -= 1;
}
}
// 1.2 Try to use the parents metadata.
if ( $post->post_parent != 0 && $replacements_todo > 0 ) {
$reps = self::get_post_meta( $post->post_parent );
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if (
is_array( $reps )
&& ! empty( $reps[ $sb_id ] )
) {
$replacements[ $sb_id ] = array(
$reps[ $sb_id ],
'particular',
-1,
);
$replacements_todo -= 1;
}
}
}
// 1.3 If no metadata set then use the category settings.
if ( $replacements_todo > 0 ) {
$categories = self::get_sorted_categories();
$ind = sizeof( $categories ) -1;
while ( $replacements_todo > 0 && $ind >= 0 ) {
$cat_id = $categories[ $ind ]->cat_ID;
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if ( ! empty( $options['category_single'][ $cat_id ][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['category_single'][ $cat_id ][ $sb_id ],
'category_single',
$sidebar_category,
);
$replacements_todo -= 1;
}
}
$ind -= 1;
}
}
// 1.4 Look for post-type level replacements.
if ( $replacements_todo > 0 ) {
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if (
isset( $options['post_type_single'][ $post_type ] )
&& ! empty( $options['post_type_single'][ $post_type ][ $sb_id ] )
) {
$replacements[ $sb_id ] = array(
$options['post_type_single'][ $post_type ][ $sb_id ],
'post_type_single',
$post_type,
);
$replacements_todo -= 1;
}
}
}
} elseif ( is_category() ) {
// 2 |== Category archive ----------------------------------------------
$expl && do_action( 'cs_explain', 'Type 2: Category Archive' );
// 2.1 Start at current category and travel up all parents
$category_object = get_queried_object();
$current_category = $category_object->term_id;
while ( 0 != $current_category && $replacements_todo > 0 ) {
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if ( ! empty( $options['category_archive'][ $current_category ][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['category_archive'][ $current_category ][ $sb_id ],
'category_archive',
$current_category,
);
$replacements_todo -= 1;
}
}
$current_category = $category_object->category_parent;
if ( 0 != $current_category ) {
$category_object = get_category( $current_category );
}
}
} elseif ( is_search() ) {
// 3 |== Search --------------------------------------------------------
// Must be before the post-type archive section; otherwise a search with
// no results is recognized as post-type archive...
$expl && do_action( 'cs_explain', 'Type 3: Search Results' );
foreach ( $sidebars as $sb_id ) {
if ( ! empty( $options['search'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['search'][ $sb_id ],
'search',
-1,
);
}
}
} elseif ( ! is_category() && ! is_singular() && get_post_type() != 'post' ) {
// 4 |== Post-Tpe Archive ----------------------------------------------
// `get_post_type() != 'post'` .. post-archive = post-index (see 7)
$post_type = get_post_type();
$post_type = apply_filters( 'cs_replace_post_type', $post_type, 'archive' );
$expl && do_action( 'cs_explain', 'Type 4: ' . ucfirst( $post_type ) . ' Archive' );
if ( ! self::supported_post_type( $post_type ) ) {
$expl && do_action( 'cs_explain', 'Invalid post type, use default sidebars.' );
return $options;
}
foreach ( $sidebars as $sb_id ) {
if (
isset( $options['post_type_archive'][ $post_type ] )
&& ! empty( $options['post_type_archive'][ $post_type ][ $sb_id ] )
) {
$replacements[ $sb_id ] = array(
$options['post_type_archive'][ $post_type ][ $sb_id ],
'post_type_archive',
$post_type,
);
$replacements_todo -= 1;
}
}
} elseif ( is_page() && ! is_front_page() ) {
// 5 |== Page ----------------------------------------------------------
// `! is_front_page()` .. in case the site uses static front page.
$post_type = get_post_type();
$post_type = apply_filters( 'cs_replace_post_type', $post_type, 'page' );
$expl && do_action( 'cs_explain', 'Type 5: ' . ucfirst( $post_type ) );
if ( ! self::supported_post_type( $post_type ) ) {
$expl && do_action( 'cs_explain', 'Invalid post type, use default sidebars.' );
return $options;
}
// 5.1 Check if replacements are defined in the post metadata.
$reps = self::get_post_meta( $this->original_post_id );
foreach ( $sidebars as $sb_id ) {
if ( is_array( $reps ) && ! empty( $reps[ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$reps[ $sb_id ],
'particular',
-1,
);
$replacements_todo -= 1;
}
}
// 5.2 Try to use the parents metadata.
if ( $post->post_parent != 0 && $replacements_todo > 0 ) {
$reps = self::get_post_meta( $post->post_parent );
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if ( is_array( $reps )
&& ! empty( $reps[ $sb_id ] )
) {
$replacements[ $sb_id ] = array(
$reps[ $sb_id ],
'particular',
-1,
);
$replacements_todo -= 1;
}
}
}
// 5.3 Look for post-type level replacements.
if ( $replacements_todo > 0 ) {
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if ( isset( $options['post_type_single'][ $post_type ] )
&& ! empty( $options['post_type_single'][ $post_type ][ $sb_id ] )
) {
$replacements[ $sb_id ] = array(
$options['post_type_single'][ $post_type ][ $sb_id ],
'post_type_single',
$post_type,
);
$replacements_todo -= 1;
}
}
}
} elseif ( is_front_page() ) {
// 6 |== Front Page ----------------------------------------------------
/*
* The front-page of the site. Either
* - the post-index (default) or
* - a static front-page.
*/
$expl && do_action( 'cs_explain', 'Type 6: Front Page' );
if ( ! is_home() ) {
// A static front-page. Maybe we need the post-meta data...
$reps_post = self::get_post_meta( $this->original_post_id );
$reps_parent = self::get_post_meta( $post->post_parent );
}
foreach ( $sidebars as $sb_id ) {
// First check if there is a 'Front Page' replacement.
if ( ! empty( $options['blog'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['blog'][ $sb_id ],
'blog',
-1,
);
} else if ( ! is_home() ) {
// There is no 'Front Page' reaplcement and this is a static
// front page, so check if the page has a replacement.
// 6.1 Check if replacements are defined in the post metadata.
if ( is_array( $reps_post ) && ! empty( $reps_post[ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$reps_post[ $sb_id ],
'particular',
-1,
);
$replacements_todo -= 1;
}
// 6.2 Try to use the parents metadata.
if ( $post->post_parent != 0 && $replacements_todo > 0 ) {
if ( $replacements[ $sb_id ] ) { continue; }
if ( is_array( $reps_parent )
&& ! empty( $reps_parent[ $sb_id ] )
) {
$replacements[ $sb_id ] = array(
$reps_parent[ $sb_id ],
'particular',
-1,
);
$replacements_todo -= 1;
}
}
}
}
} elseif ( is_home() ) {
// 7 |== Post Index ----------------------------------------------------
/*
* The post-index of the site. Either
* - the front-page (default)
* - when a static front page is used the post-index page.
*
* Note: When the default front-page is used the condition 6
* "is_front_page" above is used and this node is never executed.
*/
$expl && do_action( 'cs_explain', 'Type 7: Post Index' );
foreach ( $sidebars as $sb_id ) {
if ( ! empty( $options['post_type_archive']['post'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['post_type_archive']['post'][ $sb_id ],
'postindex',
-1,
);
}
}
} elseif ( is_tag() ) {
// 8 |== Tag archive ---------------------------------------------------
$expl && do_action( 'cs_explain', 'Type 8: Tag Archive' );
foreach ( $sidebars as $sb_id ) {
if ( ! empty( $options['tags'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['tags'][ $sb_id ],
'tags',
-1,
);
}
}
} elseif ( is_author() ) {
// 9 |== Author archive ------------------------------------------------
$author_object = get_queried_object();
$current_author = $author_object->ID;
$expl && do_action( 'cs_explain', 'Type 9: Author Archive (' . $current_author . ')' );
// 9.1 First check for specific authors.
foreach ( $sidebars as $sb_id ) {
if ( ! empty( $options['author_archive'][ $current_author ][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['author_archive'][ $current_author ][ $sb_id ],
'author_archive',
$current_author,
);
$replacements_todo -= 1;
}
}
// 9.2 Then check if there is an "Any authors" sidebar
if ( $replacements_todo > 0 ) {
foreach ( $sidebars as $sb_id ) {
if ( $replacements[ $sb_id ] ) { continue; }
if ( ! empty( $options['authors'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['authors'][ $sb_id ],
'authors',
-1,
);
}
}
}
} elseif ( is_date() ) {
// 10 |== Date archive -------------------------------------------------
$expl && do_action( 'cs_explain', 'Type 10: Date Archive' );
foreach ( $sidebars as $sb_id ) {
if ( ! empty( $options['date'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['date'][ $sb_id ],
'date',
-1,
);
}
}
} elseif ( is_404() ) {
// 11 |== 404 not found ------------------------------------------------
$expl && do_action( 'cs_explain', 'Type 11: 404 not found' );
foreach ( $sidebars as $sb_id ) {
if ( ! empty( $options['404'][ $sb_id ] ) ) {
$replacements[ $sb_id ] = array(
$options['404'][ $sb_id ],
'404',
-1,
);
}
}
}
/**
* Filter the replaced sidebars before they are processed by the plugin.
*
* @since 2.0
*
* @param array $replacements List of the final/replaced sidebars.
*/
$replacements = apply_filters( 'cs_replace_sidebars', $replacements );
return $replacements;
}
/**
* Makes sure that the replacement sidebar exists.
* If the custom sidebar does not exist then the WordPress/Post options are
* updated to remove the invalid option.
*
* @since 1.0.0
* @param string $sb_id The original sidebar (the one that is replaced).
* @param string $replacement ID of the custom sidebar that should be used.
* @param string $method Info where the replacement setting is saved.
* @param int|string $extra_index Depends on $method - can be either one:
* empty/post-type/category-ID
* @return bool
*/
public function is_valid_replacement( $sb_id, $replacement, $method, $extra_index ) {
global $wp_registered_sidebars;
$options = self::get_options();
if ( isset( $wp_registered_sidebars[ $replacement ] ) ) {
// Everything okay, we can use the replacement
return true;
}
/*
* The replacement sidebar was not registered. Something's wrong, so we
* update the options and not try to replace this sidebar again.
*/
if ( 'particular' == $method ) {
// Invalid replacement was found in post-meta data.
$sidebars = self::get_post_meta( $this->original_post_id );
if ( $sidebars && isset( $sidebars[ $sb_id ] ) ) {
unset( $sidebars[ $sb_id ] );
self::set_post_meta( $this->original_post_id, $sidebars );
}
} else {
// Invalid replacement is defined in wordpress options table.
if ( isset( $options[ $method ] ) ) {
if (
-1 != $extra_index &&
isset( $options[ $method ][ $extra_index ] ) &&
isset( $options[ $method ][ $extra_index ][ $sb_id ] )
) {
unset( $options[ $method ][ $extra_index ][ $sb_id ] );
self::set_options( $options );
}
if (
1 == $extra_index &&
isset( $options[ $method ] ) &&
isset( $options[ $method ][ $sb_id ] )
) {
unset( $options[ $method ][ $sb_id ] );
self::set_options( $options );
}
}
}
return false;
}
/**
* Returns an empty dummy-widget. This dummy widget is used when a custom
* sidebar has no widgets.
*
* @since 1.0.0
*/
public function get_empty_widget() {
$widget = new CustomSidebarsEmptyPlugin();
return array(
'name' => 'CS Empty Widget',
'id' => 'csemptywidget',
'callback' => array( $widget, 'display_callback' ),
'params' => array( array( 'number' => 2 ) ),
'classname' => 'CustomSidebarsEmptyPlugin',
'description' => 'CS dummy widget',
);
}
/**
* Checks if the specified sidebar uses custom wrapper code.
*
* @since 1.2
* @return bool
*/
public function has_wrapper_code( $sidebar ) {
return (
strlen( trim( $sidebar['before_widget'] ) )
|| strlen( trim( $sidebar['after_widget'] ) )
|| strlen( trim( $sidebar['before_title'] ) )
|| strlen( trim( $sidebar['after_title'] ) )
);
}
/**
* Clean the slashes of the custom sidebar wrapper code.
*
* @since 1.2
*/
public function clean_wrapper_code( $sidebar ) {
$sidebar['before_widget'] = stripslashes( $sidebar['before_widget'] );
$sidebar['after_widget'] = stripslashes( $sidebar['after_widget'] );
$sidebar['before_title'] = stripslashes( $sidebar['before_title'] );
$sidebar['after_title'] = stripslashes( $sidebar['after_title'] );
return $sidebar;
}
/**
* Translates a sidebar using WPML right after it was registered.
*
* @since 2.0.9.7
* @param array $sidebar The sidebar that was registered
*/
public function translate_sidebar( $sidebar ) {
if ( ! function_exists( 'icl_t' ) ) { return false; }
global $wp_registered_sidebars;
$context = 'Sidebar';
// Translate the name and description.
$sidebar['name'] = icl_t( $context, $sidebar['id'] . '-name', $sidebar['name'] );
$sidebar['description'] = icl_t( $context, $sidebar['id'] . '-description', $sidebar['description'] );
$wp_registered_sidebars[ $sidebar['id'] ] = $sidebar;
}
};