← All changes | sal/class.json-api-site-base.php +308 -27 13.6.2 → 16.3-beta View file →

		@@ -14,8 +14,12 @@
14	14	use Automattic\Jetpack\Blaze;
15	15	use Automattic\Jetpack\Status;
16	16	use Automattic\Jetpack\Status\Host;
17	17
	18	+if ( ! defined( 'ABSPATH' ) ) {
	19	+ exit( 0 );
	20	+}
	21	+
18	22	require_once __DIR__ . '/class.json-api-date.php';
19	23	require_once __DIR__ . '/class.json-api-post-base.php';
20	24
21	25	/**
		@@ -60,14 +64,24 @@
60	64	return $this->blog_id;
61	65	}
62	66
63	67	/**
	68	+ * Returns the site slug.
	69	+ *
	70	+ * @return string
	71	+ */
	72	+ public function get_slug() {
	73	+ return ( new Status() )->get_site_suffix();
	74	+ }
	75	+
	76	+ /**
64	77	* Returns the site name.
65	78	*
66	79	* @return string
67	80	*/
68	81	public function get_name() {
69		- return (string) htmlspecialchars_decode( get_bloginfo( 'name' ), ENT_QUOTES );
	82	+ $name = get_bloginfo( 'name' );
	83	+ return is_string( $name ) ? htmlspecialchars_decode( $name, ENT_QUOTES ) : '';
70	84	}
71	85
72	86	/**
73	87	* Returns the site description.
		@@ -74,9 +88,10 @@
74	88	*
75	89	* @return string
76	90	*/
77	91	public function get_description() {
78		- return (string) htmlspecialchars_decode( get_bloginfo( 'description' ), ENT_QUOTES );
	92	+ $description = get_bloginfo( 'description' );
	93	+ return is_string( $description ) ? htmlspecialchars_decode( $description, ENT_QUOTES ) : '';
79	94	}
80	95
81	96	/**
82	97	* Returns the URL for the current site.
		@@ -416,8 +431,27 @@
416	431	*/
417	432	abstract public function is_deleted();
418	433
419	434	/**
	435	+ * Indicates that a site is an A4A client. Not used in Jetpack.
	436	+ *
	437	+ * @see class.json-api-site-jetpack.php for implementation.
	438	+ */
	439	+ abstract public function is_a4a_client();
	440	+
	441	+ /**
	442	+ * Indicates that a site is an A4A dev site.
	443	+ *
	444	+ * @return bool
	445	+ */
	446	+ public function is_a4a_dev_site() {
	447	+ if ( function_exists( 'has_blog_sticker' ) ) {
	448	+ return has_blog_sticker( 'a4a-is-dev-site' );
	449	+ }
	450	+ return false;
	451	+ }
	452	+
	453	+ /**
420	454	* Return the user interactions with a site. Not used in Jetpack.
421	455	*
422	456	* @param string $role The capability to check.
423	457	* @return bool
		@@ -738,26 +772,29 @@
738	772	private function user_can_view_post( $post ) {
739	773	if ( ! $post || is_wp_error( $post ) ) {
740	774	return false;
741	775	}
742		-
743		- if ( 'inherit' === $post->post_status ) {
	776	+ // If the post is of status inherit, check if the parent exists ( different to 0 ) to check for the parent status object.
	777	+ if ( 'inherit' === $post->post_status && 0 !== (int) $post->post_parent ) {
744	778	$parent_post = get_post( $post->post_parent );
745		- $post_status_obj = get_post_status_object( $parent_post->post_status );
	779	+ $post_status_obj = $parent_post ? get_post_status_object( $parent_post->post_status ) : null;
746	780	} else {
747	781	$post_status_obj = get_post_status_object( $post->post_status );
748	782	}
749	783
750		- $authorized = (
751		- $post_status_obj->public ||
752		- ( is_user_logged_in() &&
753		- (
754		- ( $post_status_obj->protected && current_user_can( 'edit_post', $post->ID ) ) ||
755		- ( $post_status_obj->private && current_user_can( 'read_post', $post->ID ) ) ||
756		- ( 'trash' === $post->post_status && current_user_can( 'edit_post', $post->ID ) ) ||
757		- 'auto-draft' === $post->post_status
758		- )
759		- )
	784	+ $authorized = false;
	785	+
	786	+ if ( $post_status_obj ) {
	787	+ $authorized = $post_status_obj->public
	788	+ || ( is_user_logged_in() && (
	789	+ ( $post_status_obj->protected && current_user_can( 'edit_post', $post->ID ) )
	790	+ || ( $post_status_obj->private && current_user_can( 'read_post', $post->ID ) )
	791	+ ) );
	792	+ }
	793	+
	794	+ $authorized = $authorized || (
	795	+ ( 'trash' === $post->post_status && current_user_can( 'edit_post', $post->ID ) )
	796	+ || 'auto-draft' === $post->post_status
760	797	);
761	798
762	799	if ( ! $authorized ) {
763	800	return new WP_Error( 'unauthorized', 'User cannot view post', 403 );
		@@ -939,18 +976,8 @@
939	976	'upload_files' => $this->current_user_can( 'upload_files' ),
940	977	'delete_users' => $this->current_user_can( 'delete_users' ),
941	978	'remove_users' => $this->current_user_can( 'remove_users' ),
942	979	'own_site' => $is_wpcom_blog_owner,
943		- /**
944		- * Filter whether the Hosting section in Calypso should be available for site.
945		- *
946		- * @module json-api
947		- *
948		- * @since 8.2.0
949		- *
950		- * @param bool $view_hosting Can site access Hosting section. Default to false.
951		- */
952		- 'view_hosting' => apply_filters( 'jetpack_json_api_site_can_view_hosting', false ),
953	980	'view_stats' => stats_is_blog_user( $this->blog_id ),
954	981	'activate_plugins' => $this->current_user_can( 'activate_plugins' ),
955	982	'update_plugins' => $this->current_user_can( 'update_plugins' ),
956	983	'export' => $this->current_user_can( 'export' ),
		@@ -987,9 +1014,9 @@
