=== Blocksolid Gather === Contributors: peripatus Tags: slideshow, posts grid, related posts, relatedposts, related, gutenberg, block editor, blocks, gather, blocksolid, custom post type, reusable, vimeo, rumble, dailymotion Stable tag: 3.0.2 Tested up to: 7.0 Donate link: https://www.peripatus.uk/payments/ License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Related Posts grid or slideshow functionality for custom post types, shortcode and Gutenberg block. == Description == Blockolid Gather is a content aggregator which allows you to use a shortcode or gutenberg block to display related posts, pages, posts or custom post types in a slideshow or grid. In the Classic Editor Gather can be conjured using a simple shortcode such as: [blocksolid_gather specificposttitle="My Post"] If you use the Block Editor / Gutenberg our included Gather block allows you to choose your related posts via specified parameters and provides a live-preview of them within your page. If you are using our separate Blocksolid plugin as a page builder and Gutenberg overlay the Blocksolid Gather plugin also integrates well with this. = Blocksolid Gather Features = * Display any content as a slideshow or posts block grid * Choose max posts * Choose first post to return * Choose number per row * Choose post type * Choose specific post title * Order by date created, last modified, alphabetical title, random, author, relevance, menu order * Order ascending or decending * Hide margins between columns and rows * Pad out incomplete final rows * Filter by categories * Filter by tags * Related posts * Choose the excerpt length * Choose the excerpt sign-off * Choose the excerpt sign-off * Position media top, right, left, right or no media * Choose media size from registered sizes including registered custom sizes * Select a default placeholder image if a post does not have media or none at all * Show only the media in a media grid * Show image caption * Link media to post * Link caption to post * Add media zoom hover effect * Display videos including YouTube, Vimeo, Rumble and Dailymotion using their embed links * Display Podcasts e.g. Buzzsprout * Optionally show date last modified, author, categories, tags under post == Installation == * Install the plugin using the WordPress 'Add New plugin' functionality and activate. * Once activated a new Gather block will be added to those available within the WordPress block editor - make sure that you are not hiding any!. * You can then call gather via a short code like [blocksolid_gather specificposttitle="My Post"] * Parameters include: - max_posts (number) - first_post (number) - number_per_row (number) - order_by ('post_date', 'modified' 'title', 'rand', 'author', 'relevance', 'menu_order') - ascending (true, false) - get_related (true, false) - specificposttitle (string) - partial_match_title_start (true, false) - categories (numbers) - tags (numbers) - primary_category_id (number) - post_type ('post', 'page', 'custom-you-have-set') - site (number - for multisite) - media_position ('top, 'right', 'bottom', 'left', 'none') - media_size ('thumbnail, 'medium', 'large', 'full', 'widescreen_thumbnail', 'widescreen_medium', 'widescreen_large', 'custom-you-have-set') - excerpt_length (number) - excerpt_signoff (string like 'read more...') - placeholder_image_src (src of image you want to use as a default placeholder) - placeholder_image_id (id of image you want to use as a default placeholder) - show_media_only (true, false) - show_media_caption (true, false) - show_media_link (true, false) - media_hover (true, false) - show_figcaption_link (true, false) - hide_margins (true, false) - final_row_pad_empty (true, false) - show_date_created (true, false) - show_author (true, false) - show_categories (true, false) - show_tags (true, false) - display_slideshow (true, false) - autoplay_video (true, false) - dashicon_arrows (true, false) - use_thickbox (true, false) * if you use the built-in Gutenberg block editor for your website you can use the plugin's bespoke 'Gather' block to place the aggregator within your content as many times as you like in whatever arrangement. * The Gather block gives you a live preview within the Gutenberg editor. == Screenshots == 1. /assets/screenshots/screenshot-1.png Block editor showing 3 column grid of mixed posts including Podcasts, YouTube, Vimeo, Rumble and Dailymotion 2. /assets/screenshots/screenshot-2.png Showing Post settings 3. /assets/screenshots/screenshot-3.png Showing layout settings 4. /assets/screenshots/screenshot-4.png Showing media settings 5. /assets/screenshots/screenshot-5.png Set to show media only 6. /assets/screenshots/screenshot-6.png Showing excerpt settings 7. /assets/screenshots/screenshot-7.png As shown on a page 8. /assets/screenshots/screenshot-8.png As shown on a page with media only == Changelog == = 3.0.2 = *Minimum PHP and WP versions raised to 7 and WP7 respectively. - 27 May 2026* = 3.0.1 = *Environment updated. Updated to API version 3. Minimum PHP and WP versions raised to reduce testing load in readiness for WP7. - 05 December 2025* = 2.1.4 = *Environment updated. Work started to go to API 3 - 28 November 2025* = 2.1.3 = *Pages now respect related content and show siblings or children as appropriate. Issue with partial filter bleeding out sorted - 17 June 2025* = 2.1.2 = *Extended partial title omission to figcaptions - 27 May 2025* = 2.1.1 = *If block slider given class .auto automatically progresses every 10 seconds and if given class of interval-nnnnnn then nnnnnn overrides the number in milliseconds - 20 May 2025* = 2.1.0 = *Fixed minor bug - 19 May 2025* = 2.0.9 = *In a slideshow buttons showing titles can have the partial title omitted. Better handing of thickbox triggers including omission from mobile - 30 April 2025* = 2.0.8 = *In a slideshow buttons showing titles and numbers now have an active state - 18 February 2025* = 2.0.7 = *Events ordering restored - 07 February 2025* = 2.0.6 = *Partial title matches now can be ordered by parameters other than just title - 03 February 2025* = 2.0.5 = *Events now can be ordered properly by start date - 28 January 2025* = 2.0.4 = *Additional support for The Events Calendar - 16 December 2024* = 2.0.3 = *Shortcodes stripped from truncated excerpts - 13 December 2024* = 2.0.2 = *Button per slide variations - 22 November 2024* = 2.0.1 = *Slideshows, tidy up of controls - 21 November 2024* = 1.2.0 = *Partial match of start of title - 12 November 2024* = 1.1.9 = *Set the __nextHasNoMarginBottom prop to true for back-end controls - 14 October 2024* = 1.1.8 = *React code updated, bumped up to WordPress 6.5 - 18 March 2024* = 1.1.7 = *Removed deprecated third parameter from shortcode - 24 October 2023* = 1.1.6 = *Full excerpts now apply_filters - 16 October 2023* = 1.1.5 = *Added better support for custom post type taxonomies - 16 May 2023* = 1.1.4 = *Replaced deprecated function get_page_by_title() - 10 March 2023* = 1.1.3 = *Fixed bug with tags not showing if only one tag - 15 February 2023* = 1.1.2 = *Default image caption from post title - 10 November 2022* = 1.1.1 = *Removed limit on tags and categories - 04 April 2022* = 1.1.0 = *Added a div to layout - 08 March 2022* = 1.0.9 = *Added way to move meta above title - 28 February 2022* = 1.0.8 = *Layout tweaks - 24 February 2022* = 1.0.7 = *Fixed bug with author link - 10 February 2022* = 1.0.6 = *Added way to move title and meta and also to add excerpt as summary at top - 09 February 2022* = 1.0.5 = *Tweaked to respect specified excerpts - 03 February 2022* = 1.0.4 = *Added a class to indicate the chosen number per row - 02 February 2022* = 1.0.3 = *Optionally show date last modified, author, categories, tags under post - 28 January 2022* = 1.0.2 = *Added ability to choose to exclude specific categories - 18 January 2022* = 1.0.1 = *Release Date - 07 January 2022* First release == Upgrade Notice == = 1.0.1 = This is the first public release to be published