Name ), // Name
array(
'classname' => 'admiral-magazine-posts-boxed',
'description' => esc_html__( 'Displays your posts from a selected category in a boxed layout. Please use this widget ONLY in the Magazine Homepage widget area.', 'admiral' )
) // Args
);
// Delete Widget Cache on certain actions
add_action( 'save_post', array( $this, 'delete_widget_cache' ) );
add_action( 'deleted_post', array( $this, 'delete_widget_cache' ) );
add_action( 'switch_theme', array( $this, 'delete_widget_cache' ) );
}
/**
* Set default settings of the widget
*/
private function default_settings() {
$defaults = array(
'title' => '',
'category' => 0,
'layout' => 'horizontal',
'meta_date' => true,
'meta_author' => false,
);
return $defaults;
}
/**
* Main Function to display the widget
*
* @uses this->render()
*
* @param array $args / Parameters from widget area created with register_sidebar()
* @param array $instance / Settings for this widget instance
*/
function widget( $args, $instance ) {
$cache = array();
// Get Widget Object Cache
if ( ! $this->is_preview() ) {
$cache = wp_cache_get( 'widget_admiral_magazine_posts_boxed', 'widget' );
}
if ( ! is_array( $cache ) ) {
$cache = array();
}
// Display Widget from Cache if exists
if ( isset( $cache[ $this->id ] ) ) {
echo $cache[ $this->id ];
return;
}
// Start Output Buffering
ob_start();
// Get Widget Settings
$settings = wp_parse_args( $instance, $this->default_settings() );
// Output
echo $args['before_widget'];
?>
widget_title( $args, $settings ); ?>
render( $settings ); ?>
magazine_posts_horizontal( $settings ); ?>
magazine_posts_vertical( $settings ); ?>
render()
*
* @param array $instance / Settings for this widget instance
*/
function magazine_posts_horizontal( $settings ) {
// Get latest posts from database
$query_arguments = array(
'posts_per_page' => 4,
'ignore_sticky_posts' => true,
'cat' => (int)$settings['category']
);
$posts_query = new WP_Query( $query_arguments );
$i = 0;
// Check if there are posts
if( $posts_query->have_posts() ) :
// Limit the number of words for the excerpt
add_filter( 'excerpt_length', 'admiral_magazine_posts_excerpt_length' );
// Display Posts
while( $posts_query->have_posts() ) :
$posts_query->the_post();
if( isset($i) and $i == 0 ) : ?>
>
>
entry_meta( $settings ); ?>
', esc_url( get_permalink() ) ), '' ); ?>
render()
*
* @param array $instance / Settings for this widget instance
*/
function magazine_posts_vertical( $settings ) {
// Get latest posts from database
$query_arguments = array(
'posts_per_page' => 5,
'ignore_sticky_posts' => true,
'cat' => (int)$settings['category']
);
$posts_query = new WP_Query( $query_arguments );
$i = 0;
// Check if there are posts
if( $posts_query->have_posts() ) :
// Limit the number of words for the excerpt
add_filter( 'excerpt_length', 'admiral_magazine_posts_excerpt_length' );
// Display Posts
while( $posts_query->have_posts() ) :
$posts_query->the_post();
if( isset($i) and $i == 0 ) : ?>
>
>
entry_meta( $settings ); ?>
', esc_url( get_permalink() ) ), '' ); ?>
' . $postmeta . '';
}
} // entry_meta()
/**
* Displays Widget Title
*/
function widget_title( $args, $settings ) {
// Add Widget Title Filter
$widget_title = apply_filters( 'widget_title', $settings['title'], $settings, $this->id_base );
if( ! empty( $widget_title ) ) :
// Link Category Title
if( $settings['category'] > 0 ) :
// Set Link URL and Title for Category
$link_title = sprintf( esc_html__( 'View all posts from category %s', 'admiral' ), get_cat_name( $settings['category'] ) );
$link_url = esc_url( get_category_link( $settings['category'] ) );
// Display Widget Title with link to category archive
echo '';
else:
// Display default Widget Title without link
echo $args['before_title'] . $widget_title . $args['after_title'];
endif;
endif;
} // widget_title()
/**
* Update Widget Settings
*
* @param array $new_instance / New Settings for this widget instance
* @param array $old_instance / Old Settings for this widget instance
* @return array $instance
*/
function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = sanitize_text_field($new_instance['title']);
$instance['category'] = (int)$new_instance['category'];
$instance['layout'] = esc_attr($new_instance['layout']);
$instance['meta_date'] = !empty($new_instance['meta_date']);
$instance['meta_author'] = !empty($new_instance['meta_author']);
$this->delete_widget_cache();
return $instance;
}
/**
* Displays Widget Settings Form in the Backend
*
* @param array $instance / Settings for this widget instance
*/
function form( $instance ) {
// Get Widget Settings
$settings = wp_parse_args( $instance, $this->default_settings() );
?>
esc_html__( 'All Categories', 'admiral' ),
'show_count' => true,
'hide_empty' => false,
'selected' => $settings['category'],
'name' => $this->get_field_name('category'),
'id' => $this->get_field_id('category')
);
wp_dropdown_categories( $args );
?>