987	1014	**/
988	1015	public function get_logo() {
989	1016	// Set an empty response array.
990	1017	$logo_setting = array(
991		- 'id' => (int) 0,
	1018	+ 'id' => 0,
992	1019	'sizes' => array(),
993	1020	'url' => '',
994	1021	);
995	1022
		@@ -1050,8 +1077,31 @@
1050	1077	return get_option( 'stylesheet' );
1051	1078	}
1052	1079
1053	1080	/**
	1081	+ * Returns a list of errors for broken themes on the site.
	1082	+ *
	1083	+ * @return array
	1084	+ */
	1085	+ public function get_theme_errors() {
	1086	+ $themes_with_errors = wp_get_themes( array( 'errors' => true ) );
	1087	+ $theme_errors = array();
	1088	+
	1089	+ foreach ( $themes_with_errors as $theme ) {
	1090	+ $errors = $theme->errors();
	1091	+
	1092	+ if ( is_wp_error( $errors ) && ! empty( $errors->get_error_messages() ) ) {
	1093	+ $theme_errors[] = array(
	1094	+ 'name' => sanitize_title( $theme->get( 'Name' ) ),
	1095	+ 'errors' => (array) $errors->get_error_messages(),
	1096	+ );
	1097	+ }
	1098	+ }
	1099	+
	1100	+ return $theme_errors;
	1101	+ }
	1102	+
	1103	+ /**
1054	1104	* Gets the header image data.
1055	1105	*
1056	1106	* @return bool|object
1057	1107	**/
		@@ -1205,9 +1255,9 @@
1205	1255	$ss = new Sharing_Service();
1206	1256	$blog_services = $ss->get_blog_services();
1207	1257	$default_sharing_status = ! empty( $blog_services['visible'] );
1208	1258	}
1209		- return (bool) $default_sharing_status;
	1259	+ return $default_sharing_status;
