[Release]: Publish new version 2.0.1 by merging develop into main

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [2.0.1](https://github.com/rtCamp/rt-carousel/compare/v2.0.0...v2.0.1) (2026-05-04)
+
+
+### Features
+
+* add a11y announcements for carousel slide changes ([#125](https://github.com/rtCamp/rt-carousel/issues/125)) ([b7a2240](https://github.com/rtCamp/rt-carousel/commit/b7a2240))
+
+
+### Bug Fixes
+
+* carousel dot focus loss with VoiceOver activation ([#127](https://github.com/rtCamp/rt-carousel/issues/127)) ([366031e](https://github.com/rtCamp/rt-carousel/commit/366031e))
+
+
+### Refactors
+
+* replace automatic plugin deactivation with admin notice ([#129](https://github.com/rtCamp/rt-carousel/issues/129)) ([279a464](https://github.com/rtCamp/rt-carousel/commit/279a464))
+
+
 ## [2.0.0](https://github.com/rtCamp/rt-carousel/compare/v1.0.4...v2.0.0) (2026-04-13)
 
 

docs/CONTRIBUTING.md

@@ -30,6 +30,18 @@ Thank you for your interest in contributing! We welcome all contributions, from
 - **JavaScript/TypeScript**: We use the standard WordPress ESLint config. Run `npm run lint:js` to check.
 - **CSS/SCSS**: We use Stylelint. Run `npm run lint:css` to check.
 
+## Block `save()` Changes
+
+If your changes modify a block's `save()` output — including `data-wp-context`, HTML structure, class names, or new elements — you **must** add a deprecation entry in the block's `deprecated.tsx`.
+
+1. Copy the previous `save()` function into the `deprecated` array.
+2. Include the `attributes` and `supports` from the old version (copy the full `supports` from `block.json` — don't simplify it, or alignment/color classes will fail validation).
+3. For blocks with inner blocks, use `useInnerBlocksProps.save()` in the deprecated `save()` function, just like the current save does.
+
+Without this, existing content will show "Block contains unexpected or invalid content" errors in the editor.
+
+See the [Block Deprecation API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-deprecation/) for details.
+
 ## Building the Plugin
 
 To create a production-ready ZIP file:

examples/patterns/hero-carousel.php

@@ -11,18 +11,18 @@
 	exit;
 }
 
-$pattern_images_url = trailingslashit( RT_CAROUSEL_URL . '/examples/data/images' );
-$hero_slide_one     = $pattern_images_url . 'slide-autoplay-1.webp';
-$hero_slide_two     = $pattern_images_url . 'slide-autoplay-2.webp';
-$hero_slide_three   = $pattern_images_url . 'slide-autoplay-3.webp';
+$rt_carousel_images_url  = trailingslashit( RT_CAROUSEL_URL . '/examples/data/images' );
+$rt_carousel_slide_one   = $rt_carousel_images_url . 'slide-autoplay-1.webp';
+$rt_carousel_slide_two   = $rt_carousel_images_url . 'slide-autoplay-2.webp';
+$rt_carousel_slide_three = $rt_carousel_images_url . 'slide-autoplay-3.webp';
 ?>
 
 <!-- wp:rt-carousel/carousel {"loop":true,"autoplay":true,"autoplayDelay":5000,"ariaLabel":"Hero Carousel","metadata":{"categories":["rt-carousel"],"patternName":"rt-carousel/hero-carousel","name":"rtCarousel: Hero Carousel"},"align":"wide","className":"wp-block-carousel-carousel"} -->
 <div class="wp-block-rt-carousel-carousel alignwide rt-carousel wp-block-carousel-carousel" role="region" aria-roledescription="carousel" aria-label="Hero Carousel" dir="ltr" data-axis="x" data-loop="true" data-wp-interactive="rt-carousel/carousel" data-wp-context="{&quot;options&quot;:{&quot;loop&quot;:true,&quot;dragFree&quot;:false,&quot;align&quot;:&quot;start&quot;,&quot;containScroll&quot;:&quot;trimSnaps&quot;,&quot;direction&quot;:&quot;ltr&quot;,&quot;axis&quot;:&quot;x&quot;,&quot;slidesToScroll&quot;:1},&quot;autoplay&quot;:{&quot;delay&quot;:5000,&quot;stopOnInteraction&quot;:true,&quot;stopOnMouseEnter&quot;:false},&quot;isPlaying&quot;:true,&quot;timerIterationId&quot;:0,&quot;selectedIndex&quot;:-1,&quot;scrollSnaps&quot;:[],&quot;canScrollPrev&quot;:false,&quot;canScrollNext&quot;:false,&quot;scrollProgress&quot;:0,&quot;slideCount&quot;:0,&quot;ariaLabelPattern&quot;:&quot;Go to slide %d&quot;}" data-wp-init="callbacks.initCarousel" style="--rt-carousel-gap:0px"><!-- wp:rt-carousel/carousel-viewport {"className":"wp-block-carousel-carousel-viewport"} -->
 	<div class="wp-block-rt-carousel-carousel-viewport embla wp-block-carousel-carousel-viewport">
 		<div class="embla__container"><!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
-			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:cover {"url":"<?php echo esc_url( $hero_slide_one ); ?>","dimRatio":30,"minHeight":600,"minHeightUnit":"px"} -->
-				<div class="wp-block-cover" style="min-height:600px"><img class="wp-block-cover__image-background" alt="" src="<?php echo esc_url( $hero_slide_one ); ?>" data-object-fit="cover" /><span aria-hidden="true" class="wp-block-cover__background has-background-dim-30 has-background-dim"></span>
+			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:cover {"url":"<?php echo esc_url( $rt_carousel_slide_one ); ?>","dimRatio":30,"minHeight":600,"minHeightUnit":"px"} -->
+				<div class="wp-block-cover" style="min-height:600px"><img class="wp-block-cover__image-background" alt="" src="<?php echo esc_url( $rt_carousel_slide_one ); ?>" data-object-fit="cover" /><span aria-hidden="true" class="wp-block-cover__background has-background-dim-30 has-background-dim"></span>
 					<div class="wp-block-cover__inner-container"><!-- wp:heading {"textAlign":"center","level":1,"textColor":"white"} -->
 						<h1 class="wp-block-heading has-text-align-center has-white-color has-text-color">Welcome to Our Site</h1>
 						<!-- /wp:heading -->
@@ -44,8 +44,8 @@
 			<!-- /wp:rt-carousel/carousel-slide -->
 
 			<!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
-			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:cover {"url":"<?php echo esc_url( $hero_slide_two ); ?>","dimRatio":30,"minHeight":600,"minHeightUnit":"px"} -->
-				<div class="wp-block-cover" style="min-height:600px"><img class="wp-block-cover__image-background" alt="" src="<?php echo esc_url( $hero_slide_two ); ?>" data-object-fit="cover" /><span aria-hidden="true" class="wp-block-cover__background has-background-dim-30 has-background-dim"></span>
+			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:cover {"url":"<?php echo esc_url( $rt_carousel_slide_two ); ?>","dimRatio":30,"minHeight":600,"minHeightUnit":"px"} -->
+				<div class="wp-block-cover" style="min-height:600px"><img class="wp-block-cover__image-background" alt="" src="<?php echo esc_url( $rt_carousel_slide_two ); ?>" data-object-fit="cover" /><span aria-hidden="true" class="wp-block-cover__background has-background-dim-30 has-background-dim"></span>
 					<div class="wp-block-cover__inner-container"><!-- wp:heading {"textAlign":"center","level":1,"textColor":"white"} -->
 						<h1 class="wp-block-heading has-text-align-center has-white-color has-text-color">Build Something Amazing</h1>
 						<!-- /wp:heading -->
@@ -60,8 +60,8 @@
 			<!-- /wp:rt-carousel/carousel-slide -->
 
 			<!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
-			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:cover {"url":"<?php echo esc_url( $hero_slide_three ); ?>","dimRatio":30,"minHeight":600,"minHeightUnit":"px"} -->
-				<div class="wp-block-cover" style="min-height:600px"><img class="wp-block-cover__image-background" alt="" src="<?php echo esc_url( $hero_slide_three ); ?>" data-object-fit="cover" /><span aria-hidden="true" class="wp-block-cover__background has-background-dim-30 has-background-dim"></span>
+			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:cover {"url":"<?php echo esc_url( $rt_carousel_slide_three ); ?>","dimRatio":30,"minHeight":600,"minHeightUnit":"px"} -->
+				<div class="wp-block-cover" style="min-height:600px"><img class="wp-block-cover__image-background" alt="" src="<?php echo esc_url( $rt_carousel_slide_three ); ?>" data-object-fit="cover" /><span aria-hidden="true" class="wp-block-cover__background has-background-dim-30 has-background-dim"></span>
 					<div class="wp-block-cover__inner-container"><!-- wp:heading {"textAlign":"center","level":1,"textColor":"white"} -->
 						<h1 class="wp-block-heading has-text-align-center has-white-color has-text-color">Join Our Community</h1>
 						<!-- /wp:heading -->

examples/patterns/logo-showcase.php

@@ -11,12 +11,12 @@
 	exit;
 }
 
-$pattern_images_url = trailingslashit( RT_CAROUSEL_URL . '/examples/data/images' );
-$logo_one           = $pattern_images_url . 'logo-placeholder-1.svg';
-$logo_two           = $pattern_images_url . 'logo-placeholder-2.svg';
-$logo_three         = $pattern_images_url . 'logo-placeholder-3.svg';
-$logo_four          = $pattern_images_url . 'logo-placeholder-4.svg';
-$logo_five          = $pattern_images_url . 'logo-placeholder-5.svg';
+$rt_carousel_images_url = trailingslashit( RT_CAROUSEL_URL . '/examples/data/images' );
+$rt_carousel_logo_one   = $rt_carousel_images_url . 'logo-placeholder-1.svg';
+$rt_carousel_logo_two   = $rt_carousel_images_url . 'logo-placeholder-2.svg';
+$rt_carousel_logo_three = $rt_carousel_images_url . 'logo-placeholder-3.svg';
+$rt_carousel_logo_four  = $rt_carousel_images_url . 'logo-placeholder-4.svg';
+$rt_carousel_logo_five  = $rt_carousel_images_url . 'logo-placeholder-5.svg';
 ?>
 
 <!-- wp:rt-carousel/carousel {"loop":true,"autoplayDelay":3000,"autoplayStopOnInteraction":false,"ariaLabel":"Partner Logos","metadata":{"categories":["rt-carousel"],"patternName":"rt-carousel/logo-showcase","name":"rtCarousel: Logo Showcase"},"className":"wp-block-carousel-carousel is-style-columns-3"} -->
@@ -28,35 +28,35 @@
 	<div class="wp-block-rt-carousel-carousel-viewport embla wp-block-carousel-carousel-viewport">
 		<div class="embla__container"><!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
 			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:image {"width":"200px","sizeSlug":"full","linkDestination":"none","align":"center","className":"is-style-rounded"} -->
-				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $logo_one ); ?>" alt="Partner Logo 1" style="width:200px" /></figure>
+				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $rt_carousel_logo_one ); ?>" alt="Partner Logo 1" style="width:200px" /></figure>
 				<!-- /wp:image -->
 			</div>
 			<!-- /wp:rt-carousel/carousel-slide -->
 
 			<!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
 			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:image {"width":"200px","sizeSlug":"full","linkDestination":"none","align":"center","className":"is-style-rounded"} -->
-				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $logo_two ); ?>" alt="Partner Logo 2" style="width:200px" /></figure>
+				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $rt_carousel_logo_two ); ?>" alt="Partner Logo 2" style="width:200px" /></figure>
 				<!-- /wp:image -->
 			</div>
 			<!-- /wp:rt-carousel/carousel-slide -->
 
 			<!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
 			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:image {"width":"200px","sizeSlug":"full","linkDestination":"none","align":"center","className":"is-style-rounded"} -->
-				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $logo_three ); ?>" alt="Partner Logo 3" style="width:200px" /></figure>
+				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $rt_carousel_logo_three ); ?>" alt="Partner Logo 3" style="width:200px" /></figure>
 				<!-- /wp:image -->
 			</div>
 			<!-- /wp:rt-carousel/carousel-slide -->
 
 			<!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
 			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:image {"width":"200px","sizeSlug":"full","linkDestination":"none","align":"center","className":"is-style-rounded"} -->
