Merge pull request #446 from beyondwords-io/s-6203-fetch-button-for-inspect-panel

Fetch button for Block Editor inspect panel

Author: galbus

.wp-env.json

@@ -1,5 +1,5 @@
 {
-    "core": "WordPress/WordPress#6.8",
+    "core": null,
     "phpVersion": "8.4",
     "plugins": [
         "./",

composer.json

@@ -18,7 +18,7 @@
         "ergebnis/composer-normalize": "2.28.3",
         "php-parallel-lint/php-parallel-lint": "^1.3.2",
         "phpmd/phpmd": "^2.13",
-        "phpro/grumphp": "^1.13",
+        "phpro/grumphp": "^1.16",
         "phpunit/phpunit": "^9.6",
         "rregeer/phpunit-coverage-check": "^0.3.1",
         "squizlabs/php_codesniffer": "^3.7.2",

composer.lock

@@ -1,6 +1,6 @@
 {
   "name": "beyondwords-wordpress-plugin",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "private": true,
   "description": "BeyondWords WordPress Plugin",
   "repository": {

package.json

@@ -3,7 +3,7 @@
 Contributors: beyondwords, stuartmcalpine
 Donate link: https://beyondwords.io
 Tags: text-to-speech, tts, audio, AI, voice cloning
-Stable tag: 5.4.0
+Stable tag: 5.5.0
 Requires PHP: 8.0
 Tested up to: 6.8
 License: GPLv2 or later
@@ -80,6 +80,21 @@ Any questions? [Visit our website](https://beyondwords.io/?utm_source=wordpress&
 
 == Changelog ==
 
+= 5.5.0 =
+
+Release date: 2nd July 2025
+
+**Enhancements and Features:**
+
+* [#446](https://github.com/beyondwords-io/wordpress-plugin/pull/446) Fetch button for Block Editor Inspect panel.
+    * We've added a Fetch option to the Inspect panel in the BeyondWords Block Editor sidebar.
+    * This allows users to retrieve audio that has already been generated in BeyondWords, helping to quickly restore a missing or broken link between the audio and WordPress post, without needing to regenerate the audio.
+* Always show the **Generate audio** checkbox in the Block Editor.
+    * As part of the Fetch button update the **Generate audio** checkbox is now always shown in the Block Editor.
+    * If **Generate audio** is unchecked before a post is saved then audio **will not** be regenerated from the updated post content.
+* [#444](https://github.com/beyondwords-io/wordpress-plugin/pull/444) PHP 8.4 support.
+    * Run unit and e2e tests against PHP 8.0 and PHP 8.4 in GitHub Actions.
+
 = 5.4.0 =
 
 Release date: 22nd April 2025

readme.txt

@@ -15,7 +15,7 @@
  * Description:       The effortless way to make content listenable. Automatically create audio versions and embed via our customizable player.
  * Author:            BeyondWords
  * Author URI:        https://beyondwords.io
- * Version:           5.4.0
+ * Version:           5.5.0
  * License:           GPL-2.0+
  * License URI:       http://www.gnu.org/licenses/gpl-2.0.txt
  * Text Domain:       speechkit
@@ -35,7 +35,7 @@
 
 // Define constants
 // phpcs:disable
-define('BEYONDWORDS__PLUGIN_VERSION', '5.4.0');
+define('BEYONDWORDS__PLUGIN_VERSION', '5.5.0');
 define('BEYONDWORDS__PLUGIN_DIR',     plugin_dir_path(__FILE__));
 define('BEYONDWORDS__PLUGIN_URI',     plugin_dir_url(__FILE__));
 // phpcs:enable

speechkit.php

@@ -26,10 +26,10 @@ export default class DocumentSettingPanel extends Component {
 				title={ __( 'BeyondWords', 'speechkit' ) }
 				className="beyondwords-sidebar"
 			>
-				<GenerateAudio wrapper={ PanelRow } />
 				<ErrorNotice wrapper={ PanelRow } />
 				<PendingNotice wrapper={ PanelRow } />
 				<PlayAudio wrapper={ PanelRow } />
+				<GenerateAudio wrapper={ PanelRow } />
 				<PlayerStyle wrapper={ PanelRow } />
 				<PlayerContent wrapper={ PanelRow } />
 				<SelectVoice wrapper={ PanelRow } />

src/Component/Plugin/Panel/DocumentSetting/index.js

@@ -7,11 +7,6 @@ import { compose } from '@wordpress/compose';
 import { withDispatch, withSelect } from '@wordpress/data';
 import { Fragment, useEffect } from '@wordpress/element';
 
-/**
- * Internal dependencies
- */
-import GenerateAudioCheck from './check';
-
 export function GenerateAudio( {
 	generateAudio,
 	generateAudioEdited,
@@ -28,19 +23,17 @@ export function GenerateAudio( {
 	}, [ generateAudioEdited, generateAudio ] );
 
 	return (
-		<GenerateAudioCheck>
-			<Wrapper>
-				<CheckboxControl
-					className="beyondwords--generate-audio"
-					label={ __( 'Generate audio', 'speechkit' ) }
-					checked={ generateAudio }
-					onChange={ () => {
-						setGenerateAudio( ! generateAudio );
-					} }
-					__nextHasNoMarginBottom
-				/>
-			</Wrapper>
-		</GenerateAudioCheck>
+		<Wrapper>
+			<CheckboxControl
+				className="beyondwords--generate-audio"
+				label={ __( 'Generate audio', 'speechkit' ) }
+				checked={ generateAudio }
+				onChange={ () => {
+					setGenerateAudio( ! generateAudio );
+				} }
+				__nextHasNoMarginBottom
+			/>
+		</Wrapper>
 	);
 }
 

src/Component/Post/GenerateAudio/check.js

@@ -14,6 +14,7 @@
 
 use Beyondwords\Wordpress\Component\Post\PostMetaUtils;
 use Beyondwords\Wordpress\Component\Settings\SettingsUtils;
+use Beyondwords\Wordpress\Core\ApiClient;
 
 /**
  * Inspect
@@ -28,7 +29,8 @@ class Inspect
     public function init()
     {
         add_action('admin_enqueue_scripts', array($this, 'adminEnqueueScripts'));
-        add_action("add_meta_boxes", array($this, 'addMetaBox'));
+        add_action('add_meta_boxes', array($this, 'addMetaBox'));
+        add_action('rest_api_init', array($this, 'restApiInit'));
 
         add_filter('default_hidden_meta_boxes', array($this, 'hideMetaBox'));
 
@@ -311,4 +313,102 @@ public function save($postId)
 
         return $postId;
     }
+
+    /**
+     * REST API init.
+     *
+     * Register REST API routes.
+     **/
+    public function restApiInit()
+    {
+        register_rest_route('beyondwords/v1', '/projects/(?P<projectId>[0-9]+)/content/(?P<contentId>[a-zA-Z0-9\-]+)', array( // phpcs:ignore Generic.Files.LineLength.TooLong
+            'methods'  => \WP_REST_Server::READABLE,
+            'callback' => array($this, 'restApiResponse'),
+            'permission_callback' => function () {
+                return current_user_can('edit_posts');
+            },
+        ));
+    }
+
+    /**
+     * REST API response.
+     *
+     * Fetches a content object from the BeyondWords REST API.
+     *
+     * @param \WP_REST_Request $request The REST request object.
+     *
+     * @return \WP_REST_Response
+     **/
+    public function restApiResponse(\WP_REST_Request $request)
+    {
+        $projectId = $request['projectId'] ?? '';
+        $contentId = $request['contentId'] ?? '';
+
+        if (! is_numeric($projectId)) {
+            return rest_ensure_response(
+                new \WP_Error(
+                    400,
+                    __('Invalid Project ID', 'speechkit'),
+                    ['projectId' => $projectId]
+                )
+            );
+        }
+
+        if (empty($contentId)) {
+            return rest_ensure_response(
+                new \WP_Error(
+                    400,
+                    __('Invalid Content ID', 'speechkit'),
+                    ['contentId' => $contentId]
+                )
+            );
+        }
+
+        $response = ApiClient::getContent($contentId, $projectId);
+
+        // Check for REST API connection errors.
+        if (is_wp_error($response)) {
+            return rest_ensure_response(
+                new \WP_Error(
+                    500,
+                    __('Could not connect to BeyondWords API', 'speechkit'),
+                    $response->get_error_data()
+                )
+            );
+        }
+
+        $code = wp_remote_retrieve_response_code($response);
+        $body = wp_remote_retrieve_body($response);
+
+        // Check for REST API response errors.
+        if ($code < 200 || $code >= 300) {
+            return rest_ensure_response(
+                new \WP_Error(
+                    $code,
+                    /* translators: %d is replaced with the error code. */
+                    sprintf(__('BeyondWords REST API returned error code %d', 'speechkit'), $code),
+                    [
+                        'body' => $body,
+                    ]
+                )
+            );
+        }
+
+        $data = json_decode($body, true);
+
+        // Check for REST API JSON response.
+        if (! is_array($data)) {
+            return rest_ensure_response(
+                new \WP_Error(
+                    500,
+                    __('Invalid response from BeyondWords API', 'speechkit')
+                )
+            );
+        }
+
+        // Return the project ID in the response.
+        $data['project_id'] = $projectId;
+
+        return rest_ensure_response($data);
+    }
 }