1210	1260	}
1211	1261
1212	1262	/**
1213	1263	* Displays the current comment status
		@@ -1469,8 +1519,81 @@
1469	1519	return false;
1470	1520	}
1471	1521
1472	1522	/**
	1523	+ * Get the DIFM Lite site options exposed to the frontend while a build is in progress.
	1524	+ *
	1525	+ * Returns null unless the site has an active DIFM Lite build and the code is
	1526	+ * running on WordPress.com, where the DIFM Lite library exists.
	1527	+ *
	1528	+ * @return array|null
	1529	+ */
	1530	+ public function get_difm_lite_site_options() {
	1531	+ if ( ! $this->is_difm_lite_in_progress() ) {
	1532	+ return null;
	1533	+ }
	1534	+ if ( ! defined( 'IS_WPCOM' ) || ! IS_WPCOM || ! function_exists( 'require_lib' ) ) {
	1535	+ return null;
	1536	+ }
	1537	+ require_lib( 'difm-lite' );
	1538	+ if ( ! class_exists( '\DIFM_Lite_Options' ) ) {
	1539	+ // Fail closed if the library did not define the class; this method
	1540	+ // documents null for every path where the options are unavailable.
	1541	+ return null;
	1542	+ }
	1543	+ // The submission state is canonical on the purchase blog. This site may be
	1544	+ // the stickered staging build target, whose own options blob is empty, so
	1545	+ // resolve to the purchase blog before reading — otherwise a post-submit
	1546	+ // staging target reports itself as pre-submit.
	1547	+ //
	1548	+ // resolve_purchase_site_id() ships in the wpcom DIFM Lite site-role
	1549	+ // pointers change. This Jetpack code can deploy before that lands, so
	1550	+ // fall back to the current blog when it is unavailable — no retargeted
	1551	+ // builds can exist until that change is live, so the current blog is the
	1552	+ // purchase blog in that window.
	1553	+ $purchase_blog_id = $this->blog_id;
	1554	+ // @phan-suppress-next-line PhanUndeclaredClassReference -- wpcom-only class, guarded above.
	1555	+ if ( method_exists( '\DIFM_Lite_Options', 'resolve_purchase_site_id' ) ) {
	1556	+ // @phan-suppress-next-line PhanUndeclaredClassMethod -- wpcom-only class, guarded above.
	1557	+ $purchase_blog_id = \DIFM_Lite_Options::resolve_purchase_site_id( $this->blog_id );
	1558	+ }
	1559	+ // @phan-suppress-next-line PhanUndeclaredClassMethod -- wpcom-only class, guarded above.
	1560	+ $difm_lite_options = new \DIFM_Lite_Options( $purchase_blog_id );
	1561	+ return array(
	1562	+ // @phan-suppress-next-line PhanUndeclaredClassProperty -- wpcom-only class, guarded above.
	1563	+ 'is_website_content_submitted' => (bool) $difm_lite_options->is_website_content_submitted,
	1564	+ );
	1565	+ }
	1566	+
	1567	+ /**
	1568	+ * Check if the site has the gating-business-q1 blog sticker.
	1569	+ *
	1570	+ * @return bool
	1571	+ */
	1572	+ public function is_gating_business_q1() {
	1573	+ if ( function_exists( 'has_blog_sticker' ) ) {
	1574	+ return has_blog_sticker( 'gating-business-q1' );
	1575	+ } elseif ( function_exists( 'wpcomsh_is_site_sticker_active' ) ) {
	1576	+ // For atomic sites
	1577	+ return wpcomsh_is_site_sticker_active( 'gating-business-q1' );
	1578	+ }
	1579	+ return false;
	1580	+ }
	1581	+
	1582	+ /**
	1583	+ * Whether the site is still on the pre-2026 feature gating.
	1584	+ *
	1585	+ * @return bool
	1586	+ */
	1587	+ public function is_legacy_gating_site() {
	1588	+ if ( ! method_exists( 'WPCOM_Features', 'is_legacy_gating_site' ) ) {
	1589	+ return false;
	1590	+ }
	1591	+
	1592	+ return (bool) WPCOM_Features::is_legacy_gating_site( $this->blog_id );
	1593	+ }
	1594	+
	1595	+ /**
1473	1596	* Get the option of site intent which value is coming from the Hero Flow
1474	1597	*
1475	1598	* @return string
1476	1599	*/
		@@ -1478,8 +1601,17 @@
