<?php /* Widget Name: Blog Description: Showcase blog content in personalized list or grid layouts with flexible design and display settings. Author: SiteOrigin Author URI: https://siteorigin.com Documentation: https://siteorigin.com/widgets-bundle/blog-widget/ */ class SiteOrigin_Widget_Blog_Widget extends SiteOrigin_Widget { public function __construct() { parent::__construct( 'sow-blog', __( 'SiteOrigin Blog', 'so-widgets-bundle' ), array( 'description' => __( 'Showcase blog content in personalized list or grid layouts with flexible design and display settings.', 'so-widgets-bundle' ), 'help' => 'https://siteorigin.com/widgets-bundle/blog-widget/', 'instance_storage' => true, 'panels_title' => false, ), array(), false, plugin_dir_path( __FILE__ ) ); } public function initialize() { add_action( 'wp_loaded', array( $this, 'register_image_sizes' ) ); $this->register_frontend_styles( array( array( 'sow-blog', plugin_dir_url( __FILE__ ) . 'css/style.css', ), ) ); $this->register_frontend_scripts( array( array( 'sow-blog', plugin_dir_url( __FILE__ ) . 'js/blog' . SOW_BUNDLE_JS_SUFFIX . '.js', array( 'jquery' ), SOW_BUNDLE_VERSION ), ) ); add_action( 'siteorigin_widgets_enqueue_frontend_scripts_sow-blog', array( $this, 'localize_scrollto' ), 10, 2 ); add_action( 'wp_enqueue_scripts', array( $this, 'register_template_assets' ) ); add_filter( 'siteorigin_widgets_blog_query', array( $this, 'portfolio_filter_posts' ), 8, 2 ); } public function register_image_sizes() { $image_sizes = apply_filters( 'siteorigin_widgets_blog_image_sizes', array( 'portfolio' => array( 375, 375, ), 'grid' => array( 720, 480, ), 'alternate' => array( 950, 630, ), ) ); foreach ( $image_sizes as $k => $size ) { add_image_size( 'sow-blog-' . $k, (int) $size[0], (int) $size[1], true ); } } public function get_widget_form() { $templates = apply_filters( 'siteorigin_widgets_blog_templates', json_decode( file_get_contents( plugin_dir_path( __FILE__ ) . 'data/templates.json' ), true ) ); return $this->dynamic_preset_state_handler( 'active_template', $templates, array( 'title' => array( 'type' => 'text', 'label' => __( 'Title', 'so-widgets-bundle' ), ), 'template' => array( 'type' => 'presets', 'label' => __( 'Template', 'so-widgets-bundle' ), 'default_preset' => 'standard', 'options' => $templates, 'state_emitter' => array( 'callback' => 'select', 'args' => array( 'active_template' ), ), ), 'settings' => array( 'type' => 'section', 'label' => __( 'Settings', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'columns' => array( 'type' => 'number', 'label' => __( 'Column Count', 'so-widgets-bundle' ), ), 'featured_image' => array( 'type' => 'checkbox', 'label' => __( 'Featured Image', 'so-widgets-bundle' ), 'default' => true, 'state_emitter' => array( 'callback' => 'conditional', 'args' => array( 'featured_image[show]: val', 'featured_image[hide]: ! val', ), ), ), 'featured_image_empty' => array( 'type' => 'checkbox', 'label' => __( 'Skip Post if No Featured Image', 'so-widgets-bundle' ), 'default' => true, 'state_handler' => array( 'active_template[portfolio]' => array( 'slideDown' ), '_else[active_template]' => array( 'slideUp' ), ), ), 'featured_image_size' => array( 'type' => 'image-size', 'label' => __( 'Featured Image Size', 'so-widgets-bundle' ), 'custom_size' => true, 'state_handler' => array( 'featured_image[show]' => array( 'show' ), 'featured_image[hide]' => array( 'hide' ), ), ), 'tag' => array( 'type' => 'select', 'label' => __( 'Post Title HTML Tag', 'so-widgets-bundle' ), 'default' => 'h2', 'options' => array( 'h1' => __( 'H1', 'so-widgets-bundle' ), 'h2' => __( 'H2', 'so-widgets-bundle' ), 'h3' => __( 'H3', 'so-widgets-bundle' ), 'h4' => __( 'H4', 'so-widgets-bundle' ), 'h5' => __( 'H5', 'so-widgets-bundle' ), 'h6' => __( 'H6', 'so-widgets-bundle' ), 'p' => __( 'Paragraph', 'so-widgets-bundle' ), ) ), 'content' => array( 'type' => 'select', 'label' => __( 'Post Content ', 'so-widgets-bundle' ), 'description' => __( 'Choose how to display your post content. Select Full Post Content if using the "more" quicktag.', 'so-widgets-bundle' ), 'default' => 'full', 'options' => array( 'excerpt' => __( 'Post Excerpt', 'so-widgets-bundle' ), 'full' => __( 'Full Post Content', 'so-widgets-bundle' ), ), 'state_emitter' => array( 'callback' => 'select', 'args' => array( 'content_type' ), ), 'state_handler' => array( 'active_template[standard,masonry,grid,offset,alternate]' => array( 'slideDown' ), '_else[active_template]' => array( 'slideUp' ), ), ), 'trim_manual_excerpt' => array( 'type' => 'checkbox', 'label' => __( 'Trim Manual Excerpt', 'so-widgets-bundle' ), 'description' => __( 'Trim the excerpt length even if a manual excerpt has been added to the post.', 'so-widgets-bundle' ), 'state_handler' => array( 'content_type[excerpt]' => array( 'show' ), '_else[content_type]' => array( 'hide' ), ), ), 'read_more' => array( 'type' => 'checkbox', 'label' => __( 'Post Excerpt Read More Link', 'so-widgets-bundle' ), 'description' => __( 'Display the Read More link below the post excerpt.', 'so-widgets-bundle' ), 'state_handler' => array( 'content_type[excerpt]' => array( 'show' ), '_else[content_type]' => array( 'hide' ), ), ), 'excerpt_length' => array( 'type' => 'number', 'label' => __( 'Excerpt Length', 'so-widgets-bundle' ), 'default' => 55, 'state_handler' => array( 'content_type[excerpt]' => array( 'show' ), '_else[content_type]' => array( 'hide' ), ), ), 'date' => array( 'type' => 'checkbox', 'label' => __( 'Post Date', 'so-widgets-bundle' ), 'default' => true, ), 'author' => array( 'type' => 'checkbox', 'label' => __( 'Post Author', 'so-widgets-bundle' ), 'default' => true, ), 'filter_categories' => array( 'type' => 'checkbox', 'label' => __( 'Filter Categories ', 'so-widgets-bundle' ), 'state_emitter' => array( 'callback' => 'conditional', 'args' => array( 'filter_categories[show]: val', 'filter_categories[hide]: ! val', ), ), ), 'categories' => array( 'type' => 'checkbox', 'label' => __( 'Post Categories', 'so-widgets-bundle' ), 'default' => true, ), 'tags' => array( 'type' => 'checkbox', 'label' => __( 'Post Tags', 'so-widgets-bundle' ), 'default' => false, ), 'comment_count' => array( 'type' => 'checkbox', 'label' => __( 'Post Comment Count', 'so-widgets-bundle' ), 'default' => true, ), ), ), 'design' => array( 'type' => 'section', 'label' => __( 'Design', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'post' => array( 'type' => 'section', 'label' => __( 'Post', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'border' => array( 'type' => 'color', 'label' => __( 'Border Color', 'so-widgets-bundle' ), 'default' => '#e6e6e6', ), 'background' => array( 'type' => 'color', 'label' => __( 'Background Color', 'so-widgets-bundle' ), 'default' => '#fff', ), ), ), 'title' => array( 'type' => 'section', 'label' => __( 'Post Title', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '24px', ), 'color' => array( 'type' => 'color', 'label' => __( 'Color', 'so-widgets-bundle' ), 'default' => '#2d2d2d', ), 'color_hover' => array( 'type' => 'color', 'label' => __( 'Hover Color', 'so-widgets-bundle' ), 'default' => '#626262', ), ), ), 'meta' => array( 'type' => 'section', 'label' => __( 'Post Meta', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '13px', ), 'color' => array( 'type' => 'color', 'label' => __( 'Color', 'so-widgets-bundle' ), 'default' => '#929292', ), 'color_hover' => array( 'type' => 'color', 'label' => __( 'Hover Color', 'so-widgets-bundle' ), 'default' => '#f14e4e', ), ), ), 'offset_post_meta' => array( 'type' => 'section', 'label' => __( 'Offset Post Meta', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '13px', ), 'color' => array( 'type' => 'color', 'label' => __( 'Color', 'so-widgets-bundle' ), 'default' => '#929292', ), 'link_color' => array( 'type' => 'color', 'label' => __( 'Link Color', 'so-widgets-bundle' ), 'default' => '#2d2d2d', ), 'link_color_hover' => array( 'type' => 'color', 'label' => __( 'Link Color Hover', 'so-widgets-bundle' ), 'default' => '#f14e4e', ), 'link_font_size' => array( 'type' => 'measurement', 'label' => __( 'Link Font Size', 'so-widgets-bundle' ), 'default' => '14px', ), ), ), 'overlay_post_category' => array( 'type' => 'section', 'label' => __( 'Overlay Post Category', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '11px', ), 'color' => array( 'type' => 'color', 'label' => __( 'Color', 'so-widgets-bundle' ), 'default' => '#fff', ), 'color_hover' => array( 'type' => 'color', 'label' => __( 'Hover Color', 'so-widgets-bundle' ), 'default' => '#fff', ), 'background' => array( 'type' => 'color', 'label' => __( 'Background', 'so-widgets-bundle' ), 'default' => 'rgba(0,0,0,0.7)', 'alpha' => true, ), 'background_hover' => array( 'type' => 'color', 'label' => __( 'Hover Background', 'so-widgets-bundle' ), 'default' => 'rgba(0,0,0,0.75)', 'alpha' => true, ), ), ), 'content' => array( 'type' => 'section', 'label' => __( 'Post Content', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '15px', ), 'color' => array( 'type' => 'color', 'label' => __( 'Color', 'so-widgets-bundle' ), 'default' => '#626262', ), 'link_color' => array( 'type' => 'color', 'label' => __( 'Link Color', 'so-widgets-bundle' ), 'default' => '#f14e4e', ), 'link_color_hover' => array( 'type' => 'color', 'label' => __( 'Link Hover Color', 'so-widgets-bundle' ), 'default' => '#626262', ), ), ), 'filter_categories' => array( 'type' => 'section', 'label' => __( 'Filter Categories', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '11px', 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), 'text_transform' => array( 'type' => 'checkbox', 'label' => __( 'Capitalize Categories', 'so-widgets-bundle' ), 'default' => true, 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), 'color' => array( 'type' => 'color', 'label' => __( 'Color', 'so-widgets-bundle' ), 'default' => '#929292', 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), 'color_hover' => array( 'type' => 'color', 'label' => __( 'Hover Color', 'so-widgets-bundle' ), 'default' => '#2d2d2d', 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), 'selected_border_color' => array( 'type' => 'color', 'label' => __( 'Selected Border Color', 'so-widgets-bundle' ), 'default' => '#2d2d2d', 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), 'selected_border_thickness' => array( 'type' => 'measurement', 'label' => __( 'Selected Border Thickness', 'so-widgets-bundle' ), 'default' => '2px', 'state_handler' => array( 'filter_categories[show]' => array( 'show' ), 'filter_categories[hide]' => array( 'hide' ), ), ), ), ), 'featured_image' => array( 'type' => 'section', 'label' => __( 'Featured Image', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'border_color' => array( 'type' => 'color', 'label' => __( 'Border Color', 'so-widgets-bundle' ), 'default' => '#929292', ), 'hover_overlay_color' => array( 'type' => 'color', 'label' => __( 'Hover Overlay Color', 'so-widgets-bundle' ), 'default' => 'rgba(255,255,255,0.9)', 'alpha' => true, ), 'post_title_font' => array( 'type' => 'font', 'label' => __( 'Post Title Font', 'so-widgets-bundle' ), ), 'post_title_font_size' => array( 'type' => 'measurement', 'label' => __( 'Post Title Font Size', 'so-widgets-bundle' ), 'default' => '15px', ), 'post_title_color' => array( 'type' => 'color', 'label' => __( 'Post Title Color', 'so-widgets-bundle' ), 'default' => '#2d2d2d', ), 'divider_border_color' => array( 'type' => 'color', 'label' => __( 'Divider Border Color', 'so-widgets-bundle' ), 'default' => '#2d2d2d', ), 'divider_border_thickness' => array( 'type' => 'measurement', 'label' => __( 'Divider Border Thickness', 'so-widgets-bundle' ), 'default' => '1px', ), 'divider_border_margin' => array( 'type' => 'measurement', 'label' => __( 'Divider Border Margin', 'so-widgets-bundle' ), 'default' => '13px', ), 'post_meta_font' => array( 'type' => 'font', 'label' => __( 'Post Meta Font', 'so-widgets-bundle' ), ), 'post_meta_font_size' => array( 'type' => 'measurement', 'label' => __( 'Post Meta Font Size', 'so-widgets-bundle' ), 'default' => '11px', ), 'post_meta_color' => array( 'type' => 'color', 'label' => __( 'Post Meta Color', 'so-widgets-bundle' ), 'default' => '#929292', ), ), ), 'pagination' => array( 'type' => 'section', 'label' => __( 'Pagination', 'so-widgets-bundle' ), 'hide' => true, 'fields' => array( 'top_margin' => array( 'type' => 'measurement', 'label' => __( 'Top Margin', 'so-widgets-bundle' ), 'default' => '30px', ), 'link_margin' => array( 'type' => 'measurement', 'label' => __( 'Link Margin', 'so-widgets-bundle' ), 'default' => '8px', ), 'border_color' => array( 'type' => 'color', 'label' => __( 'Border Color', 'so-widgets-bundle' ), 'default' => '#626262', ), 'border_color_hover' => array( 'type' => 'color', 'label' => __( 'Border Hover Color', 'so-widgets-bundle' ), 'default' => '#f14e4e', ), 'background' => array( 'type' => 'color', 'label' => __( 'Background', 'so-widgets-bundle' ), ), 'background_hover' => array( 'type' => 'color', 'label' => __( 'Hover Background', 'so-widgets-bundle' ), ), 'border_radius' => array( 'type' => 'slider', 'label' => __( 'Border Radius', 'so-widgets-bundle' ), 'max' => 50, 'min' => 0, 'step' => 1, ), 'font' => array( 'type' => 'font', 'label' => __( 'Font', 'so-widgets-bundle' ), ), 'font_size' => array( 'type' => 'measurement', 'label' => __( 'Font Size', 'so-widgets-bundle' ), 'default' => '14px', ), 'link_color' => array( 'type' => 'color', 'label' => __( 'Link Color', 'so-widgets-bundle' ), 'default' => '#626262', ), 'link_color_hover' => array( 'type' => 'color', 'label' => __( 'Link Hover Color', 'so-widgets-bundle' ), 'default' => '#f14e4e', ), 'dots_color' => array( 'type' => 'color', 'label' => __( 'Dots Color', 'so-widgets-bundle' ), 'default' => '#626262', ), 'width' => array( 'type' => 'measurement', 'label' => __( 'Width', 'so-widgets-bundle' ), 'units' => array( 'px', 'vh', 'vw', 'vmin', 'vmax' ), 'default' => '40px', ), 'height' => array( 'type' => 'measurement', 'label' => __( 'Height', 'so-widgets-bundle' ), 'units' => array( 'px', 'vh', 'vw', 'vmin', 'vmax' ), 'default' => '43px', ), ), ), ), ), 'posts' => array( 'type' => 'posts', 'label' => __( 'Posts Query', 'so-widgets-bundle' ), 'hide' => true, ), ) ); } public function get_settings_form() { return array( 'responsive_breakpoint' => array( 'type' => 'measurement', 'label' => __( 'Responsive Breakpoint', 'so-widgets-bundle' ), 'default' => '780px', 'description' => __( 'Device width, in pixels, to collapse into a mobile view.', 'so-widgets-bundle' ), ), 'scrollto' => array( 'type' => 'checkbox', 'label' => __( 'Scroll Top', 'so-widgets-bundle' ), 'default' => true, 'description' => __( 'Scroll the user to the top of the Blog Widget after pagination links are clicked.', 'so-widgets-bundle' ), ), ); } public function register_template_assets() { wp_register_script( 'sow-blog-template-masonry', plugin_dir_url( __FILE__ ) . 'js/masonry' . SOW_BUNDLE_JS_SUFFIX . '.js', array( 'jquery', 'jquery-isotope' ) ); wp_register_script( 'sow-blog-template-portfolio', plugin_dir_url( __FILE__ ) . 'js/portfolio' . SOW_BUNDLE_JS_SUFFIX . '.js', array( 'jquery', 'jquery-isotope' ) ); wp_register_script( 'jquery-isotope', plugin_dir_url( SOW_BUNDLE_BASE_FILE ) . 'js/lib/isotope.pkgd' . SOW_BUNDLE_JS_SUFFIX . '.js', array( 'jquery' ), '3.0.4', true ); do_action( 'siteorigin_widgets_blog_template_stylesheets' ); } public function localize_scrollto( $instance, $widget ) { $global_settings = $this->get_global_settings(); wp_localize_script( 'sow-blog', 'soBlogWidget', array( 'scrollto' => ! empty( $global_settings['scrollto'] ), 'scrollto_offset' => ( int ) apply_filters( 'siteorigin_widgets_blog_scrollto_offset', 90 ), ) ); } public function get_template_name( $instance ) { return 'base'; } public function get_style_name( $instance ) { $template = empty( $instance['template'] ) ? 'standard' : $instance['template']; // If this template has any assets, load them. if ( wp_style_is( 'sow-blog-template-' . $template, 'registered' ) ) { wp_enqueue_style( 'sow-blog-template-' . $template ); } if ( wp_script_is( 'sow-blog-template-' . $template, 'registered' ) ) { wp_enqueue_script( 'sow-blog-template-' . $template ); } return $template; } public function get_less_variables( $instance ) { if ( empty( $instance ) ) { return array(); } $less_vars = array( 'responsive_breakpoint' => $this->get_global_settings( 'responsive_breakpoint' ), 'categories' => ! empty( $instance['settings']['categories'] ) ? $instance['settings']['categories'] : false, 'author' => ! empty( $instance['settings']['author'] ) ? $instance['settings']['author'] : false, 'columns' => isset( $instance['settings']['columns'] ) && (int) $instance['settings']['columns'] > 0 ? (int) $instance['settings']['columns'] : 1, ); if ( $instance['template'] == 'masonry' ) { $less_vars['column_width'] = 100 / $less_vars['columns'] - $less_vars['columns'] * 0.5 . '%'; } elseif ( $instance['template'] == 'grid' && $less_vars['columns'] > 2 ) { $less_vars['column_spacing'] = $less_vars['columns'] * 0.5 . '%'; } if ( $instance['template'] != 'portfolio' ) { // Post. $less_vars['post_border_color'] = ! empty( $instance['design']['post']['border'] ) ? $instance['design']['post']['border'] : ''; $less_vars['post_background'] = ! empty( $instance['design']['post']['background'] ) ? $instance['design']['post']['background'] : ''; // Post Title. if ( ! empty( $instance['design']['title']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['title']['font'] ); $less_vars['title_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['title_font_style'] = $font['style']; $less_vars['title_font_weight'] = $font['weight_raw']; } } $less_vars['title_font_size'] = ! empty( $instance['design']['title']['font_size'] ) ? $instance['design']['title']['font_size'] : ''; $less_vars['title_color'] = ! empty( $instance['design']['title']['color'] ) ? $instance['design']['title']['color'] : ''; $less_vars['title_color_hover'] = ! empty( $instance['design']['title']['color_hover'] ) ? $instance['design']['title']['color_hover'] : ''; // Post Meta. if ( ! empty( $instance['design']['meta']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['meta']['font'] ); $less_vars['meta_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['meta_font_style'] = $font['style']; $less_vars['meta_font_weight'] = $font['weight_raw']; } } $less_vars['meta_font_size'] = ! empty( $instance['design']['meta']['font_size'] ) ? $instance['design']['meta']['font_size'] : ''; $less_vars['meta_color'] = ! empty( $instance['design']['meta']['color'] ) ? $instance['design']['meta']['color'] : ''; $less_vars['meta_color_hover'] = ! empty( $instance['design']['meta']['color_hover'] ) ? $instance['design']['meta']['color_hover'] : ''; if ( $instance['template'] == 'offset' ) { // Offset Post Meta. if ( ! empty( $instance['design']['offset_post_meta']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['offset_post_meta']['font'] ); $less_vars['offset_post_meta_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['offset_post_meta_font_style'] = $font['style']; $less_vars['offset_post_meta_font_weight'] = $font['weight_raw']; } } $less_vars['offset_post_meta_font_size'] = ! empty( $instance['design']['offset_post_meta']['font_size'] ) ? $instance['design']['offset_post_meta']['font_size'] : ''; $less_vars['offset_post_meta_color'] = ! empty( $instance['design']['offset_post_meta']['color'] ) ? $instance['design']['offset_post_meta']['color'] : ''; $less_vars['offset_post_meta_link_color'] = ! empty( $instance['design']['offset_post_meta']['link_color'] ) ? $instance['design']['offset_post_meta']['link_color'] : ''; $less_vars['offset_post_meta_link_color_hover'] = ! empty( $instance['design']['offset_post_meta']['link_color_hover'] ) ? $instance['design']['offset_post_meta']['link_color_hover'] : ''; $less_vars['offset_post_meta_link_font_size'] = ! empty( $instance['design']['offset_post_meta']['link_font_size'] ) ? $instance['design']['offset_post_meta']['link_font_size'] : ''; } // Content. if ( ! empty( $instance['design']['content']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['content']['font'] ); $less_vars['content_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['content_font_style'] = $font['style']; $less_vars['content_font_weight'] = $font['weight_raw']; } } $less_vars['content_font_size'] = ! empty( $instance['design']['content']['font_size'] ) ? $instance['design']['content']['font_size'] : ''; $less_vars['content_color'] = ! empty( $instance['design']['content']['color'] ) ? $instance['design']['content']['color'] : ''; $less_vars['content_link'] = ! empty( $instance['design']['content']['link_color'] ) ? $instance['design']['content']['link_color'] : ''; $less_vars['content_link_hover'] = ! empty( $instance['design']['content']['link_color_hover'] ) ? $instance['design']['content']['link_color_hover'] : ''; } else { global $_wp_additional_image_sizes; if ( ! empty( $instance['settings']['featured_image_size'] ) ) { $less_vars['image_size'] = $instance['settings']['featured_image_size'] == 'custom_size' ? $instance['settings']['featured_image_size_width'] : $instance['settings']['featured_image_size']; if ( isset( $_wp_additional_image_sizes[ $less_vars['image_size'] ] ) ) { $less_vars['image_size'] = $_wp_additional_image_sizes[ $less_vars['image_size'] ]['width'] . 'px'; } } $less_vars['column_width'] = number_format( 98.8333 / $less_vars['columns'], 2 ) . '%'; if ( empty( $less_vars['categories'] ) && ! empty( $instance['settings']['filter_categories'] ) ) { $less_vars['categories'] = 1; } } // Pagination. $less_vars['pagination_top_margin'] = ! empty( $instance['design']['pagination']['top_margin'] ) ? $instance['design']['pagination']['top_margin'] : ''; $less_vars['pagination_link_margin'] = ! empty( $instance['design']['pagination']['link_margin'] ) ? $instance['design']['pagination']['link_margin'] : ''; $less_vars['pagination_link_margin_offset'] = ! empty( $instance['design']['pagination']['link_margin'] ) ? '-' . $instance['design']['pagination']['link_margin'] : ''; $less_vars['pagination_border_color'] = ! empty( $instance['design']['pagination']['border_color'] ) ? $instance['design']['pagination']['border_color'] : ''; $less_vars['pagination_border_color_hover'] = ! empty( $instance['design']['pagination']['border_color_hover'] ) ? $instance['design']['pagination']['border_color_hover'] : ''; $less_vars['pagination_background'] = ! empty( $instance['design']['pagination']['background'] ) ? $instance['design']['pagination']['background'] : ''; $less_vars['pagination_background_hover'] = ! empty( $instance['design']['pagination']['background_hover'] ) ? $instance['design']['pagination']['background_hover'] : ''; $less_vars['pagination_border_radius'] = ! empty( $instance['design']['pagination']['border_radius'] ) ? $instance['design']['pagination']['border_radius'] . 'px' : ''; if ( ! empty( $instance['design']['pagination']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['pagination']['font'] ); $less_vars['pagination_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['pagination_font_style'] = $font['style']; $less_vars['pagination_font_weight'] = $font['weight_raw']; } } $less_vars['pagination_font_size'] = ! empty( $instance['design']['pagination']['font_size'] ) ? $instance['design']['pagination']['font_size'] : ''; $less_vars['pagination_link_color'] = ! empty( $instance['design']['pagination']['link_color'] ) ? $instance['design']['pagination']['link_color'] : ''; $less_vars['pagination_link_color_hover'] = ! empty( $instance['design']['pagination']['link_color_hover'] ) ? $instance['design']['pagination']['link_color_hover'] : ''; $less_vars['pagination_dots_color'] = ! empty( $instance['design']['pagination']['dots_color'] ) ? $instance['design']['pagination']['dots_color'] : ''; $less_vars['pagination_width'] = ! empty( $instance['design']['pagination']['width'] ) ? $instance['design']['pagination']['width'] : ''; $less_vars['pagination_height'] = ! empty( $instance['design']['pagination']['height'] ) ? $instance['design']['pagination']['height'] : ''; if ( $instance['template'] == 'masonry' ) { // Overlay Post Category. if ( ! empty( $instance['design']['overlay_post_category']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['overlay_post_category']['font'] ); $less_vars['overlay_post_category_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['overlay_post_category_font_style'] = $font['style']; $less_vars['overlay_post_category_font_weight'] = $font['weight_raw']; } } $less_vars['overlay_post_category_font_size'] = ! empty( $instance['design']['overlay_post_category']['font_size'] ) ? $instance['design']['overlay_post_category']['font_size'] : ''; $less_vars['overlay_post_category_color'] = ! empty( $instance['design']['overlay_post_category']['color'] ) ? $instance['design']['overlay_post_category']['color'] : ''; $less_vars['overlay_post_category_color_hover'] = ! empty( $instance['design']['overlay_post_category']['color_hover'] ) ? $instance['design']['overlay_post_category']['color_hover'] : ''; $less_vars['overlay_post_category_background'] = ! empty( $instance['design']['overlay_post_category']['background'] ) ? $instance['design']['overlay_post_category']['background'] : 'rgba(0,0,0,0.80)'; $less_vars['overlay_post_category_background_hover'] = ! empty( $instance['design']['overlay_post_category']['background_hover'] ) ? $instance['design']['overlay_post_category']['background_hover'] : 'rgba(0,0,0,0.75)'; } if ( $instance['template'] == 'portfolio' ) { // Filter Categories. if ( ! empty( $instance['design']['filter_categories']['font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['filter_categories']['font'] ); $less_vars['filter_categories_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['filter_categories_font_style'] = $font['style']; $less_vars['filter_categories_font_weight'] = $font['weight_raw']; } } $less_vars['filter_categories_font_size'] = ! empty( $instance['design']['filter_categories']['font_size'] ) ? $instance['design']['filter_categories']['font_size'] : ''; $less_vars['filter_categories_color'] = ! empty( $instance['design']['filter_categories']['color'] ) ? $instance['design']['filter_categories']['color'] : ''; $less_vars['filter_categories_color_hover'] = ! empty( $instance['design']['filter_categories']['color_hover'] ) ? $instance['design']['filter_categories']['color_hover'] : ''; $less_vars['filter_categories_text_transform'] = ! empty( $instance['design']['filter_categories']['text_transform'] ) ? 'uppercase' : ''; $less_vars['filter_categories_selected_border_color'] = ! empty( $instance['design']['filter_categories']['selected_border_color'] ) ? $instance['design']['filter_categories']['selected_border_color'] : ''; $less_vars['filter_categories_selected_border_thickness'] = ! empty( $instance['design']['filter_categories']['selected_border_thickness'] ) ? $instance['design']['filter_categories']['selected_border_thickness'] : ''; // Featured Images. $less_vars['featured_image_border_color'] = ! empty( $instance['design']['featured_image']['border_color'] ) ? $instance['design']['featured_image']['border_color'] : ''; $less_vars['featured_image_hover_overlay_color'] = ! empty( $instance['design']['featured_image']['hover_overlay_color'] ) ? $instance['design']['featured_image']['hover_overlay_color'] : ''; if ( ! empty( $instance['design']['featured_image']['post_title_font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['featured_image']['post_title_font'] ); $less_vars['featured_image_post_title_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['featured_image_post_title_font_style'] = $font['style']; $less_vars['featured_image_post_title_font_weight'] = $font['weight_raw']; } } $less_vars['featured_image_post_title_font_size'] = ! empty( $instance['design']['featured_image']['post_title_font_size'] ) ? $instance['design']['featured_image']['post_title_font_size'] : ''; $less_vars['featured_image_post_title_color'] = ! empty( $instance['design']['featured_image']['post_title_color'] ) ? $instance['design']['featured_image']['post_title_color'] : ''; $less_vars['featured_image_divider_border_color'] = ! empty( $instance['design']['featured_image']['divider_border_color'] ) ? $instance['design']['featured_image']['divider_border_color'] : ''; $less_vars['featured_image_divider_border_thickness'] = ! empty( $instance['design']['featured_image']['divider_border_thickness'] ) ? $instance['design']['featured_image']['divider_border_thickness'] : ''; $less_vars['featured_image_divider_border_margin'] = ! empty( $instance['design']['featured_image']['divider_border_margin'] ) ? $instance['design']['featured_image']['divider_border_margin'] : ''; if ( ! empty( $instance['design']['featured_image']['post_meta_font'] ) ) { $font = siteorigin_widget_get_font( $instance['design']['featured_image']['post_meta_font'] ); $less_vars['featured_image_post_meta_font'] = $font['family']; if ( ! empty( $font['weight'] ) ) { $less_vars['featured_image_post_meta_font_style'] = $font['style']; $less_vars['featured_image_post_meta_font_weight'] = $font['weight_raw']; } } $less_vars['featured_image_post_meta_font_size'] = ! empty( $instance['design']['featured_image']['post_meta_font_size'] ) ? $instance['design']['featured_image']['post_meta_font_size'] : ''; $less_vars['featured_image_post_meta_color'] = ! empty( $instance['design']['featured_image']['post_meta_color'] ) ? $instance['design']['featured_image']['post_meta_color'] : ''; } return $less_vars; } /** * Get terms for a given taxonomy. * * This method retrieves the terms for a given taxonomy. If a post ID is provided, * it retrieves the terms associated with that post. Otherwise, it retrieves * all terms for the taxonomy. * * @param string $taxonomy The taxonomy to retrieve terms for. * @param int $post_id The post ID. Defaults to 0. * @param bool $error_check Whether to check for errors. Defaults to true. * * @return array|false The terms for the taxonomy or false if an error occurs. */ public static function get_terms_for_taxonomy( $taxonomy, $post_id = 0, $error_check = true ) { $terms = $post_id ? get_the_terms( (int) $post_id, $taxonomy ) : get_terms( $taxonomy ); set_query_var( 'siteorigin_widgets_portfolio_taxonomy', $taxonomy ); if ( $error_check && ( empty( $terms ) || is_wp_error( $terms ) ) ) { return false; } return $terms; } /** * Legacy method to get the terms for the portfolio. * * This method retrieves the terms for a given query. It is the legacy version of * `get_query_terms`, and ideally should be replaced with the newer method. * * @param array $instance The instance settings. * @param int $post_id Optional. The post ID to retrieve terms for. Default is 0. * * @return array The terms for the query. */ public static function portfolio_get_terms( $instance, $post_id = 0 ) { $query = wp_parse_args( siteorigin_widget_post_selector_process_query( $instance['posts'] ) ); return self::get_query_terms( $instance, $query, $post_id ); } /** * Get query terms for the instance. * * This method retrieves the terms for the portfolio based on the instance * and post ID. It checks for developer-set terms, Jetpack Portfolio terms, * and other possible taxonomies. If no terms are found, it uses a fallback term. * The fallback term is `category`. The fallback term can be filtered using * the `siteorigin_widgets_blog_portfolio_fallback_term` filter. * * @param array $instance The instance configuration array. * @param array $query The Blog query that'll be used to retrieve the posts. * @param int $post_id Optional. The post ID to retrieve terms for. Default is 0. * * @return array|false The terms for the portfolio, or false if no terms are found. */ public static function get_query_terms( $instance, $query, $post_id = 0 ) { $terms = array(); $query['post_type'] = ! empty( $query['post_type'] ) ? $query['post_type'] : array( 'post' ); if ( ! empty( $post_id ) ) { // Check if a developer has set terms for this post type. $taxonomy = apply_filters( 'siteorigin_widgets_blog_portfolio_taxonomy', '', $instance, $query['post_type'] ); if ( ! empty( $taxonomy ) && is_array( $taxonomy ) ) { return $taxonomy; } } // Has user set terms? If so, let's use that if a post id hasn't be set. // Individual posts should use their terms, rather than one set in the widget. if ( empty( $post_id ) && ! empty( $query ) && ! empty( $query['tax_query'] ) ) { foreach ( $query['tax_query'] as $tax ) { if ( isset( $tax['terms'] ) ) { $terms[] = $tax['terms']; } } // We need to set a taxonomy so we can hide/show terms. // Let's use the first term's taxonomy. if ( ! empty( $terms ) && ! empty( $query['tax_query'][1] ) && ! empty( $query['tax_query'][1]['taxonomy'] ) ) { set_query_var( 'siteorigin_widgets_portfolio_taxonomy', $query['tax_query'][1]['taxonomy'] ); } return $terms; } // Check for Jetpack Portfolio terms. if ( post_type_exists( 'jetpack-portfolio' ) && $query['post_type'] === 'jetpack-portfolio' ) { $terms = self::get_terms_for_taxonomy( 'jetpack-portfolio-type', $post_id ); if ( $terms ) { return $terms; } } // Check for terms in other possible taxonomies. $possible_tax = get_object_taxonomies( $query['post_type'] ); foreach ( $possible_tax as $tax ) { $terms = self::get_terms_for_taxonomy( $tax, $post_id ); if ( $terms ) { return $terms; } } // Use fallback term if no terms are found. $fallback = apply_filters( 'siteorigin_widgets_blog_portfolio_fallback_term', 'category', $instance ); return self::get_terms_for_taxonomy( $fallback, $post_id, false ); } /** * Retrieves a list of terms for the given instance for the purpose of filtering. * * This method retrieves the terms for the given instance and posts. It first finds * the query terms, ensures that the terms are valid and (optionally) filters out any * terms that aren't associated with the posts. * * @param array $instance The instance configuration array. * @param WP_Query $posts The query object containing the posts. * @param array $query The query array. * * @return array The filtered terms for the instance and posts. */ private static function get_filter_categories( $instance, $posts, $query ) { $terms = self::get_query_terms( $instance, $query ); if ( ! apply_filters( 'siteorigin_widgets_blog_portfolio_ensure_valid_terms', true ) ) { return $terms; } if ( empty( $terms ) || is_wp_error( $terms ) ) { return $terms; } $taxonomy = apply_filters( 'siteorigin_widgets_blog_portfolio_taxonomy_filter', get_query_var( 'siteorigin_widgets_portfolio_taxonomy' ) ); // Get all of the terms for the posts. $all_terms = array(); foreach ( $posts->posts as $post ) { $post_terms = wp_get_post_terms( $post->ID, $taxonomy ); foreach ( $post_terms as $post_term ) { $all_terms[] = $post_term->slug; } } $all_terms = array_unique( $all_terms ); // Filter out any terms that aren't in the posts. $filtered_terms = array(); foreach ( $terms as $term ) { $slug = is_object( $term ) ? $term->slug : $term; if ( in_array( $slug, $all_terms ) ) { $filtered_terms[] = $term; } } return $filtered_terms; } public function modify_instance( $instance ) { if ( empty( $instance ) || ! is_array( $instance ) ) { return array(); } if ( ! isset( $instance['settings'] ) || ! is_array( $instance['settings'] ) ) { $instance['settings'] = array(); } if ( ! isset( $instance['settings']['tag'] ) ) { $instance['settings']['tag'] = 'h2'; } if ( empty( $instance['template'] ) ) { $instance['template'] = 'standard'; } else { $custom_template = apply_filters( 'siteorigin_widgets_blog_custom_template', false, $instance ); if ( ! $custom_template ) { // Ensure selected template is valid. switch ( $instance['template'] ) { case 'alternate': case 'grid': case 'masonry': case 'offset': case 'portfolio': case 'standard': break; default: $instance['template'] = 'standard'; break; } } } // Add featured image default for instances of the Blog widget created prior to the Featured Image Size setting. if ( ! isset( $instance['settings']['featured_image_size'] ) ) { if ( $instance['template'] == 'grid' || $instance['template'] == 'alternate' || $instance['template'] == 'portfolio' ) { $instance['settings']['featured_image_size'] = 'sow-blog-' . $instance['template']; } else { $instance['settings']['featured_image_size'] = 'full'; } $instance['settings']['featured_image_size_width'] = 0; $instance['settings']['featured_image_size_height'] = 0; } // Migrate old opacity fields. if ( ! empty( $instance['design']['featured_image']['hover_overlay_opacity'] ) ) { $color = ! empty( $instance['design']['featured_image']['hover_overlay_color'] ) ? $instance['design']['featured_image']['hover_overlay_color'] : '#fff'; $color = ltrim( $instance['design']['featured_image']['hover_overlay_color'], '#' ); $rgb = array_map( 'hexdec', str_split( $color , strlen( $color ) == 6 ? 2 : 1 ) ); $opacity = ! empty( $instance['design']['featured_image']['hover_overlay_opacity'] ) ? $instance['design']['featured_image']['hover_overlay_opacity'] : 0.9; $instance['design']['featured_image']['hover_overlay_color'] = "rgba( $rgb[0], $rgb[1], $rgb[2], $opacity )"; unset( $instance['design']['featured_image']['hover_overlay_opacity'] ); } if ( ! empty( $instance['design']['overlay_post_category']['background_opacity'] ) ) { $color = ! empty( $instance['design']['overlay_post_category']['background'] ) ? $instance['design']['overlay_post_category']['background'] : '#000'; $color = ltrim( $color, '#' ); $rgb = array_map( 'hexdec', str_split( $color , strlen( $color ) == 6 ? 2 : 1 ) ); $opacity = $instance['design']['overlay_post_category']['background_opacity']; $instance['design']['overlay_post_category']['background'] = "rgba( $rgb[0], $rgb[1], $rgb[2], $opacity )"; unset( $instance['design']['overlay_post_category']['background_opacity'] ); } if ( ! empty( $instance['design']['overlay_post_category']['background_opacity_hover'] ) ) { $color = ! empty( $instance['design']['overlay_post_category']['background_hover'] ) ? $instance['design']['overlay_post_category']['background_hover'] : '#000'; $color = ltrim( $color, '#' ); $rgb = array_map( 'hexdec', str_split( $color , strlen( $color ) == 6 ? 2 : 1 ) ); $opacity = $instance['design']['overlay_post_category']['background_opacity_hover']; $instance['design']['overlay_post_category']['background_hover'] = "rgba( $rgb[0], $rgb[1], $rgb[2], $opacity )"; unset( $instance['design']['overlay_post_category']['background_opacity_hover'] ); } $instance['paged_id'] = $this->get_style_hash( $instance ); // Ensure Filter Categories is disabled for templates that // don't support it. if ( $instance['template'] !== 'portfolio' && $instance['template'] !== 'masonry' ) { $instance['settings']['filter_categories'] = false; } // Prevent WAF PHP function block. if ( is_array( $instance['settings'] ) && isset( $instance['settings']['date_format'] ) ) { $instance['settings']['date_output_format'] = $instance['settings']['date_format']; unset( $instance['settings']['date_format'] ); } return $instance; } public static function get_template( $instance ) { $template_file = plugin_dir_path( __FILE__ ) . 'tpl/' . sanitize_file_name( $instance['template'] ) . '.php'; $override_file = apply_filters( 'siteorigin_widgets_blog_template_file', $template_file, $instance ); // If any of the below checks fail, return the default template. // Otherwise, allow the override. if ( empty( $override_file ) ) { return $template_file; } // File name must end in '-sow-blog.php' if ( substr( $override_file, -13 ) != '-sow-blog.php' ) { return $template_file; } if ( ! file_exists( $override_file ) ) { return $template_file; } return $override_file; } public function get_template_variables( $instance, $args ) { if ( ! isset( $instance['paged'] ) ) { $instance['paged'] = ! empty( $_GET['sow-' . $instance['paged_id'] ] ) ? (int) $_GET['sow-' . $instance['paged_id'] ] : 1; } $query = wp_parse_args( array( 'paged' => $instance['paged'], ), siteorigin_widget_post_selector_process_query( $instance['posts'] ) ); // If the user has set an offset, account for it after the first page. if ( isset( $query['offset'] ) && $instance['paged'] > 1 ) { $query['offset'] = $offset = ( $query['paged'] - 1 ) * $query['posts_per_page'] + $query['offset']; } if ( $instance['template'] == 'portfolio' && ! empty( $instance['featured_image_fallback'] ) ) { // The portfolio template relies on each post having an image so exclude any posts that don't. $query['meta_query'] = array( array( 'key' => '_thumbnail_id', 'compare' => 'EXISTS', ), ); } // Add template specific settings. $template_settings = array( 'date_output_format' => isset( $instance['settings']['date_output_format'] ) ? $instance['settings']['date_output_format'] : null, ); if ( $instance['template'] == 'offset' ) { if ( $instance['settings']['date'] ) { if ( get_the_time( 'U' ) !== get_the_modified_time( 'U' ) ) { $template_settings['time_string'] = '<time class="entry-date published" datetime="%1$s">%2$s</time><time class="updated" datetime="%3$s">%4$s</time>'; } else { $template_settings['time_string'] = '<time class="entry-date published updated" datetime="%1$s">%2$s</time>'; } } } $posts = new WP_Query( apply_filters( 'siteorigin_widgets_blog_query', $query, $instance ) ); $template_settings['filter_categories'] = ! empty( $instance['settings']['filter_categories'] ); if ( $template_settings['filter_categories'] === true ) { $template_settings['terms'] = self::get_filter_categories( $instance, $posts, $query ); } // Add the current template to the settings array to allow for easier referencing. $instance['settings']['template'] = $instance['template']; return array( 'title' => $instance['title'], 'settings' => $instance['settings'], 'template_settings' => $template_settings, 'posts' => $posts, 'query' => $query, ); } public function portfolio_filter_posts( $query, $instance ) { if ( $instance['template'] == 'portfolio' && ! empty( $instance['settings']['featured_image_empty'] ) && empty( $instance['settings']['featured_image_fallback'] ) ) { $query['meta_query'] = array( array( 'key' => '_thumbnail_id', 'compare' => 'EXISTS', ), ); } return $query; } public static function post_meta( $settings ) { ob_start(); if ( is_sticky() ) { ?> <span class="sow-featured-post"><?php esc_html_e( 'Sticky', 'so-widgets-bundle' ); ?></span> <?php } if ( $settings['date'] ) { $date_output_format = isset( $settings['date_output_format'] ) ? $settings['date_output_format'] : null; ?> <span class="sow-entry-date"> <a href="<?php echo esc_url( get_permalink() ); ?>" rel="bookmark"> <time class="published" datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>"> <?php echo esc_html( get_the_date( $date_output_format ) ); ?> </time> <time class="updated" datetime="<?php echo esc_attr( get_the_modified_date( 'c' ) ); ?>"> <?php echo esc_html( get_the_modified_date() ); ?> </time> </a> </span> <?php } ?> <?php if ( $settings['author'] ) { ?> <span class="sow-entry-author-link byline"> <?php if ( function_exists( 'coauthors_posts_links' ) ) { ?> <?php coauthors_posts_links(); ?> <?php } else { ?> <span class="sow-author author vcard"> <a class="url fn n" href="<?php echo esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ); ?>" rel="author"> <?php echo esc_html( get_the_author() ); ?> </a> </span> <?php } ?> </span> <?php } ?> <?php if ( $settings['categories'] && has_category() ) { $categories = get_the_terms( get_the_ID(), 'category' ); $categories = apply_filters( 'siteorigin_widgets_blog_filter_categories_output', $categories, $settings ); if ( ! empty( $categories ) ) { echo '<span class="sow-entry-categories">'; $category_links = []; foreach ( $categories as $category ) { $category_link = get_category_link( $category->term_id ); $category_links[] = '<a href="' . esc_url( $category_link ) . '">' . esc_html__( $category->name, 'so-widgets-bundle' ) . '</a>'; } /* translators: used between list items, there is a space after the comma */ echo implode( esc_html__( ', ', 'so-widgets-bundle' ), $category_links ); echo '</span>'; } } if ( ! empty( $settings['tags'] ) && has_tag() ) { ?> <span class="sow-entry-tags"> <?php the_tags( '' ); ?> </span> <?php } ?> <?php if ( comments_open() && $settings['comment_count'] ) { ?> <span class="sow-entry-comments"> <?php comments_popup_link( esc_html__( 'Leave a comment', 'so-widgets-bundle' ), esc_html__( 'One Comment', 'so-widgets-bundle' ), esc_html__( '% Comments', 'so-widgets-bundle' ) ); ?> </span> <?php } $post_meta = ob_get_clean(); echo apply_filters( 'siteorigin_widgets_blog_post_meta', $post_meta, $settings ); } static public function post_featured_image( $settings, $categories = false, $size = 'full' ) { if ( $settings['featured_image'] ) { if ( ! has_post_thumbnail() && ! empty( $settings['featured_image_fallback'] ) ) { $featured_image = apply_filters( 'siteorigin_widgets_blog_featured_image_fallback', false, $settings ); } if ( has_post_thumbnail() || ! empty( $featured_image ) ) { ob_start(); ?> <div class="sow-entry-thumbnail"> <?php if ( $categories && $settings['categories'] && has_category() ) { ?> <div class="sow-thumbnail-meta"> <?php echo get_the_category_list(); ?> </div> <?php } ?> <a href="<?php echo esc_url( get_the_permalink() ); ?>"> <?php if ( has_post_thumbnail() ) { if ( ! empty( $settings['featured_image_size'] ) ) { $size = $settings['featured_image_size'] == 'custom_size' ? array( $settings['featured_image_size_width'], $settings['featured_image_size_height'] ) : $settings['featured_image_size']; } else { // Check if this template has a different default image size. if ( $size == 'full' && has_image_size( 'sow-blog-' . $settings['template'] ) ) { $size = 'sow-blog-' . $settings['template']; } } the_post_thumbnail( $size ); } elseif( ! empty( $featured_image ) ) { echo $featured_image; } ?> </a> </div> <?php echo apply_filters( 'siteorigin_widgets_blog_featured_image_markup', ob_get_clean(), $settings, $categories = false, $size = 'full' ); } } } static public function generate_post_title( $settings ) { $tag = siteorigin_widget_valid_tag( $settings['tag'], 'h2' ); the_title( '<' . $tag . ' class="sow-entry-title" style="margin: 0 0 5px;"><a href="' . esc_url( get_permalink() ) . '" rel="bookmark">', '</a></' . $tag . '>' ); } public function override_read_more( $settings, $setup = true ) { // Read More Override. if ( $settings['content'] == 'full' && apply_filters( 'siteorigin_widgets_blog_full_content_read_more', true ) ) { if ( $setup ) { set_query_var( 'siteorigin_blog_read_more', ! empty( $settings['read_more_text'] ) ? $settings['read_more_text'] : __( 'Continue reading', 'so-widgets-bundle' ) ); add_filter( 'the_content_more_link', array( $this, 'alter_read_more_link' ) ); } else { remove_filter( 'the_content_more_link', array( $this, 'alter_read_more_link' ) ); } } if ( $setup ) { set_query_var( 'siteorigin_blog_excerpt_length', apply_filters( 'siteorigin_widgets_blog_excerpt_length', isset( $settings['excerpt_length'] ) ? $settings['excerpt_length'] : 55 ) ); add_filter( 'excerpt_length', array( $this, 'alter_excerpt_length' ), 1000 ); add_filter( 'excerpt_more', array( $this, 'alter_excerpt_more_indicator' ) ); } else { remove_filter( 'excerpt_length', array( $this, 'alter_excerpt_length' ), 1000 ); remove_filter( 'the_content_more_link', array( $this, 'alter_excerpt_more_indicator' ) ); } } public function alter_read_more_link( $link ) { return '<a class="sow-more-link" href="' . esc_url( get_permalink() ) . '"> ' . esc_html( get_query_var( 'siteorigin_blog_read_more' ) ) . '<span class="sow-more-link-arrow">→</span></a>'; } public function alter_excerpt_more_indicator( $indicator ) { return apply_filters( 'siteorigin_widgets_blog_excerpt_trim', get_query_var( 'siteorigin_blog_excerpt_length' ) == 0 ? '' : '...' ); } public function alter_excerpt_length( $length = 55 ) { return get_query_var( 'siteorigin_blog_excerpt_length' ); } public static function output_content( $settings, $space_above = 20 ) { if ( apply_filters( 'siteorigin_widgets_blog_show_content', true, $settings ) ) { ?> <div class="sow-entry-content" style="margin-top: <?php echo (int) $space_above; ?>px;" > <?php if ( $settings['content'] == 'full' ) { the_content(); } else { self::generate_excerpt( $settings ); } ?> </div> <?php } } public static function content_wrapper( $settings, $styles = array() ) { $styles = apply_filters( 'siteorigin_widgets_blog_content_wrapper_styles', $styles, $settings ); ?> <div class="sow-blog-content-wrapper" <?php if ( ! empty( $styles ) ) { echo ' style="'; foreach ( $styles as $key => $val ) { echo siteorigin_sanitize_attribute_key( $key ) . ': ' . esc_attr( $val ) . ';'; } echo '"'; } ?>> <?php } /** * Checks if a read more link should be displayed. * * Determines display by checking: * 1. Read more enabled in widget settings. * 2. Filter to override default behavior (true). * 3. Post has manual excerpt or auto-excerpt exceeds word limit * * @param array $settings The current Blog widget settings. * @return bool True if read more link should be displayed, false otherwise. */ private static function maybe_add_read_more( $settings ): bool { if ( ! $settings['read_more'] ) { return false; } if ( apply_filters( 'siteorigin_widgets_blog_always_add_read_more', false ) ) { return true; } return has_excerpt() || count( preg_split( '~[^\p{L}\p{N}\']+~u', get_the_excerpt() ) ) >= get_query_var( 'siteorigin_blog_excerpt_length' ); } public static function generate_excerpt( $settings ) { $length = get_query_var( 'siteorigin_blog_excerpt_length' ); $excerpt = get_the_excerpt(); if ( ! has_excerpt() || ! empty( $settings['trim_manual_excerpt'] ) ) { $excerpt = wp_trim_words( $excerpt, $length, apply_filters( 'siteorigin_widgets_blog_excerpt_trim', '...' ) ); } if ( self::maybe_add_read_more( $settings ) ) { $read_more_text = ! empty( $settings['read_more_text'] ) ? $settings['read_more_text'] : __( 'Continue reading', 'so-widgets-bundle' ); $read_more_text = '<a class="sow-more-link more-link excerpt" href="' . esc_url( get_permalink() ) . '">' . esc_html( $read_more_text ) . '<span class="sow-more-link-arrow">→</span></a>'; $excerpt .= $read_more_text; } echo '<p>' . wp_kses_post( $excerpt ) . '</p>'; } public function paginate_links( $settings, $posts, $instance ) { $addon_active = class_exists( 'SiteOrigin_Premium' ) && ! empty( SiteOrigin_Premium::single()->get_active_addons()['plugin/blog'] ); if ( $addon_active ) { $pagination_markup = apply_filters( 'siteorigin_widgets_blog_pagination_markup', false, $settings, $posts, $instance ); } if ( empty( $pagination_markup ) ) { if ( $addon_active && isset( $settings['pagination_reload'] ) && $settings['pagination_reload'] == 'ajax' ) { $current = 99999; $show_all_prev_next = true; } else { $current = max( 1, $posts->query['paged'] ); $show_all_prev_next = false; } wp_reset_query(); $pagination_markup = paginate_links( array( 'format' => '?sow-' . $instance['paged_id'] . '=%#%', 'total' => $posts->max_num_pages, 'current' => $current, 'show_all' => $show_all_prev_next, 'prev_next' => ! $show_all_prev_next, 'prev_text' => is_rtl() ? '→' : '←', 'next_text' => is_rtl() ? '←' : '→', // Prevent multiple Blog widgets from "stacking" pagination. 'base' => get_the_permalink() . '%_%', ) ); } if ( ! empty( $pagination_markup ) && $settings['pagination'] != 'disabled' ) { // To resolve a potential issue with the Block Editor, we need to override REST URLs with the actual permalink. if ( defined( 'REST_REQUEST' ) && strpos( $pagination_markup, 'sowb/v1/widgets/previews' ) !== false ) { $pagination_markup = str_replace( // All non-standard pagination won't have the full URL present so what we replace changes. strpos( $pagination_markup, rest_url() ) !== false ? esc_url_raw( rest_url() ) . 'sowb/v1/widgets/previews/' : '/wp-json/sowb/v1/widgets/previews', get_the_permalink(), $pagination_markup ); } ?> <nav class="sow-post-navigation"> <h3 class="screen-reader-text"><?php esc_html_e( 'Pagination', 'so-widgets-bundle' ); ?></h3> <div class="sow-nav-links<?php if ( ! empty( $settings['pagination'] ) ) { echo ' sow-post-pagination-' . esc_attr( $settings['pagination'] ); } ?>"> <?php echo $pagination_markup; ?> </div> </nav> <?php } } public function total_pages( $posts ) { // WP Query's max_num_pages doesn't account for offset, so let's do that now. if ( ! empty( $posts->query['offset'] ) && is_numeric( $posts->query['offset'] ) ) { return ceil( max( $posts->found_posts - $posts->query['offset'], 1 ) / $posts->query['posts_per_page'] ); } else { return $posts->max_num_pages; } } public function get_form_teaser() { if ( class_exists( 'SiteOrigin_Premium' ) ) { return false; } return array( sprintf( __( 'Get more pagination themes and Ajax reloading with %sSiteOrigin Premium%s', 'so-widgets-bundle' ), '<a href="https://siteorigin.com/downloads/premium/?featured_addon=plugin/blog" target="_blank" rel="noopener noreferrer">', '</a>' ), sprintf( __( 'Adjust the post Read More link text and choose a custom post date format with %sSiteOrigin Premium%s', 'so-widgets-bundle' ), '<a href="https://siteorigin.com/downloads/premium/?featured_addon=plugin/blog" target="_blank" rel="noopener noreferrer">', '</a>' ), ); } } siteorigin_widget_register( 'sow-blog', __FILE__, 'SiteOrigin_Widget_Blog_Widget' );