-				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $logo_four ); ?>" alt="Partner Logo 4" style="width:200px" /></figure>
+				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $rt_carousel_logo_four ); ?>" alt="Partner Logo 4" style="width:200px" /></figure>
 				<!-- /wp:image -->
 			</div>
 			<!-- /wp:rt-carousel/carousel-slide -->
 
 			<!-- wp:rt-carousel/carousel-slide {"className":"wp-block-carousel-carousel-slide"} -->
 			<div class="wp-block-rt-carousel-carousel-slide embla__slide wp-block-carousel-carousel-slide" role="group" aria-roledescription="slide" data-wp-interactive="rt-carousel/carousel" data-wp-class--is-active="callbacks.isSlideActive" data-wp-bind--aria-current="callbacks.isSlideActive"><!-- wp:image {"width":"200px","sizeSlug":"full","linkDestination":"none","align":"center","className":"is-style-rounded"} -->
-				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $logo_five ); ?>" alt="Partner Logo 5" style="width:200px" /></figure>
+				<figure class="wp-block-image aligncenter size-full is-resized is-style-rounded"><img src="<?php echo esc_url( $rt_carousel_logo_five ); ?>" alt="Partner Logo 5" style="width:200px" /></figure>
 				<!-- /wp:image -->
 			</div>
 			<!-- /wp:rt-carousel/carousel-slide -->