1478	1601	return get_option( 'site_intent', '' );
1479	1602	}
1480	1603
1481	1604	/**
	1605	+ * Get the option of site partner bundle which value is coming from the Partner Flow
	1606	+ *
	1607	+ * @return string
	1608	+ */
	1609	+ public function get_site_partner_bundle() {
	1610	+ return get_option( 'site_partner_bundle', '' );
	1611	+ }
	1612	+
	1613	+ /**
1482	1614	* Get site option to determine if and how to display launchpad onboarding
1483	1615	*
1484	1616	* @return string
1485	1617	*/
		@@ -1511,8 +1643,58 @@
1511	1643	return array();
1512	1644	}
1513	1645
1514	1646	/**
	1647	+ * Whether the AI Launchpad is enabled for this site. Mirrors AI_Launchpad::is_enabled_for_site() in jetpack-mu-wpcom.
	1648	+ *
	1649	+ * @return bool
	1650	+ */
	1651	+ public function is_ai_launchpad_enabled() {
	1652	+ return (bool) get_option( 'wpcom_ai_launchpad_enabled' ) && ! $this->is_ai_launchpad_no_guidance();
	1653	+ }
	1654	+
	1655	+ /**
	1656	+ * Whether the AI Launchpad was dismissed (skipped), which leaves the site with no setup guidance.
	1657	+ *
	1658	+ * @return bool
	1659	+ */
	1660	+ public function is_ai_launchpad_dismissed() {
	1661	+ return (bool) get_option( 'wpcom_ai_launchpad_dismissed' );
	1662	+ }
	1663	+
	1664	+ /**
	1665	+ * Whether every AI Launchpad task has been completed.
	1666	+ *
	1667	+ * @return bool
	1668	+ */
	1669	+ public function is_ai_launchpad_completed() {
	1670	+ return (bool) get_option( 'wpcom_ai_launchpad_completed' );
	1671	+ }
	1672	+
	1673	+ /**
	1674	+ * Whether the site gets no setup guidance: no My Home, Site Setup, or launchpad. Mirrors
	1675	+ * wpcom_launchpad_is_no_guidance() in jetpack-mu-wpcom, which also counts a skipped AI Launchpad.
	1676	+ *
	1677	+ * @return bool
	1678	+ */
	1679	+ public function is_ai_launchpad_no_guidance() {
	1680	+ if ( get_option( 'wpcom_ai_launchpad_no_guidance' ) ) {
	1681	+ return true;
	1682	+ }
	1683	+
	1684	+ return (bool) get_option( 'wpcom_ai_launchpad_enabled' ) && (bool) get_option( 'wpcom_ai_launchpad_dismissed' );
	1685	+ }
	1686	+
	1687	+ /**
	1688	+ * Get site option for migration source site domain
	1689	+ *
	1690	+ * @return string
	1691	+ */
	1692	+ public function get_migration_source_site_domain() {
	1693	+ return get_option( 'migration_source_site_domain', '' );
	1694	+ }
	1695	+
	1696	+ /**
1515	1697	* Detect whether a site is WordPress.com Staging Site.
1516	1698	*
1517	1699	* @see class.json-api-site-jetpack.php for implementation.
1518	1700	*/
		@@ -1612,8 +1794,20 @@
