feat(block): add block version of the republish button

.distignore

@@ -35,3 +35,7 @@ contributing.md
 docs
 release.sh
 release
+src/**/*.js
+src/**/*.jsx
+src/**/*.scss
+webpack.config.js

.gitignore

@@ -8,3 +8,4 @@ node_modules/
 release/
 vendor
 .phpunit.result.cache
+dist/

assets/widget.js

@@ -96,6 +96,14 @@ function show_modal( $modal, $close ) {
 
 	initTabSwitching();
 
+	// Bind copy button via data attribute (replaces inline onclick).
+	var $copyBtn = $modal.find( '[data-copy-active]' );
+	$copyBtn.off( 'click.republish' ).on( 'click.republish', function() {
+		if ( window.ClipboardUtils ) {
+			ClipboardUtils.copyFromElement( getActiveTextarea(), this );
+		}
+	} );
+
 	trapFocus( $modal );
 	$close.focus();
 }

includes/class-republish-button-block.php

@@ -0,0 +1,193 @@
+<?php
+/**
+ * Republish Button Block.
+ *
+ * @package Republication_Tracker_Tool
+ */
+
+// Exit if accessed directly.
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Republish Button Block class.
+ */
+final class Republication_Tracker_Tool_Republish_Button_Block {
+
+	/**
+	 * Initialize the block.
+	 */
+	public static function init() {
+		add_action( 'init', [ __CLASS__, 'register_block' ] );
+	}
+
+	/**
+	 * Register the block.
+	 *
+	 * On block themes the block is fully available. On classic themes it is
+	 * still registered (so existing content does not become an "unknown block")
+	 * but hidden from the inserter.
+	 */
+	public static function register_block() {
+		$args = [
+			'render_callback' => [ __CLASS__, 'render_block' ],
+		];
+
+		if ( function_exists( 'wp_is_block_theme' ) && ! wp_is_block_theme() ) {
+			$args['supports'] = [
+				'inserter' => false,
+			];
+		}
+
+		register_block_type_from_metadata(
+			REPUBLICATION_TRACKER_TOOL_PATH . 'src/blocks/republish-button',
+			$args
+		);
+	}
+
+	/**
+	 * Render the block on the frontend.
+	 *
+	 * @param array $attrs Block attributes.
+	 * @return string Rendered block HTML.
+	 */
+	public static function render_block( $attrs ) {
+		global $post;
+
+		// Guard: only render on singular views.
+		if ( ! is_singular() || ! $post instanceof \WP_Post ) {
+			return '';
+		}
+
+		// Guard: check allowed post types.
+		$allowed_post_types = (array) apply_filters( 'republication_tracker_tool_post_types', [ 'post' ] );
+		if ( ! in_array( get_post_type( $post ), $allowed_post_types, true ) ) {
+			return '';
+		}
+
+		// Guard: check if widget is hidden for this post (same filter as the widget).
+		$hide = apply_filters(
+			'hide_republication_widget',
+			get_post_meta( $post->ID, 'republication-tracker-tool-hide-widget', true ),
+			$post
+		);
+		if ( true == $hide ) { // phpcs:ignore Universal.Operators.StrictComparisons.LooseEqual
+			return '';
+		}
+
+		// Translated defaults (block.json defaults are not translatable).
+		$default_attrs = [
+			'buttonText'  => __( 'Republish This Story', 'republication-tracker-tool' ),
+			'message'     => __( 'Republish our articles for free, online or in print, under a Creative Commons license.', 'republication-tracker-tool' ),
+			'displayMode' => 'modal',
+		];
+		$attrs = wp_parse_args( $attrs, $default_attrs );
+
+		// Validate displayMode against allowed values.
+		if ( ! in_array( $attrs['displayMode'], [ 'modal', 'page' ], true ) ) {
+			$attrs['displayMode'] = 'modal';
+		}
+
+		// Fall back to translated default when attribute is empty string.
+		$button_text  = '' === trim( (string) $attrs['buttonText'] ) ? $default_attrs['buttonText'] : $attrs['buttonText'];
+		$message_text = '' === trim( (string) $attrs['message'] ) ? $default_attrs['message'] : $attrs['message'];
+		$display_mode = $attrs['displayMode'];
+
+		// License badge.
+		$license_key   = get_option( 'republication_tracker_tool_license', REPUBLICATION_TRACKER_TOOL_DEFAULT_LICENSE );
+		$using_license = isset( REPUBLICATION_TRACKER_TOOL_LICENSES[ $license_key ] );
+
+		// Block wrapper attributes go on the outer div (anchor, alignment, layout, block supports).
+		$wrapper_attributes = get_block_wrapper_attributes();
+
+		// Start building output.
+		$html = '<div ' . $wrapper_attributes . '>';
+
+		// Message.
+		$html .= '<p class="wp-block-republication-tracker-tool-republish-button__message">' . wp_kses_post( $message_text ) . '</p>';
+
+		// Button or link (inherits colors from wrapper via CSS).
+		$button_class = 'wp-block-republication-tracker-tool-republish-button__button';
+		if ( 'page' === $display_mode ) {
+			$endpoint      = apply_filters( 'republication_tracker_tool_endpoint', 'republish' );
+			$republish_url = home_url( '/' . $endpoint . wp_make_link_relative( get_permalink( $post->ID ) ) );
+			$html         .= '<a class="' . esc_attr( $button_class ) . '" href="' . esc_url( $republish_url ) . '">' . esc_html( $button_text ) . '</a>';
+		} else {
+			$html .= '<button class="' . esc_attr( $button_class ) . '" data-modal-trigger="republish">' . esc_html( $button_text ) . '</button>';
+		}
+
+		// License badge.
+		if ( $using_license ) {
+			$html .= sprintf(
+				'<p><a class="license" rel="noreferrer license" target="_blank" href="%s"><img alt="%s" style="border-width:0" src="%s" /></a></p>',
+				esc_url( REPUBLICATION_TRACKER_TOOL_LICENSES[ $license_key ]['url'] ),
+				esc_html__( 'Creative Commons License', 'republication-tracker-tool' ),
+				esc_url( plugin_dir_url( __DIR__ ) . 'assets/img/' . $license_key . '.png' )
+			);
+		}
+
+		$html .= '</div>';
+
+		// Modal (only for modal mode, only once per page).
+		if ( 'modal' === $display_mode ) {
+			self::enqueue_modal_assets();
+
+			if ( ! Republication_Tracker_Tool::$modal_rendered ) {
+				Republication_Tracker_Tool::$modal_rendered = true;
+
+				$is_amp             = false; // Block themes do not support AMP.
+				$modal_content_path = REPUBLICATION_TRACKER_TOOL_PATH . 'includes/shareable-content.php';
+
+				ob_start();
+				?>
+				<div id="republication-tracker-tool-modal" style="display:none;" data-postid="<?php echo esc_attr( $post->ID ); ?>" data-pluginsdir="<?php echo esc_attr( plugins_url() ); ?>" role="dialog" aria-modal="true" aria-labelledby="republish-modal-label">
+					<?php include $modal_content_path; ?>
+				</div>
+				<?php
+				$html .= ob_get_clean();
+			}
+		}
+
+		return $html;
+	}
+
+	/**
+	 * Enqueue modal-specific assets.
+	 */
+	private static function enqueue_modal_assets() {
+		// Modal styles (same handle as widget for deduplication).
+		wp_enqueue_style(
+			'republication-tracker-tool-css',
+			REPUBLICATION_TRACKER_TOOL_URL . 'assets/widget.css',
+			[],
+			REPUBLICATION_TRACKER_TOOL_VERSION
+		);
+
+		// Clipboard utilities (shared with widget).
+		wp_enqueue_script(
+			'republication-tracker-tool-clipboard-utils',
+			REPUBLICATION_TRACKER_TOOL_URL . 'assets/clipboard-utils.js',
+			[],
+			REPUBLICATION_TRACKER_TOOL_VERSION,
+			true
+		);
+
+		// Block frontend script.
+		$asset_file = REPUBLICATION_TRACKER_TOOL_PATH . 'dist/republish-button-view.asset.php';
+		$asset      = file_exists( $asset_file )
+			? include $asset_file
+			: [
+				'dependencies' => [],
+				'version'      => REPUBLICATION_TRACKER_TOOL_VERSION,
+			];
+
+		wp_enqueue_script(
+			'republication-tracker-tool-republish-button-view',
+			REPUBLICATION_TRACKER_TOOL_URL . 'dist/republish-button-view.js',
+			array_merge( $asset['dependencies'], [ 'republication-tracker-tool-clipboard-utils' ] ),
+			$asset['version'],
+			true
+		);
+	}
+}
+
+Republication_Tracker_Tool_Republish_Button_Block::init();