inc/Plugin.php

@@ -39,22 +39,23 @@ protected function setup_hooks(): void {
 		add_filter( 'block_categories_all', [ $this, 'register_block_category' ] );
 		add_action( 'init', [ $this, 'register_pattern_category' ] );
 		add_action( 'init', [ $this, 'register_block_patterns' ] );
-		add_action( 'admin_init', [ $this, 'deactivate_legacy_plugin' ] );
+		add_action( 'admin_notices', [ $this, 'legacy_plugin_notice' ] );
+		add_action( 'network_admin_notices', [ $this, 'legacy_plugin_notice' ] );
 	}
 
 	/**
-	 * Deactivate the legacy "Carousel Kit" plugin if still active.
+	 * Show an admin notice if the legacy "Carousel Kit" plugin is still active.
 	 *
 	 * Handles both single-site and network-wide activations.
 	 */
-	public function deactivate_legacy_plugin(): void {
-		$old_plugin = 'carousel-kit/carousel-kit.php';
+	public function legacy_plugin_notice(): void {
+		$old_plugin   = 'carousel-kit/carousel-kit.php';
+		$network_wide = is_multisite() && is_plugin_active_for_network( $old_plugin );
 
 		if ( ! is_plugin_active( $old_plugin ) ) {
 			return;
 		}
 
-		$network_wide = is_multisite() && is_plugin_active_for_network( $old_plugin );
 		if ( $network_wide && ! current_user_can( 'manage_network_plugins' ) ) {
 			return;
 		}
@@ -63,21 +64,41 @@ public function deactivate_legacy_plugin(): void {
 			return;
 		}
 
-		// Silent flag prevents deactivation hooks from firing redirect.
-		deactivate_plugins( $old_plugin, true, $network_wide );
-
-		if ( is_plugin_active( $old_plugin ) ) {
+		// Only show the notice in the matching admin context.
+		if ( is_network_admin() !== $network_wide ) {
 			return;
 		}
 
-		add_action(
-			'admin_notices',
-			static function (): void {
-				printf(
-					'<div class="notice notice-info is-dismissible"><p>%s</p></div>',
-					esc_html__( 'The old "Carousel Kit" plugin has been deactivated. rtCarousel is its replacement.', 'rt-carousel' )
-				);
-			}
+		if ( $network_wide ) {
+			$deactivate_url = wp_nonce_url(
+				add_query_arg(
+					[
+						'action'      => 'deactivate',
+						'plugin'      => $old_plugin,
+						'networkwide' => '1',
+					],
+					network_admin_url( 'plugins.php' )
+				),
+				'deactivate-plugin_' . $old_plugin
+			);
+		} else {
+			$deactivate_url = wp_nonce_url(
+				add_query_arg(
+					[
+						'action' => 'deactivate',
+						'plugin' => $old_plugin,
+					],
+					admin_url( 'plugins.php' )
+				),
+				'deactivate-plugin_' . $old_plugin
+			);
+		}
+
+		printf(
+			'<div class="notice notice-warning is-dismissible"><p>%s <a href="%s">%s</a></p></div>',
+			esc_html__( 'The "Carousel Kit" plugin is still active. rtCarousel is its replacement — please deactivate Carousel Kit.', 'rt-carousel' ),
+			esc_url( $deactivate_url ),
+			esc_html__( 'Deactivate Carousel Kit', 'rt-carousel' )
 		);
 	}
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "rt-carousel",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Carousel block using Embla and WordPress Interactivity API",
   "author": "rtCamp",
   "private": true,