Release: v3.10.2

.github/workflows/prepare-release.yml

@@ -100,6 +100,8 @@ jobs:
       GH_TOKEN: ${{ secrets.CHANGELOG_PAT || github.token }}
     steps:
       - name: Authorize labeler
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
           actor='${{ github.event.sender.login }}'
           perm=$(gh api "repos/${{ github.repository }}/collaborators/$actor/permission" --jq '.permission' 2>/dev/null || echo none)
@@ -110,12 +112,17 @@ jobs:
           esac
 
       - name: Dispatch changelog generation
+        env:
+          REPO: ${{ github.repository }}
+          BRANCH: ${{ github.event.pull_request.head.ref }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
         run: |
           gh workflow run changelog.yml \
             --repo codesnippetspro/.github-private \
             --ref main \
             --field mode=generate \
-            --field repo="${{ github.repository }}" \
-            --field pr_number="${{ github.event.pull_request.number }}" \
+            --field repo="$REPO" \
+            --field branch="$BRANCH" \
+            --field pr_number="$PR_NUMBER" \
             --field readme_path="./src/readme.txt"
-          echo "::notice::Dispatched changelog generation for PR #${{ github.event.pull_request.number }}"
+          echo "::notice::Dispatched changelog generation for PR #$PR_NUMBER"

CHANGELOG.md

@@ -1,16 +1,37 @@
 # Changelog
 
+## [3.10.2] (2026-09-01)
+
+### Added
+* Added a confirmation flow for run-once snippet execution and hardened the handler to prevent failed or confusing actions.
+
+### Changed
+* Snippet names now respect the row truncation Screen Option in the admin list for better readability.
+* Version switching AJAX requests now validate the correct nonce, improving reliability when updating snippet versions.
+
+### Fixed
+* Fixed safe mode fatal errors caused by an undefined wp_get_current_user() call.
+* Fixed PHP validation being triggered incorrectly when activating snippets in bulk.
+* Fixed saving issues after a user session expires.
+* Fixed warnings caused by aliased field names when reading modified snippet fields.
+* Fixed vendor autoloader issues by stripping unprefixed namespace references.
+* Resolved issues where snippet names and version switches could behave inconsistently in the admin UI.
+
 ## [3.10.1] (2026-08-28)
 
 ### Changed
-* Enhanced active-link visibility in the toolbar with border-based styling
-* Standardized sidebar label font sizing for consistency
+* Enhanced active-link visibility in the toolbar with border-based styling.
 
 ### Fixed
-* Fixed admin bar script loading on core to work correctly on front-end
-* Fixed snippet modification dates to send with proper UTC offset
-* Fixed row truncation screen option to persist correctly across sessions
-* Fixed sticky sidebar from displaying unwanted horizontal scrollbar
+* Fixed a fatal error affecting snippets that use a `namespace` or `declare` statement.
+* Fixed the snippets page rendering blank when another plugin's screen settings filter returned an invalid value.
+* Fixed snippet saving on hosts that block REST API `PUT` and `PATCH` requests, by sending writes as `POST` with a method override.
+* Fixed the Snippets List Order setting not being applied to the snippets list.
+* Fixed admin bar snippet scripts failing to load on the free version, including on the site front end.
+* Fixed snippet modified dates being sent without the correct UTC offset.
+* Fixed the row truncation screen option not persisting across sessions.
+* Fixed inconsistent sidebar label sizes.
+* Fixed the sticky editor sidebar showing an unwanted horizontal scrollbar.
 
 ## [3.10.0] (2026-08-24)
 

package.json

@@ -2,7 +2,7 @@
   "name": "code-snippets",
   "description": "Manage code snippets running on a WordPress-powered site through a graphical interface.",
   "homepage": "https://codesnippets.pro",
-  "version": "3.10.1",
+  "version": "3.10.2",
   "main": "src/dist/edit.js",
   "directories": {
     "test": "tests"

src/code-snippets.php

@@ -8,11 +8,11 @@
  * License:      GPL-2.0-or-later
  * License URI:  license.txt
  * Text Domain:  code-snippets
- * Version:      3.10.1
+ * Version:      3.10.2
  * Requires PHP: 7.4
  * Requires at least: 5.5
  *
- * @version   3.10.1
+ * @version   3.10.2
  * @package   Code_Snippets
  * @author    Shea Bunge <shea@codesnippets.pro>
  * @copyright 2012-2026 Code Snippets Pro
@@ -37,7 +37,7 @@
 	 *
 	 * @const string
 	 */
-	define( 'CODE_SNIPPETS_VERSION', '3.10.1' );
+	define( 'CODE_SNIPPETS_VERSION', '3.10.2' );
 
 	/**
 	 * The full path to the main file of this plugin.

src/css/common/list-table/_layout.scss

@@ -278,9 +278,11 @@
 		text-align: start;
 	}
 
-	// Snippet names always stay on a single line, truncating gracefully;
-	// the full name is exposed through the title attribute.
-	td.column-name > .snippet-name {
+	// Names and descriptions are both governed by the "Truncate long snippet
+	// names and descriptions" Screen Option. When it is off, the full name is
+	// shown; when on, it stays on a single line and the full value remains
+	// available through the title attribute.
+	&.truncate-row-values td.column-name > .snippet-name {
 		display: block;
 		max-inline-size: min(15rem, 30vw);
 		white-space: nowrap;

src/js/components/ManageMenu/ManageMenu.tsx

@@ -2,7 +2,7 @@ import React, { useEffect, useMemo, useState } from 'react'
 import { __ } from '@wordpress/i18n'
 import { createInterpolateElement } from '@wordpress/element'
 import { fetchConstQueryParam, fetchQueryParam, updateQueryParams } from '../../utils/urls'
-import { DismissibleNotice } from '../common/Notice'
+import { DismissibleNotice, type NoticeType } from '../common/Notice'
 import { SUBPAGES, Toolbar } from '../common/Toolbar'
 import { UpsellPage } from '../common/UpsellDialog'
 import { CommunityCloud } from './CommunityCloud/CommunityCloud'
@@ -24,31 +24,46 @@ const repositionTableOptionsSettings = () => {
 	}
 }
 
-const getNoticeText = (result: string) => {
+const getNotice = (result: string): { text: string, type: NoticeType } | undefined => {
 	switch (result) {
 		case 'deleted':
-			return __('Snippet <strong>deleted</strong>.', 'code-snippets')
+			return { text: __('Snippet <strong>deleted</strong>.', 'code-snippets'), type: 'success' }
+
+		case 'executed':
+			return { text: __('Snippet <strong>executed</strong>.', 'code-snippets'), type: 'success' }
+
+		case 'run-once-failed':
+			return {
+				text: __('The snippet could not be run. Check that its code is valid and try again.', 'code-snippets'),
+				type: 'error'
+			}
+
+		case 'run-once-safe-mode':
+			return {
+				text: __('Safe mode is active, so the snippet was not run.', 'code-snippets'),
+				type: 'warning'
+			}
 
 		default:
 			return undefined
 	}
 }
 
 const PageNotices = () => {
-	const [noticeText, setNoticeText] = useState(() => {
+	const [notice, setNotice] = useState(() => {
 		const result = fetchQueryParam('result')
 		updateQueryParams({ result: undefined })
-		return result && getNoticeText(result)
+		return result ? getNotice(result) : undefined
 	})
 
-	return noticeText
+	return notice
 		? <DismissibleNotice
 			className="code-snippets-notice"
 			onDismiss={() => {
-				setNoticeText(undefined)
+				setNotice(undefined)
 			}}
-			type="success">
-			<p>{createInterpolateElement(noticeText, { strong: <strong /> })}</p>
+			type={notice.type}>
+			<p>{createInterpolateElement(notice.text, { strong: <strong /> })}</p>
 		</DismissibleNotice>
 		: null
 }

src/js/components/ManageMenu/SnippetsTable/TableColumns.tsx

@@ -26,7 +26,12 @@ const RunOnceButton: React.FC<ColumnProps> = ({ snippet }) =>
 	<a
 		className="snippet-execution-button"
 		title={__('Run Once', 'code-snippets')}
-		href={buildUrl(window.location.href, { action: 'run-once', snippet: snippet.id })}
+		href={buildUrl(window.location.href, {
+			action: 'run-once',
+			snippet: snippet.id,
+			network: snippet.network ? 'true' : 'false',
+			_wpnonce: window.CODE_SNIPPETS_MANAGE?.runOnceNonce ?? ''
+		})}
 	>
 		<span className="screen-reader-text">{__('Run Once', 'code-snippets')}</span>
 		<span aria-hidden="true">&nbsp;</span>

src/js/hooks/useRestAPI.tsx

@@ -1,7 +1,7 @@
 import React, { useMemo } from 'react'
 import axios from 'axios'
 import { createContextHook } from '../utils/bootstrap'
-import { REST_API_AXIOS_CONFIG, applyMethodOverride } from '../utils/restAPI'
+import { REST_API_AXIOS_CONFIG, applyMethodOverride, applyRestNonce, listenForNonceRefresh } from '../utils/restAPI'
 import type { PropsWithChildren } from 'react'
 import type { AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios'
 
@@ -60,7 +60,9 @@ const [Context, useRestAPI] = createContextHook<RestAPIContext>('useRestAPI')
 export const WithRestAPIContext: React.FC<PropsWithChildren> = ({ children }) => {
 	const axiosInstance = useMemo(() => {
 		const instance = axios.create(REST_API_AXIOS_CONFIG)
+		instance.interceptors.request.use(applyRestNonce)
 		instance.interceptors.request.use(applyMethodOverride)
+		listenForNonceRefresh()
 		return instance
 	}, [])
 

src/js/hooks/useSubmitSnippet.tsx

@@ -1,6 +1,7 @@
 import { __ } from '@wordpress/i18n'
 import { isAxiosError } from 'axios'
 import React, { useCallback } from 'react'
+import { describeRequestError } from '../utils/errors'
 import { useSnippetForm } from '../components/EditMenu/SnippetForm/WithSnippetFormContext'
 import { createSnippetObject, isCondition } from '../utils/snippets/snippets'
 import { buildUrl } from '../utils/urls'
@@ -113,8 +114,8 @@ export const useSubmitSnippet = (): UseSubmitSnippet => {
 					: api.update({ ...request, id }))
 
 				return response.id ? createSnippetObject(response) : undefined
-			} catch (error) {
-				return isAxiosError(error) ? error.message : undefined
+			} catch (error: unknown) {
+				return isAxiosError(error) ? describeRequestError(error) : undefined
 			} finally {
 				setIsWorking(false)
 			}

src/js/types/Window.ts

@@ -12,6 +12,13 @@ declare global {
 		readonly wp: {
 			readonly editor?: WordPressEditor
 			readonly codeEditor?: WordPressCodeEditor
+			readonly hooks?: {
+				addAction: (
+					hookName: string,
+					namespace: string,
+					callback: (data: { rest_nonce?: string }) => void
+				) => void
+			}
 		}
 		readonly pagenow?: string
 		readonly ajaxurl: string
@@ -72,6 +79,7 @@ declare global {
 			cloudSearchPerPage: number
 			isSafeModeActive: boolean
 			bulkDownloadNonce: string
+			runOnceNonce?: string
 			supportsZipDownloads: boolean
 			editorTheme: string
 		}

src/js/utils/errors.ts

@@ -20,3 +20,36 @@ export const unpackErrorResponse = (error: unknown): string => {
 
 	return __('An unknown error occurred.', 'code-snippets')
 }
+
+/**
+ * Explain a failed request in terms the reader can act on.
+ *
+ * An expired session is the common case worth naming: the snippet editor is a
+ * screen people leave open, and once the session lapses WordPress rejects every
+ * write with a 403 that says only "Cookie check failed". Reporting the raw
+ * status left people believing the plugin had ignored them.
+ */
+export const describeRequestError = (error: unknown): string => {
+	if (!isAxiosError(error)) {
+		return unpackErrorResponse(error)
+	}
+
+	if (!error.response) {
+		return __(
+			'The request did not reach your site. Check your connection, or whether a security plugin is blocking it.',
+			'code-snippets'
+		)
+	}
+
+	const data: unknown = error.response.data
+	const code = data && 'object' === typeof data && 'code' in data ? String(data.code) : ''
+
+	if ('rest_cookie_invalid_nonce' === code || 'rest_not_logged_in' === code) {
+		return __(
+			'You have been signed out, so nothing was saved. Sign in again in another tab, then save. Your changes are still here.',
+			'code-snippets'
+		)
+	}
+
+	return unpackErrorResponse(error)
+}

src/js/utils/restAPI.ts

@@ -41,9 +41,54 @@ export const applyMethodOverride = (config: InternalAxiosRequestConfig): Interna
 	return config
 }
 
+/**
+ * The REST nonce to authenticate the next request with.
+ *
+ * Held in a variable rather than baked into the axios config, because the value
+ * the page was rendered with does not stay valid. A nonce expires with the
+ * session, and the snippet editor is a screen people leave open for a long
+ * time. Once it lapsed, every save failed with a 403 and the only cure was
+ * reloading the page, which loses whatever was being written.
+ */
+let restNonce = window.CODE_SNIPPETS?.restAPI.nonce
+
+/**
+ * Keep the REST nonce current for as long as the page is open.
+ *
+ * WordPress already sends a freshly minted nonce with every Heartbeat response,
+ * from `wp_refresh_heartbeat_nonces()`. Core applies it to `wpApiSettings`,
+ * which our screens do not enqueue, so the value went unused. Listening for the
+ * tick ourselves means an editor left open stays able to save.
+ */
+export const listenForNonceRefresh = () => {
+	// Heartbeat also fires the tick through the hooks API, which avoids
+	// depending on jQuery being present and typed.
+	window.wp.hooks?.addAction(
+		'heartbeat.tick',
+		'code-snippets/refresh-rest-nonce',
+		(data: { rest_nonce?: string }) => {
+			if (data.rest_nonce) {
+				restNonce = data.rest_nonce
+			}
+		}
+	)
+}
+
+/**
+ * Attach the current nonce to an outgoing request.
+ *
+ * Read per request, so that a nonce refreshed since page load is actually used.
+ */
+export const applyRestNonce = (config: InternalAxiosRequestConfig): InternalAxiosRequestConfig => {
+	if (restNonce) {
+		config.headers.set('X-WP-Nonce', restNonce)
+	}
+
+	return config
+}
+
 export const REST_API_AXIOS_CONFIG: AxiosRequestConfig = {
 	headers: {
-		'X-WP-Nonce': window.CODE_SNIPPETS?.restAPI.nonce,
 		'Access-Control': window.CODE_SNIPPETS?.restAPI.cloud.token
 	}
 }