Add setting/settings UI for including WooCommerce products in Fresh Data widgets #13625

Feature Description

When freshData is enabled and the WooCommerce plugin is installed/active (use the same heuristics we use elsewhere in the plugin to detect WooCommerce), we should show a new toggle/boolean setting in Analytics settings that asks the user if they want to include WooCommerce products in the "Recent Activity"/"Latest Content" cards/widgets.

Do not alter or remove anything below. The following sections will be managed by moderators only.

Acceptance criteria

(All changes should require the freshData feature flag to be enabled.)

• Add a new setting to the Analytics module settings "freshDataIncludesWooCommerceProducts". The setting should default to true.
• When Analytics is connected and WooCommerce is connected, there should be a setting UI in Site Kit Settings > Analytics with the label Include products in Recent activity and the subtitle Show your new products alongside your latest posts in "Recent activity"
• The Analytics datastore should have a selector (eg. shouldFreshDataIncludesWooCommerceProducts) that returns true if the "freshDataIncludesWooCommerceProducts" setting is enabled and WooCommerce is installed. If either are no longer true, the setting should return false.
• The Settings UI should not appear when WooCommerce is disconnected.
• Optionally: the check for WooCommerce being installed can move from the "Ads" module to the "core/site" store, given it's relevant to multiple modules. That said: the check is simple (getPluginStatusProperty( 'installed', PLUGINS.WOOCOMMERCE )) so can also be duplicated if desired.