includes/class-widget.php

@@ -13,13 +13,6 @@
  */
 class Republication_Tracker_Tool_Widget extends WP_Widget {
 
-	/**
-	 * Whether the widget has been instantiated.
-	 *
-	 * @var bool
-	 */
-	public $has_instance = false;
-
 	/**
 	 * Sets up the widgets name etc.
 	 */
@@ -108,25 +101,27 @@ public function widget( $args, $instance ) {
 
 		echo wp_kses_post( $args['after_widget'] );
 
-		// if has_instance is false, we can continue with displaying the modal.
-		if ( isset( $this->has_instance ) && false === $this->has_instance ) {
+		// If the modal has not been rendered yet, include it.
+		if ( ! Republication_Tracker_Tool::$modal_rendered ) {
 
-			// update has_instance so the next time the widget is created on the same page, it does not create a second modal.
-			$this->has_instance = true;
+			// Mark the modal as rendered.
+			Republication_Tracker_Tool::$modal_rendered = true;
 
 			// define our path to grab file content from.
 			$modal_content_path = plugin_dir_path( __FILE__ ) . 'shareable-content.php';
 
+			$is_amp = self::is_amp();
+
 			if ( $is_amp ) {
 				?>
 					<amp-lightbox id="republication-tracker-tool-modal" layout="nodisplay" role="dialog" aria-modal="true" aria-labelledby="republish-modal-label">
-						<?php echo esc_html( include_once $modal_content_path ); ?>
+						<?php include $modal_content_path; ?>
 					</amp-lightbox>
 				<?php
 			} else {
 				?>
 					<div id="republication-tracker-tool-modal" style="display:none;" data-postid="<?php echo esc_attr( $post->ID ); ?>" data-pluginsdir="<?php echo esc_attr( plugins_url() ); ?>" role="dialog" aria-modal="true" aria-labelledby="republish-modal-label">
-						<?php echo esc_html( include_once $modal_content_path ); ?>
+						<?php include $modal_content_path; ?>
 					</div>
 				<?php
 			}

includes/shareable-content.php

@@ -192,7 +192,7 @@ class="plain-text-field__input"
 			<?php
 			if ( ! $is_amp ) {
 				?>
-			<button onclick="ClipboardUtils.copyFromElement( getActiveTextarea(), this )" class="republication-tracker-tool__copy-button republication-tracker-tool__copy-button--main show-for-html"><?php echo esc_html__( 'Copy to Clipboard', 'republication-tracker-tool' ); ?></button>
+			<button data-copy-active class="republication-tracker-tool__copy-button republication-tracker-tool__copy-button--main show-for-html"><?php echo esc_html__( 'Copy to Clipboard', 'republication-tracker-tool' ); ?></button>
 				<?php
 			}