WordPress · kraftbj · Mar 6, 2026 · Mar 6, 2026 · Mar 16, 2026 · Mar 16, 2026
diff --git a/assets/icon-180.png b/assets/icon-180.png
diff --git a/assets/icon-192.png b/assets/icon-192.png
diff --git a/assets/icon-512.png b/assets/icon-512.png
diff --git a/class-wp-press-this-plugin.php b/class-wp-press-this-plugin.php
@@ -1635,6 +1635,13 @@ public function html() {
 <head>
 	<meta http-equiv="Content-Type" content="<?php echo esc_attr( get_bloginfo( 'html_type' ) ); ?>; charset=<?php echo esc_attr( get_option( 'blog_charset' ) ); ?>" />
 	<meta name="viewport" content="width=device-width, initial-scale=1">
+	<meta name="mobile-web-app-capable" content="yes">
+	<meta name="apple-mobile-web-app-capable" content="yes">
+	<meta name="apple-mobile-web-app-status-bar-style" content="default">
+	<meta name="apple-mobile-web-app-title" content="<?php echo esc_attr__( 'Press This', 'press-this' ); ?>">
+	<meta name="theme-color" content="#2271b1">
+	<link rel="apple-touch-icon" href="<?php echo esc_url( plugins_url( 'assets/icon-180.png', __FILE__ ) ); ?>">
+	<link rel="manifest" href="<?php echo esc_url( rest_url( 'press-this/v1/manifest' ) ); ?>">
 	<title><?php esc_html_e( 'Press This!', 'press-this' ); ?></title>
 
 	<script>

diff --git a/includes/class-press-this-assets.php b/includes/class-press-this-assets.php
@@ -230,6 +230,7 @@ public function get_script_dependencies() {
 			'wp-format-library',
 			'wp-html-entities',
 			'wp-i18n',
+			'wp-keyboard-shortcuts',
 			'wp-primitives',
 		);
 	}