1612	1794	return ! empty( get_option( 'wpcom_classic_early_release' ) );
1613	1795	}
1614	1796
1615	1797	/**
	1798	+ * Returns whether APM (Application Performance Monitoring) is enabled for the site.
	1799	+ *
	1800	+ * APM is an Atomic-only hosting feature. Non-Atomic site types (Simple wpcom, real
	1801	+ * Jetpack) return false; Jetpack_Shadow_Site overrides with the actual read.
	1802	+ *
	1803	+ * @return bool
	1804	+ **/
	1805	+ public function get_apm_enabled() {
	1806	+ return false;
	1807	+ }
	1808	+
	1809	+ /**
1616	1810	* Get Zendesk site meta.
1617	1811	*
1618	1812	* @return array|null
1619	1813	*/
		@@ -1624,5 +1818,92 @@
1624	1818	*
1625	1819	* @return bool
1626	1820	*/
1627	1821	abstract public function is_pending_plan();
	1822	+
	1823	+ /**
	1824	+ * Detect whether the site is a Garden site.
	1825	+ *
	1826	+ * @return bool
	1827	+ */
	1828	+ public function is_garden() {
	1829	+ return false;
	1830	+ }
	1831	+
	1832	+ /**
	1833	+ * Get the Garden name.
	1834	+ *
	1835	+ * @return string
	1836	+ */
	1837	+ public function garden_name() {
	1838	+ return null;
	1839	+ }
	1840	+
	1841	+ /**
	1842	+ * Get the Garden partner.
	1843	+ *
	1844	+ * @return string
	1845	+ */
	1846	+ public function garden_partner() {
	1847	+ return null;
	1848	+ }
	1849	+
	1850	+ /**
	1851	+ * Detect whether the Garden site is provisioned.
	1852	+ *
	1853	+ * @return bool|null
	1854	+ */
	1855	+ public function garden_is_provisioned() {
	1856	+ return null;
	1857	+ }
	1858	+
	1859	+ /**
	1860	+ * Detect whether the site is a Flex site.
	1861	+ *
	1862	+ * @return bool
	1863	+ */
	1864	+ public function is_wpcom_flex() {
	1865	+ if ( function_exists( 'has_blog_sticker' ) ) {
	1866	+ return has_blog_sticker( 'flex-cache-site' );
	1867	+ }
	1868	+ return false;
	1869	+ }
	1870	+
	1871	+ /**
	1872	+ * Detect whether Big Sky AI assistant is enabled for this site.
	1873	+ *
	1874	+ * @return bool
	1875	+ */
	1876	+ public function is_big_sky_enabled() {
	1877	+ return false;
	1878	+ }
	1879	+
	1880	+ /**
	1881	+ * Get the state of any block on the site's outgoing email.
	1882	+ *
	1883	+ * @return array|null `status` (`blocked` or `at_risk`), `reason` and `expires_on`,
	1884	+ * or null if the site has never been blocked.
	1885	+ */
	1886	+ public function get_atomic_email_block() {
	1887	+ return null;
	1888	+ }
	1889	+
	1890	+ /**
	1891	+ * Get Jetpack recovery mode status.
	1892	+ *
	1893	+ * @return array|null
	1894	+ */
	1895	+ public function get_jetpack_recovery_mode_status() {
	1896	+ $status = get_option( 'jetpack_recovery_mode_status' );
	1897	+ return is_array( $status ) ? $status : null;
	1898	+ }
	1899	+
	1900	+ /**
	1901	+ * Whether WordPress.com accounts must have two-step authentication to log in through SSO.
	1902	+ *
	1903	+ * @return bool
	1904	+ */
	1905	+ public function get_jetpack_sso_require_two_step() {
	1906	+ /** This filter is documented in projects/packages/connection/src/sso/class-helpers.php */
	1907	+ return (bool) apply_filters( 'jetpack_sso_require_two_step', get_option( 'jetpack_sso_require_two_step', false ) );
	1908	+ }
1628	1909	}