(For context, the shouldFreshDataIncludesWooCommerceProducts() selector will control whether WooCommerce products are fetched alongside WordPress posts for "Fresh Data" cards/widgets in future issues, see #13627.)

Implementation Brief

Ownership and view-only access. The setting is a site-wide display preference, not a connection detail, so it does not go in get_owned_keys() (no ownership-change notice). It must go in get_view_only_keys(), otherwise REST_Modules_Controller strips it for view-only Dashboard Sharing users and the gate would resolve undefined on a shared dashboard.

Because the default is only registered when the flag is on, getting the setting's value returns undefined when the flag is off.

• Update includes/Modules/Analytics_4/Settings.php:
  • Import Google\Site_Kit\Core\Util\Feature_Flags.
  • In get_default(), add 'freshDataIncludesWooCommerceProducts' => true inside a
    if ( Feature_Flags::enabled( 'freshData' ) ) block, following the rrmExpressSetup pattern in includes/Modules/Reader_Revenue_Manager/Settings.php.
  • In get_view_only_keys(), append the same key behind the same flag check.
  • In sanitize_boolean_properties(), add the key to $boolean_properties so a truthy string from the REST payload is cast to a real boolean.
• Update assets/js/modules/analytics-4/datastore/base.js: add 'freshDataIncludesWooCommerceProducts' to settingSlugs (not ownedSettingsSlugs). This generates getFreshDataIncludesWooCommerceProducts() / setFreshDataIncludesWooCommerceProducts() and includes the key in the existing haveSettingsChanged / submitChanges flow, so the toggle saves with the settings form's "Confirm Changes" button — no bespoke save action.
• Migrate isWooCommerceActivated from the "ads" module (

  site-kit-wp/assets/js/modules/ads/datastore/module-data.js

  Lines 178 to 189 in 4984509

  	/**
  	* Determines whether the WooCommerce plugin is activated or not.
  	*
  	* @since 1.148.0
  	*
  	* @param {Object} state Data store's state.
  	* @return {boolean|undefined} True if the plugin is activated, false if it is not, and undefined if data is being resolved.
  	*/
  	isWooCommerceActivated: getPluginStatusProperty(
  	'active',
  	PLUGINS.WOOCOMMERCE
  	),

  ) to core/site.
• Create assets/js/modules/analytics-4/datastore/fresh-data.ts with a single createRegistrySelector-based selector shouldIncludeWooCommerceProducts():
  • returns false immediately when ! isFeatureEnabled( 'freshData' ) (@/js/features);
  • returns undefined while any dependency is unresolved (isWooCommerceActivated(), getFreshDataIncludesWooCommerceProducts(), and isModuleConnected( MODULE_SLUG_ANALYTICS_4 ) from CORE_MODULES), so consumers can wait rather than fetch-then-refetch;
  • otherwise returns analyticsConnected && wooCommerceActive && setting === true. Register it in assets/js/modules/analytics-4/datastore/index.js's combineStores call (alphabetical, between enhancedMeasurement and keyEvents).
• Create
  assets/js/modules/analytics-4/components/settings/SettingsIncludeWooCommerceProductsSwitch.tsx
  — a Switch plus a <p className="googlesitekit-module-settings-group__helper-text"> subtitle, modelled on assets/js/components/conversion-tracking/ConversionTrackingToggle.js. Label: Include products in Recent activity. Subtitle: Show your new products alongside your latest posts in "Recent activity". It renders null unless the freshData flag is on, isWooCommerceInstalled() is true and Analytics is connected; it is disabled while hasModuleAccess === false; it reads and writes the setting only (no direct save). One component per file — do not inline it in SettingsForm.js.
• Update assets/js/modules/analytics-4/components/settings/SettingsForm.js to render the new component after <TrackingExclusionSwitches /> and before the EntityOwnershipChangeNotice.
• Update assets/js/modules/analytics-4/components/settings/SettingsView.js to append { label: 'Include products in Recent activity', status: … } to the existing SettingsStatuses array, spread in only when the flag is on and WooCommerce is installed — the same conditional-spread shape already used for gtgEnabled.
• Add stories so the new row is covered by VRT: a WithWooCommerceProductsToggle story in SettingsForm.stories.js and a matching one in SettingsView.stories.js, both with parameters = { features: [ 'freshData' ] }, a registry seeded via provideSiteInfo( registry, { wooCommerceInstalled: true, wooCommerceActive: true } ), and scenario = {}. Include an off-state story for SettingsView.

Test Coverage

• Extend tests/phpunit/integration/Core/Assets/AssetsTest.php using its existing get_inline_base_data() helper: wooCommerceActive and wooCommerceInstalled are present and false on a site without WooCommerce, and wooCommerceActive is true when a WooCommerce class stub is defined.
• Extend tests/phpunit/integration/Modules/Analytics_4/SettingsTest.php: with freshData enabled (the enable_feature() helper on TestCase), get() returns freshDataIncludesWooCommerceProducts => true by default, the key appears in get_view_only_keys(), and '1' / 0 sanitize to true / false; with the flag off the key is absent from both defaults and view-only keys.
• Add assets/js/modules/analytics-4/datastore/fresh-data.test.js covering the truth table for shouldIncludeWooCommerceProducts(): false with the flag off; undefined while site info or settings are unresolved; true only when flag + Analytics connected + WooCommerce active + setting true; false when each of those is individually flipped; and specifically false when WooCommerce is installed but not active.
• Add SettingsIncludeWooCommerceProductsSwitch.test.js: renders with the exact label and subtitle when flag + WooCommerce installed + Analytics connected; renders nothing when the flag is off, when WooCommerce is not installed, and when Analytics is not connected; still renders when WooCommerce is installed but inactive; clicking dispatches setFreshDataIncludesWooCommerceProducts and flips haveSettingsChanged() to true; the switch is disabled when hasModuleAccess is false. Use the features: [ 'freshData' ] option of the custom render from @tests/js/test-utils.
• Extend SettingsForm.test.js to assert the row is absent by default (no flag) and present under the flag with WooCommerce installed, so the default settings-form snapshot does not shift for non-flagged sites.

QA Brief

• With freshData off (default), open Site Kit → Settings → Analytics in both view and edit mode and confirm nothing has changed.
• Enable freshData (tester plugin or a googlesitekit_is_feature_enabled filter snippet). Without WooCommerce installed, confirm the setting does not appear in either mode.
• Install and activate WooCommerce, reload, and confirm the edit form shows a toggle labelled Include products in Recent activity with the subtitle Show your new products alongside your latest posts in "Recent activity", switched on by default, and that view mode lists the same label with the setting reflecting the saved value.
• In the browser console, run googlesitekit.data.select( 'modules/analytics-4' ).shouldIncludeWooCommerceProducts() and confirm it returns true. Switch the toggle off, click Confirm Changes, reload, confirm it stayed off, and confirm the selector now returns false. Switch it back on and confirm it returns true again.
• Deactivate WooCommerce (leaving it installed) and confirm the settings row still appears in both view and edit mode, while shouldIncludeWooCommerceProducts() returns false. Reactivate and confirm the saved preference is honoured.
• Delete WooCommerce entirely and confirm the row disappears. Disconnect Analytics and confirm it is gone too.
• On a shared dashboard, sign in as a view-only user and confirm shouldIncludeWooCommerceProducts() reflects the owner's saved choice. As an admin without module access, confirm the toggle is shown but disabled.
• The Ads module now reads WooCommerce status from core/site: confirm the Ads setup flow's WooCommerce redirect modal, the Ads setup CTA banner and the "account linked via Google for WooCommerce" notification still behave as before.

Changelog entry

• Add a setting to include WooCommerce products in the "Recent activity" tab.