diff --git a/press-this-plugin.php b/press-this-plugin.php
@@ -139,6 +139,17 @@ function wp_ajax_press_this_plugin_add_category() {
  * @since 2.0.1
  */
 function press_this_register_rest_routes() {
+	// Web App Manifest for Add to Home Screen / PWA support.
+	register_rest_route(
+		'press-this/v1',
+		'/manifest',
+		array(
+			'methods'             => WP_REST_Server::READABLE,
+			'callback'            => 'press_this_rest_manifest',
+			'permission_callback' => '__return_true',
+		)
+	);
+
 	// URL scraping endpoint for Direct Access Mode.
 	register_rest_route(
 		'press-this/v1',
@@ -926,6 +937,52 @@ function press_this_is_proxy_enabled() {
 	return apply_filters( 'press_this_enable_url_proxy', false );
 }
 
+/**
+ * REST callback for Web App Manifest.
+ *
+ * Returns a JSON manifest for Add to Home Screen / PWA support.
+ * Must be publicly accessible so the browser can fetch it without authentication.
+ *
+ * @since 2.0.1
+ *
+ * @return WP_REST_Response Manifest JSON.
+ */
+function press_this_rest_manifest() {
+	$manifest = array(
+		'name'             => __( 'Press This', 'press-this' ),
+		'short_name'       => __( 'Press This', 'press-this' ),
+		'start_url'        => admin_url( 'press-this.php' ),
+		'display'          => 'standalone',
+		'theme_color'      => '#2271b1',
+		'background_color' => '#ffffff',
+		'icons'            => array(
+			array(
+				'src'   => plugins_url( 'assets/icon-192.png', __FILE__ ),
+				'sizes' => '192x192',
+				'type'  => 'image/png',
+			),
+			array(
+				'src'   => plugins_url( 'assets/icon-512.png', __FILE__ ),
+				'sizes' => '512x512',
+				'type'  => 'image/png',
+			),
+		),
+		'share_target'     => array(
+			'action' => admin_url( 'press-this.php' ),
+			'method' => 'GET',
+			'params' => array(
+				'url'   => 'u',
+				'title' => 't',
+			),
+		),
+	);
+
+	$response = new WP_REST_Response( $manifest, 200 );
+	$response->header( 'Content-Type', 'application/manifest+json; charset=utf-8' );
+
+	return $response;
+}
+
 /**
  * Permission callback for REST scrape endpoint.
  *

diff --git a/src/components/Header.js b/src/components/Header.js
@@ -11,7 +11,13 @@
 /**
  * WordPress dependencies
  */
-import { useState, useCallback, useEffect, useRef } from '@wordpress/element';
+import {
+	useState,
+	useCallback,
+	useEffect,
+	useRef,
+	useMemo,
+} from '@wordpress/element';
 import {
 	Button,
 	TextControl,
@@ -66,7 +72,7 @@
 * @param {Function} props.onRedo                Redo callback.
 * @param {boolean}  props.hasUndo               Whether undo is available.
 * @param {boolean}  props.hasRedo               Whether redo is available.
 * @return {JSX.Element} Header component.
 */
 export default function Header( {
 	siteName,
@@ -93,6 +99,15 @@
 	const [ showUpgradeNotice, setShowUpgradeNotice ] =
 		useState( isLegacyBookmarklet );
 
+	// Detect standalone display mode (added to home screen).
+	const isStandalone = useMemo(
+		() =>
+			( typeof window.matchMedia === 'function' &&
+				window.matchMedia( '(display-mode: standalone)' ).matches ) ||
+			window.navigator.standalone === true,
+		[]
+	);
+
 	// Track if initial auto-scan has been performed.
 	const hasAutoScanned = useRef( false );
 
@@ -404,6 +419,32 @@
 											'press-this'
 										) }
 									</MenuItem>
+									{ isStandalone && (
+										<>
+											<MenuItem
+												href={ siteUrl }
+												onClick={ onClose }
+											>
+												{ __(
+													'View Site',
+													'press-this'
+												) }
+											</MenuItem>
+											<MenuItem
+												onClick={ () => {
+													// Reload without query params for a blank post.
+													window.location.href =
+														window.location.pathname;
+													onClose();
+												} }
+											>
+												{ __(
+													'New Post',
+													'press-this'
+												) }
+											</MenuItem>
+										</>
+									) }
 								</MenuGroup>
 							) }
 						</DropdownMenu>

diff --git a/src/components/PressThisEditor.js b/src/components/PressThisEditor.js
@@ -57,7 +57,7 @@
 *
 * This must be a separate component to access BlockEditorProvider context.
 *
 * @return {JSX.Element|null} Block Inspector panel or null if no block selected.
 */
 function SidebarBlockInspector() {
 	const hasSelectedBlock = useSelect( ( select ) => {
@@ -87,7 +87,7 @@
 * position rather than always appended at the end.
 *
 * @param {Object} props Props passed through to ScrapedMediaPanel.
 * @return {JSX.Element|null} ScrapedMediaPanel with store-connected insertion.
 */
 function ConnectedScrapedMediaPanel( props ) {
 	const { insertBlock } = useDispatch( blockEditorStore );
@@ -179,9 +179,29 @@
  * @param {string}  url            URL to redirect to.
  * @param {boolean} inParentWindow Whether to redirect in parent window.
  */
+
+/**
+ * Check if running in standalone display mode (added to home screen).
+ *
+ * @return {boolean} True if standalone mode.
+ */
+function isStandaloneMode() {
+	return (
+		( typeof window.matchMedia === 'function' &&
+			window.matchMedia( '(display-mode: standalone)' ).matches ) ||
+		window.navigator.standalone === true
+	);
+}
+
 function performSafeRedirect( url, inParentWindow = false ) {
 	const safeUrl = safeRedirect( url );
 
+	// In standalone mode there's no opener window, so always redirect self.
+	if ( isStandaloneMode() ) {
+		window.location.href = safeUrl;
+		return;
+	}
+
 	if ( inParentWindow && window.opener ) {
 		try {
 			// Attempt to check if opener is same origin.
@@ -247,7 +267,7 @@
 * @param {Function} props.onUndoReady       Callback when undo/redo handlers are ready (receives { handleUndo, handleRedo, hasUndo, hasRedo }).
 * @param {string}   props.categoryNonce
 * @param {string}   props.ajaxUrl
 * @return {JSX.Element} Press This Editor component.
 */
 export default function PressThisEditor( {
 	post,

diff --git a/tests/components/header-publish-controls.test.js b/tests/components/header-publish-controls.test.js
@@ -79,4 +79,15 @@ describe( 'Header Publish Controls', () => {
 		// Check for disabled state.
 		expect( headerContent ).toContain( 'disabled' );
 	} );
+
+	test( 'Standalone mode detection guards matchMedia availability', () => {
+		expect( headerContent ).toContain( "typeof window.matchMedia === 'function'" );
+	} );
+
+	test( 'Standalone mode shows View Site and New Post menu items', () => {
+		expect( headerContent ).toContain( 'View Site' );
+		expect( headerContent ).toContain( 'New Post' );
+		// Items are conditionally rendered only in standalone mode.
+		expect( headerContent ).toContain( '{ isStandalone && (' );
+	} );
 } );
diff --git a/tests/components/undo-redo.test.js b/tests/components/undo-redo.test.js
@@ -142,3 +142,35 @@ describe( 'Undo/Redo: PressThisEditor stack and shortcuts', () => {
 		);
 	} );
 } );
+
+describe( 'Standalone mode: PressThisEditor', () => {
+	let editorContent;
+
+	beforeAll( () => {
+		const editorPath = path.resolve(
+			__dirname,
+			'../../src/components/PressThisEditor.js'
+		);
+		editorContent = fs.readFileSync( editorPath, 'utf8' );
+	} );
+
+	test( 'isStandaloneMode guards matchMedia availability', () => {
+		expect( editorContent ).toContain( "typeof window.matchMedia === 'function'" );
+	} );
+
+	test( 'performSafeRedirect checks standalone mode before opener redirect', () => {
+		// isStandaloneMode is called inside performSafeRedirect.
+		expect( editorContent ).toMatch(
+			/performSafeRedirect[\s\S]*?isStandaloneMode\(\)/
+		);
+	} );
+
+	test( 'Standalone mode redirects self instead of using opener', () => {
+		// In standalone mode, redirect goes to window.location.href directly.
+		const standaloneBlock = editorContent.match(
+			/if\s*\(\s*isStandaloneMode\(\)\s*\)\s*\{([\s\S]*?)\}/
+		);
+		expect( standaloneBlock ).not.toBeNull();
+		expect( standaloneBlock[ 1 ] ).toContain( 'window.location.href' );
+	} );
+} );