2 * MB_IN_BYTES ) {
+ return false;
+ }
+
+ $extension = strtolower( pathinfo( $font_path, PATHINFO_EXTENSION ) );
+ $types = array(
+ 'woff' => array( 'mime' => 'font/woff', 'magic' => 'wOFF' ),
+ 'woff2' => array( 'mime' => 'font/woff2', 'magic' => 'wOF2' ),
+ 'ttf' => array( 'mime' => 'font/ttf', 'magic' => "\x00\x01\x00\x00" ),
+ 'otf' => array( 'mime' => 'font/otf', 'magic' => 'OTTO' ),
+ );
+ if ( empty( $types[ $extension ] ) ) {
+ return false;
+ }
+
+ $handle = fopen( $font_path, 'rb' );
+ $magic = $handle ? fread( $handle, 4 ) : false;
+ if ( $handle ) {
+ fclose( $handle );
+ }
+ if ( $types[ $extension ]['magic'] !== $magic ) {
+ return false;
+ }
+
+ return array(
+ 'path' => $font_path,
+ 'mime' => $types[ $extension ]['mime'],
+ 'size' => $size,
+ );
+}
+
+function funkycommerce_normalize_font_face_styles( $styles ) {
+ if ( ! preg_match_all( '/@font-face\s*\{[^{}]*\}/i', $styles, $matches ) ) {
+ return '';
+ }
+
+ $uploads = wp_get_upload_dir();
+ $font_base_url = trailingslashit( $uploads['baseurl'] ) . 'fonts/';
+ $faces = array();
+ foreach ( $matches[0] as $block ) {
+ if ( ! preg_match( '/url\(([\'"]?)([^)\'"]+)\1\)/i', $block, $url_match ) ) {
+ continue;
+ }
+ $url = html_entity_decode( $url_match[2] );
+ if ( 0 !== strpos( $url, $font_base_url ) ) {
+ continue;
+ }
+
+ $relative_path = ltrim( substr( $url, strlen( $font_base_url ) ), '/' );
+ if ( ! funkycommerce_get_valid_font_file( $relative_path ) ) {
+ continue;
+ }
+
+ preg_match( '/font-family\s*:\s*([^;]+)/i', $block, $family_match );
+ preg_match( '/font-style\s*:\s*([^;]+)/i', $block, $style_match );
+ preg_match( '/font-weight\s*:\s*([^;]+)/i', $block, $weight_match );
+ $family = strtolower( trim( $family_match[1] ?? '' ) );
+ $style = strtolower( trim( $style_match[1] ?? 'normal' ) );
+ $weight = strtolower( trim( $weight_match[1] ?? '400' ) );
+ if ( ! $family ) {
+ continue;
+ }
+
+ $key = $family . '|' . $style . '|' . $weight;
+ if ( isset( $faces[ $key ] ) ) {
+ continue;
+ }
+
+ $proxy_url = add_query_arg(
+ array(
+ 'funkycommerce_font' => rawurlencode( $relative_path ),
+ 'funkycommerce_font_v' => '3',
+ ),
+ home_url( '/' )
+ );
+ $normalized = str_replace( $url_match[0], "url('" . esc_url_raw( $proxy_url ) . "')", $block );
+ $normalized = preg_replace( '/font-display\s*:\s*(?:auto|block|fallback|optional|swap)/i', 'font-display:swap', $normalized );
+ $weight_rank = array_search( (int) $weight, array( 400, 700, 600, 500, 800, 300, 200, 100, 900 ), true );
+ $faces[ $key ] = array(
+ 'css' => $normalized,
+ 'priority' => ( 'normal' === $style ? 0 : 20 ) + ( false === $weight_rank ? 10 : $weight_rank ),
+ );
+ }
+
+ uasort(
+ $faces,
+ static fn( $left, $right ) => $left['priority'] <=> $right['priority']
+ );
+ return implode( "\n", array_column( array_slice( $faces, 0, 8 ), 'css' ) );
+}
+
+/**
+ * Capture WordPress' generated font-face rules without printing style markup.
+ *
+ * @param bool $normalize_for_headless Whether to validate and proxy a compact set for the public storefront.
+ */
+function funkycommerce_get_font_face_styles( $normalize_for_headless = true ) {
if ( ! function_exists( 'wp_print_font_faces' ) ) {
return '';
}
@@ -748,21 +1342,7 @@ function funkycommerce_get_font_face_styles() {
}
$styles = implode( "\n", $matches[1] );
- $uploads = wp_get_upload_dir();
- $font_base_url = trailingslashit( $uploads['baseurl'] ) . 'fonts/';
-
- return preg_replace_callback(
- '/url\(([\'"]?)([^)\'"]+)\1\)/i',
- static function ( $match ) use ( $font_base_url ) {
- $url = html_entity_decode( $match[2] );
- if ( 0 !== strpos( $url, $font_base_url ) ) {
- return $match[0];
- }
- $relative_path = ltrim( substr( $url, strlen( $font_base_url ) ), '/' );
- return "url('" . esc_url_raw( add_query_arg( 'funkycommerce_font', rawurlencode( $relative_path ), home_url( '/' ) ) ) . "')";
- },
- $styles
- );
+ return $normalize_for_headless ? funkycommerce_normalize_font_face_styles( $styles ) : $styles;
}
function funkycommerce_serve_headless_font() {
@@ -770,38 +1350,56 @@ function funkycommerce_serve_headless_font() {
return;
}
- $relative_path = rawurldecode( sanitize_text_field( wp_unslash( $_GET['funkycommerce_font'] ) ) );
- if ( ! preg_match( '/^[A-Za-z0-9._-]+\.(woff2?|ttf|otf)$/', $relative_path ) ) {
+ ini_set( 'display_errors', '0' );
+ while ( ob_get_level() > 0 ) {
+ ob_end_clean();
+ }
+
+ header( 'Access-Control-Allow-Origin: *' );
+ header( 'Access-Control-Allow-Methods: GET, HEAD, OPTIONS' );
+ header( 'Cross-Origin-Resource-Policy: cross-origin' );
+ header( 'X-Content-Type-Options: nosniff' );
+
+ $method = strtoupper( (string) ( $_SERVER['REQUEST_METHOD'] ?? 'GET' ) );
+ if ( 'OPTIONS' === $method ) {
+ header( 'Access-Control-Max-Age: 86400' );
+ status_header( 204 );
+ exit;
+ }
+ if ( ! in_array( $method, array( 'GET', 'HEAD' ), true ) ) {
+ header( 'Allow: GET, HEAD, OPTIONS' );
+ status_header( 405 );
+ exit;
+ }
+
+ $version = (string) ( $_GET['funkycommerce_font_v'] ?? '' );
+ if ( ! in_array( $version, array( '2', '3' ), true ) ) {
status_header( 400 );
exit;
}
- $uploads = wp_get_upload_dir();
- $fonts_dir = realpath( trailingslashit( $uploads['basedir'] ) . 'fonts' );
- $font_path = $fonts_dir ? realpath( trailingslashit( $fonts_dir ) . $relative_path ) : false;
- if ( ! $font_path || 0 !== strpos( $font_path, trailingslashit( $fonts_dir ) ) || ! is_readable( $font_path ) ) {
+ $relative_path = rawurldecode( sanitize_text_field( wp_unslash( $_GET['funkycommerce_font'] ) ) );
+ $font = funkycommerce_get_valid_font_file( $relative_path );
+ if ( ! $font ) {
status_header( 404 );
exit;
}
- $extension = strtolower( pathinfo( $font_path, PATHINFO_EXTENSION ) );
- $types = array(
- 'woff' => 'font/woff',
- 'woff2' => 'font/woff2',
- 'ttf' => 'font/ttf',
- 'otf' => 'font/otf',
- );
- header( 'Access-Control-Allow-Origin: *' );
+ $etag = '"' . hash( 'sha256', $relative_path . '|' . filemtime( $font['path'] ) . '|' . $font['size'] ) . '"';
header( 'Cache-Control: public, max-age=31536000, immutable' );
- header( 'Content-Type: ' . $types[ $extension ] );
- header( 'Content-Length: ' . filesize( $font_path ) );
- header( 'X-Content-Type-Options: nosniff' );
- if ( 'HEAD' !== ( $_SERVER['REQUEST_METHOD'] ?? 'GET' ) ) {
- readfile( $font_path );
+ header( 'ETag: ' . $etag );
+ if ( $etag === ( $_SERVER['HTTP_IF_NONE_MATCH'] ?? '' ) ) {
+ status_header( 304 );
+ exit;
+ }
+ header( 'Content-Type: ' . $font['mime'] );
+ header( 'Content-Length: ' . $font['size'] );
+ if ( 'HEAD' !== $method ) {
+ readfile( $font['path'] );
}
exit;
}
-add_action( 'template_redirect', 'funkycommerce_serve_headless_font', 0 );
+add_action( 'template_redirect', 'funkycommerce_serve_headless_font', -10 );
/**
* Return CSS and typed block-theme settings used by headless page content.
@@ -873,9 +1471,9 @@ function funkycommerce_get_headless_theme_styles() {
}
/**
- * Expose configured special pages and their React-safe editor content to WPGraphQL.
+ * Expose React-safe editor content and theme styles to WPGraphQL.
*/
-function funkycommerce_register_special_page_graphql_fields() {
+function funkycommerce_register_headless_content_graphql_fields() {
register_graphql_object_type(
'FunkyCommerceThemeColor',
array(
@@ -956,37 +1554,6 @@ function funkycommerce_register_special_page_graphql_fields() {
)
);
- register_graphql_field(
- 'RootQuery',
- 'funkycommerceSpecialPage',
- array(
- 'type' => 'Page',
- 'description' => __( 'Configured WordPress page backing a special storefront route.', 'funkycommerce-headless' ),
- 'args' => array(
- 'key' => array(
- 'type' => array( 'non_null' => 'String' ),
- ),
- ),
- 'resolve' => function ( $root, $args, $context ) {
- $key = sanitize_key( $args['key'] ?? '' );
- $allowed_keys = array( 'home', 'shop', 'blog', 'cart', 'checkout', 'account' );
-
- if ( ! in_array( $key, $allowed_keys, true ) ) {
- throw new \GraphQL\Error\UserError( __( 'Unknown special storefront page key.', 'funkycommerce-headless' ) );
- }
-
- $page_id = funkycommerce_get_special_page_id( $key );
- $page = $page_id ? get_post( $page_id ) : null;
-
- if ( ! $page || 'page' !== $page->post_type || 'publish' !== $page->post_status ) {
- return null;
- }
-
- return \WPGraphQL\Data\DataSource::resolve_post_object( $page_id, $context );
- },
- )
- );
-
register_graphql_field(
'Page',
'themeStyles',
@@ -1007,6 +1574,45 @@ function funkycommerce_register_special_page_graphql_fields() {
)
);
+ register_graphql_field(
+ 'Post',
+ 'headlessContent',
+ array(
+ 'type' => 'String',
+ 'description' => __( 'Rendered post content with the configured editor-script policy applied.', 'funkycommerce-headless' ),
+ 'resolve' => function ( $post ) {
+ $post_id = funkycommerce_graphql_content_database_id( $post );
+ return $post_id ? funkycommerce_render_headless_content_field( $post_id, 'post_content', 'the_content' ) : '';
+ },
+ )
+ );
+
+ register_graphql_field(
+ 'Product',
+ 'headlessDescription',
+ array(
+ 'type' => 'String',
+ 'description' => __( 'Rendered product description with the configured editor-script policy applied.', 'funkycommerce-headless' ),
+ 'resolve' => function ( $product ) {
+ $product_id = funkycommerce_graphql_content_database_id( $product );
+ return $product_id ? funkycommerce_render_headless_content_field( $product_id, 'post_content', 'the_content' ) : '';
+ },
+ )
+ );
+
+ register_graphql_field(
+ 'Product',
+ 'headlessShortDescription',
+ array(
+ 'type' => 'String',
+ 'description' => __( 'Rendered product short description with the configured editor-script policy applied.', 'funkycommerce-headless' ),
+ 'resolve' => function ( $product ) {
+ $product_id = funkycommerce_graphql_content_database_id( $product );
+ return $product_id ? funkycommerce_render_headless_content_field( $product_id, 'post_excerpt', 'woocommerce_short_description' ) : '';
+ },
+ )
+ );
+
register_graphql_field(
'Page',
'headlessContent',
@@ -1014,7 +1620,7 @@ function funkycommerce_register_special_page_graphql_fields() {
'type' => 'String',
'description' => __( 'Rendered editor content excluding application components already mapped in React.', 'funkycommerce-headless' ),
'resolve' => function ( $page ) {
- $page_id = funkycommerce_graphql_page_database_id( $page );
+ $page_id = funkycommerce_graphql_content_database_id( $page );
return $page_id ? funkycommerce_render_headless_page_content( $page_id ) : '';
},
)
@@ -1027,48 +1633,15 @@ function funkycommerce_register_special_page_graphql_fields() {
'type' => array( 'list_of' => 'String' ),
'description' => __( 'Structural shortcode and block references retained for future backend component mapping.', 'funkycommerce-headless' ),
'resolve' => function ( $page ) {
- $page_id = funkycommerce_graphql_page_database_id( $page );
+ $page_id = funkycommerce_graphql_content_database_id( $page );
$content = $page_id ? (string) get_post_field( 'post_content', $page_id ) : '';
return funkycommerce_extract_headless_references( $content );
},
)
);
- // Reverse lookup: given a Page node, return the special page key if this page is
- // registered as one (handles translated pages too — their source page shares the key).
- register_graphql_field(
- 'Page',
- 'funkycommerceSpecialPageKey',
- array(
- 'type' => 'String',
- 'description' => __( 'The special storefront route key ("shop", "cart", etc.) if this page backs a special route.', 'funkycommerce-headless' ),
- 'resolve' => function ( $page ) {
- $page_id = funkycommerce_graphql_page_database_id( $page );
- $allowed_keys = array( 'home', 'shop', 'blog', 'cart', 'checkout', 'account' );
-
- foreach ( $allowed_keys as $key ) {
- $special_id = funkycommerce_get_special_page_id( $key );
- if ( ! $special_id ) {
- continue;
- }
- // Match the page itself or any of its translations.
- if ( (int) $page_id === $special_id ) {
- return $key;
- }
- // Check Polylang translations.
- if ( function_exists( 'pll_get_post_translations' ) ) {
- $translations = pll_get_post_translations( $special_id );
- if ( in_array( (int) $page_id, array_values( $translations ), true ) ) {
- return $key;
- }
- }
- }
- return null;
- },
- )
- );
}
-add_action( 'graphql_register_types', 'funkycommerce_register_special_page_graphql_fields' );
+add_action( 'graphql_register_types', 'funkycommerce_register_headless_content_graphql_fields' );
/**
* Expose the legacy comment rating meta used by product and editorial reviews.
@@ -1144,10 +1717,6 @@ function funkycommerce_register_create_review_mutation() {
throw new \GraphQL\Error\UserError( __( 'The requested review target is unavailable.', 'funkycommerce-headless' ) );
}
- if ( 'community_post' === $post->post_type && ! is_user_logged_in() ) {
- throw new \GraphQL\Error\UserError( __( 'Sign in to join this community discussion.', 'funkycommerce-headless' ) );
- }
-
if ( ! comments_open( $post_id ) ) {
throw new \GraphQL\Error\UserError( __( 'Comments are closed for this item.', 'funkycommerce-headless' ) );
}
@@ -1156,7 +1725,7 @@ function funkycommerce_register_create_review_mutation() {
throw new \GraphQL\Error\UserError( __( 'A valid name, email, and comment are required.', 'funkycommerce-headless' ) );
}
- if ( 0 === $parent_id && in_array( $post->post_type, array( 'product', 'community_post' ), true ) && ( $rating < 1 || $rating > 5 ) ) {
+ if ( 0 === $parent_id && 'product' === $post->post_type && ( $rating < 1 || $rating > 5 ) ) {
throw new \GraphQL\Error\UserError( __( 'A star rating from 1 to 5 is required.', 'funkycommerce-headless' ) );
}
diff --git a/inc/account.php b/inc/account.php
index 9bcdf9e..35f0b07 100644
--- a/inc/account.php
+++ b/inc/account.php
@@ -52,6 +52,303 @@ function funkycommerce_plain_price( $price_html ) {
);
}
+/**
+ * Move a signed WooCommerce download URL to the WordPress application origin.
+ *
+ * @param string $download_url Signed WooCommerce download URL.
+ * @return string
+ */
+function funkycommerce_backend_download_url( $download_url ) {
+ $query = wp_parse_url( (string) $download_url, PHP_URL_QUERY );
+ if ( ! is_string( $query ) || '' === $query ) {
+ return esc_url_raw( (string) $download_url );
+ }
+
+ return esc_url_raw( trailingslashit( site_url() ) . '?' . $query );
+}
+
+/**
+ * Keep signed WooCommerce download requests on the WordPress application origin.
+ *
+ * @param array $files Download file data.
+ * @return array
+ */
+function funkycommerce_backend_item_download_urls( $files ) {
+ if ( ! is_array( $files ) ) {
+ return $files;
+ }
+
+ foreach ( $files as &$file ) {
+ if ( is_array( $file ) && ! empty( $file['download_url'] ) ) {
+ $file['download_url'] = funkycommerce_backend_download_url( $file['download_url'] );
+ }
+ }
+ unset( $file );
+
+ return $files;
+}
+add_filter( 'woocommerce_get_item_downloads', 'funkycommerce_backend_item_download_urls', 10, 1 );
+
+/**
+ * Whether a WooCommerce download source is hosted outside this WordPress installation.
+ */
+function funkycommerce_download_source_is_external( $file_path ) {
+ $scheme = strtolower( (string) wp_parse_url( (string) $file_path, PHP_URL_SCHEME ) );
+ $host = strtolower( (string) wp_parse_url( (string) $file_path, PHP_URL_HOST ) );
+ $local = strtolower( (string) wp_parse_url( site_url(), PHP_URL_HOST ) );
+ return in_array( $scheme, array( 'http', 'https' ), true ) && '' !== $host && $host !== $local;
+}
+
+/**
+ * Force remote sources through WooCommerce's server-side streaming handler instead
+ * of redirecting the browser to Google Drive or another storage provider.
+ */
+function funkycommerce_force_external_download_proxy( $method, $product_id, $file_path ) {
+ if ( funkycommerce_download_source_is_external( $file_path ) && wp_http_validate_url( $file_path ) ) {
+ return 'force';
+ }
+ return $method;
+}
+add_filter( 'woocommerce_file_download_method', 'funkycommerce_force_external_download_proxy', 20, 3 );
+
+/**
+ * Bound repeated remote fetches per order permission, file, and visitor.
+ */
+function funkycommerce_rate_limit_external_download( $file_path, $email_address, $order, $product, $download ) {
+ if ( ! funkycommerce_download_source_is_external( $file_path ) ) {
+ return $file_path;
+ }
+
+ $window_seconds = max( 10, (int) apply_filters( 'funkycommerce_external_download_rate_window', MINUTE_IN_SECONDS ) );
+ $attempt_limit = max( 1, (int) apply_filters( 'funkycommerce_external_download_rate_limit', 6 ) );
+ $ip_address = class_exists( 'WC_Geolocation' )
+ ? \WC_Geolocation::get_ip_address()
+ : sanitize_text_field( wp_unslash( $_SERVER['REMOTE_ADDR'] ?? '' ) );
+ $order_id = is_object( $download ) && is_callable( array( $download, 'get_order_id' ) )
+ ? absint( $download->get_order_id() )
+ : ( $order instanceof \WC_Order ? $order->get_id() : 0 );
+ $download_id = is_object( $download ) && is_callable( array( $download, 'get_download_id' ) )
+ ? sanitize_text_field( (string) $download->get_download_id() )
+ : '';
+ $key = 'sf_remote_dl_' . md5( implode( '|', array( $order_id, $download_id, $ip_address ) ) );
+ $state = get_transient( $key );
+ $window_started = is_array( $state ) ? absint( $state['started'] ?? 0 ) : 0;
+ $attempts = is_array( $state ) ? absint( $state['attempts'] ?? 0 ) : 0;
+ $now = time();
+
+ if ( ! $window_started || $window_started + $window_seconds <= $now ) {
+ $window_started = $now;
+ $attempts = 0;
+ }
+ if ( $attempts >= $attempt_limit ) {
+ $retry_after = max( 1, $window_started + $window_seconds - $now );
+ header( 'Retry-After: ' . $retry_after );
+ header( 'Cache-Control: no-store, private' );
+ wp_die(
+ esc_html__( 'Too many download attempts. Wait briefly before trying this file again.', 'funkycommerce-headless' ),
+ esc_html__( 'Download temporarily limited', 'funkycommerce-headless' ),
+ array( 'response' => 429 )
+ );
+ }
+
+ set_transient(
+ $key,
+ array(
+ 'started' => $window_started,
+ 'attempts' => $attempts + 1,
+ ),
+ $window_seconds
+ );
+ return $file_path;
+}
+add_filter( 'woocommerce_download_product_filepath', 'funkycommerce_rate_limit_external_download', 20, 5 );
+
+/**
+ * Permit the configured headless storefront to fetch signed WooCommerce files as blobs.
+ */
+function funkycommerce_allow_download_fetch_cors() {
+ if ( empty( $_GET['download_file'] ) || empty( $_GET['order'] ) || empty( $_GET['key'] ) ) {
+ return;
+ }
+
+ $request_origin = esc_url_raw( wp_unslash( $_SERVER['HTTP_ORIGIN'] ?? '' ) );
+ $frontend_url = function_exists( 'funkycommerce_frontend_url' ) ? funkycommerce_frontend_url() : '';
+ $scheme = strtolower( (string) wp_parse_url( $frontend_url, PHP_URL_SCHEME ) );
+ $host = strtolower( (string) wp_parse_url( $frontend_url, PHP_URL_HOST ) );
+ $port = absint( wp_parse_url( $frontend_url, PHP_URL_PORT ) );
+ $allowed_origin = $scheme && $host ? $scheme . '://' . $host . ( $port ? ':' . $port : '' ) : '';
+ if ( ! $request_origin || ! $allowed_origin || ! hash_equals( $allowed_origin, strtolower( untrailingslashit( $request_origin ) ) ) ) {
+ return;
+ }
+
+ header( 'Access-Control-Allow-Origin: ' . $allowed_origin );
+ header( 'Access-Control-Allow-Credentials: true' );
+ header( 'Access-Control-Expose-Headers: Content-Disposition, Content-Length, Content-Type, Retry-After' );
+ header( 'Vary: Origin', false );
+}
+add_action( 'init', 'funkycommerce_allow_download_fetch_cors', 0 );
+
+/**
+ * Return signed WooCommerce downloads for an order without exposing source file paths.
+ */
+function funkycommerce_order_downloads( $order, $guest_access = false ) {
+ if (
+ ! $order instanceof \WC_Order
+ || ! $order->is_download_permitted()
+ || ! $order->has_downloadable_item()
+ ) {
+ return array();
+ }
+
+ return array_map(
+ static function ( $download ) use ( $order, $guest_access ) {
+ $expires = $download['access_expires'] ?? null;
+ if ( $expires instanceof \WC_DateTime || $expires instanceof \DateTimeInterface ) {
+ $expires = $expires->format( DATE_ATOM );
+ } elseif ( is_numeric( $expires ) ) {
+ $expires = gmdate( DATE_ATOM, (int) $expires );
+ } elseif ( ! is_string( $expires ) ) {
+ $expires = '';
+ }
+
+ $remaining = $download['downloads_remaining'] ?? '';
+ $url = funkycommerce_backend_download_url( $download['download_url'] ?? '' );
+ if ( $guest_access && '' !== $url ) {
+ $token_expires = time() + ( 30 * MINUTE_IN_SECONDS );
+ $url = add_query_arg(
+ array(
+ 'sf_guest_expires' => $token_expires,
+ 'sf_guest_token' => funkycommerce_guest_download_signature(
+ $order,
+ absint( $download['product_id'] ?? 0 ),
+ sanitize_text_field( (string) ( $download['download_id'] ?? '' ) ),
+ $token_expires
+ ),
+ ),
+ $url
+ );
+ }
+ return array(
+ 'id' => sanitize_text_field( (string) ( $download['download_id'] ?? '' ) ),
+ 'orderId' => $order->get_id(),
+ 'productId' => absint( $download['product_id'] ?? 0 ),
+ 'productName' => sanitize_text_field( (string) ( $download['product_name'] ?? '' ) ),
+ 'fileName' => sanitize_text_field( (string) ( $download['download_name'] ?? '' ) ),
+ 'url' => $url,
+ 'remaining' => '' === $remaining ? null : max( 0, (int) $remaining ),
+ 'expiresAt' => $expires,
+ );
+ },
+ $order->get_downloadable_items()
+ );
+}
+
+/**
+ * Keep the server-side order confirmation window aligned with the storefront's
+ * seven-day retained order-success credential. The order key and billing email
+ * remain required even when WooCommerce attached a customer during checkout.
+ */
+function funkycommerce_guest_download_access_is_current( $order ) {
+ if ( ! $order instanceof \WC_Order ) {
+ return false;
+ }
+ $approved_at = $order->get_date_completed() ?: $order->get_date_paid() ?: $order->get_date_created();
+ return $approved_at && ( $approved_at->getTimestamp() + ( 7 * DAY_IN_SECONDS ) ) >= time();
+}
+
+/**
+ * Issue an opaque guest access token while storing only its keyed hash.
+ */
+function funkycommerce_issue_guest_download_access_token( $order ) {
+ if ( ! funkycommerce_guest_download_access_is_current( $order ) ) {
+ return '';
+ }
+ $token = wp_generate_password( 64, false, false );
+ $approved_at = $order->get_date_completed() ?: $order->get_date_paid() ?: $order->get_date_created();
+ $expires = $approved_at->getTimestamp() + ( 7 * DAY_IN_SECONDS );
+ $tokens = array_values(
+ array_filter(
+ (array) $order->get_meta( '_funkycommerce_guest_download_tokens', true ),
+ static fn( $entry ) => is_array( $entry ) && absint( $entry['expires'] ?? 0 ) >= time()
+ )
+ );
+ $tokens[] = array(
+ 'hash' => hash_hmac( 'sha256', $token, wp_salt( 'auth' ) ),
+ 'expires' => $expires,
+ );
+ $order->update_meta_data( '_funkycommerce_guest_download_tokens', array_slice( $tokens, -5 ) );
+ $order->save_meta_data();
+ return $token;
+}
+
+/**
+ * Validate an opaque guest access token without exposing order credentials.
+ */
+function funkycommerce_guest_download_access_token_is_valid( $order, $token ) {
+ if ( ! funkycommerce_guest_download_access_is_current( $order ) || '' === $token ) {
+ return false;
+ }
+ $actual = hash_hmac( 'sha256', $token, wp_salt( 'auth' ) );
+ foreach ( (array) $order->get_meta( '_funkycommerce_guest_download_tokens', true ) as $entry ) {
+ $expires = is_array( $entry ) ? absint( $entry['expires'] ?? 0 ) : 0;
+ $stored = is_array( $entry ) ? (string) ( $entry['hash'] ?? '' ) : '';
+ if ( $expires >= time() && '' !== $stored && hash_equals( $stored, $actual ) ) {
+ return true;
+ }
+ }
+ return false;
+}
+
+/**
+ * Bind a short-lived headless guest token to the same order and file permission
+ * that WooCommerce validates on the final download request.
+ */
+function funkycommerce_guest_download_signature( $order, $product_id, $download_id, $expires ) {
+ if ( ! $order instanceof \WC_Order ) {
+ return '';
+ }
+ $payload = implode(
+ '|',
+ array(
+ $order->get_id(),
+ $order->get_order_key(),
+ strtolower( (string) $order->get_billing_email() ),
+ absint( $product_id ),
+ sanitize_text_field( (string) $download_id ),
+ absint( $expires ),
+ )
+ );
+ return hash_hmac( 'sha256', $payload, wp_salt( 'auth' ) );
+}
+
+/**
+ * Disable WooCommerce's account-session check only for a verified, short-lived
+ * headless guest link. WooCommerce still enforces the order key, email hash,
+ * permission record, expiry, and remaining download count.
+ */
+function funkycommerce_allow_signed_guest_download( $pre_option ) {
+ $product_id = isset( $_GET['download_file'] ) ? absint( wp_unslash( $_GET['download_file'] ) ) : 0;
+ $download_id = isset( $_GET['key'] ) ? sanitize_text_field( wp_unslash( $_GET['key'] ) ) : '';
+ $order_key = isset( $_GET['order'] ) ? wc_clean( wp_unslash( $_GET['order'] ) ) : '';
+ $expires = isset( $_GET['sf_guest_expires'] ) ? absint( wp_unslash( $_GET['sf_guest_expires'] ) ) : 0;
+ $token = isset( $_GET['sf_guest_token'] ) ? sanitize_text_field( wp_unslash( $_GET['sf_guest_token'] ) ) : '';
+
+ if ( ! $product_id || '' === $download_id || '' === $order_key || ! $expires || '' === $token ) {
+ return $pre_option;
+ }
+ if ( $expires < time() || $expires > time() + HOUR_IN_SECONDS ) {
+ return $pre_option;
+ }
+ $order_id = wc_get_order_id_by_order_key( $order_key );
+ $order = $order_id ? wc_get_order( $order_id ) : false;
+ if ( ! funkycommerce_guest_download_access_is_current( $order ) ) {
+ return $pre_option;
+ }
+ $expected = funkycommerce_guest_download_signature( $order, $product_id, $download_id, $expires );
+ return '' !== $expected && hash_equals( $expected, $token ) ? 'no' : $pre_option;
+}
+add_filter( 'pre_option_woocommerce_downloads_require_login', 'funkycommerce_allow_signed_guest_download' );
+
function funkycommerce_account_orders( $user_id ) {
if ( ! function_exists( 'wc_get_orders' ) ) {
return array();
@@ -93,6 +390,9 @@ function ( $order ) {
'currency' => $order->get_currency(),
'language' => (string) $order->get_meta( '_funkycommerce_order_language' ),
'items' => $items,
+ 'downloads' => funkycommerce_order_downloads( $order ),
+ 'hasDownloadableItems' => $order->has_downloadable_item(),
+ 'downloadPermitted' => $order->is_download_permitted(),
);
},
$orders
@@ -106,20 +406,20 @@ function funkycommerce_account_payload( $user_id ) {
}
$roles = (array) $user->roles;
$role = in_array( 'collaborator', $roles, true ) ? 'collaborator' : ( in_array( 'creator', $roles, true ) ? 'creator' : 'member' );
- $email_verified = ! is_callable( array( 'Auto_Assign_Guest_Orders', 'is_user_email_verified' ) )
- || Auto_Assign_Guest_Orders::is_user_email_verified( $user_id );
return array(
'databaseId' => $user_id,
'displayName' => $user->display_name,
'firstName' => get_user_meta( $user_id, 'first_name', true ),
'lastName' => get_user_meta( $user_id, 'last_name', true ),
'email' => $user->user_email,
- 'emailVerified' => $email_verified,
+ 'emailVerificationRequired' => funkycommerce_registration_email_verification_required(),
+ 'emailVerified' => funkycommerce_is_registration_email_verified( $user_id ),
'role' => $role,
'profilePublic' => 'private' !== get_user_meta( $user_id, '_community_profile_visibility', true ),
+ 'avatarUrl' => funkycommerce_custom_avatar_url( $user_id ) ?: null,
+ 'avatarAttachmentId' => funkycommerce_custom_avatar_attachment_id( $user_id ) ?: null,
'billingAddress' => funkycommerce_account_address( $user_id, 'billing' ),
'shippingAddress' => funkycommerce_account_address( $user_id, 'shipping' ),
- 'orders' => funkycommerce_account_orders( $user_id ),
);
}
@@ -172,6 +472,21 @@ function funkycommerce_register_account_graphql() {
),
)
);
+ register_graphql_object_type(
+ 'FunkycommerceAccountDownload',
+ array(
+ 'fields' => array(
+ 'id' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'orderId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'productId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'productName' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'fileName' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'url' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'remaining' => array( 'type' => 'Int' ),
+ 'expiresAt' => array( 'type' => 'String' ),
+ ),
+ )
+ );
register_graphql_object_type(
'FunkycommerceAccountOrder',
array(
@@ -185,6 +500,9 @@ function funkycommerce_register_account_graphql() {
'currency' => array( 'type' => array( 'non_null' => 'String' ) ),
'language' => array( 'type' => array( 'non_null' => 'String' ) ),
'items' => array( 'type' => array( 'list_of' => 'FunkycommerceAccountOrderItem' ) ),
+ 'downloads' => array( 'type' => array( 'list_of' => 'FunkycommerceAccountDownload' ) ),
+ 'hasDownloadableItems' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
+ 'downloadPermitted' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
),
)
);
@@ -197,12 +515,18 @@ function funkycommerce_register_account_graphql() {
'firstName' => array( 'type' => 'String' ),
'lastName' => array( 'type' => 'String' ),
'email' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'emailVerificationRequired' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
'emailVerified' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
'role' => array( 'type' => array( 'non_null' => 'String' ) ),
'profilePublic' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
+ 'avatarUrl' => array( 'type' => 'String' ),
+ 'avatarAttachmentId' => array( 'type' => 'Int' ),
'billingAddress' => array( 'type' => 'FunkycommerceAccountAddress' ),
'shippingAddress' => array( 'type' => 'FunkycommerceAccountAddress' ),
- 'orders' => array( 'type' => array( 'list_of' => 'FunkycommerceAccountOrder' ) ),
+ 'orders' => array(
+ 'type' => array( 'list_of' => 'FunkycommerceAccountOrder' ),
+ 'resolve' => fn( $account ) => funkycommerce_account_orders( (int) ( $account['databaseId'] ?? 0 ) ),
+ ),
),
)
);
@@ -256,10 +580,61 @@ function funkycommerce_register_account_graphql() {
'currency' => $order->get_currency(),
'language' => (string) $order->get_meta( '_funkycommerce_order_language' ),
'items' => $items,
+ 'downloads' => funkycommerce_order_downloads( $order ),
+ 'hasDownloadableItems' => $order->has_downloadable_item(),
+ 'downloadPermitted' => $order->is_download_permitted(),
);
},
)
);
+ register_graphql_mutation(
+ 'resendFunkycommerceEmailVerification',
+ array(
+ 'inputFields' => array(),
+ 'outputFields' => array(
+ 'status' => array( 'type' => array( 'non_null' => 'String' ) ),
+ ),
+ 'mutateAndGetPayload' => function () {
+ $user_id = funkycommerce_require_account_user();
+ return array( 'status' => funkycommerce_send_registration_email_verification( $user_id ) );
+ },
+ )
+ );
+ register_graphql_mutation(
+ 'updateFunkycommerceAccountEmail',
+ array(
+ 'inputFields' => array(
+ 'email' => array( 'type' => array( 'non_null' => 'String' ) ),
+ ),
+ 'outputFields' => array(
+ 'account' => array( 'type' => 'FunkycommerceAccount' ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ $user_id = funkycommerce_require_account_user();
+ $email = sanitize_email( (string) ( $input['email'] ?? '' ) );
+ if ( ! is_email( $email ) ) {
+ throw new \GraphQL\Error\UserError( __( 'Enter a valid email address.', 'funkycommerce-headless' ) );
+ }
+
+ $existing_user_id = email_exists( $email );
+ if ( $existing_user_id && (int) $existing_user_id !== $user_id ) {
+ throw new \GraphQL\Error\UserError( __( 'That email address is already in use.', 'funkycommerce-headless' ) );
+ }
+
+ $result = wp_update_user(
+ array(
+ 'ID' => $user_id,
+ 'user_email' => $email,
+ )
+ );
+ if ( is_wp_error( $result ) ) {
+ throw new \GraphQL\Error\UserError( $result->get_error_message() );
+ }
+
+ return array( 'account' => funkycommerce_account_payload( $user_id ) );
+ },
+ )
+ );
register_graphql_mutation(
'updateFunkycommerceAddress',
array(
@@ -345,3 +720,108 @@ function funkycommerce_register_account_graphql() {
);
}
add_action( 'graphql_register_types', 'funkycommerce_register_account_graphql' );
+
+/**
+ * Allow an order owner to retrieve signed download links for the digital success page.
+ */
+function funkycommerce_order_downloads_rest( \WP_REST_Request $request ) {
+ $order = wc_get_order( (int) $request['id'] );
+ if ( ! $order instanceof \WC_Order ) {
+ return new \WP_Error( 'funkycommerce_order_not_found', __( 'Order not found.', 'funkycommerce-headless' ), array( 'status' => 404 ) );
+ }
+
+ $user_id = function_exists( 'funkycommerce_graphql_login_user_id' ) ? funkycommerce_graphql_login_user_id() : get_current_user_id();
+ $account_access = $user_id && (int) $order->get_customer_id() === (int) $user_id;
+ $order_key = sanitize_text_field( (string) $request->get_param( 'key' ) );
+ $email = sanitize_email( (string) $request->get_param( 'email' ) );
+ $access_token = sanitize_text_field( (string) $request->get_param( 'access_token' ) );
+ $opaque_access = funkycommerce_guest_download_access_token_is_valid( $order, $access_token );
+ $credential_access = funkycommerce_guest_download_access_is_current( $order )
+ && '' !== $order_key
+ && '' !== $email
+ && hash_equals( (string) $order->get_order_key(), $order_key )
+ && hash_equals( strtolower( (string) $order->get_billing_email() ), strtolower( $email ) );
+ $guest_access = $opaque_access || $credential_access;
+
+ if ( ! $account_access && ! $guest_access ) {
+ return new \WP_Error(
+ 'funkycommerce_download_forbidden',
+ __( 'The download credentials are invalid or expired.', 'funkycommerce-headless' ),
+ array( 'status' => 403 )
+ );
+ }
+
+ $response = new \WP_REST_Response(
+ array(
+ 'order_id' => $order->get_id(),
+ 'downloads' => funkycommerce_order_downloads( $order, $guest_access ),
+ 'has_downloadable_items' => $order->has_downloadable_item(),
+ 'download_permitted' => $order->is_download_permitted(),
+ )
+ );
+ $response->header( 'Cache-Control', 'no-store, private' );
+ return $response;
+}
+
+function funkycommerce_register_order_downloads_rest() {
+ register_rest_route(
+ 'funkycommerce/v1',
+ '/orders/(?P
\d+)/downloads',
+ array(
+ 'methods' => \WP_REST_Server::READABLE,
+ 'callback' => 'funkycommerce_order_downloads_rest',
+ 'permission_callback' => '__return_true',
+ 'args' => array(
+ 'id' => array( 'required' => true, 'sanitize_callback' => 'absint' ),
+ 'key' => array( 'sanitize_callback' => 'sanitize_text_field' ),
+ 'email' => array( 'sanitize_callback' => 'sanitize_email' ),
+ 'access_token' => array( 'sanitize_callback' => 'sanitize_text_field' ),
+ ),
+ )
+ );
+}
+add_action( 'rest_api_init', 'funkycommerce_register_order_downloads_rest' );
+
+/**
+ * Add a headless download-library link to WooCommerce customer emails.
+ */
+function funkycommerce_downloads_email_access( $order, $sent_to_admin, $plain_text ) {
+ if (
+ $sent_to_admin
+ || ! $order instanceof \WC_Order
+ || ! $order->has_downloadable_item()
+ || ! $order->is_download_permitted()
+ ) {
+ return;
+ }
+
+ if ( $order->get_customer_id() ) {
+ $url = funkycommerce_frontend_url( 'account#downloads' );
+ $label = __( 'Access your downloads in your account', 'funkycommerce-headless' );
+ } else {
+ $access_token = funkycommerce_issue_guest_download_access_token( $order );
+ if ( '' === $access_token ) {
+ return;
+ }
+ $url = add_query_arg(
+ array(
+ 'order_id' => $order->get_id(),
+ 'access_token' => $access_token,
+ ),
+ funkycommerce_frontend_url( 'order-success/digital' )
+ );
+ $label = __( 'Access your order downloads', 'funkycommerce-headless' );
+ }
+
+ if ( $plain_text ) {
+ echo "\n" . esc_html( $label ) . ': ' . esc_url( $url ) . "\n";
+ return;
+ }
+
+ printf(
+ '%2$s
',
+ esc_url( $url ),
+ esc_html( $label )
+ );
+}
+add_action( 'woocommerce_email_after_order_table', 'funkycommerce_downloads_email_access', 20, 3 );
diff --git a/inc/admin-theme.php b/inc/admin-theme.php
new file mode 100644
index 0000000..7ab9568
--- /dev/null
+++ b/inc/admin-theme.php
@@ -0,0 +1,495 @@
+ $background,
+ 'text' => $text,
+ 'accent' => $accent,
+ 'button_text' => $button_text,
+ 'heading' => $heading,
+ 'body_font' => $body_font,
+ 'heading_font' => $heading_font,
+ 'button_font' => $button_font,
+ 'colors' => $colors,
+ 'fonts' => $fonts,
+ );
+}
+
+/**
+ * Build CSS custom properties shared by wp-admin and the editor canvas.
+ */
+function funkycommerce_get_admin_theme_variables_css( $tokens ) {
+ $declarations = array(
+ '--funky-admin-background:' . $tokens['background'],
+ '--funky-admin-text:' . $tokens['text'],
+ '--funky-admin-accent:' . $tokens['accent'],
+ '--funky-admin-accent-text:' . $tokens['button_text'],
+ '--funky-admin-heading:' . $tokens['heading'],
+ '--funky-admin-body-font:' . $tokens['body_font'],
+ '--funky-admin-heading-font:' . $tokens['heading_font'],
+ '--funky-admin-button-font:' . $tokens['button_font'],
+ );
+
+ foreach ( $tokens['colors'] as $slug => $color ) {
+ $declarations[] = '--wp--preset--color--' . $slug . ':' . $color;
+ }
+ foreach ( $tokens['fonts'] as $slug => $font ) {
+ $declarations[] = '--wp--preset--font-family--' . $slug . ':' . $font;
+ }
+
+ return ':root{' . implode( ';', $declarations ) . '}';
+}
+
+/**
+ * Generate the scoped wp-admin theme.
+ */
+function funkycommerce_get_admin_theme_css() {
+ $tokens = funkycommerce_get_admin_theme_tokens();
+ $variables = funkycommerce_get_admin_theme_variables_css( $tokens );
+ $font_faces = function_exists( 'funkycommerce_get_font_face_styles' ) ? funkycommerce_get_font_face_styles( false ) : '';
+
+ return $font_faces . $variables . '
+body.wp-admin{
+ --funky-admin-surface:var(--funky-admin-background);
+ --funky-admin-surface-raised:var(--funky-admin-background);
+ --funky-admin-border:var(--funky-admin-text);
+ --funky-admin-muted:var(--funky-admin-text);
+ --funky-admin-accent-soft:var(--funky-admin-background);
+ background:var(--funky-admin-surface)!important;
+ color:var(--funky-admin-text)!important;
+ font-family:var(--funky-admin-body-font)!important;
+}
+@supports (color:color-mix(in srgb,#000 50%,#fff)){
+ body.wp-admin{
+ --funky-admin-surface:color-mix(in srgb,var(--funky-admin-background) 96%,var(--funky-admin-text) 4%);
+ --funky-admin-surface-raised:color-mix(in srgb,var(--funky-admin-background) 99%,var(--funky-admin-text) 1%);
+ --funky-admin-border:color-mix(in srgb,var(--funky-admin-text) 18%,transparent);
+ --funky-admin-muted:color-mix(in srgb,var(--funky-admin-text) 68%,var(--funky-admin-background));
+ --funky-admin-accent-soft:color-mix(in srgb,var(--funky-admin-accent) 14%,var(--funky-admin-background));
+ }
+}
+body.wp-admin :where(button,input,select,textarea){font-family:var(--funky-admin-body-font)!important}
+body.wp-admin :where(.wrap h1,.wrap h2,.wrap h3,.wrap h4,.wrap h5,.wrap h6,.editor-post-title__input,.components-modal__header-heading){
+ color:var(--funky-admin-heading)!important;
+ font-family:var(--funky-admin-heading-font)!important;
+}
+body.wp-admin :where(a,.button-link,.components-button.is-link){color:var(--funky-admin-accent)!important}
+body.wp-admin :where(a,.button,.components-button,input,select,textarea):focus{
+ border-color:var(--funky-admin-accent)!important;
+ box-shadow:0 0 0 1px var(--funky-admin-accent)!important;
+ outline-color:var(--funky-admin-accent)!important;
+}
+body.wp-admin #wpadminbar,
+body.wp-admin #adminmenuback,
+body.wp-admin #adminmenuwrap,
+body.wp-admin #adminmenu{
+ background:var(--funky-admin-text)!important;
+ color:var(--funky-admin-background)!important;
+ font-family:var(--funky-admin-body-font)!important;
+}
+body.wp-admin #wpadminbar :where(.ab-item,.ab-label,.display-name,.username,.ab-empty-item),
+body.wp-admin #wpadminbar :where(input,select,textarea){
+ font-family:var(--funky-admin-body-font)!important;
+}
+body.wp-admin #wpadminbar :where(.ab-item,.ab-label),
+body.wp-admin #adminmenu :where(a,.wp-menu-image:before){
+ color:var(--funky-admin-background)!important;
+}
+body.wp-admin #adminmenu :where(a:hover,.wp-has-current-submenu>a.menu-top,.current a.menu-top,.wp-menu-open>a.menu-top),
+body.wp-admin #adminmenu .wp-submenu a:focus,
+body.wp-admin #adminmenu .wp-submenu a:hover,
+body.wp-admin #wpadminbar .ab-top-menu>li.hover>.ab-item,
+body.wp-admin #wpadminbar.nojq .quicklinks .ab-top-menu>li>.ab-item:focus,
+body.wp-admin #wpadminbar:not(.mobile) .ab-top-menu>li:hover>.ab-item{
+ background:var(--funky-admin-accent)!important;
+ color:var(--funky-admin-accent-text)!important;
+}
+body.wp-admin #adminmenu .wp-submenu,
+body.wp-admin #adminmenu .wp-has-current-submenu .wp-submenu,
+body.wp-admin #wpadminbar .menupop .ab-sub-wrapper{
+ background:var(--funky-admin-text)!important;
+}
+body.wp-admin #adminmenu .wp-menu-arrow,
+body.wp-admin #adminmenu .wp-menu-arrow div{background:var(--funky-admin-accent)!important}
+body.wp-admin :where(.postbox,.stuffbox,.card,.notice,.welcome-panel,.plugin-card,.theme,.components-panel,.components-popover__content,.components-modal__frame){
+ background-color:var(--funky-admin-surface-raised)!important;
+ border-color:var(--funky-admin-border)!important;
+ color:var(--funky-admin-text)!important;
+}
+body.wp-admin :where(.alternate,.striped>tbody>:nth-child(odd),ul.striped>:nth-child(odd)){
+ background-color:var(--funky-admin-accent-soft)!important;
+}
+body.wp-admin :where(.widefat,.wp-list-table){
+ background-color:var(--funky-admin-surface-raised)!important;
+ border-color:var(--funky-admin-border)!important;
+ color:var(--funky-admin-text)!important;
+}
+body.wp-admin :where(.widefat thead td,.widefat thead th,.widefat tfoot td,.widefat tfoot th){
+ background-color:var(--funky-admin-accent-soft)!important;
+ border-color:var(--funky-admin-border)!important;
+ color:var(--funky-admin-heading)!important;
+}
+body.wp-admin :where(input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea){
+ background-color:var(--funky-admin-background)!important;
+ border-color:var(--funky-admin-border)!important;
+ color:var(--funky-admin-text)!important;
+}
+body.wp-admin .wp-core-ui .button-primary,
+body.wp-admin .components-button.is-primary{
+ background:var(--funky-admin-accent)!important;
+ border-color:var(--funky-admin-accent)!important;
+ color:var(--funky-admin-accent-text)!important;
+ font-family:var(--funky-admin-button-font)!important;
+}
+body.wp-admin .wp-core-ui .button-primary:hover,
+body.wp-admin .wp-core-ui .button-primary:focus,
+body.wp-admin .components-button.is-primary:hover,
+body.wp-admin .components-button.is-primary:focus{
+ background:var(--funky-admin-accent)!important;
+ border-color:var(--funky-admin-accent)!important;
+ color:var(--funky-admin-accent-text)!important;
+}
+@supports (color:color-mix(in srgb,#000 50%,#fff)){
+ body.wp-admin #adminmenu .wp-submenu,
+ body.wp-admin #adminmenu .wp-has-current-submenu .wp-submenu,
+ body.wp-admin #wpadminbar .menupop .ab-sub-wrapper{
+ background:color-mix(in srgb,var(--funky-admin-text) 92%,var(--funky-admin-background))!important;
+ }
+ body.wp-admin .wp-core-ui .button-primary:hover,
+ body.wp-admin .wp-core-ui .button-primary:focus,
+ body.wp-admin .components-button.is-primary:hover,
+ body.wp-admin .components-button.is-primary:focus{
+ background:color-mix(in srgb,var(--funky-admin-accent) 84%,var(--funky-admin-text))!important;
+ border-color:color-mix(in srgb,var(--funky-admin-accent) 84%,var(--funky-admin-text))!important;
+ }
+}
+body.wp-admin :where(input[type=checkbox]:checked,input[type=radio]:checked)::before{color:var(--funky-admin-accent)!important}
+body.wp-admin :where(.interface-interface-skeleton__header,.interface-interface-skeleton__sidebar,.edit-post-layout__metaboxes,.editor-header){
+ background:var(--funky-admin-surface-raised)!important;
+ color:var(--funky-admin-text)!important;
+}
+body.wp-admin #screen-meta{
+ background-color:var(--funky-admin-surface-raised)!important;
+ border-color:var(--funky-admin-border)!important;
+ color:var(--funky-admin-text)!important;
+}
+body.wp-admin #screen-meta-links{display:block!important}
+body.wp-admin #screen-meta-links .screen-meta-toggle{
+ display:block!important;
+ font-family:var(--funky-admin-body-font)!important;
+}
+body.wp-admin #screen-meta-links .show-settings{
+ background:var(--funky-admin-surface-raised)!important;
+ border-color:var(--funky-admin-border)!important;
+ color:var(--funky-admin-text)!important;
+ font-family:var(--funky-admin-body-font)!important;
+}
+body.wp-admin #screen-meta-links .show-settings:focus{
+ border-color:var(--funky-admin-accent)!important;
+ box-shadow:0 0 0 1px var(--funky-admin-accent)!important;
+}
+/* WordPress clones these hidden templates into the active list table. */
+body.wp-admin.edit-php #inlineedit{display:none!important}
+body.wp-admin :where(.row-actions span.delete a,.row-actions span.trash a,.row-actions span.spam a,.submitbox .submitdelete){
+ color:#b32d2e!important;
+}
+body.wp-admin :where(.description,.howto,.subsubsub,.row-actions,.components-base-control__help){color:var(--funky-admin-muted)!important}
+';
+}
+
+/**
+ * Load the generated theme throughout wp-admin.
+ */
+function funkycommerce_enqueue_admin_theme() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : (array) get_option( 'funkycommerce_control_center', array() );
+ if ( 'yes' !== ( $settings['admin_block_theme_styles'] ?? 'no' ) ) {
+ return;
+ }
+
+ wp_enqueue_style( 'colors' );
+ wp_add_inline_style( 'colors', funkycommerce_get_admin_theme_css() );
+}
+add_action( 'admin_enqueue_scripts', 'funkycommerce_enqueue_admin_theme', PHP_INT_MAX );
+
+/**
+ * Add the same selected colors and fonts to iframe-based block editor canvases.
+ */
+function funkycommerce_add_block_editor_theme_styles( $editor_settings ) {
+ $tokens = funkycommerce_get_admin_theme_tokens();
+ $variables = funkycommerce_get_admin_theme_variables_css( $tokens );
+ $editor_css = $variables . '
+:where(body){
+ background-color:var(--funky-admin-background);
+ color:var(--funky-admin-text);
+ font-family:var(--funky-admin-body-font);
+}
+:where(h1,h2,h3,h4,h5,h6){
+ color:var(--funky-admin-heading);
+ font-family:var(--funky-admin-heading-font);
+}
+:where(a){color:var(--funky-admin-accent)}
+:where(button,input[type=button],input[type=submit],.wp-element-button,.wp-block-button__link){
+ font-family:var(--funky-admin-button-font);
+}';
+
+ if ( ! isset( $editor_settings['styles'] ) || ! is_array( $editor_settings['styles'] ) ) {
+ $editor_settings['styles'] = array();
+ }
+ $editor_settings['styles'][] = array(
+ 'css' => $editor_css,
+ '__unstableType' => 'theme',
+ );
+
+ return $editor_settings;
+}
+add_filter( 'block_editor_settings_all', 'funkycommerce_add_block_editor_theme_styles' );
+
+/**
+ * Add a language selector to the native Code block and serialize a standard
+ * language class for frontend syntax highlighting.
+ */
+function funkycommerce_enqueue_code_block_language_control() {
+ $handle = 'funkycommerce-code-block-language';
+ wp_register_script(
+ $handle,
+ false,
+ array( 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-compose', 'wp-element', 'wp-hooks', 'wp-i18n' ),
+ FUNKYCOMMERCE_HEADLESS_VERSION,
+ true
+ );
+ wp_enqueue_script( $handle );
+ wp_add_inline_script(
+ $handle,
+ <<<'JS'
+(function (wp) {
+ if (!wp || !wp.blocks || !wp.hooks || !wp.blockEditor) return;
+ var el = wp.element.createElement;
+ var Fragment = wp.element.Fragment;
+ var languages = [
+ { label: wp.i18n.__('Plain text', 'funkycommerce'), value: '' },
+ { label: 'Bash / Shell', value: 'bash' },
+ { label: 'CSS', value: 'css' },
+ { label: 'HTML / XML', value: 'markup' },
+ { label: 'JavaScript', value: 'javascript' },
+ { label: 'JSON', value: 'json' },
+ { label: 'JSX', value: 'jsx' },
+ { label: 'PHP', value: 'php' },
+ { label: 'Python', value: 'python' },
+ { label: 'SQL', value: 'sql' },
+ { label: 'TypeScript', value: 'typescript' },
+ { label: 'TSX', value: 'tsx' }
+ ];
+ var themes = [
+ { label: wp.i18n.__('Auto (site theme)', 'funkycommerce'), value: 'auto' },
+ { label: 'One Light', value: 'one-light' },
+ { label: 'One Dark', value: 'one-dark' },
+ { label: 'Dracula', value: 'dracula' },
+ { label: 'Duotone Light', value: 'duotone-light' },
+ { label: 'Duotone Dark', value: 'duotone-dark' },
+ { label: 'Prism Default', value: 'prism' },
+ { label: 'Prism Coy', value: 'coy' },
+ { label: 'Prism Dark', value: 'dark' },
+ { label: 'Prism Funky', value: 'funky' },
+ { label: 'Prism Okaidia', value: 'okaidia' },
+ { label: 'Prism Solarized Light', value: 'solarized-light' },
+ { label: 'Prism Tomorrow Night', value: 'tomorrow' },
+ { label: 'Prism Twilight', value: 'twilight' }
+ ];
+
+ wp.hooks.addFilter('blocks.registerBlockType', 'funkycommerce/code-language-attribute', function (settings, name) {
+ if (name !== 'core/code') return settings;
+ return Object.assign({}, settings, {
+ attributes: Object.assign({}, settings.attributes, {
+ language: {
+ type: 'string',
+ source: 'attribute',
+ selector: 'pre',
+ attribute: 'data-code-language',
+ default: ''
+ },
+ theme: {
+ type: 'string',
+ source: 'attribute',
+ selector: 'pre',
+ attribute: 'data-code-theme',
+ default: 'auto'
+ }
+ })
+ });
+ });
+
+ var withLanguageControl = wp.compose.createHigherOrderComponent(function (BlockEdit) {
+ return function (props) {
+ if (props.name !== 'core/code') return el(BlockEdit, props);
+ return el(Fragment, null,
+ el(BlockEdit, props),
+ el(wp.blockEditor.InspectorControls, null,
+ el(wp.components.PanelBody, {
+ title: wp.i18n.__('Code highlighting', 'funkycommerce'),
+ initialOpen: true
+ }, el(wp.components.SelectControl, {
+ label: wp.i18n.__('Language', 'funkycommerce'),
+ value: props.attributes.language || '',
+ options: languages,
+ onChange: function (language) {
+ props.setAttributes({ language: language });
+ }
+ }), el(wp.components.SelectControl, {
+ label: wp.i18n.__('Color theme', 'funkycommerce'),
+ value: props.attributes.theme || 'auto',
+ options: themes,
+ onChange: function (theme) {
+ props.setAttributes({ theme: theme });
+ }
+ }))
+ )
+ );
+ };
+ }, 'withFunkycommerceCodeLanguageControl');
+ wp.hooks.addFilter('editor.BlockEdit', 'funkycommerce/code-language-control', withLanguageControl);
+
+ wp.hooks.addFilter('blocks.getSaveContent.extraProps', 'funkycommerce/code-language-markup', function (extraProps, blockType, attributes) {
+ if (blockType.name !== 'core/code') return extraProps;
+ var classNames = (extraProps.className || '').split(/\s+/).filter(function (name) {
+ return name && name.indexOf('language-') !== 0;
+ });
+ if (attributes.language) classNames.push('language-' + attributes.language);
+ var nextProps = Object.assign({}, extraProps, { className: classNames.join(' ') });
+ if (attributes.language) nextProps['data-code-language'] = attributes.language;
+ if (attributes.theme && attributes.theme !== 'auto') nextProps['data-code-theme'] = attributes.theme;
+ return nextProps;
+ });
+}(window.wp));
+JS
+ );
+}
+add_action( 'enqueue_block_editor_assets', 'funkycommerce_enqueue_code_block_language_control' );
diff --git a/inc/admin-view-links.php b/inc/admin-view-links.php
new file mode 100644
index 0000000..cad88eb
--- /dev/null
+++ b/inc/admin-view-links.php
@@ -0,0 +1,85 @@
+post_name );
+ if ( ! $slug ) {
+ return '';
+ }
+
+ if ( 'post' === $post->post_type ) {
+ $path = 'blog/' . $slug;
+ } elseif ( 'product' === $post->post_type ) {
+ $path = 'shop/' . $slug;
+ } elseif ( 'community_post' === $post->post_type ) {
+ $path = 'community_post/' . $slug;
+ } elseif ( 'page' === $post->post_type ) {
+ $page_uri = get_page_uri( $post );
+ $path = implode( '/', array_map( 'rawurlencode', array_filter( explode( '/', $page_uri ) ) ) );
+ } else {
+ return '';
+ }
+
+ if ( function_exists( 'pll_get_post_language' ) ) {
+ $language = sanitize_key( (string) pll_get_post_language( $post->ID, 'slug' ) );
+ $default = function_exists( 'pll_default_language' ) ? sanitize_key( (string) pll_default_language( 'slug' ) ) : '';
+ if ( $language && $language !== $default ) {
+ $path = $language . '/' . $path;
+ }
+ }
+
+ return $path;
+}
+
+/**
+ * Resolve a post's frontend URL, falling back to the native permalink.
+ *
+ * @param int $post_id Post database ID.
+ * @return string
+ */
+function funkycommerce_frontend_post_url( $post_id ) {
+ $post = get_post( $post_id );
+ if ( ! $post instanceof WP_Post || 'publish' !== $post->post_status ) {
+ return get_permalink( $post_id );
+ }
+ $path = funkycommerce_frontend_post_path( $post );
+ if ( ! $path ) {
+ return get_permalink( $post );
+ }
+ $url = funkycommerce_frontend_url( $path );
+ return wp_http_validate_url( $url ) ? $url : get_permalink( $post );
+}
+
+/**
+ * Replace only the archive row's View action.
+ *
+ * @param array $actions Existing row actions.
+ * @param WP_Post $post Current post.
+ * @return array
+ */
+function funkycommerce_frontend_row_actions( $actions, $post ) {
+ if ( isset( $actions['view'] ) ) {
+ $actions['view'] = sprintf(
+ '%2$s',
+ esc_url( funkycommerce_frontend_post_url( $post->ID ) ),
+ esc_html__( 'View', 'funkycommerce-headless' )
+ );
+ }
+ return $actions;
+}
+add_filter( 'post_row_actions', 'funkycommerce_frontend_row_actions', 10, 2 );
+add_filter( 'page_row_actions', 'funkycommerce_frontend_row_actions', 10, 2 );
diff --git a/inc/artifact-invalidation.php b/inc/artifact-invalidation.php
new file mode 100644
index 0000000..0c885cb
--- /dev/null
+++ b/inc/artifact-invalidation.php
@@ -0,0 +1,472 @@
+get_error_code() );
+ return;
+ }
+ if ( ! wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_FLUSH_EVENT ) ) {
+ wp_schedule_single_event( time() + 30, FUNKYCOMMERCE_ARTIFACT_FLUSH_EVENT );
+ }
+}
+
+/**
+ * Convert a public URL to a canonical route dependency.
+ *
+ * @param string $url Public URL.
+ * @return string|null
+ */
+function funkycommerce_artifact_route_dependency( $url ) {
+ $path = wp_parse_url( $url, PHP_URL_PATH );
+ $route = funkycommerce_normalize_artifact_route( is_string( $path ) ? $path : '' );
+ return null === $route ? null : 'route:' . $route;
+}
+
+/**
+ * Return typed dependencies for a public post.
+ *
+ * @param WP_Post $post Post object.
+ * @return array
+ */
+function funkycommerce_artifact_post_dependencies( $post ) {
+ $post_type = sanitize_key( $post->post_type );
+ $kind = 'page' === $post_type ? 'page' : ( in_array( $post_type, array( 'product', 'product_variation' ), true ) ? 'product' : 'post' );
+ $post_id = (int) $post->ID;
+ if ( 'product_variation' === $post_type && 0 < (int) $post->post_parent ) {
+ $post_id = (int) $post->post_parent;
+ $post_type = 'product';
+ }
+ $dependencies = array(
+ $kind . ':' . $post_id,
+ 'archive:' . $post_type,
+ 'sitemap:public',
+ );
+ if ( 0 < (int) $post->post_author ) {
+ $dependencies[] = 'author:' . (int) $post->post_author;
+ }
+ if ( 'product' === $post_type ) {
+ $dependencies[] = 'archive:shop';
+ }
+ $route = funkycommerce_artifact_route_dependency( get_permalink( $post_id ) );
+ if ( null !== $route ) {
+ $dependencies[] = $route;
+ }
+ foreach ( get_object_taxonomies( $post_type ) as $taxonomy ) {
+ $term_ids = wp_get_object_terms( $post_id, $taxonomy, array( 'fields' => 'ids' ) );
+ if ( is_wp_error( $term_ids ) ) {
+ continue;
+ }
+ foreach ( $term_ids as $term_id ) {
+ $dependencies[] = 'term:' . sanitize_key( $taxonomy ) . ':' . (int) $term_id;
+ }
+ $dependencies[] = 'archive:' . sanitize_key( $taxonomy );
+ }
+ return array_values( array_unique( $dependencies ) );
+}
+
+/**
+ * Collect public post and product changes.
+ *
+ * @param int $post_id Post ID.
+ * @param WP_Post $post Post object.
+ * @return void
+ */
+function funkycommerce_collect_post_change( $post_id, $post ) {
+ if ( wp_is_post_revision( $post_id ) || wp_is_post_autosave( $post_id ) || ! $post instanceof WP_Post ) {
+ return;
+ }
+ $public_post = $post;
+ if ( 'product_variation' === $post->post_type && 0 < (int) $post->post_parent ) {
+ $parent = get_post( (int) $post->post_parent );
+ if ( $parent instanceof WP_Post ) {
+ $public_post = $parent;
+ }
+ }
+ $post_type = get_post_type_object( $public_post->post_type );
+ if ( ! $post_type || ! $post_type->public ) {
+ return;
+ }
+ funkycommerce_collect_artifact_changes( funkycommerce_artifact_post_dependencies( $public_post ), 'post_changed' );
+}
+add_action( 'save_post', 'funkycommerce_collect_post_change', 30, 2 );
+add_action( 'deleted_post', 'funkycommerce_collect_post_change', 30, 2 );
+
+/**
+ * Collect publish-state transitions including unpublishing.
+ *
+ * @param string $new_status New status.
+ * @param string $old_status Old status.
+ * @param WP_Post $post Post object.
+ * @return void
+ */
+function funkycommerce_collect_post_status_change( $new_status, $old_status, $post ) {
+ if ( $new_status === $old_status || ( 'publish' !== $new_status && 'publish' !== $old_status ) ) {
+ return;
+ }
+ funkycommerce_collect_post_change( $post->ID, $post );
+}
+add_action( 'transition_post_status', 'funkycommerce_collect_post_status_change', 30, 3 );
+
+/**
+ * Collect WooCommerce changes which may not result in a normal post save.
+ *
+ * @param int $product_id Product or variation ID.
+ * @return void
+ */
+function funkycommerce_collect_product_change( $product_id ) {
+ $post = get_post( (int) $product_id );
+ if ( $post instanceof WP_Post ) {
+ funkycommerce_collect_post_change( $post->ID, $post );
+ }
+}
+add_action( 'woocommerce_update_product', 'funkycommerce_collect_product_change', 20 );
+add_action( 'woocommerce_product_set_stock', static function( $product ) {
+ if ( is_object( $product ) && is_callable( array( $product, 'get_id' ) ) ) {
+ funkycommerce_collect_product_change( $product->get_id() );
+ }
+}, 20 );
+add_action( 'woocommerce_variation_set_stock', static function( $product ) {
+ if ( is_object( $product ) && is_callable( array( $product, 'get_id' ) ) ) {
+ funkycommerce_collect_product_change( $product->get_id() );
+ }
+}, 20 );
+
+/**
+ * Collect taxonomy and archive changes.
+ *
+ * @param int $term_id Term ID.
+ * @param int $tt_id Term-taxonomy ID.
+ * @param string $taxonomy Taxonomy.
+ * @return void
+ */
+function funkycommerce_collect_term_change( $term_id, $tt_id = 0, $taxonomy = '' ) {
+ unset( $tt_id );
+ $taxonomy = sanitize_key( $taxonomy );
+ if ( '' === $taxonomy ) {
+ $term = get_term( (int) $term_id );
+ if ( $term instanceof WP_Term ) {
+ $taxonomy = sanitize_key( $term->taxonomy );
+ }
+ }
+ if ( '' === $taxonomy ) {
+ return;
+ }
+ funkycommerce_collect_artifact_changes(
+ array(
+ 'term:' . $taxonomy . ':' . (int) $term_id,
+ 'archive:' . $taxonomy,
+ 'sitemap:public',
+ ),
+ 'term_changed'
+ );
+}
+add_action( 'created_term', 'funkycommerce_collect_term_change', 30, 3 );
+add_action( 'edited_term', 'funkycommerce_collect_term_change', 30, 3 );
+add_action( 'delete_term', 'funkycommerce_collect_term_change', 30, 3 );
+
+/**
+ * Collect public author/profile changes.
+ *
+ * @param int $user_id User ID.
+ * @return void
+ */
+function funkycommerce_collect_author_change( $user_id ) {
+ funkycommerce_collect_artifact_changes(
+ array(
+ 'author:' . (int) $user_id,
+ 'archive:authors',
+ 'sitemap:public',
+ ),
+ 'author_changed'
+ );
+}
+add_action( 'profile_update', 'funkycommerce_collect_author_change', 30 );
+add_action( 'user_register', 'funkycommerce_collect_author_change', 30 );
+add_action( 'deleted_user', 'funkycommerce_collect_author_change', 30 );
+
+/**
+ * Collect navigation changes.
+ *
+ * @param int $menu_id Menu term ID.
+ * @return void
+ */
+function funkycommerce_collect_menu_change( $menu_id ) {
+ if ( $menu_id instanceof WP_Term ) {
+ $menu_id = $menu_id->term_id;
+ }
+ funkycommerce_collect_artifact_changes(
+ array(
+ 'menu:' . (int) $menu_id,
+ 'menu:global',
+ ),
+ 'menu_changed'
+ );
+}
+add_action( 'wp_update_nav_menu', 'funkycommerce_collect_menu_change', 30 );
+add_action( 'wp_delete_nav_menu', 'funkycommerce_collect_menu_change', 30 );
+
+/**
+ * Collect public Control Center configuration changes while ignoring operations-only fields.
+ *
+ * @param mixed $old_value Previous settings.
+ * @param mixed $new_value New settings.
+ * @return void
+ */
+function funkycommerce_collect_control_center_change( $old_value, $new_value ) {
+ $old_value = is_array( $old_value ) ? $old_value : array();
+ $new_value = is_array( $new_value ) ? $new_value : array();
+ $ignored = array(
+ 'artifact_mode',
+ 'artifact_site_key',
+ 'artifact_signing_secret',
+ 'artifact_cache_ttl',
+ 'artifact_retention_days',
+ 'build_webhook_url',
+ 'build_badge_id',
+ 'periodic_rebuild',
+ 'rebuild_interval',
+ );
+ $changed_keys = array();
+ foreach ( array_unique( array_merge( array_keys( $old_value ), array_keys( $new_value ) ) ) as $key ) {
+ if ( ! in_array( $key, $ignored, true ) && ( $old_value[ $key ] ?? null ) !== ( $new_value[ $key ] ?? null ) ) {
+ $changed_keys[] = $key;
+ }
+ }
+ if ( empty( $changed_keys ) ) {
+ return;
+ }
+ funkycommerce_collect_artifact_changes(
+ array(
+ 'config:storefront',
+ 'theme:global',
+ 'sitemap:public',
+ ),
+ 'storefront_config_changed'
+ );
+}
+add_action( 'update_option_funkycommerce_control_center', 'funkycommerce_collect_control_center_change', 30, 2 );
+
+/**
+ * Collect global theme/style changes.
+ *
+ * @return void
+ */
+function funkycommerce_collect_theme_change() {
+ funkycommerce_collect_artifact_changes(
+ array(
+ 'theme:global',
+ 'config:storefront',
+ ),
+ 'theme_changed'
+ );
+}
+add_action( 'customize_save_after', 'funkycommerce_collect_theme_change', 30 );
+add_action( 'wp_update_custom_css_post', 'funkycommerce_collect_theme_change', 30 );
+add_action( 'save_post_wp_global_styles', 'funkycommerce_collect_theme_change', 30 );
+add_action( 'update_option_theme_mods_' . get_option( 'stylesheet' ), 'funkycommerce_collect_theme_change', 30 );
+
+/**
+ * Flush the debounce window and wake the bounded worker.
+ *
+ * @return void
+ */
+function funkycommerce_flush_artifact_changes() {
+ if ( ! funkycommerce_artifact_invalidation_enabled() ) {
+ return;
+ }
+ $flushed = FunkyCommerce_Artifact_Store::flush_changes();
+ if ( is_wp_error( $flushed ) ) {
+ error_log( 'FunkyCommerce artifact invalidation failed: ' . $flushed->get_error_code() );
+ wp_schedule_single_event( time() + MINUTE_IN_SECONDS, FUNKYCOMMERCE_ARTIFACT_FLUSH_EVENT );
+ return;
+ }
+ if ( 0 < $flushed['affected'] && has_filter( 'funkycommerce_generate_route_artifact' ) && ! wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_WORK_EVENT ) ) {
+ wp_schedule_single_event( time() + 1, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ }
+ do_action( 'funkycommerce_artifact_changes_flushed', $flushed );
+}
+add_action( FUNKYCOMMERCE_ARTIFACT_FLUSH_EVENT, 'funkycommerce_flush_artifact_changes' );
+
+/**
+ * Process a bounded regeneration batch through the renderer contract.
+ *
+ * @return void
+ */
+function funkycommerce_process_artifact_jobs() {
+ if ( ! funkycommerce_artifact_invalidation_enabled() || ! has_filter( 'funkycommerce_generate_route_artifact' ) ) {
+ return;
+ }
+ $lease_key = 'queue-worker:' . funkycommerce_artifact_site_key();
+ $lease = FunkyCommerce_Artifact_Store::acquire_lease( $lease_key, 'queue-worker', 120 );
+ if ( is_wp_error( $lease ) ) {
+ if ( 'artifact_lease_conflict' !== $lease->get_error_code() ) {
+ error_log( 'FunkyCommerce artifact worker lease failed: ' . $lease->get_error_code() );
+ }
+ if ( ! wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_WORK_EVENT ) ) {
+ wp_schedule_single_event( time() + MINUTE_IN_SECONDS, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ }
+ return;
+ }
+
+ try {
+ $jobs = FunkyCommerce_Artifact_Store::claim_regeneration_jobs( 1 );
+ if ( is_wp_error( $jobs ) ) {
+ error_log( 'FunkyCommerce artifact queue failed: ' . $jobs->get_error_code() );
+ wp_schedule_single_event( time() + MINUTE_IN_SECONDS, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ return;
+ }
+ foreach ( $jobs as $job ) {
+ FunkyCommerce_Artifact_Store::record_worker_trace( $job['route_path'], 'claimed', (int) $job['target_revision'] );
+ $identity = array(
+ 'siteKey' => funkycommerce_artifact_site_key(),
+ 'locale' => $job['locale'],
+ 'route' => $job['route_path'],
+ 'shellVersion' => $job['shell_version'],
+ 'variant' => $job['variant'],
+ );
+ $current_time_limit = (int) ini_get( 'max_execution_time' );
+ if ( 0 < $current_time_limit && function_exists( 'set_time_limit' ) && false === set_time_limit( max( 60, $current_time_limit ) ) ) {
+ error_log( 'FunkyCommerce artifact worker could not refresh its execution budget.' );
+ }
+ $artifact = apply_filters( 'funkycommerce_generate_route_artifact', null, $identity, (int) $job['target_revision'] );
+ FunkyCommerce_Artifact_Store::record_worker_trace( $job['route_path'], 'rendered', (int) $job['target_revision'] );
+ if ( is_wp_error( $artifact ) || ! is_array( $artifact ) ) {
+ $error_code = is_wp_error( $artifact ) ? $artifact->get_error_code() : 'artifact_renderer_unavailable';
+ FunkyCommerce_Artifact_Store::fail_regeneration_job( $job['id'], $job['claim_token'], $job['target_revision'], $error_code );
+ continue;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $job['route_path'], 'storing', (int) $job['target_revision'] );
+ $stored = FunkyCommerce_Artifact_Store::put_artifact( $artifact );
+ FunkyCommerce_Artifact_Store::record_worker_trace( $job['route_path'], 'stored', (int) $job['target_revision'] );
+ if ( is_wp_error( $stored ) || 'failed' === ( $artifact['state'] ?? null ) ) {
+ $error_code = is_wp_error( $stored )
+ ? $stored->get_error_code()
+ : sanitize_key( (string) ( $artifact['failure']['code'] ?? 'artifact_generation_failed' ) );
+ FunkyCommerce_Artifact_Store::fail_regeneration_job( $job['id'], $job['claim_token'], $job['target_revision'], $error_code );
+ continue;
+ }
+ FunkyCommerce_Artifact_Store::complete_regeneration_job( $job['id'], $job['claim_token'], $stored['sourceRevision'] );
+ FunkyCommerce_Artifact_Store::record_worker_trace( $job['route_path'], 'completed', (int) $job['target_revision'] );
+ }
+
+ $due = FunkyCommerce_Artifact_Store::has_due_regeneration_jobs();
+ if ( is_wp_error( $due ) ) {
+ error_log( 'FunkyCommerce artifact queue check failed: ' . $due->get_error_code() );
+ wp_schedule_single_event( time() + MINUTE_IN_SECONDS, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ return;
+ }
+ if ( $due && ! wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_WORK_EVENT ) ) {
+ wp_schedule_single_event( time() + 1, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ }
+ } finally {
+ FunkyCommerce_Artifact_Store::release_lease( $lease_key, $lease );
+ }
+}
+add_action( FUNKYCOMMERCE_ARTIFACT_WORK_EVENT, 'funkycommerce_process_artifact_jobs' );
+
+/**
+ * Keep retryable queue work moving after its backoff window.
+ *
+ * @return void
+ */
+function funkycommerce_ensure_artifact_worker() {
+ if ( ! funkycommerce_artifact_invalidation_enabled() || ! has_filter( 'funkycommerce_generate_route_artifact' ) || wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_WORK_EVENT ) ) {
+ return;
+ }
+ $due = FunkyCommerce_Artifact_Store::has_due_regeneration_jobs();
+ if ( is_wp_error( $due ) ) {
+ error_log( 'FunkyCommerce artifact queue check failed: ' . $due->get_error_code() );
+ return;
+ }
+ if ( $due ) {
+ wp_schedule_single_event( time() + MINUTE_IN_SECONDS, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ }
+}
+add_action( 'init', 'funkycommerce_ensure_artifact_worker', 40 );
+
+/**
+ * Add the bounded reconciliation interval.
+ *
+ * @param array $schedules Cron schedules.
+ * @return array
+ */
+function funkycommerce_artifact_cron_schedules( $schedules ) {
+ $schedules['funkycommerce_artifact_reconcile'] = array(
+ 'interval' => 5 * MINUTE_IN_SECONDS,
+ 'display' => __( 'Every five minutes', 'funkycommerce-headless' ),
+ );
+ return $schedules;
+}
+add_filter( 'cron_schedules', 'funkycommerce_artifact_cron_schedules' );
+
+/**
+ * Restore the periodic revision reconciliation event when artifact mode is active.
+ *
+ * @return void
+ */
+function funkycommerce_ensure_artifact_reconciliation() {
+ $scheduled = wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_RECONCILE_EVENT );
+ if ( ! funkycommerce_artifact_invalidation_enabled() ) {
+ if ( $scheduled ) {
+ wp_unschedule_event( $scheduled, FUNKYCOMMERCE_ARTIFACT_RECONCILE_EVENT );
+ }
+ return;
+ }
+ if ( ! $scheduled ) {
+ wp_schedule_event( time() + ( 5 * MINUTE_IN_SECONDS ), 'funkycommerce_artifact_reconcile', FUNKYCOMMERCE_ARTIFACT_RECONCILE_EVENT );
+ }
+}
+add_action( 'init', 'funkycommerce_ensure_artifact_reconciliation', 40 );
+
+/**
+ * Reconcile the latest dependency revision and wake any due route jobs.
+ *
+ * @return void
+ */
+function funkycommerce_reconcile_artifact_revision() {
+ if ( ! funkycommerce_artifact_invalidation_enabled() ) {
+ return;
+ }
+ $reconciled = FunkyCommerce_Artifact_Store::reconcile_revision();
+ if ( is_wp_error( $reconciled ) ) {
+ error_log( 'FunkyCommerce artifact reconciliation failed: ' . $reconciled->get_error_code() );
+ return;
+ }
+ if ( 0 < $reconciled['affected'] && has_filter( 'funkycommerce_generate_route_artifact' ) && ! wp_next_scheduled( FUNKYCOMMERCE_ARTIFACT_WORK_EVENT ) ) {
+ wp_schedule_single_event( time() + 1, FUNKYCOMMERCE_ARTIFACT_WORK_EVENT );
+ }
+}
+add_action( FUNKYCOMMERCE_ARTIFACT_RECONCILE_EVENT, 'funkycommerce_reconcile_artifact_revision' );
diff --git a/inc/artifact-protocol.php b/inc/artifact-protocol.php
new file mode 100644
index 0000000..7e87d36
--- /dev/null
+++ b/inc/artifact-protocol.php
@@ -0,0 +1,680 @@
+ $path,
+ 'status' => 400,
+ )
+ );
+}
+
+/**
+ * Return the configured artifact site key.
+ *
+ * The hostname fallback is stable for existing installations, while explicit
+ * configuration remains required before artifact delivery can be enabled.
+ *
+ * @return string
+ */
+function funkycommerce_artifact_site_key() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : (array) get_option( 'funkycommerce_control_center', array() );
+ $configured = sanitize_title( (string) ( $settings['artifact_site_key'] ?? '' ) );
+ if ( preg_match( '/^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/', $configured ) ) {
+ return $configured;
+ }
+
+ $host = (string) wp_parse_url( home_url( '/' ), PHP_URL_HOST );
+ $key = sanitize_title( $host . '-' . get_current_blog_id() );
+ return substr( $key, 0, 64 );
+}
+
+/**
+ * Return the current artifact rollout mode.
+ *
+ * @return string
+ */
+function funkycommerce_artifact_mode() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : (array) get_option( 'funkycommerce_control_center', array() );
+ $mode = sanitize_key( (string) ( $settings['artifact_mode'] ?? 'build-webhook' ) );
+ return in_array( $mode, array( 'build-webhook', 'shadow', 'artifact' ), true ) ? $mode : 'build-webhook';
+}
+
+/**
+ * Return the shared-cache TTL.
+ *
+ * @return int
+ */
+function funkycommerce_artifact_cache_ttl() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : (array) get_option( 'funkycommerce_control_center', array() );
+ return min( 3600, max( 0, (int) ( $settings['artifact_cache_ttl'] ?? 60 ) ) );
+}
+
+/**
+ * Return the artifact retention window.
+ *
+ * @return int
+ */
+function funkycommerce_artifact_retention_days() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : (array) get_option( 'funkycommerce_control_center', array() );
+ return min( 365, max( 1, (int) ( $settings['artifact_retention_days'] ?? 30 ) ) );
+}
+
+/**
+ * Return the artifact signing secret without exposing it through public settings.
+ *
+ * @return string
+ */
+function funkycommerce_artifact_signing_secret() {
+ if ( defined( 'FUNKYCOMMERCE_ARTIFACT_SIGNING_SECRET' ) ) {
+ return trim( (string) FUNKYCOMMERCE_ARTIFACT_SIGNING_SECRET );
+ }
+ return trim( (string) get_option( 'funkycommerce_artifact_signing_secret', '' ) );
+}
+
+/**
+ * Normalize a canonical public route.
+ *
+ * @param mixed $route Route value.
+ * @return string|null
+ */
+function funkycommerce_normalize_artifact_route( $route ) {
+ if ( ! is_string( $route ) || '' === $route || '/' !== $route[0] || 0 === strpos( $route, '//' ) ) {
+ return null;
+ }
+ if ( false !== strpos( $route, '\\' ) || false !== strpbrk( $route, "?#\r\n\t\0" ) ) {
+ return null;
+ }
+ if ( preg_match( '/%(?![0-9A-Fa-f]{2})/', $route ) ) {
+ return null;
+ }
+
+ $segments = explode( '/', $route );
+ $encoded = array();
+ foreach ( $segments as $segment ) {
+ $decoded = rawurldecode( $segment );
+ if ( '.' === $decoded || '..' === $decoded || false !== strpos( $decoded, '\\' ) || preg_match( '/[\x00-\x1F\x7F]/', $decoded ) ) {
+ return null;
+ }
+ $encoded[] = rawurlencode( $decoded );
+ }
+
+ $normalized = preg_replace( '#/+#', '/', implode( '/', $encoded ) );
+ $normalized = '/' === $normalized ? '/' : untrailingslashit( $normalized );
+ return $normalized ?: '/';
+}
+
+/**
+ * Whether a dependency tag follows protocol v1.
+ *
+ * @param mixed $tag Dependency tag.
+ * @return bool
+ */
+function funkycommerce_is_artifact_dependency_tag( $tag ) {
+ if ( ! is_string( $tag ) || strlen( $tag ) > 256 || preg_match( '/[\x00-\x20\x7F]/', $tag ) ) {
+ return false;
+ }
+ $separator = strpos( $tag, ':' );
+ if ( false === $separator || 0 === $separator ) {
+ return false;
+ }
+ $kind = substr( $tag, 0, $separator );
+ $identifier = substr( $tag, $separator + 1 );
+ $kinds = array(
+ 'archive',
+ 'author',
+ 'community',
+ 'config',
+ 'media',
+ 'menu',
+ 'page',
+ 'post',
+ 'product',
+ 'redirect',
+ 'route',
+ 'site',
+ 'sitemap',
+ 'term',
+ 'theme',
+ 'translation',
+ );
+ if ( ! in_array( $kind, $kinds, true ) || '' === $identifier ) {
+ return false;
+ }
+ if ( 'route' === $kind ) {
+ return funkycommerce_normalize_artifact_route( $identifier ) === $identifier;
+ }
+ $part_pattern = '/^[A-Za-z0-9][A-Za-z0-9._-]{0,190}$/';
+ if ( 'term' === $kind ) {
+ $parts = explode( ':', $identifier );
+ return 2 === count( $parts ) && preg_match( $part_pattern, $parts[0] ) && preg_match( $part_pattern, $parts[1] );
+ }
+ return (bool) preg_match( $part_pattern, $identifier );
+}
+
+/**
+ * Validate unique dependency tags.
+ *
+ * @param mixed $dependencies Dependencies.
+ * @param string $path Wire path.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_artifact_dependencies( $dependencies, $path = 'dependencies' ) {
+ if ( ! is_array( $dependencies ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_dependencies', 'Expected an array of dependency tags.', $path );
+ }
+ $seen = array();
+ foreach ( $dependencies as $index => $dependency ) {
+ if ( ! funkycommerce_is_artifact_dependency_tag( $dependency ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_dependency', 'Invalid dependency tag.', $path . '[' . $index . ']' );
+ }
+ if ( isset( $seen[ $dependency ] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_duplicate_dependency', 'Duplicate dependency tag.', $path . '[' . $index . ']' );
+ }
+ $seen[ $dependency ] = true;
+ }
+ return true;
+}
+
+/**
+ * Validate a protocol timestamp.
+ *
+ * @param mixed $value Timestamp.
+ * @return bool
+ */
+function funkycommerce_is_artifact_timestamp( $value ) {
+ return is_string( $value ) && preg_match( '/^\d{4}-\d{2}-\d{2}T/', $value ) && false !== strtotime( $value );
+}
+
+/**
+ * Validate an HTTPS URL without credentials.
+ *
+ * @param mixed $value URL.
+ * @return bool
+ */
+function funkycommerce_is_artifact_https_url( $value ) {
+ if ( ! is_string( $value ) || '' === $value ) {
+ return false;
+ }
+ $parts = wp_parse_url( $value );
+ return is_array( $parts )
+ && 'https' === ( $parts['scheme'] ?? '' )
+ && ! empty( $parts['host'] )
+ && empty( $parts['user'] )
+ && empty( $parts['pass'] );
+}
+
+/**
+ * Normalize the bounded artifact locale contract.
+ *
+ * @param mixed $locale Locale candidate.
+ * @return string|null
+ */
+function funkycommerce_normalize_artifact_locale( $locale ) {
+ if ( ! is_string( $locale ) ) {
+ return null;
+ }
+ $parts = explode( '-', str_replace( '_', '-', trim( $locale ) ) );
+ if ( 1 === count( $parts ) && preg_match( '/^[a-z]{2,3}$/i', $parts[0] ) ) {
+ return strtolower( $parts[0] );
+ }
+ if (
+ 2 === count( $parts )
+ && preg_match( '/^[a-z]{2,3}$/i', $parts[0] )
+ && preg_match( '/^[a-z]{2}$/i', $parts[1] )
+ ) {
+ return strtolower( $parts[0] ) . '-' . strtoupper( $parts[1] );
+ }
+ return null;
+}
+
+/**
+ * Validate an artifact identity.
+ *
+ * @param mixed $identity Identity object.
+ * @param string $path Wire path.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_artifact_identity( $identity, $path = 'identity' ) {
+ if ( ! is_array( $identity ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_identity', 'Expected an artifact identity object.', $path );
+ }
+ if ( ! is_string( $identity['siteKey'] ?? null ) || ! preg_match( '/^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/', $identity['siteKey'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_site_key', 'Expected a lowercase site key.', $path . '.siteKey' );
+ }
+ if (
+ ! is_string( $identity['locale'] ?? null )
+ || funkycommerce_normalize_artifact_locale( $identity['locale'] ) !== $identity['locale']
+ ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_locale', 'Expected a normalized locale.', $path . '.locale' );
+ }
+ $route = $identity['route'] ?? null;
+ if ( funkycommerce_normalize_artifact_route( $route ) !== $route ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_route', 'Expected a normalized public route.', $path . '.route' );
+ }
+ if ( ! is_string( $identity['shellVersion'] ?? null ) || ! preg_match( '/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/', $identity['shellVersion'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_shell_version', 'Expected a bounded shell version.', $path . '.shellVersion' );
+ }
+ if ( 'public' !== ( $identity['variant'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_variant', 'Only the public artifact variant is supported.', $path . '.variant' );
+ }
+ return true;
+}
+
+/**
+ * Create the canonical identity key used by TypeScript and PHP.
+ *
+ * @param array $identity Valid identity.
+ * @return string|WP_Error
+ */
+function funkycommerce_artifact_identity_key( $identity ) {
+ $valid = funkycommerce_validate_artifact_identity( $identity );
+ if ( is_wp_error( $valid ) ) {
+ return $valid;
+ }
+ return implode(
+ '|',
+ array_map(
+ 'rawurlencode',
+ array(
+ $identity['siteKey'],
+ $identity['locale'],
+ $identity['shellVersion'],
+ $identity['variant'],
+ $identity['route'],
+ )
+ )
+ );
+}
+
+/**
+ * Validate a shell registration payload.
+ *
+ * @param mixed $shell Shell payload.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_shell_manifest( $shell ) {
+ if ( ! is_array( $shell ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_shell', 'Expected a shell manifest object.' );
+ }
+ if ( FUNKYCOMMERCE_SHELL_SCHEMA_VERSION !== ( $shell['schemaVersion'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_unknown_shell_schema', 'Unsupported shell schema version.', 'schemaVersion' );
+ }
+ if ( FUNKYCOMMERCE_ARTIFACT_SCHEMA_VERSION !== ( $shell['artifactSchemaVersion'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_unknown_artifact_schema', 'Unsupported artifact schema version.', 'artifactSchemaVersion' );
+ }
+ if ( ! is_string( $shell['siteKey'] ?? null ) || ! preg_match( '/^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/', $shell['siteKey'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_site_key', 'Expected a lowercase site key.', 'siteKey' );
+ }
+ if ( ! is_string( $shell['shellVersion'] ?? null ) || ! preg_match( '/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/', $shell['shellVersion'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_shell_version', 'Expected a bounded shell version.', 'shellVersion' );
+ }
+ if ( ! funkycommerce_is_artifact_timestamp( $shell['builtAt'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_timestamp', 'Expected an ISO timestamp.', 'builtAt' );
+ }
+ if ( ! preg_match( '/^sha256:[a-f0-9]{64}$/', (string) ( $shell['contentHash'] ?? '' ) ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hash', 'Expected a lowercase sha256 content hash.', 'contentHash' );
+ }
+ $template = $shell['template'] ?? null;
+ if ( ! is_string( $template ) || '' === $template ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_template', 'Expected a shell HTML template.', 'template' );
+ }
+ foreach ( array( 'head', 'css', 'content', 'payload' ) as $slot ) {
+ if ( 1 !== substr_count( $template, '' ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_template_slot', 'Expected each shell insertion slot exactly once.', 'template' );
+ }
+ }
+ if ( ! is_array( $shell['assets'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_assets', 'Expected a shell asset array.', 'assets' );
+ }
+ foreach ( $shell['assets'] as $index => $asset ) {
+ if ( ! is_array( $asset ) || ! in_array( $asset['kind'] ?? null, array( 'script', 'style', 'modulepreload', 'asset' ), true ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_asset', 'Unsupported shell asset.', 'assets[' . $index . ']' );
+ }
+ $url = $asset['url'] ?? null;
+ if ( ! is_string( $url ) || ( 0 !== strpos( $url, '/' ) && ! funkycommerce_is_artifact_https_url( $url ) ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_asset_url', 'Expected a root-relative or HTTPS asset URL.', 'assets[' . $index . '].url' );
+ }
+ if ( isset( $asset['crossOrigin'] ) && ! in_array( $asset['crossOrigin'], array( 'anonymous', 'use-credentials' ), true ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_cross_origin', 'Unsupported cross-origin mode.', 'assets[' . $index . '].crossOrigin' );
+ }
+ }
+ if ( isset( $shell['seedRoutes'] ) ) {
+ if ( ! is_array( $shell['seedRoutes'] ) || count( $shell['seedRoutes'] ) > 10000 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_seed_routes', 'Expected at most 10000 seed routes.', 'seedRoutes' );
+ }
+ $seen = array();
+ foreach ( $shell['seedRoutes'] as $index => $seed ) {
+ $path = 'seedRoutes[' . $index . ']';
+ if ( ! is_array( $seed ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_seed_route', 'Expected a seed route object.', $path );
+ }
+ $route = $seed['route'] ?? null;
+ if ( funkycommerce_normalize_artifact_route( $route ) !== $route ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_seed_route', 'Expected a normalized public route.', $path . '.route' );
+ }
+ if (
+ ! is_string( $seed['locale'] ?? null )
+ || funkycommerce_normalize_artifact_locale( $seed['locale'] ) !== $seed['locale']
+ ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_seed_locale', 'Expected a normalized locale.', $path . '.locale' );
+ }
+ $key = $seed['locale'] . '|' . $route;
+ if ( isset( $seen[ $key ] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_duplicate_seed_route', 'Duplicate seed route identity.', $path );
+ }
+ $seen[ $key ] = true;
+ }
+ }
+ return true;
+}
+
+/**
+ * Validate artifact SEO metadata.
+ *
+ * @param mixed $seo SEO object.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_artifact_seo( $seo ) {
+ if ( ! is_array( $seo ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_seo', 'Expected SEO metadata.', 'seo' );
+ }
+ foreach ( array( 'title', 'description', 'robots' ) as $field ) {
+ if ( ! is_string( $seo[ $field ] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_seo', 'Expected SEO strings.', 'seo.' . $field );
+ }
+ }
+ if ( ! funkycommerce_is_artifact_https_url( $seo['canonicalUrl'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_canonical', 'Expected a credential-free HTTPS canonical URL.', 'seo.canonicalUrl' );
+ }
+ if ( ! is_array( $seo['structuredData'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_structured_data', 'Expected a structured-data array.', 'seo.structuredData' );
+ }
+ return true;
+}
+
+/**
+ * Validate artifact hydration data.
+ *
+ * @param mixed $hydration Hydration payload.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_artifact_hydration( $hydration ) {
+ if ( ! is_array( $hydration ) || FUNKYCOMMERCE_HYDRATION_SCHEMA_VERSION !== ( $hydration['schemaVersion'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration', 'Unsupported hydration payload.', 'hydration.schemaVersion' );
+ }
+ if ( ! is_string( $hydration['shellVersion'] ?? null ) || ! preg_match( '/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/', $hydration['shellVersion'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration_shell', 'Expected a bounded shell version.', 'hydration.shellVersion' );
+ }
+ if ( ! is_int( $hydration['contentRevision'] ?? null ) || $hydration['contentRevision'] < 0 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration_revision', 'Expected a non-negative hydration revision.', 'hydration.contentRevision' );
+ }
+ foreach ( array( 'generatedAt', 'expiresAt' ) as $field ) {
+ if ( ! funkycommerce_is_artifact_timestamp( $hydration[ $field ] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration_timestamp', 'Expected an ISO timestamp.', 'hydration.' . $field );
+ }
+ }
+ if ( strtotime( $hydration['expiresAt'] ) < strtotime( $hydration['generatedAt'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration_expiry', 'Hydration expiration cannot precede generation.', 'hydration.expiresAt' );
+ }
+ if ( ! is_array( $hydration['entries'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration_entries', 'Expected hydration seed entries.', 'hydration.entries' );
+ }
+ $keys = array();
+ foreach ( $hydration['entries'] as $index => $entry ) {
+ $path = 'hydration.entries[' . $index . ']';
+ if ( ! is_array( $entry ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hydration_entry', 'Expected a hydration seed entry.', $path );
+ }
+ $cache_key = $entry['cacheKey'] ?? null;
+ if ( ! is_string( $cache_key ) || '' === trim( $cache_key ) || strlen( $cache_key ) > 256 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_cache_key', 'Expected a bounded cache key.', $path . '.cacheKey' );
+ }
+ if ( isset( $keys[ $cache_key ] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_duplicate_cache_key', 'Duplicate hydration cache key.', $path . '.cacheKey' );
+ }
+ if ( ! array_key_exists( 'value', $entry ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_missing_seed_value', 'Expected a JSON seed value.', $path . '.value' );
+ }
+ $dependencies_valid = funkycommerce_validate_artifact_dependencies( $entry['dependencies'] ?? null, $path . '.dependencies' );
+ if ( is_wp_error( $dependencies_valid ) ) {
+ return $dependencies_valid;
+ }
+ $keys[ $cache_key ] = true;
+ }
+ return true;
+}
+
+/**
+ * Validate sanitized failure metadata.
+ *
+ * @param mixed $failure Failure metadata.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_artifact_failure( $failure ) {
+ if ( ! is_array( $failure ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_failure', 'Expected failure metadata.', 'failure' );
+ }
+ if ( ! is_string( $failure['code'] ?? null ) || ! preg_match( '/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/', $failure['code'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_failure_code', 'Expected a bounded failure code.', 'failure.code' );
+ }
+ $message = $failure['message'] ?? null;
+ if ( ! is_string( $message ) || '' === trim( $message ) || strlen( $message ) > 500 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_failure_message', 'Expected a bounded sanitized failure message.', 'failure.message' );
+ }
+ if ( ! is_bool( $failure['retryable'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_failure_retry', 'Expected a retryable boolean.', 'failure.retryable' );
+ }
+ if ( ! funkycommerce_is_artifact_timestamp( $failure['failedAt'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_failure_timestamp', 'Expected an ISO timestamp.', 'failure.failedAt' );
+ }
+ return true;
+}
+
+/**
+ * Validate a route artifact payload before publication.
+ *
+ * @param mixed $artifact Artifact payload.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_route_artifact( $artifact ) {
+ if ( ! is_array( $artifact ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_payload', 'Expected a route artifact object.' );
+ }
+ if ( FUNKYCOMMERCE_ARTIFACT_SCHEMA_VERSION !== ( $artifact['schemaVersion'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_unknown_schema', 'Unsupported artifact schema version.', 'schemaVersion' );
+ }
+ $identity_valid = funkycommerce_validate_artifact_identity( $artifact['identity'] ?? null );
+ if ( is_wp_error( $identity_valid ) ) {
+ return $identity_valid;
+ }
+ $states = array( 'ready', 'stale', 'generating', 'failed', 'tombstone' );
+ if ( ! in_array( $artifact['state'] ?? null, $states, true ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_state', 'Unsupported artifact state.', 'state' );
+ }
+ $status = $artifact['statusCode'] ?? null;
+ if ( ! is_int( $status ) || $status < 200 || $status > 599 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_status', 'Expected a valid HTTP status.', 'statusCode' );
+ }
+ if ( ! array_key_exists( 'redirectTo', $artifact ) || ( null !== $artifact['redirectTo'] && ! funkycommerce_is_artifact_https_url( $artifact['redirectTo'] ) ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_redirect', 'Expected null or an HTTPS redirect destination.', 'redirectTo' );
+ }
+ if ( $status >= 300 && $status < 400 && null === $artifact['redirectTo'] ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_redirect', 'Redirect artifacts require an HTTPS destination.', 'redirectTo' );
+ }
+ if ( 'tombstone' === $artifact['state'] && ! in_array( $status, array( 404, 410 ), true ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_tombstone', 'Tombstones must return 404 or 410.', 'statusCode' );
+ }
+ if ( ! is_int( $artifact['sourceRevision'] ?? null ) || $artifact['sourceRevision'] < 0 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_revision', 'Expected a non-negative revision.', 'sourceRevision' );
+ }
+ foreach ( array( 'generatedAt', 'validatedAt' ) as $timestamp ) {
+ if ( ! funkycommerce_is_artifact_timestamp( $artifact[ $timestamp ] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_timestamp', 'Expected an ISO timestamp.', $timestamp );
+ }
+ }
+ if ( ! preg_match( '/^sha256:[a-f0-9]{64}$/', (string) ( $artifact['contentHash'] ?? '' ) ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_hash', 'Expected a lowercase sha256 content hash.', 'contentHash' );
+ }
+ if ( ! preg_match( '/^(?:W\/)?"[^"\r\n]{1,256}"$/', (string) ( $artifact['etag'] ?? '' ) ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_etag', 'Expected a quoted HTTP entity tag.', 'etag' );
+ }
+ foreach ( array( 'documentHtml', 'semanticHtml', 'routeCss' ) as $field ) {
+ if ( ! is_string( $artifact[ $field ] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_body', 'Expected artifact body strings.', $field );
+ }
+ }
+ $seo_valid = funkycommerce_validate_artifact_seo( $artifact['seo'] ?? null );
+ if ( is_wp_error( $seo_valid ) ) {
+ return $seo_valid;
+ }
+ $dependencies_valid = funkycommerce_validate_artifact_dependencies( $artifact['dependencies'] ?? null );
+ if ( is_wp_error( $dependencies_valid ) ) {
+ return $dependencies_valid;
+ }
+ $hydration = $artifact['hydration'] ?? null;
+ $hydration_valid = funkycommerce_validate_artifact_hydration( $hydration );
+ if ( is_wp_error( $hydration_valid ) ) {
+ return $hydration_valid;
+ }
+ if ( ( $artifact['identity']['shellVersion'] ?? null ) !== ( $hydration['shellVersion'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_hydration_shell_mismatch', 'Hydration and artifact shell versions must match.', 'hydration.shellVersion' );
+ }
+ if ( $artifact['sourceRevision'] !== ( $hydration['contentRevision'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_hydration_revision_mismatch', 'Hydration and artifact revisions must match.', 'hydration.contentRevision' );
+ }
+ if ( ! array_key_exists( 'failure', $artifact ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_missing_failure', 'Expected an explicit failure field.', 'failure' );
+ }
+ if ( 'failed' === $artifact['state'] && ! is_array( $artifact['failure'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_missing_failure', 'Failed artifacts require failure metadata.', 'failure' );
+ }
+ if ( 'failed' !== $artifact['state'] && null !== $artifact['failure'] ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_unexpected_failure', 'Only failed artifacts may include failure metadata.', 'failure' );
+ }
+ if ( 'failed' === $artifact['state'] ) {
+ $failure_valid = funkycommerce_validate_artifact_failure( $artifact['failure'] );
+ if ( is_wp_error( $failure_valid ) ) {
+ return $failure_valid;
+ }
+ }
+ return true;
+}
+
+/**
+ * Validate a signed change event.
+ *
+ * @param mixed $event Event payload.
+ * @return true|WP_Error
+ */
+function funkycommerce_validate_artifact_change_event( $event ) {
+ if ( ! is_array( $event ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_event', 'Expected a change event object.' );
+ }
+ if ( FUNKYCOMMERCE_CHANGE_EVENT_SCHEMA_VERSION !== ( $event['schemaVersion'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_unknown_event_schema', 'Unsupported change-event schema.', 'schemaVersion' );
+ }
+ if ( ! is_string( $event['eventId'] ?? null ) || ! preg_match( '/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/', $event['eventId'] ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_event_id', 'Expected a bounded event ID.', 'eventId' );
+ }
+ if ( funkycommerce_artifact_site_key() !== ( $event['siteKey'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_wrong_site', 'The event does not target this site.', 'siteKey' );
+ }
+ if ( ! is_int( $event['revision'] ?? null ) || $event['revision'] < 1 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_revision', 'Expected a positive revision.', 'revision' );
+ }
+ if ( ! funkycommerce_is_artifact_timestamp( $event['occurredAt'] ?? null ) ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_timestamp', 'Expected an ISO timestamp.', 'occurredAt' );
+ }
+ $reason = $event['reason'] ?? null;
+ if ( ! is_string( $reason ) || '' === trim( $reason ) || strlen( $reason ) > 200 ) {
+ return funkycommerce_artifact_protocol_error( 'artifact_invalid_reason', 'Expected a bounded change reason.', 'reason' );
+ }
+ $dependencies_valid = funkycommerce_validate_artifact_dependencies( $event['dependencies'] ?? null );
+ if ( is_wp_error( $dependencies_valid ) || empty( $event['dependencies'] ) ) {
+ return is_wp_error( $dependencies_valid )
+ ? $dependencies_valid
+ : funkycommerce_artifact_protocol_error( 'artifact_empty_event', 'A change event requires dependencies.', 'dependencies' );
+ }
+ return true;
+}
+
+/**
+ * Resolve whether a route may enter the public artifact cache.
+ *
+ * @param string $route Normalized route.
+ * @param array $locale_codes Configured locale codes.
+ * @return string public, private, or bypass.
+ */
+function funkycommerce_artifact_route_visibility( $route, $locale_codes = array() ) {
+ $normalized = funkycommerce_normalize_artifact_route( $route );
+ if ( null === $normalized ) {
+ return 'bypass';
+ }
+ $path = strtolower( $normalized );
+ $segments = explode( '/', ltrim( $path, '/' ) );
+ $locales = array_map(
+ static function ( $locale ) {
+ return strtolower( str_replace( '_', '-', trim( (string) $locale ) ) );
+ },
+ (array) $locale_codes
+ );
+ if ( ! empty( $segments[0] ) && in_array( $segments[0], $locales, true ) ) {
+ array_shift( $segments );
+ $path = '/' . implode( '/', $segments );
+ $path = '/' === $path ? '/' : untrailingslashit( $path );
+ }
+
+ $private = array( '/account', '/auth', '/cart', '/checkout', '/layout-studio', '/oauth', '/order', '/order-success', '/reading-list', '/reset-password', '/unsubscribe', '/wishlist' );
+ foreach ( $private as $prefix ) {
+ if ( $path === $prefix || 0 === strpos( $path, $prefix . '/' ) ) {
+ return 'private';
+ }
+ }
+ $bypass = array( '/.netlify', '/.well-known', '/api', '/assets', '/assistant-model', '/graphql', '/icons', '/wp-admin', '/wp-json' );
+ foreach ( $bypass as $prefix ) {
+ if ( $path === $prefix || 0 === strpos( $path, $prefix . '/' ) ) {
+ return 'bypass';
+ }
+ if ( in_array( $path, array( '/_headers', '/_redirects', '/wp-login.php' ), true ) ) {
+ return 'bypass';
+ }
+ }
+ if ( preg_match( '/\.(?:avif|css|csv|eot|gif|gz|ico|jpe?g|js|json|map|mp3|mp4|pdf|png|svg|txt|webmanifest|webm|webp|woff2?|xml|zip)$/i', $path ) ) {
+ return 'bypass';
+ }
+ return (string) apply_filters( 'funkycommerce_artifact_route_visibility', 'public', $normalized, $locale_codes );
+}
diff --git a/inc/artifact-renderer.php b/inc/artifact-renderer.php
new file mode 100644
index 0000000..bdd788d
--- /dev/null
+++ b/inc/artifact-renderer.php
@@ -0,0 +1,1956 @@
+ 'funkycommerce_native_render_hero',
+ 'video-hero' => 'funkycommerce_native_render_video_hero',
+ 'categories' => 'funkycommerce_native_render_categories',
+ 'slider' => 'funkycommerce_native_render_slider',
+ 'carousel' => 'funkycommerce_native_render_carousel',
+ 'grid' => 'funkycommerce_native_render_grid',
+ 'tags' => 'funkycommerce_native_render_tags',
+ 'product-tags' => 'funkycommerce_native_render_product_tags',
+ 'authors' => 'funkycommerce_native_render_authors',
+ 'reviews' => 'funkycommerce_native_render_reviews',
+ 'comments' => 'funkycommerce_native_render_comments',
+ 'community-feed' => 'funkycommerce_native_render_community_feed',
+ 'community-hero' => 'funkycommerce_native_render_community_hero',
+ 'community-marketplace' => 'funkycommerce_native_render_community_marketplace',
+ 'community-tag-picks' => 'funkycommerce_native_render_community_tag_picks',
+ 'community-members' => 'funkycommerce_native_render_community_members',
+ 'testimonials' => 'funkycommerce_native_render_testimonials',
+ 'related-sections' => 'funkycommerce_native_render_related_sections',
+ 'funkycommerce_map' => 'funkycommerce_native_render_funkycommerce_map',
+ 'gml_map' => 'funkycommerce_native_render_gml_map',
+ 'funkycommerce_locations' => 'funkycommerce_native_render_funkycommerce_locations',
+ 'sorted_locations' => 'funkycommerce_native_render_sorted_locations',
+ );
+ }
+
+ /**
+ * Generate a complete route artifact.
+ *
+ * @param array $identity Artifact identity.
+ * @param int $revision Source revision.
+ * @return array|WP_Error
+ */
+ public static function generate( $identity, $revision ) {
+ $valid = funkycommerce_validate_artifact_identity( $identity );
+ if ( is_wp_error( $valid ) ) {
+ return $valid;
+ }
+ if ( funkycommerce_artifact_site_key() !== $identity['siteKey'] ) {
+ return new WP_Error( 'artifact_wrong_site', __( 'The renderer identity targets a different site.', 'funkycommerce-headless' ), array( 'status' => 409 ) );
+ }
+ if ( 'public' !== funkycommerce_artifact_route_visibility( $identity['route'], array( $identity['locale'] ) ) ) {
+ return new WP_Error( 'artifact_route_not_public', __( 'This route cannot be rendered as a public artifact.', 'funkycommerce-headless' ), array( 'status' => 400 ) );
+ }
+ if ( ! is_int( $revision ) || $revision < 0 ) {
+ return new WP_Error( 'artifact_invalid_revision', __( 'The artifact revision is invalid.', 'funkycommerce-headless' ), array( 'status' => 400 ) );
+ }
+
+ $shell = FunkyCommerce_Artifact_Store::get_shell( $identity['siteKey'], $identity['shellVersion'] );
+ if ( is_wp_error( $shell ) ) {
+ return $shell;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'shell-loaded', $revision );
+
+ $previous_user_id = get_current_user_id();
+ wp_set_current_user( 0 );
+ try {
+ $route = self::resolve_route( $identity['route'] );
+ if ( is_wp_error( $route ) ) {
+ return $route;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'route-resolved', $revision );
+
+ $rendered = self::render_route( $route, $identity );
+ if ( is_wp_error( $rendered ) ) {
+ return $rendered;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'route-rendered', $revision );
+ if (
+ ! is_array( $rendered )
+ || ! is_array( $rendered['data'] ?? null )
+ || ! is_array( $rendered['dependencies'] ?? null )
+ || ! is_string( $rendered['semanticHtml'] ?? null )
+ || ! is_string( $rendered['routeCss'] ?? null )
+ ) {
+ return new WP_Error( 'artifact_invalid_render_result', __( 'The route renderer returned an invalid result.', 'funkycommerce-headless' ) );
+ }
+
+ $dependencies = self::normalize_dependencies(
+ array_merge(
+ array(
+ 'route:' . $identity['route'],
+ 'site:' . get_current_blog_id(),
+ 'config:storefront',
+ 'theme:global',
+ 'menu:global',
+ 'sitemap:public',
+ 'translation:' . strtolower( $identity['locale'] ),
+ ),
+ $rendered['dependencies']
+ )
+ );
+ if ( is_wp_error( $dependencies ) ) {
+ return $dependencies;
+ }
+
+ $navigation = self::navigation();
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'navigation-rendered', $revision );
+ $dependencies = self::normalize_dependencies( array_merge( $dependencies, $navigation['dependencies'] ) );
+ if ( is_wp_error( $dependencies ) ) {
+ return $dependencies;
+ }
+ $navigation_dependencies = self::normalize_dependencies( array_merge( array( 'menu:global', 'config:storefront' ), $navigation['dependencies'] ) );
+ if ( is_wp_error( $navigation_dependencies ) ) {
+ return $navigation_dependencies;
+ }
+
+ $semantic_html = $navigation['headerHtml'] . $rendered['semanticHtml'] . $navigation['footerHtml'];
+ $route_css = trim( (string) $rendered['routeCss'] );
+ $seo = self::seo( $route, $rendered, $identity );
+ if ( is_wp_error( $seo ) ) {
+ return $seo;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'seo-rendered', $revision );
+ $rendered['data'] = self::complete_route_data( $route, $rendered['data'], $seo, $identity );
+
+ $generated_at = gmdate( 'c' );
+ $ttl = max( 60, (int) apply_filters( 'funkycommerce_artifact_hydration_ttl', 300, $identity ) );
+ $hydration = array(
+ 'schemaVersion' => FUNKYCOMMERCE_HYDRATION_SCHEMA_VERSION,
+ 'shellVersion' => $identity['shellVersion'],
+ 'contentRevision' => $revision,
+ 'generatedAt' => $generated_at,
+ 'expiresAt' => gmdate( 'c', time() + $ttl ),
+ 'entries' => array(
+ array(
+ 'cacheKey' => 'artifact-route:v1:' . $identity['route'],
+ 'value' => $rendered['data'],
+ 'dependencies' => $dependencies,
+ ),
+ array(
+ 'cacheKey' => 'artifact-navigation:v1:' . strtolower( $identity['locale'] ),
+ 'value' => $navigation['data'],
+ 'dependencies' => $navigation_dependencies,
+ ),
+ array(
+ 'cacheKey' => 'wordpress-theme-styles:v5',
+ 'value' => function_exists( 'funkycommerce_get_headless_theme_styles' ) ? funkycommerce_get_headless_theme_styles() : array(),
+ 'dependencies' => array( 'theme:global', 'config:storefront' ),
+ ),
+ ),
+ );
+ $hydration['entries'] = array_merge( $hydration['entries'], self::route_seed_entries( $route, $rendered, $dependencies ) );
+ $hydration = apply_filters( 'funkycommerce_artifact_hydration_payload', $hydration, $identity, $route );
+ if ( ! is_array( $hydration ) ) {
+ return new WP_Error( 'artifact_invalid_hydration_filter', __( 'The filtered hydration payload is invalid.', 'funkycommerce-headless' ) );
+ }
+
+ $hash_material = array(
+ 'identity' => $identity,
+ 'state' => $rendered['state'],
+ 'statusCode' => $rendered['statusCode'],
+ 'redirectTo' => $rendered['redirectTo'],
+ 'semanticHtml' => $semantic_html,
+ 'routeCss' => $route_css,
+ 'seo' => $seo,
+ 'dependencies' => $dependencies,
+ 'routeData' => $rendered['data'],
+ 'navigation' => $navigation['data'],
+ );
+ $content_json = self::canonical_json( $hash_material );
+ if ( is_wp_error( $content_json ) ) {
+ return $content_json;
+ }
+ $content_hash = 'sha256:' . hash( 'sha256', $content_json );
+ $etag = '"' . substr( hash( 'sha256', $content_hash . '|' . $revision . '|' . $identity['shellVersion'] ), 0, 48 ) . '"';
+
+ $document = self::assemble_document( $shell['template'], $seo, $route_css, $semantic_html, $hydration, $identity );
+ if ( is_wp_error( $document ) ) {
+ return $document;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'document-assembled', $revision );
+
+ $artifact = array(
+ 'schemaVersion' => FUNKYCOMMERCE_ARTIFACT_SCHEMA_VERSION,
+ 'identity' => $identity,
+ 'state' => $rendered['state'],
+ 'statusCode' => $rendered['statusCode'],
+ 'redirectTo' => $rendered['redirectTo'],
+ 'sourceRevision' => $revision,
+ 'generatedAt' => $generated_at,
+ 'validatedAt' => $generated_at,
+ 'contentHash' => $content_hash,
+ 'etag' => $etag,
+ 'documentHtml' => $document,
+ 'semanticHtml' => $semantic_html,
+ 'routeCss' => $route_css,
+ 'seo' => $seo,
+ 'dependencies' => $dependencies,
+ 'hydration' => $hydration,
+ 'failure' => null,
+ );
+ $artifact = apply_filters( 'funkycommerce_rendered_route_artifact', $artifact, $route );
+ if ( ! is_array( $artifact ) ) {
+ return new WP_Error( 'artifact_invalid_renderer_filter', __( 'The filtered route artifact is invalid.', 'funkycommerce-headless' ) );
+ }
+ $valid = funkycommerce_validate_route_artifact( $artifact );
+ FunkyCommerce_Artifact_Store::record_worker_trace( $identity['route'], 'artifact-validated', $revision );
+ return is_wp_error( $valid ) ? $valid : $artifact;
+ } finally {
+ wp_set_current_user( $previous_user_id );
+ }
+ }
+
+ /**
+ * Resolve a normalized route through WordPress rewrite rules.
+ *
+ * @param string $path Normalized route.
+ * @return array|WP_Error
+ */
+ private static function resolve_route( $path ) {
+ if ( '/' === $path ) {
+ if ( 'page' === get_option( 'show_on_front' ) && 0 < (int) get_option( 'page_on_front' ) ) {
+ $query = new WP_Query(
+ array(
+ 'page_id' => (int) get_option( 'page_on_front' ),
+ 'post_status' => 'publish',
+ )
+ );
+ } else {
+ $query = new WP_Query(
+ array(
+ 'post_type' => 'post',
+ 'post_status' => 'publish',
+ 'paged' => 1,
+ )
+ );
+ }
+ return self::classify_query( $query, $path, true );
+ }
+
+ $singular_route = self::resolve_current_singular_route( $path );
+ if ( is_array( $singular_route ) ) {
+ return $singular_route;
+ }
+
+ $rules = wp_rewrite_rules();
+ if ( ! is_array( $rules ) || empty( $rules ) ) {
+ return new WP_Error( 'artifact_rewrite_rules_unavailable', __( 'WordPress rewrite rules are unavailable.', 'funkycommerce-headless' ), array( 'status' => 503 ) );
+ }
+
+ $request = ltrim( rawurldecode( $path ), '/' );
+ foreach ( $rules as $match => $query_string ) {
+ $request_match = $request;
+ if ( ! preg_match( '#^' . $match . '#', $request_match, $matches ) ) {
+ $request_match = trailingslashit( $request );
+ if ( ! preg_match( '#^' . $match . '#', $request_match, $matches ) ) {
+ continue;
+ }
+ }
+
+ $query_string = preg_replace( '!^.+\?!', '', $query_string );
+ $query_string = self::expand_rewrite_matches( $query_string, $matches );
+ parse_str( (string) $query_string, $query_vars );
+ $query_vars['post_status'] = 'publish';
+ $query = new WP_Query( $query_vars );
+ return self::classify_query( $query, $path, false );
+ }
+
+ $old_slug = self::old_slug_redirect( $path );
+ return null === $old_slug ? self::not_found_route( $path ) : $old_slug;
+ }
+
+ /**
+ * Resolve current singular permalinks without scanning the complete rewrite map.
+ *
+ * @param string $path Normalized route.
+ * @return array|null
+ */
+ private static function resolve_current_singular_route( $path ) {
+ $request = trim( rawurldecode( $path ), '/' );
+ if ( '' === $request ) {
+ return null;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $path, 'singular-resolving', 0 );
+
+ $post_type_objects = get_post_types( array( 'publicly_queryable' => true ), 'objects' );
+ unset( $post_type_objects['attachment'] );
+ if ( empty( $post_type_objects ) ) {
+ return null;
+ }
+
+ $candidates = array(
+ array(
+ 'path' => $request,
+ 'types' => array_keys( $post_type_objects ),
+ ),
+ );
+ foreach ( $post_type_objects as $post_type => $post_type_object ) {
+ $rewrite_slug = is_array( $post_type_object->rewrite ?? null )
+ ? trim( (string) ( $post_type_object->rewrite['slug'] ?? '' ), '/' )
+ : '';
+ if ( '' === $rewrite_slug || false !== strpos( $rewrite_slug, '%' ) || 0 !== strpos( $request, $rewrite_slug . '/' ) ) {
+ continue;
+ }
+ $candidates[] = array(
+ 'path' => substr( $request, strlen( $rewrite_slug ) + 1 ),
+ 'types' => array( $post_type ),
+ );
+ }
+
+ foreach ( $candidates as $candidate ) {
+ FunkyCommerce_Artifact_Store::record_worker_trace( $path, 'singular-looking-up', 0 );
+ $post = self::find_public_post_by_path( $candidate['path'], $candidate['types'] );
+ if (
+ ! $post instanceof WP_Post
+ || 'publish' !== $post->post_status
+ || '' !== (string) $post->post_password
+ ) {
+ continue;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $path, 'singular-found', 0 );
+ $canonical_path = self::path_from_url( self::frontend_url_for_backend_url( get_permalink( $post ) ) );
+ if ( $path !== $canonical_path ) {
+ continue;
+ }
+ FunkyCommerce_Artifact_Store::record_worker_trace( $path, 'singular-canonical', 0 );
+ return array(
+ 'kind' => 'product' === $post->post_type ? 'product' : $post->post_type,
+ 'path' => $path,
+ 'query' => null,
+ 'object' => $post,
+ 'canonical' => self::frontend_url_for_backend_url( get_permalink( $post ) ),
+ );
+ }
+
+ return null;
+ }
+
+ /**
+ * Resolve a public post through indexed leaf lookup and bounded parent checks.
+ *
+ * @param string $path Candidate post path without a CPT prefix.
+ * @param array $post_types Allowed post types.
+ * @return WP_Post|null
+ */
+ private static function find_public_post_by_path( $path, $post_types ) {
+ global $wpdb;
+
+ $segments = array_values( array_filter( explode( '/', trim( rawurldecode( $path ), '/' ) ), 'strlen' ) );
+ $segments = array_map( 'sanitize_title', $segments );
+ $post_types = array_values( array_unique( array_filter( array_map( 'sanitize_key', $post_types ) ) ) );
+ if ( empty( $segments ) || empty( $post_types ) || in_array( '', $segments, true ) ) {
+ return null;
+ }
+
+ $sql = "SELECT ID,post_parent,post_name,post_type,post_status,post_password
+ FROM {$wpdb->posts}
+ WHERE post_name = %s
+ LIMIT 50";
+ $leaf_rows = $wpdb->get_results(
+ $wpdb->prepare( $sql, end( $segments ) ),
+ ARRAY_A
+ );
+ if ( ! is_array( $leaf_rows ) || '' !== $wpdb->last_error ) {
+ return null;
+ }
+
+ foreach ( $leaf_rows as $leaf ) {
+ if (
+ ! in_array( (string) $leaf['post_type'], $post_types, true )
+ || 'publish' !== (string) $leaf['post_status']
+ || '' !== (string) $leaf['post_password']
+ ) {
+ continue;
+ }
+ $current = $leaf;
+ $matched = true;
+ for ( $index = count( $segments ) - 1; $index >= 0; --$index ) {
+ if ( $segments[ $index ] !== (string) $current['post_name'] ) {
+ $matched = false;
+ break;
+ }
+ $parent_id = (int) $current['post_parent'];
+ if ( 0 === $index ) {
+ $matched = 0 === $parent_id;
+ break;
+ }
+ if ( $parent_id <= 0 ) {
+ $matched = false;
+ break;
+ }
+ $current = $wpdb->get_row(
+ $wpdb->prepare(
+ "SELECT ID,post_parent,post_name,post_type,post_status,post_password
+ FROM {$wpdb->posts}
+ WHERE ID = %d AND post_type = %s AND post_status = 'publish' LIMIT 1",
+ $parent_id,
+ $leaf['post_type']
+ ),
+ ARRAY_A
+ );
+ if ( ! is_array( $current ) || '' !== (string) $current['post_password'] ) {
+ $matched = false;
+ break;
+ }
+ }
+ if ( $matched ) {
+ $raw_post = $wpdb->get_row(
+ $wpdb->prepare(
+ "SELECT * FROM {$wpdb->posts} WHERE ID = %d LIMIT 1",
+ (int) $leaf['ID']
+ )
+ );
+ if ( ! is_object( $raw_post ) || '' !== $wpdb->last_error ) {
+ return null;
+ }
+ $raw_post = sanitize_post( $raw_post, 'raw' );
+ wp_cache_add( (int) $raw_post->ID, $raw_post, 'posts' );
+ return new WP_Post( $raw_post );
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Convert a query into a stable route descriptor.
+ *
+ * @param WP_Query $query Query.
+ * @param string $path Requested route.
+ * @param bool $home Whether this is the root route.
+ * @return array
+ */
+ private static function classify_query( $query, $path, $home ) {
+ if ( $query->is_404() ) {
+ $old_slug = self::old_slug_redirect( $path );
+ return null === $old_slug ? self::not_found_route( $path ) : $old_slug;
+ }
+
+ $object = $query->get_queried_object();
+ if ( $query->is_singular() && $object instanceof WP_Post ) {
+ $post_type = get_post_type_object( $object->post_type );
+ if ( 'publish' !== $object->post_status || ! $post_type || ! $post_type->public || '' !== (string) $object->post_password ) {
+ return self::not_found_route( $path );
+ }
+ return array(
+ 'kind' => $home ? 'home' : ( 'product' === $object->post_type ? 'product' : $object->post_type ),
+ 'path' => $path,
+ 'query' => $query,
+ 'object' => $object,
+ 'canonical' => self::frontend_url_for_backend_url( get_permalink( $object ) ),
+ );
+ }
+ if ( $object instanceof WP_Term ) {
+ $paged = max( 1, (int) $query->get( 'paged' ) );
+ return array(
+ 'kind' => 'taxonomy',
+ 'path' => $path,
+ 'query' => $query,
+ 'object' => $object,
+ 'canonical' => 1 < $paged ? self::frontend_url( $path ) : self::frontend_url_for_backend_url( get_term_link( $object ) ),
+ );
+ }
+ if ( $object instanceof WP_User ) {
+ $paged = max( 1, (int) $query->get( 'paged' ) );
+ return array(
+ 'kind' => 'author',
+ 'path' => $path,
+ 'query' => $query,
+ 'object' => $object,
+ 'canonical' => 1 < $paged ? self::frontend_url( $path ) : self::frontend_url_for_backend_url( get_author_posts_url( $object->ID ) ),
+ );
+ }
+
+ $kind = $home || $query->is_home() ? 'post_archive' : ( $query->is_post_type_archive( 'product' ) ? 'product_archive' : 'archive' );
+ return array(
+ 'kind' => $kind,
+ 'path' => $path,
+ 'query' => $query,
+ 'object' => $object,
+ 'canonical' => self::frontend_url( $path ),
+ );
+ }
+
+ /**
+ * Return a not-found route descriptor.
+ *
+ * @param string $path Route.
+ * @return array
+ */
+ private static function not_found_route( $path ) {
+ return array(
+ 'kind' => 'not_found',
+ 'path' => $path,
+ 'query' => null,
+ 'object' => null,
+ 'canonical' => self::frontend_url( $path ),
+ );
+ }
+
+ /**
+ * Render a resolved route.
+ *
+ * @param array $route Route descriptor.
+ * @param array $identity Artifact identity.
+ * @return array|WP_Error
+ */
+ private static function render_route( $route, $identity ) {
+ $redirect = apply_filters( 'funkycommerce_artifact_redirect_destination', null, $route, $identity );
+ if ( null !== $redirect ) {
+ if ( ! funkycommerce_is_artifact_https_url( $redirect ) ) {
+ return new WP_Error( 'artifact_invalid_redirect', __( 'The route redirect destination must be HTTPS.', 'funkycommerce-headless' ) );
+ }
+ return self::redirect_render( $route, $redirect );
+ }
+
+ if ( 'redirect' === $route['kind'] ) {
+ return self::redirect_render( $route, $route['canonical'] );
+ }
+
+ if ( $route['object'] instanceof WP_Post ) {
+ $canonical_path = self::path_from_url( $route['canonical'] );
+ if ( null !== $canonical_path && $canonical_path !== $identity['route'] ) {
+ return self::redirect_render( $route, $route['canonical'] );
+ }
+ return self::render_singular( $route );
+ }
+ if ( 'not_found' === $route['kind'] ) {
+ $status = (int) apply_filters( 'funkycommerce_artifact_tombstone_status', 404, $identity['route'] );
+ $status = in_array( $status, array( 404, 410 ), true ) ? $status : 404;
+ return array(
+ 'state' => 'tombstone',
+ 'statusCode' => $status,
+ 'redirectTo' => null,
+ 'semanticHtml' => '' . esc_html__( 'Page not found', 'funkycommerce-headless' ) . '
' . esc_html__( 'The requested page is no longer available.', 'funkycommerce-headless' ) . '
',
+ 'routeCss' => '',
+ 'dependencies' => array(),
+ 'data' => array(
+ 'type' => 'not_found',
+ 'route' => $identity['route'],
+ 'statusCode' => $status,
+ ),
+ );
+ }
+ return self::render_archive( $route );
+ }
+
+ /**
+ * Render a canonical redirect.
+ *
+ * @param array $route Route descriptor.
+ * @param string $url HTTPS destination.
+ * @return array
+ */
+ private static function redirect_render( $route, $url ) {
+ $dependencies = array( 'redirect:' . substr( hash( 'sha256', $route['path'] . '|' . $url ), 0, 32 ) );
+ if ( $route['object'] instanceof WP_Post ) {
+ $dependencies = array_merge( $dependencies, self::post_dependencies( $route['object'] ) );
+ }
+ return array(
+ 'state' => 'ready',
+ 'statusCode' => 301,
+ 'redirectTo' => $url,
+ 'semanticHtml' => '' . esc_html__( 'Continue to the canonical page', 'funkycommerce-headless' ) . '
',
+ 'routeCss' => '',
+ 'dependencies' => $dependencies,
+ 'data' => array(
+ 'type' => 'redirect',
+ 'route' => $route['path'],
+ 'statusCode' => 301,
+ 'redirectTo' => $url,
+ ),
+ );
+ }
+
+ /**
+ * Render a public page, post, community post, or product.
+ *
+ * @param array $route Route descriptor.
+ * @return array|WP_Error
+ */
+ private static function render_singular( $route ) {
+ $post = $route['object'];
+ $dependencies = self::post_dependencies( $post );
+ $content = self::render_post_content( $post, $route['query'] );
+ if ( is_wp_error( $content ) ) {
+ return $content;
+ }
+ $route_css = self::extract_route_css( $content );
+ if ( is_wp_error( $route_css ) ) {
+ return $route_css;
+ }
+ $content = $route_css['html'];
+ $image = self::featured_image( $post->ID );
+ $author = self::author_data( (int) $post->post_author );
+ $terms = self::post_terms( $post );
+ $uri = self::path_from_url( get_permalink( $post ) );
+ $uri = null === $uri ? $route['path'] : $uri;
+ $data = array(
+ 'type' => $route['kind'],
+ 'id' => base64_encode( 'post:' . $post->ID ),
+ 'databaseId' => (int) $post->ID,
+ 'postType' => $post->post_type,
+ 'slug' => $post->post_name,
+ 'uri' => trailingslashit( $uri ),
+ 'title' => get_the_title( $post ),
+ 'excerpt' => self::post_excerpt( $post ),
+ 'content' => $content,
+ 'headlessContent' => $content,
+ 'modified' => get_post_modified_time( 'c', true, $post ),
+ 'published' => get_post_time( 'c', true, $post ),
+ 'author' => $author,
+ 'featuredImage' => $image,
+ 'terms' => $terms,
+ );
+
+ if ( 'product' === $post->post_type ) {
+ $product = function_exists( 'wc_get_product' ) ? wc_get_product( $post->ID ) : null;
+ if ( ! $product ) {
+ return new WP_Error( 'artifact_product_unavailable', __( 'The product could not be loaded.', 'funkycommerce-headless' ) );
+ }
+ $product_data = self::product_data( $product );
+ $data = array_merge( $data, $product_data );
+ $semantic = self::product_html( $post, $product, $product_data, $content, $image, $terms );
+ } else {
+ $semantic = self::article_html( $route['kind'], $post, $content, $image, $author, $terms );
+ }
+
+ return array(
+ 'state' => 'ready',
+ 'statusCode' => 200,
+ 'redirectTo' => null,
+ 'semanticHtml' => $semantic,
+ 'routeCss' => $route_css['css'],
+ 'dependencies' => $dependencies,
+ 'data' => apply_filters( 'funkycommerce_artifact_route_data', $data, $route ),
+ );
+ }
+
+ /**
+ * Render a taxonomy, author, shop, post, date, or post-type archive.
+ *
+ * @param array $route Route descriptor.
+ * @return array
+ */
+ private static function render_archive( $route ) {
+ $query = $route['query'];
+ $object = $route['object'];
+ $title = get_bloginfo( 'name' );
+ $description = get_bloginfo( 'description' );
+ $dependencies = array();
+
+ if ( $object instanceof WP_Term ) {
+ $title = $object->name;
+ $description = term_description( $object );
+ $dependencies[] = 'term:' . sanitize_key( $object->taxonomy ) . ':' . (int) $object->term_id;
+ $dependencies[] = 'archive:' . sanitize_key( $object->taxonomy );
+ } elseif ( $object instanceof WP_User ) {
+ $title = $object->display_name;
+ $description = get_the_author_meta( 'description', $object->ID );
+ $dependencies[] = 'author:' . (int) $object->ID;
+ $dependencies[] = 'archive:authors';
+ } elseif ( 'product_archive' === $route['kind'] ) {
+ $title = function_exists( 'wc_get_page_id' ) && 0 < wc_get_page_id( 'shop' ) ? get_the_title( wc_get_page_id( 'shop' ) ) : __( 'Shop', 'funkycommerce-headless' );
+ $description = '';
+ $dependencies[] = 'archive:shop';
+ $dependencies[] = 'archive:product';
+ } else {
+ $post_type = $query instanceof WP_Query ? $query->get( 'post_type' ) : '';
+ $post_type = is_array( $post_type ) ? reset( $post_type ) : $post_type;
+ $post_type = is_string( $post_type ) ? sanitize_key( $post_type ) : '';
+ $post_type_object = '' !== $post_type ? get_post_type_object( $post_type ) : null;
+ $posts_page_id = (int) get_option( 'page_for_posts' );
+ $title = $post_type_object
+ ? $post_type_object->labels->name
+ : ( 0 < $posts_page_id ? get_the_title( $posts_page_id ) : __( 'Latest stories', 'funkycommerce-headless' ) );
+ $dependencies[] = 'archive:' . ( '' !== $post_type ? $post_type : 'post' );
+ }
+
+ $items = array();
+ $html = '';
+ if ( $query instanceof WP_Query ) {
+ foreach ( $query->posts as $post ) {
+ if ( ! $post instanceof WP_Post || 'publish' !== $post->post_status || '' !== (string) $post->post_password ) {
+ continue;
+ }
+ $summary = self::post_summary( $post );
+ $items[] = $summary;
+ $dependencies = array_merge( $dependencies, self::post_dependencies( $post ) );
+ $html .= self::summary_html( $summary );
+ }
+ }
+ if ( '' === $html ) {
+ $html = '' . esc_html__( 'No public content is available yet.', 'funkycommerce-headless' ) . '
';
+ }
+
+ $paged = $query instanceof WP_Query ? max( 1, (int) $query->get( 'paged' ) ) : 1;
+ $max_pages = $query instanceof WP_Query ? max( 1, (int) $query->max_num_pages ) : 1;
+ $pagination = self::pagination_html( $route['path'], $paged, $max_pages );
+ $semantic = '' . $html . '
' . $pagination . '';
+
+ $data = array(
+ 'type' => $route['kind'],
+ 'route' => $route['path'],
+ 'title' => wp_strip_all_tags( $title ),
+ 'description' => wp_strip_all_tags( $description ),
+ 'items' => $items,
+ 'page' => $paged,
+ 'totalPages' => $max_pages,
+ );
+ if ( $object instanceof WP_Term ) {
+ $data['taxonomy'] = $object->taxonomy;
+ $data['termId'] = (int) $object->term_id;
+ $data['slug'] = $object->slug;
+ } elseif ( $object instanceof WP_User ) {
+ $data['author'] = self::author_data( $object->ID );
+ }
+
+ return array(
+ 'state' => 'ready',
+ 'statusCode' => 200,
+ 'redirectTo' => null,
+ 'semanticHtml' => $semantic,
+ 'routeCss' => '',
+ 'dependencies' => $dependencies,
+ 'data' => apply_filters( 'funkycommerce_artifact_route_data', $data, $route ),
+ );
+ }
+
+ /**
+ * Render content using the existing headless pipeline and public native shortcodes.
+ *
+ * @param WP_Post $post Post.
+ * @param WP_Query|null $query Resolved route query.
+ * @return string|WP_Error
+ */
+ private static function render_post_content( $post, $query ) {
+ global $shortcode_tags, $wp_query, $wp_the_query;
+
+ $previous_post = $GLOBALS['post'] ?? null;
+ $previous_wp_query = $wp_query;
+ $previous_wp_the_query = $wp_the_query;
+ $originals = array();
+ foreach ( self::public_shortcode_renderers() as $tag => $callback ) {
+ if ( ! function_exists( $callback ) ) {
+ continue;
+ }
+ $originals[ $tag ] = $shortcode_tags[ $tag ] ?? null;
+ add_shortcode( $tag, $callback );
+ }
+ if ( $query instanceof WP_Query ) {
+ $wp_query = $query;
+ $wp_the_query = $query;
+ }
+ $GLOBALS['post'] = $post;
+ setup_postdata( $post );
+
+ try {
+ if ( 'page' === $post->post_type && function_exists( 'funkycommerce_render_headless_page_content' ) ) {
+ return funkycommerce_render_headless_page_content( $post->ID );
+ }
+ if ( function_exists( 'funkycommerce_render_headless_content_field' ) ) {
+ return funkycommerce_render_headless_content_field( $post->ID, 'post_content', 'the_content' );
+ }
+ return apply_filters( 'the_content', (string) $post->post_content );
+ } finally {
+ foreach ( $originals as $tag => $original ) {
+ if ( null !== $original ) {
+ $shortcode_tags[ $tag ] = $original;
+ } else {
+ remove_shortcode( $tag );
+ }
+ }
+ $wp_query = $previous_wp_query;
+ $wp_the_query = $previous_wp_the_query;
+ $GLOBALS['post'] = $previous_post;
+ if ( $previous_post instanceof WP_Post ) {
+ setup_postdata( $previous_post );
+ }
+ }
+ }
+
+ /**
+ * Extract WordPress-generated per-route CSS from rendered content.
+ *
+ * @param string $html Rendered content.
+ * @return array|WP_Error
+ */
+ private static function extract_route_css( $html ) {
+ $css = array();
+ $html = preg_replace_callback(
+ '/]*data-wp-block-supports=(["\'])[^"\']+\1[^>]*>(.*?)<\/style>/is',
+ static function ( $matches ) use ( &$css ) {
+ $css[] = trim( $matches[2] );
+ return '';
+ },
+ $html
+ );
+ $utility_css = self::compile_arbitrary_utility_css( is_string( $html ) ? $html : '' );
+ if ( is_wp_error( $utility_css ) ) {
+ return $utility_css;
+ }
+ $css[] = $utility_css;
+ $compiled = implode( "\n", array_filter( $css ) );
+ if ( strlen( $compiled ) > 32768 ) {
+ return new WP_Error( 'artifact_route_css_too_large', __( 'The generated route CSS exceeds the 32 KB limit.', 'funkycommerce-headless' ) );
+ }
+ return array(
+ 'html' => is_string( $html ) ? $html : '',
+ 'css' => $compiled,
+ );
+ }
+
+ /**
+ * Compile the finite arbitrary-value utility contract into route-scoped CSS.
+ *
+ * @param string $html Rendered content.
+ * @return string|WP_Error
+ */
+ private static function compile_arbitrary_utility_css( $html ) {
+ if ( '' === $html || ! preg_match_all( '/\bclass\s*=\s*(["\'])(.*?)\1/is', $html, $matches ) ) {
+ return '';
+ }
+ $tokens = array();
+ foreach ( $matches[2] as $attribute ) {
+ $decoded = html_entity_decode( $attribute, ENT_QUOTES | ENT_HTML5, 'UTF-8' );
+ foreach ( preg_split( '/\s+/', $decoded ) as $token ) {
+ if ( false !== strpos( $token, '[' ) ) {
+ $tokens[ $token ] = true;
+ }
+ }
+ }
+ if ( count( $tokens ) > 200 ) {
+ return new WP_Error( 'artifact_route_css_rule_limit', __( 'The route contains more than 200 arbitrary-value utilities.', 'funkycommerce-headless' ) );
+ }
+ $rules = array();
+ foreach ( array_keys( $tokens ) as $token ) {
+ $rule = self::compile_arbitrary_utility_rule( $token );
+ if ( null !== $rule ) {
+ $rules[] = $rule;
+ }
+ }
+ return implode( "\n", $rules );
+ }
+
+ /**
+ * Compile one safe arbitrary-value utility.
+ *
+ * @param string $token Utility token.
+ * @return string|null
+ */
+ private static function compile_arbitrary_utility_rule( $token ) {
+ if (
+ '' === $token
+ || strlen( $token ) > 160
+ || ! preg_match( '/^[\x21-\x7e]+$/', $token )
+ || preg_match( '/[<>{};"\'`\\\\]/', $token )
+ ) {
+ return null;
+ }
+ $parts = self::split_utility_variants( $token );
+ $base = array_pop( $parts );
+ $selector = '.' . preg_replace_callback(
+ '/[^a-zA-Z0-9_-]/',
+ static function ( $match ) {
+ return '\\' . $match[0];
+ },
+ $token
+ );
+ $media = array();
+ $dark = false;
+ $pseudos = array(
+ 'hover' => ':hover',
+ 'focus' => ':focus',
+ 'focus-within' => ':focus-within',
+ 'focus-visible' => ':focus-visible',
+ 'active' => ':active',
+ 'disabled' => ':disabled',
+ 'visited' => ':visited',
+ 'checked' => ':checked',
+ 'required' => ':required',
+ 'invalid' => ':invalid',
+ 'read-only' => ':read-only',
+ 'open' => '[open]',
+ );
+ $breakpoints = array(
+ 'sm' => '(min-width:640px)',
+ 'md' => '(min-width:768px)',
+ 'lg' => '(min-width:1024px)',
+ 'xl' => '(min-width:1280px)',
+ '2xl' => '(min-width:1536px)',
+ );
+ foreach ( $parts as $variant ) {
+ if ( isset( $breakpoints[ $variant ] ) ) {
+ $media[] = $breakpoints[ $variant ];
+ } elseif ( 'dark' === $variant ) {
+ $dark = true;
+ } elseif ( isset( $pseudos[ $variant ] ) ) {
+ $selector .= $pseudos[ $variant ];
+ } elseif ( 'portrait' === $variant || 'landscape' === $variant ) {
+ $media[] = '(orientation:' . $variant . ')';
+ } elseif ( 'motion-safe' === $variant ) {
+ $media[] = '(prefers-reduced-motion:no-preference)';
+ } elseif ( 'motion-reduce' === $variant ) {
+ $media[] = '(prefers-reduced-motion:reduce)';
+ } elseif ( 'print' === $variant ) {
+ $media[] = 'print';
+ } else {
+ return null;
+ }
+ }
+ if ( $dark ) {
+ $selector = '.dark ' . $selector;
+ }
+
+ $declaration = self::arbitrary_utility_declaration( $base, $selector );
+ if ( null === $declaration ) {
+ return null;
+ }
+ $selector = $declaration['selector'];
+ $rule = $selector . '{' . $declaration['css'] . '}';
+ if ( ! empty( $media ) ) {
+ $query = in_array( 'print', $media, true )
+ ? implode( ' and ', $media )
+ : implode( ' and ', array_unique( $media ) );
+ $rule = '@media ' . $query . '{' . $rule . '}';
+ }
+ return $rule;
+ }
+
+ /**
+ * Split variants without treating bracket content as separators.
+ *
+ * @param string $token Utility token.
+ * @return array
+ */
+ private static function split_utility_variants( $token ) {
+ $parts = array();
+ $depth = 0;
+ $start = 0;
+ $length = strlen( $token );
+ for ( $index = 0; $index < $length; $index++ ) {
+ if ( '[' === $token[ $index ] ) {
+ $depth++;
+ } elseif ( ']' === $token[ $index ] ) {
+ $depth--;
+ if ( 0 > $depth ) {
+ return array( '' );
+ }
+ } elseif ( ':' === $token[ $index ] && 0 === $depth ) {
+ $parts[] = substr( $token, $start, $index - $start );
+ $start = $index + 1;
+ }
+ }
+ if ( 0 !== $depth ) {
+ return array( '' );
+ }
+ $parts[] = substr( $token, $start );
+ return $parts;
+ }
+
+ /**
+ * Map an arbitrary utility to a bounded CSS declaration.
+ *
+ * @param string $base Base utility.
+ * @param string $selector Escaped selector.
+ * @return array|null
+ */
+ private static function arbitrary_utility_declaration( $base, $selector ) {
+ if ( preg_match( '/^(bg|border|caret|decoration|fill|placeholder|stroke|text)-\[(#[0-9a-fA-F]{3,8})\](?:\/(100|\d{1,2}))?$/', $base, $match ) ) {
+ $properties = array(
+ 'bg' => 'background-color',
+ 'border' => 'border-color',
+ 'caret' => 'caret-color',
+ 'decoration' => 'text-decoration-color',
+ 'fill' => 'fill',
+ 'placeholder' => 'color',
+ 'stroke' => 'stroke',
+ 'text' => 'color',
+ );
+ $color = self::arbitrary_hex_color( $match[2], isset( $match[3] ) ? (int) $match[3] : 100 );
+ if ( null === $color ) {
+ return null;
+ }
+ if ( 'placeholder' === $match[1] ) {
+ $selector .= '::placeholder';
+ }
+ return array( 'selector' => $selector, 'css' => $properties[ $match[1] ] . ':' . $color . ';' );
+ }
+
+ if ( preg_match( '/^(bottom|gap|h|inset|left|m|mb|min-h|min-w|ml|mr|mt|mx|my|p|pb|pl|pr|pt|px|py|right|top|w|max-h|max-w)-\[(-?\d+(?:\.\d+)?(?:px|rem|em|%|vh|vw|ch))\]$/', $base, $match ) ) {
+ $properties = array(
+ 'bottom' => array( 'bottom' ), 'gap' => array( 'gap' ), 'h' => array( 'height' ),
+ 'inset' => array( 'top', 'right', 'bottom', 'left' ), 'left' => array( 'left' ),
+ 'm' => array( 'margin' ), 'mb' => array( 'margin-bottom' ), 'min-h' => array( 'min-height' ),
+ 'min-w' => array( 'min-width' ), 'ml' => array( 'margin-left' ), 'mr' => array( 'margin-right' ),
+ 'mt' => array( 'margin-top' ), 'mx' => array( 'margin-left', 'margin-right' ),
+ 'my' => array( 'margin-top', 'margin-bottom' ), 'p' => array( 'padding' ),
+ 'pb' => array( 'padding-bottom' ), 'pl' => array( 'padding-left' ),
+ 'pr' => array( 'padding-right' ), 'pt' => array( 'padding-top' ),
+ 'px' => array( 'padding-left', 'padding-right' ), 'py' => array( 'padding-top', 'padding-bottom' ),
+ 'right' => array( 'right' ), 'top' => array( 'top' ), 'w' => array( 'width' ),
+ 'max-h' => array( 'max-height' ), 'max-w' => array( 'max-width' ),
+ );
+ $css = '';
+ foreach ( $properties[ $match[1] ] as $property ) {
+ $css .= $property . ':' . $match[2] . ';';
+ }
+ return array( 'selector' => $selector, 'css' => $css );
+ }
+
+ if ( preg_match( '/^rounded(?:-([trbl]{1,2}))?-\[(\d+(?:\.\d+)?(?:px|rem|em|%))\]$/', $base, $match ) ) {
+ $corners = array(
+ '' => array( 'border-radius' ), 't' => array( 'border-top-left-radius', 'border-top-right-radius' ),
+ 'r' => array( 'border-top-right-radius', 'border-bottom-right-radius' ),
+ 'b' => array( 'border-bottom-right-radius', 'border-bottom-left-radius' ),
+ 'l' => array( 'border-top-left-radius', 'border-bottom-left-radius' ),
+ 'tl' => array( 'border-top-left-radius' ), 'tr' => array( 'border-top-right-radius' ),
+ 'br' => array( 'border-bottom-right-radius' ), 'bl' => array( 'border-bottom-left-radius' ),
+ );
+ $suffix = $match[1] ?? '';
+ if ( ! isset( $corners[ $suffix ] ) ) {
+ return null;
+ }
+ $css = '';
+ foreach ( $corners[ $suffix ] as $property ) {
+ $css .= $property . ':' . $match[2] . ';';
+ }
+ return array( 'selector' => $selector, 'css' => $css );
+ }
+ if ( preg_match( '/^opacity-\[(0(?:\.\d+)?|1(?:\.0+)?)\]$/', $base, $match ) ) {
+ return array( 'selector' => $selector, 'css' => 'opacity:' . $match[1] . ';' );
+ }
+ if ( preg_match( '/^(order|z)-\[(-?\d{1,4})\]$/', $base, $match ) ) {
+ return array( 'selector' => $selector, 'css' => ( 'z' === $match[1] ? 'z-index' : 'order' ) . ':' . $match[2] . ';' );
+ }
+ if ( preg_match( '/^aspect-\[(\d{1,4})\/(\d{1,4})\]$/', $base, $match ) && '0' !== $match[2] ) {
+ return array( 'selector' => $selector, 'css' => 'aspect-ratio:' . $match[1] . '/' . $match[2] . ';' );
+ }
+ return null;
+ }
+
+ /**
+ * Return an rgba color for an allowlisted hexadecimal value.
+ *
+ * @param string $hex Hexadecimal color.
+ * @param int $opacity Percentage opacity.
+ * @return string|null
+ */
+ private static function arbitrary_hex_color( $hex, $opacity ) {
+ $value = substr( $hex, 1 );
+ if ( 3 === strlen( $value ) || 4 === strlen( $value ) ) {
+ $value = implode( '', array_map( static fn( $character ) => $character . $character, str_split( $value ) ) );
+ }
+ if ( 6 !== strlen( $value ) && 8 !== strlen( $value ) ) {
+ return null;
+ }
+ $alpha = 8 === strlen( $value ) ? hexdec( substr( $value, 6, 2 ) ) / 255 : 1;
+ $alpha = max( 0, min( 1, $alpha * max( 0, min( 100, $opacity ) ) / 100 ) );
+ return sprintf(
+ 'rgba(%d,%d,%d,%s)',
+ hexdec( substr( $value, 0, 2 ) ),
+ hexdec( substr( $value, 2, 2 ) ),
+ hexdec( substr( $value, 4, 2 ) ),
+ rtrim( rtrim( sprintf( '%.3F', $alpha ), '0' ), '.' )
+ );
+ }
+
+ /**
+ * Build post dependency tags matching invalidation.
+ *
+ * @param WP_Post $post Post.
+ * @return array
+ */
+ private static function post_dependencies( $post ) {
+ $kind = 'page' === $post->post_type ? 'page' : ( 'product' === $post->post_type ? 'product' : 'post' );
+ $deps = array(
+ $kind . ':' . (int) $post->ID,
+ 'archive:' . sanitize_key( $post->post_type ),
+ );
+ if ( 0 < (int) $post->post_author ) {
+ $deps[] = 'author:' . (int) $post->post_author;
+ }
+ if ( 'product' === $post->post_type ) {
+ $deps[] = 'archive:shop';
+ }
+ foreach ( get_object_taxonomies( $post->post_type ) as $taxonomy ) {
+ $term_ids = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) );
+ if ( is_wp_error( $term_ids ) ) {
+ continue;
+ }
+ $deps[] = 'archive:' . sanitize_key( $taxonomy );
+ foreach ( $term_ids as $term_id ) {
+ $deps[] = 'term:' . sanitize_key( $taxonomy ) . ':' . (int) $term_id;
+ }
+ }
+ return $deps;
+ }
+
+ /**
+ * Return public navigation data, HTML, and dependencies.
+ *
+ * @return array
+ */
+ private static function navigation() {
+ $locations = get_nav_menu_locations();
+ $data = array();
+ $dependencies = array();
+ foreach ( array( 'header', 'mobile', 'footer' ) as $location ) {
+ $menu_id = isset( $locations[ $location ] ) ? (int) $locations[ $location ] : 0;
+ if ( 0 >= $menu_id ) {
+ $data[ $location ] = array();
+ continue;
+ }
+ $dependencies[] = 'menu:' . $menu_id;
+ $items = wp_get_nav_menu_items( $menu_id, array( 'update_post_term_cache' => false ) );
+ $data[ $location ] = array();
+ foreach ( is_array( $items ) ? $items : array() as $item ) {
+ $url = self::frontend_url_for_backend_url( $item->url );
+ $data[ $location ][] = array(
+ 'id' => (int) $item->ID,
+ 'parentId' => (int) $item->menu_item_parent,
+ 'label' => wp_strip_all_tags( $item->title ),
+ 'url' => $url,
+ 'target' => '_blank' === $item->target ? '_blank' : '',
+ 'classes' => array_values( array_filter( array_map( 'sanitize_html_class', (array) $item->classes ) ) ),
+ );
+ if ( 0 < (int) $item->object_id && in_array( $item->type, array( 'post_type', 'taxonomy' ), true ) ) {
+ if ( 'taxonomy' === $item->type ) {
+ $dependencies[] = 'term:' . sanitize_key( $item->object ) . ':' . (int) $item->object_id;
+ } else {
+ $linked = get_post( (int) $item->object_id );
+ if ( $linked instanceof WP_Post ) {
+ $dependencies = array_merge( $dependencies, self::post_dependencies( $linked ) );
+ }
+ }
+ }
+ }
+ }
+ return array(
+ 'data' => $data,
+ 'headerHtml' => self::menu_html( $data['header'] ?? array(), 'header' ),
+ 'footerHtml' => self::menu_html( $data['footer'] ?? array(), 'footer' ),
+ 'dependencies' => $dependencies,
+ );
+ }
+
+ /**
+ * Render a flat, accessible menu fallback.
+ *
+ * @param array $items Menu items.
+ * @param string $location Menu location.
+ * @return string
+ */
+ private static function menu_html( $items, $location ) {
+ if ( empty( $items ) ) {
+ return '';
+ }
+ $html = '';
+ }
+
+ /**
+ * Build an article fallback.
+ *
+ * @param string $kind Route kind.
+ * @param WP_Post $post Post.
+ * @param string $content Content HTML.
+ * @param array $image Featured image.
+ * @param array $author Author data.
+ * @param array $terms Terms.
+ * @return string
+ */
+ private static function article_html( $kind, $post, $content, $image, $author, $terms ) {
+ $html = '';
+ $html .= '' . self::image_html( $image );
+ $html .= '' . $content . '
';
+ $html .= self::terms_html( $terms ) . self::interactive_placeholder( $post ) . '';
+ return $html;
+ }
+
+ /**
+ * Build a product fallback with no cart, account, or viewer state.
+ *
+ * @param WP_Post $post Post.
+ * @param WC_Product $product Product.
+ * @param array $product_data Public product data.
+ * @param string $content Description.
+ * @param array $image Image.
+ * @param array $terms Terms.
+ * @return string
+ */
+ private static function product_html( $post, $product, $product_data, $content, $image, $terms ) {
+ $html = '';
+ $html .= '';
+ $html .= self::image_html( $image );
+ if ( '' !== trim( $product->get_short_description() ) ) {
+ $html .= '' . wp_kses_post( apply_filters( 'woocommerce_short_description', $product->get_short_description() ) ) . '
';
+ }
+ $html .= '' . $content . '
';
+ $html .= '' . esc_html__( 'Purchasing options load securely in the interactive storefront.', 'funkycommerce-headless' ) . '
' . wp_kses_post( $summary['priceHtml'] ) . '
';
+ }
+ if ( '' !== $summary['excerpt'] ) {
+ $html .= '' . esc_html( $summary['excerpt'] ) . '
';
+ }
+ return $html . '';
+ }
+
+ /**
+ * Build canonical SEO and JSON-LD data.
+ *
+ * @param array $route Route descriptor.
+ * @param array $rendered Render result.
+ * @param array $identity Artifact identity.
+ * @return array|WP_Error
+ */
+ private static function seo( $route, $rendered, $identity ) {
+ $data = $rendered['data'];
+ $site_name = get_bloginfo( 'name' );
+ $title = (string) ( $data['title'] ?? ( 'not_found' === $route['kind'] ? __( 'Page not found', 'funkycommerce-headless' ) : $site_name ) );
+ $description = (string) ( $data['excerpt'] ?? $data['description'] ?? get_bloginfo( 'description' ) );
+ $canonical = 'redirect' === ( $data['type'] ?? '' ) ? $rendered['redirectTo'] : $route['canonical'];
+ if ( ! funkycommerce_is_artifact_https_url( $canonical ) ) {
+ return new WP_Error( 'artifact_invalid_canonical', __( 'The configured public storefront URL must use HTTPS.', 'funkycommerce-headless' ) );
+ }
+
+ $robots = 'tombstone' === $rendered['state'] ? 'noindex, follow' : 'index, follow';
+ if ( $route['object'] instanceof WP_Post ) {
+ $yoast_title = (string) get_post_meta( $route['object']->ID, '_yoast_wpseo_title', true );
+ $yoast_desc = (string) get_post_meta( $route['object']->ID, '_yoast_wpseo_metadesc', true );
+ $yoast_url = self::frontend_url_for_backend_url( (string) get_post_meta( $route['object']->ID, '_yoast_wpseo_canonical', true ) );
+ if ( function_exists( 'wpseo_replace_vars' ) ) {
+ $yoast_title = wpseo_replace_vars( $yoast_title, $route['object'] );
+ $yoast_desc = wpseo_replace_vars( $yoast_desc, $route['object'] );
+ }
+ $title = '' !== trim( $yoast_title ) ? $yoast_title : $title;
+ $description = '' !== trim( $yoast_desc ) ? $yoast_desc : $description;
+ if ( funkycommerce_is_artifact_https_url( $yoast_url ) ) {
+ $canonical = $yoast_url;
+ }
+ if ( '1' === (string) get_post_meta( $route['object']->ID, '_yoast_wpseo_meta-robots-noindex', true ) ) {
+ $robots = 'noindex, follow';
+ }
+ }
+ if ( $site_name && $title !== $site_name && false === stripos( $title, $site_name ) ) {
+ $title .= ' | ' . $site_name;
+ }
+
+ $structured = array(
+ array(
+ '@context' => 'https://schema.org',
+ '@type' => 'WebPage',
+ 'name' => wp_strip_all_tags( $title ),
+ 'url' => $canonical,
+ 'inLanguage' => $identity['locale'],
+ 'description' => wp_strip_all_tags( $description ),
+ ),
+ );
+ if ( $route['object'] instanceof WP_Post && in_array( $route['object']->post_type, array( 'post', 'community_post' ), true ) ) {
+ $structured[] = array(
+ '@context' => 'https://schema.org',
+ '@type' => 'Article',
+ 'headline' => get_the_title( $route['object'] ),
+ 'datePublished' => get_post_time( 'c', true, $route['object'] ),
+ 'dateModified' => get_post_modified_time( 'c', true, $route['object'] ),
+ 'author' => array(
+ '@type' => 'Person',
+ 'name' => get_the_author_meta( 'display_name', $route['object']->post_author ),
+ ),
+ 'mainEntityOfPage' => $canonical,
+ );
+ } elseif ( $route['object'] instanceof WP_Post && 'product' === $route['object']->post_type ) {
+ $structured[] = self::product_structured_data( $route['object'], $data, $canonical );
+ }
+
+ $seo = array(
+ 'title' => wp_strip_all_tags( $title ),
+ 'description' => wp_strip_all_tags( $description ),
+ 'canonicalUrl' => $canonical,
+ 'robots' => $robots,
+ 'structuredData' => $structured,
+ );
+ $seo = apply_filters( 'funkycommerce_artifact_seo', $seo, $route, $rendered );
+ $valid = funkycommerce_validate_artifact_seo( $seo );
+ return is_wp_error( $valid ) ? $valid : $seo;
+ }
+
+ /**
+ * Build Product JSON-LD.
+ *
+ * @param WP_Post $post Product post.
+ * @param array $data Product data.
+ * @param string $canonical Canonical URL.
+ * @return array
+ */
+ private static function product_structured_data( $post, $data, $canonical ) {
+ $schema = array(
+ '@context' => 'https://schema.org',
+ '@type' => 'Product',
+ 'name' => get_the_title( $post ),
+ 'description' => self::post_excerpt( $post ),
+ 'url' => $canonical,
+ 'sku' => (string) ( $data['sku'] ?? '' ),
+ );
+ if ( ! empty( $data['featuredImage']['url'] ) ) {
+ $schema['image'] = array( $data['featuredImage']['url'] );
+ }
+ if ( '' !== (string) ( $data['price'] ?? '' ) ) {
+ $schema['offers'] = array(
+ '@type' => 'Offer',
+ 'price' => (string) $data['price'],
+ 'priceCurrency' => (string) ( $data['currency'] ?? funkycommerce_base_currency() ),
+ 'availability' => ! empty( $data['inStock'] ) ? 'https://schema.org/InStock' : 'https://schema.org/OutOfStock',
+ 'url' => $canonical,
+ );
+ }
+ return $schema;
+ }
+
+ /**
+ * Assemble a shell document using the four required slots.
+ *
+ * @param string $template Shell template.
+ * @param array $seo SEO metadata.
+ * @param string $route_css Route CSS.
+ * @param string $semantic_html Semantic content.
+ * @param array $hydration Hydration payload.
+ * @param array $identity Artifact identity.
+ * @return string|WP_Error
+ */
+ private static function assemble_document( $template, $seo, $route_css, $semantic_html, $hydration, $identity ) {
+ $structured_json = self::json_encode( $seo['structuredData'] );
+ $payload_json = self::json_encode( $hydration );
+ if ( is_wp_error( $structured_json ) ) {
+ return $structured_json;
+ }
+ if ( is_wp_error( $payload_json ) ) {
+ return $payload_json;
+ }
+
+ $head = '' . esc_html( $seo['title'] ) . ''
+ . ''
+ . ''
+ . ''
+ . '';
+ $css = '' === $route_css ? '' : '';
+ $payload = '';
+ $document = str_replace(
+ array(
+ '',
+ '',
+ '',
+ '',
+ ),
+ array( $head, $css, $semantic_html, $payload ),
+ $template
+ );
+ return preg_replace(
+ '/]*)\blang=(["\'])[^"\']*\2([^>]*)>/i',
+ '',
+ $document,
+ 1
+ );
+ }
+
+ /**
+ * Add route-specific aliases for the current frontend cache contract.
+ *
+ * @param array $route Route descriptor.
+ * @param array $rendered Render result.
+ * @param array $dependencies Dependencies.
+ * @return array
+ */
+ private static function route_seed_entries( $route, $rendered, $dependencies ) {
+ $data = $rendered['data'];
+ $uri = trailingslashit( $route['path'] );
+ $keys = array();
+ if ( $route['object'] instanceof WP_Post ) {
+ if ( 'page' === $route['object']->post_type ) {
+ $keys[] = 'page:' . $uri;
+ $keys[] = 'content-page-by-uri:v1:' . $uri;
+ } elseif ( 'product' === $route['object']->post_type ) {
+ $keys[] = 'product:' . $route['path'];
+ $keys[] = 'product:' . $route['object']->post_name;
+ } else {
+ $keys[] = 'post:' . $uri;
+ }
+
+ }
+ $entries = array();
+ foreach ( array_unique( $keys ) as $key ) {
+ $entries[] = array(
+ 'cacheKey' => $key,
+ 'value' => $data,
+ 'dependencies' => $dependencies,
+ );
+ }
+ return $entries;
+ }
+
+ /**
+ * Complete route data for cache keys whose frontend shape is stable.
+ *
+ * @param array $route Route descriptor.
+ * @param array $data Base route data.
+ * @param array $seo Artifact SEO.
+ * @param array $identity Artifact identity.
+ * @return array
+ */
+ private static function complete_route_data( $route, $data, $seo, $identity ) {
+ if ( ! $route['object'] instanceof WP_Post || 'page' !== $route['object']->post_type ) {
+ return $data;
+ }
+ $post = $route['object'];
+ $references = function_exists( 'funkycommerce_extract_headless_references' )
+ ? funkycommerce_extract_headless_references( (string) $post->post_content )
+ : array();
+ $translations = array();
+ if ( function_exists( 'pll_get_post_translations' ) ) {
+ foreach ( (array) pll_get_post_translations( $post->ID ) as $language => $post_id ) {
+ if ( (int) $post_id === (int) $post->ID ) {
+ continue;
+ }
+ $translation_url = get_permalink( (int) $post_id );
+ $translation_uri = self::path_from_url( $translation_url );
+ if ( null !== $translation_uri ) {
+ $translations[] = array(
+ 'databaseId' => (int) $post_id,
+ 'languageCode' => strtolower( str_replace( '_', '-', (string) $language ) ),
+ 'uri' => trailingslashit( $translation_uri ),
+ );
+ }
+ }
+ }
+ $image = is_array( $data['featuredImage'] ?? null )
+ ? array(
+ 'sourceUrl' => $data['featuredImage']['url'],
+ 'altText' => $data['featuredImage']['alt'],
+ 'srcSet' => $data['featuredImage']['srcSet'],
+ 'width' => $data['featuredImage']['width'],
+ 'height' => $data['featuredImage']['height'],
+ )
+ : null;
+ $author = is_array( $data['author'] ?? null )
+ ? array(
+ 'id' => base64_encode( 'user:' . $data['author']['databaseId'] ),
+ 'name' => $data['author']['name'],
+ 'description' => $data['author']['description'],
+ 'uri' => $data['author']['uri'],
+ 'avatarUrl' => $data['author']['avatarUrl'],
+ )
+ : null;
+ $page_seo = array(
+ 'title' => $seo['title'],
+ 'description' => $seo['description'],
+ 'keywords' => null,
+ 'canonical' => $seo['canonicalUrl'],
+ 'robots' => $seo['robots'],
+ 'opengraphTitle' => null,
+ 'opengraphDescription' => null,
+ 'opengraphType' => 'website',
+ 'opengraphUrl' => $seo['canonicalUrl'],
+ 'opengraphImage' => $image['sourceUrl'] ?? null,
+ 'opengraphPublishedTime' => get_post_time( 'c', true, $post ),
+ 'opengraphPublisher' => null,
+ 'opengraphModifiedTime' => get_post_modified_time( 'c', true, $post ),
+ 'opengraphAuthor' => $author['name'] ?? null,
+ 'siteName' => get_bloginfo( 'name' ),
+ 'twitterTitle' => null,
+ 'twitterDescription' => null,
+ 'breadcrumbs' => array(),
+ 'pageType' => 'WebPage',
+ 'articleType' => null,
+ );
+ return array_merge(
+ $data,
+ array(
+ 'content' => $data['headlessContent'],
+ 'headlessShortcodes' => array_values( $references ),
+ 'templateName' => get_page_template_slug( $post ) ?: null,
+ 'languageCode' => strtolower( $identity['locale'] ),
+ 'translations' => $translations,
+ 'author' => $author,
+ 'featuredImage' => $image,
+ 'scripts' => array(),
+ 'themeStyles' => function_exists( 'funkycommerce_get_headless_theme_styles' ) ? funkycommerce_get_headless_theme_styles() : array(),
+ 'seo' => $page_seo,
+ )
+ );
+ }
+
+ /**
+ * Return an attachment image payload.
+ *
+ * @param int $attachment_id Attachment ID.
+ * @return array|null
+ */
+ public static function attachment_image( $attachment_id ) {
+ $source = wp_get_attachment_image_src( $attachment_id, 'full' );
+ if ( ! is_array( $source ) || empty( $source[0] ) ) {
+ return null;
+ }
+ return array(
+ 'id' => (int) $attachment_id,
+ 'url' => esc_url_raw( $source[0] ),
+ 'alt' => (string) get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ),
+ 'width' => (int) $source[1],
+ 'height' => (int) $source[2],
+ 'srcSet' => (string) wp_get_attachment_image_srcset( $attachment_id, 'full' ),
+ );
+ }
+
+ /**
+ * Return a featured image payload.
+ *
+ * @param int $post_id Post ID.
+ * @return array|null
+ */
+ private static function featured_image( $post_id ) {
+ $image_id = get_post_thumbnail_id( $post_id );
+ return $image_id ? self::attachment_image( $image_id ) : null;
+ }
+
+ /**
+ * Render a responsive image.
+ *
+ * @param array|null $image Image data.
+ * @return string
+ */
+ private static function image_html( $image ) {
+ if ( ! is_array( $image ) || empty( $image['url'] ) ) {
+ return '';
+ }
+ $srcset = '' !== $image['srcSet'] ? ' srcset="' . esc_attr( $image['srcSet'] ) . '"' : '';
+ return '![' . esc_attr( $image['alt'] ) . '](' . esc_url( $image['url'] ) . ')
';
+ }
+
+ /**
+ * Return public author data.
+ *
+ * @param int $author_id User ID.
+ * @return array|null
+ */
+ private static function author_data( $author_id ) {
+ if ( 0 >= $author_id ) {
+ return null;
+ }
+ $user = get_userdata( $author_id );
+ if ( ! $user ) {
+ return null;
+ }
+ return array(
+ 'databaseId' => (int) $author_id,
+ 'name' => $user->display_name,
+ 'description' => (string) get_the_author_meta( 'description', $author_id ),
+ 'uri' => self::frontend_url_for_backend_url( get_author_posts_url( $author_id ) ),
+ 'avatarUrl' => esc_url_raw( get_avatar_url( $author_id, array( 'size' => 192 ) ) ),
+ );
+ }
+
+ /**
+ * Return public post terms.
+ *
+ * @param WP_Post $post Post.
+ * @return array
+ */
+ private static function post_terms( $post ) {
+ $result = array();
+ foreach ( get_object_taxonomies( $post->post_type, 'objects' ) as $taxonomy ) {
+ if ( ! $taxonomy->public ) {
+ continue;
+ }
+ $terms = wp_get_post_terms( $post->ID, $taxonomy->name );
+ if ( is_wp_error( $terms ) ) {
+ continue;
+ }
+ foreach ( $terms as $term ) {
+ $result[] = array(
+ 'taxonomy' => $taxonomy->name,
+ 'databaseId' => (int) $term->term_id,
+ 'name' => $term->name,
+ 'slug' => $term->slug,
+ 'uri' => self::frontend_url_for_backend_url( get_term_link( $term ) ),
+ );
+ }
+ }
+ return $result;
+ }
+
+ /**
+ * Render linked public terms.
+ *
+ * @param array $terms Terms.
+ * @return string
+ */
+ private static function terms_html( $terms ) {
+ if ( empty( $terms ) ) {
+ return '';
+ }
+ $html = '';
+ }
+
+ /**
+ * Render a safe client-only placeholder when application components exist.
+ *
+ * @param WP_Post $post Post.
+ * @return string
+ */
+ private static function interactive_placeholder( $post ) {
+ if ( ! function_exists( 'funkycommerce_extract_headless_references' ) ) {
+ return '';
+ }
+ $references = funkycommerce_extract_headless_references( (string) $post->post_content );
+ return empty( $references )
+ ? ''
+ : '' . esc_html__( 'Interactive page features load in the storefront application.', 'funkycommerce-headless' ) . '
' . esc_html__( 'Storefront preview — mirrors the published layout', 'funkycommerce-headless' ) . '
';
+ funkycommerce_backend_preview_render_nav_bar( 'header', __( 'Preview header menu', 'funkycommerce-headless' ) );
+}
+add_action( 'wp_body_open', 'funkycommerce_backend_preview_render_header' );
+
+/**
+ * Render the mirrored footer: the real footer menu, matching the storefront's
+ * footer navigation.
+ */
+function funkycommerce_backend_preview_render_footer() {
+ if ( ! funkycommerce_backend_preview_active() ) {
+ return;
+ }
+ funkycommerce_backend_preview_render_nav_bar( 'footer', __( 'Preview footer menu', 'funkycommerce-headless' ) );
+}
+add_action( 'wp_footer', 'funkycommerce_backend_preview_render_footer' );
diff --git a/inc/build-webhooks.php b/inc/build-webhooks.php
index a120341..f55470a 100644
--- a/inc/build-webhooks.php
+++ b/inc/build-webhooks.php
@@ -50,6 +50,7 @@ function funkycommerce_static_generation_config() {
'gtmContainerId' => (string) ( $settings['gtm_container_id'] ?? '' ),
'headScripts' => (string) ( $settings['head_scripts'] ?? '' ),
'bodyScripts' => (string) ( $settings['body_scripts'] ?? '' ),
+ 'footerScripts' => (string) ( $settings['footer_scripts'] ?? '' ),
);
}
@@ -57,6 +58,9 @@ function funkycommerce_static_generation_config() {
* Expose public build inputs to CI without exposing privileged deployment settings.
*/
function funkycommerce_register_static_generation_graphql() {
+ if ( ! funkycommerce_is_headless_mode() ) {
+ return;
+ }
register_graphql_field(
'RootQuery',
'funkycommerceStaticGenerationConfig',
@@ -75,6 +79,9 @@ function funkycommerce_register_static_generation_graphql() {
* Trigger the configured deployment build hook.
*/
function funkycommerce_trigger_storefront_build( $reason = 'scheduled' ) {
+ if ( ! funkycommerce_is_headless_mode() ) {
+ return;
+ }
$settings = funkycommerce_control_center_settings();
$webhook_url = $settings['build_webhook_url'] ?? '';
@@ -100,12 +107,32 @@ function funkycommerce_trigger_storefront_build( $reason = 'scheduled' ) {
if ( is_wp_error( $response ) ) {
error_log( 'FunkyCommerce storefront build webhook failed: ' . $response->get_error_message() );
+ funkycommerce_emit_notification(
+ 'theme.build_webhook_failed',
+ __( 'Storefront build webhook failed', 'funkycommerce-headless' ),
+ __( 'The configured storefront build service could not be reached.', 'funkycommerce-headless' ),
+ array(
+ __( 'Reason', 'funkycommerce-headless' ) => sanitize_key( $reason ),
+ __( 'Error', 'funkycommerce-headless' ) => $response->get_error_code(),
+ ),
+ admin_url( 'themes.php?page=funkycommerce-control-center' )
+ );
return;
}
$status = wp_remote_retrieve_response_code( $response );
if ( $status < 200 || $status >= 300 ) {
error_log( sprintf( 'FunkyCommerce storefront build webhook returned HTTP %d.', $status ) );
+ funkycommerce_emit_notification(
+ 'theme.build_webhook_failed',
+ __( 'Storefront build webhook failed', 'funkycommerce-headless' ),
+ __( 'The configured storefront build service rejected the request.', 'funkycommerce-headless' ),
+ array(
+ __( 'Reason', 'funkycommerce-headless' ) => sanitize_key( $reason ),
+ __( 'HTTP status', 'funkycommerce-headless' ) => (int) $status,
+ ),
+ admin_url( 'themes.php?page=funkycommerce-control-center' )
+ );
}
}
add_action( FUNKYCOMMERCE_BUILD_EVENT, 'funkycommerce_trigger_storefront_build' );
@@ -147,7 +174,7 @@ function funkycommerce_sync_build_schedule( $old_value = array(), $value = array
}
$value = is_array( $value ) ? $value : array();
- if ( 'yes' === ( $value['periodic_rebuild'] ?? 'no' ) && ! empty( $value['build_webhook_url'] ) ) {
+ if ( 'build-webhook' === ( $value['artifact_mode'] ?? 'build-webhook' ) && 'no' !== ( $value['headless_mode'] ?? 'yes' ) && 'yes' === ( $value['periodic_rebuild'] ?? 'no' ) && ! empty( $value['build_webhook_url'] ) ) {
wp_schedule_event( time() + HOUR_IN_SECONDS, 'funkycommerce_rebuild_interval', FUNKYCOMMERCE_BUILD_EVENT );
}
}
@@ -157,8 +184,12 @@ function funkycommerce_sync_build_schedule( $old_value = array(), $value = array
* Restore a missing recurring event after theme activation or a cron reset.
*/
function funkycommerce_ensure_build_schedule() {
+ if ( ! funkycommerce_is_headless_mode() ) {
+ return;
+ }
$settings = funkycommerce_control_center_settings();
if (
+ 'build-webhook' === funkycommerce_artifact_mode() &&
'yes' === ( $settings['periodic_rebuild'] ?? 'no' ) &&
! empty( $settings['build_webhook_url'] ) &&
! wp_next_scheduled( FUNKYCOMMERCE_BUILD_EVENT )
@@ -172,6 +203,9 @@ function funkycommerce_ensure_build_schedule() {
* Debounce publishing changes into one build request.
*/
function funkycommerce_schedule_content_build() {
+ if ( ! funkycommerce_is_headless_mode() || 'build-webhook' !== funkycommerce_artifact_mode() ) {
+ return;
+ }
$settings = funkycommerce_control_center_settings();
if ( empty( $settings['build_webhook_url'] ) || wp_next_scheduled( FUNKYCOMMERCE_BUILD_DEBOUNCE_EVENT ) ) {
return;
diff --git a/inc/checkout-context.php b/inc/checkout-context.php
new file mode 100644
index 0000000..cad87da
--- /dev/null
+++ b/inc/checkout-context.php
@@ -0,0 +1,802 @@
+ \Automattic\WooCommerce\StoreApi\Schemas\V1\CheckoutSchema::IDENTIFIER,
+ 'namespace' => FUNKYCOMMERCE_CHECKOUT_CONTEXT_NAMESPACE,
+ 'data_callback' => static fn() => array(),
+ 'schema_callback' => static function () {
+ $fields = array();
+ foreach ( array( 'language', 'backend_language', 'currency', 'account_username', 'marketing_consent_label', 'session_entry', 'referrer', 'user_agent', 'session_start_time' ) as $field ) {
+ $fields[ $field ] = array(
+ 'type' => 'string',
+ 'arg_options' => array(
+ 'sanitize_callback' => 'sanitize_text_field',
+ ),
+ );
+ }
+ $fields['marketing_consent'] = array(
+ 'type' => 'boolean',
+ 'default' => false,
+ );
+ $fields['digital_order'] = array(
+ 'type' => 'boolean',
+ 'default' => false,
+ );
+ return $fields;
+ },
+ 'schema_type' => ARRAY_A,
+ )
+ );
+}
+add_action( 'init', 'funkycommerce_register_checkout_context_extension', 20 );
+
+/**
+ * Read and validate a language identifier from checkout extension data.
+ */
+function funkycommerce_checkout_language( $value, $fallback = '' ) {
+ $value = trim( (string) $value );
+ if ( '' === $value || ! preg_match( '/^[a-zA-Z]{2,3}(?:[-_][a-zA-Z0-9]{2,8})*$/', $value ) ) {
+ return $fallback;
+ }
+ return substr( $value, 0, 40 );
+}
+
+function funkycommerce_is_store_api_checkout_request() {
+ if ( ! defined( 'REST_REQUEST' ) || ! REST_REQUEST ) {
+ return false;
+ }
+ $request_uri = rawurldecode( wp_unslash( $_SERVER['REQUEST_URI'] ?? '' ) );
+ return false !== strpos( $request_uri, '/wc/store/v1/checkout' );
+}
+
+/**
+ * Whether the backend allows Stripe BLIK to be presented for selected PLN checkout.
+ */
+function funkycommerce_blik_presentation_enabled() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : array();
+ return funkycommerce_is_pro() && 'yes' === ( $settings['blik_enabled'] ?? 'no' );
+}
+
+/**
+ * Capture validated checkout context before WooCommerce validates the request.
+ */
+function funkycommerce_capture_store_api_checkout_context( $response, $handler, $request ) {
+ if (
+ $request instanceof \WP_REST_Request
+ && false !== strpos( $request->get_route(), '/wc/store/v1/checkout' )
+ ) {
+ $extensions = (array) $request->get_param( 'extensions' );
+ $context = (array) ( $extensions[ FUNKYCOMMERCE_CHECKOUT_CONTEXT_NAMESPACE ] ?? array() );
+ $currency = strtoupper( sanitize_text_field( (string) ( $context['currency'] ?? '' ) ) );
+
+ global $funkycommerce_store_api_payment_currency;
+ $funkycommerce_store_api_payment_currency = preg_match( '/^[A-Z]{3}$/', $currency ) ? $currency : '';
+ global $funkycommerce_store_api_digital_order;
+ $funkycommerce_store_api_digital_order = true === ( $context['digital_order'] ?? false );
+ }
+ return $response;
+}
+add_filter( 'rest_request_before_callbacks', 'funkycommerce_capture_store_api_checkout_context', 10, 3 );
+
+/**
+ * Digital orders do not need a geographic billing destination. Keep identity and
+ * contact fields required while allowing WooCommerce to validate an empty address.
+ */
+function funkycommerce_relax_digital_checkout_address_locale( $locales ) {
+ global $funkycommerce_store_api_digital_order;
+ if ( ! $funkycommerce_store_api_digital_order || ! funkycommerce_is_store_api_checkout_request() ) {
+ return $locales;
+ }
+
+ foreach ( $locales as &$locale ) {
+ foreach ( array( 'address_1', 'city', 'state', 'postcode' ) as $field ) {
+ if ( isset( $locale[ $field ] ) ) {
+ $locale[ $field ]['required'] = false;
+ }
+ }
+ }
+ unset( $locale );
+
+ return $locales;
+}
+add_filter( 'woocommerce_get_country_locale', 'funkycommerce_relax_digital_checkout_address_locale', 100 );
+
+/**
+ * Read the selected currency before WooCommerce validates the requested gateway.
+ */
+function funkycommerce_store_api_payment_currency() {
+ global $funkycommerce_store_api_payment_currency;
+ $currency = $funkycommerce_store_api_payment_currency
+ ?? sanitize_text_field( wp_unslash( $_POST['funkycommerce_selected_currency'] ?? '' ) );
+ $currency = strtoupper( (string) $currency );
+ return preg_match( '/^[A-Z]{3}$/', $currency ) ? $currency : '';
+}
+
+/**
+ * Make Woo Stripe's BLIK gateway selectable for a PLN storefront selection even when
+ * WooCommerce's persisted base currency causes the gateway's own availability check to hide it.
+ */
+function funkycommerce_enable_selected_blik_gateway( $gateways ) {
+ if (
+ ! funkycommerce_is_store_api_checkout_request()
+ || 'PLN' !== funkycommerce_store_api_payment_currency()
+ || ! funkycommerce_blik_presentation_enabled()
+ || empty( $gateways['stripe'] )
+ || ! function_exists( 'WC' )
+ || ! WC()->payment_gateways()
+ ) {
+ return $gateways;
+ }
+
+ $registered = WC()->payment_gateways()->payment_gateways();
+ $blik = $registered['stripe_blik'] ?? null;
+ if ( $blik instanceof \WC_Payment_Gateway && 'yes' === $blik->enabled ) {
+ $gateways['stripe_blik'] = $blik;
+ }
+ return $gateways;
+}
+add_filter( 'woocommerce_available_payment_gateways', 'funkycommerce_enable_selected_blik_gateway', 100 );
+
+/**
+ * Convert a stored order amount using the backend-owned display currency rate.
+ */
+function funkycommerce_convert_checkout_amount( $value, $rate ) {
+ return wc_format_decimal( (float) $value * (float) $rate, wc_get_price_decimals() );
+}
+
+/**
+ * Convert nested WooCommerce item tax arrays without changing their tax-rate identities.
+ */
+function funkycommerce_convert_checkout_taxes( $taxes, $rate ) {
+ if ( ! is_array( $taxes ) ) {
+ return $taxes;
+ }
+ foreach ( $taxes as &$amounts ) {
+ if ( ! is_array( $amounts ) ) {
+ continue;
+ }
+ foreach ( $amounts as &$amount ) {
+ $amount = funkycommerce_convert_checkout_amount( $amount, $rate );
+ }
+ unset( $amount );
+ }
+ unset( $amounts );
+ return $taxes;
+}
+
+/**
+ * Persist a BLIK order in PLN using the same backend rate used by storefront display prices.
+ */
+function funkycommerce_convert_blik_order_to_pln( $order, $selected_currency ) {
+ if ( ! $order instanceof \WC_Order || 'PLN' !== $selected_currency ) {
+ return;
+ }
+
+ $base_currency = strtoupper( (string) get_option( 'woocommerce_currency', 'EUR' ) );
+ if ( 'PLN' === $base_currency ) {
+ $order->set_currency( 'PLN' );
+ return;
+ }
+
+ $rates = function_exists( 'funkycommerce_currency_rates' ) ? funkycommerce_currency_rates() : array();
+ $rate = (float) ( $rates['PLN'] ?? 0 );
+ if ( $rate <= 0 ) {
+ throw new \Automattic\WooCommerce\StoreApi\Exceptions\RouteException(
+ 'funkycommerce-blik-rate-unavailable',
+ __( 'The PLN conversion rate is currently unavailable. Choose another payment method or try again shortly.', 'funkycommerce-headless' ),
+ 503
+ );
+ }
+
+ foreach ( $order->get_items( array( 'line_item', 'shipping', 'fee', 'coupon', 'tax' ) ) as $item ) {
+ foreach ( array( 'subtotal', 'subtotal_tax', 'total', 'total_tax', 'amount', 'discount', 'discount_tax', 'tax_total', 'shipping_tax_total' ) as $property ) {
+ $getter = 'get_' . $property;
+ $setter = 'set_' . $property;
+ if ( is_callable( array( $item, $getter ) ) && is_callable( array( $item, $setter ) ) ) {
+ $item->{$setter}( funkycommerce_convert_checkout_amount( $item->{$getter}(), $rate ) );
+ }
+ }
+ if ( is_callable( array( $item, 'get_taxes' ) ) && is_callable( array( $item, 'set_taxes' ) ) ) {
+ $item->set_taxes( funkycommerce_convert_checkout_taxes( $item->get_taxes(), $rate ) );
+ }
+ $item->save();
+ }
+
+ $order->calculate_totals( false );
+ $order->set_currency( 'PLN' );
+ $order->update_meta_data( '_funkycommerce_base_currency', $base_currency );
+ $order->update_meta_data( '_funkycommerce_currency_rate', $rate );
+}
+
+function funkycommerce_checkout_account_mode() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : array();
+ $mode = sanitize_key( (string) ( $settings['checkout_account_mode'] ?? 'optional' ) );
+ return in_array( $mode, array( 'guest', 'optional', 'required' ), true ) ? $mode : 'optional';
+}
+
+/**
+ * Apply the theme's account policy only to the headless Store API checkout.
+ */
+function funkycommerce_enable_store_api_checkout_registration( $enabled ) {
+ if ( ! funkycommerce_is_store_api_checkout_request() ) {
+ return $enabled;
+ }
+ return 'guest' !== funkycommerce_checkout_account_mode();
+}
+add_filter( 'woocommerce_checkout_registration_enabled', 'funkycommerce_enable_store_api_checkout_registration' );
+
+function funkycommerce_require_store_api_checkout_registration( $required ) {
+ if ( ! funkycommerce_is_store_api_checkout_request() ) {
+ return $required;
+ }
+ if ( funkycommerce_graphql_login_user_id() ) {
+ return false;
+ }
+ return 'required' === funkycommerce_checkout_account_mode();
+}
+add_filter( 'woocommerce_checkout_registration_required', 'funkycommerce_require_store_api_checkout_registration' );
+
+function funkycommerce_store_api_guest_checkout_option( $value ) {
+ if ( ! funkycommerce_is_store_api_checkout_request() ) {
+ return $value;
+ }
+ return 'required' === funkycommerce_checkout_account_mode() ? 'no' : 'yes';
+}
+add_filter( 'option_woocommerce_enable_guest_checkout', 'funkycommerce_store_api_guest_checkout_option' );
+
+function funkycommerce_suppress_store_api_new_account_email( $enabled ) {
+ global $funkycommerce_checkout_account_notification_pending;
+ return ! empty( $funkycommerce_checkout_account_notification_pending ) ? false : $enabled;
+}
+add_filter( 'woocommerce_email_enabled_customer_new_account', 'funkycommerce_suppress_store_api_new_account_email' );
+
+function funkycommerce_send_store_api_account_notification( $customer_id ) {
+ global $funkycommerce_checkout_account_notification_pending;
+ if ( empty( $funkycommerce_checkout_account_notification_pending ) ) {
+ return;
+ }
+ if ( 'yes' === get_user_meta( $customer_id, '_funkycommerce_checkout_account_notification_sent', true ) ) {
+ $funkycommerce_checkout_account_notification_pending = false;
+ return;
+ }
+ wp_new_user_notification( $customer_id, null, 'user' );
+ update_user_meta( $customer_id, '_funkycommerce_checkout_account_notification_sent', 'yes' );
+ $funkycommerce_checkout_account_notification_pending = false;
+}
+add_action( 'woocommerce_created_customer', 'funkycommerce_send_store_api_account_notification', 20 );
+
+/**
+ * Permit the headless storefront to call Woo Stripe's signed post-confirmation endpoint.
+ *
+ * The endpoint validates a one-time Stripe nonce, order ID, and intent ID before changing
+ * an order. It is not a REST route, so WordPress's normal REST CORS headers do not apply.
+ */
+function funkycommerce_allow_stripe_order_status_cors() {
+ $action = sanitize_key( wp_unslash( $_GET['wc-ajax'] ?? '' ) );
+ if ( 'wc_stripe_update_order_status' !== $action ) {
+ return;
+ }
+
+ header( 'Access-Control-Allow-Origin: *' );
+ header( 'Vary: Origin', false );
+}
+add_action( 'send_headers', 'funkycommerce_allow_stripe_order_status_cors' );
+
+/**
+ * Restore the order's checkout user before Woo Stripe verifies its user-bound nonce.
+ *
+ * Headless Store API requests cannot retain WordPress's newly issued auth cookie across
+ * origins. The secret order key proves ownership before this request adopts the same user
+ * that generated Woo Stripe's nonce.
+ */
+function funkycommerce_authenticate_stripe_order_status_request() {
+ $action = sanitize_key( wp_unslash( $_GET['wc-ajax'] ?? '' ) );
+ if ( 'wc_stripe_update_order_status' !== $action ) {
+ return;
+ }
+
+ $order_id = absint( $_POST['order_id'] ?? 0 );
+ $order_key = sanitize_text_field( wp_unslash( $_POST['order_key'] ?? '' ) );
+ $order = $order_id ? wc_get_order( $order_id ) : false;
+ if (
+ ! $order instanceof \WC_Order
+ || '' === $order_key
+ || ! hash_equals( (string) $order->get_order_key(), $order_key )
+ ) {
+ return;
+ }
+
+ wp_set_current_user( (int) $order->get_customer_id() );
+}
+add_action( 'init', 'funkycommerce_authenticate_stripe_order_status_request', 1 );
+
+/**
+ * Resolve an order object from a WPGraphQL Order model.
+ */
+function funkycommerce_graphql_order_object( $source ) {
+ if ( class_exists( 'WC_Order' ) && $source instanceof \WC_Order ) {
+ return $source;
+ }
+ if ( is_object( $source ) && method_exists( $source, 'get_id' ) ) {
+ return wc_get_order( $source->get_id() );
+ }
+ $order_id = is_object( $source ) ? ( $source->databaseId ?? $source->ID ?? 0 ) : 0;
+ return $order_id ? wc_get_order( $order_id ) : false;
+}
+
+/**
+ * Attach the authenticated customer and storefront context to the persisted order.
+ */
+function funkycommerce_apply_store_api_checkout_context( $order, $request ) {
+ if ( ! $order instanceof \WC_Order || ! $request instanceof \WP_REST_Request ) {
+ return;
+ }
+
+ $user_id = funkycommerce_graphql_login_user_id();
+ if ( $user_id && (int) $order->get_customer_id() !== $user_id ) {
+ $order->set_customer_id( $user_id );
+ }
+
+ $extensions = (array) $request->get_param( 'extensions' );
+ $context = isset( $extensions[ FUNKYCOMMERCE_CHECKOUT_CONTEXT_NAMESPACE ] )
+ ? (array) $extensions[ FUNKYCOMMERCE_CHECKOUT_CONTEXT_NAMESPACE ]
+ : array();
+ $language = funkycommerce_checkout_language( $context['language'] ?? '' );
+ $backend = funkycommerce_checkout_language( $context['backend_language'] ?? '', $language );
+ $currency = strtoupper( sanitize_text_field( (string) ( $context['currency'] ?? '' ) ) );
+ $payment_method = sanitize_key( (string) $request->get_param( 'payment_method' ) );
+ if ( 'stripe_blik' === $payment_method ) {
+ if ( 'PLN' !== $currency || ! funkycommerce_blik_presentation_enabled() ) {
+ throw new \Automattic\WooCommerce\StoreApi\Exceptions\RouteException(
+ 'funkycommerce-blik-unavailable',
+ __( 'BLIK is available only when PLN is selected and BLIK presentation is enabled.', 'funkycommerce-headless' ),
+ 400
+ );
+ }
+ funkycommerce_convert_blik_order_to_pln( $order, $currency );
+ }
+ $account_mode = funkycommerce_checkout_account_mode();
+ $create_account = filter_var( $request->get_param( 'create_account' ), FILTER_VALIDATE_BOOLEAN );
+ if ( $user_id || 'guest' === $account_mode ) {
+ $create_account = false;
+ } elseif ( 'required' === $account_mode ) {
+ $create_account = true;
+ }
+ $request->set_param( 'create_account', $create_account );
+
+ global $funkycommerce_checkout_account_username;
+ global $funkycommerce_checkout_account_notification_pending;
+ $funkycommerce_checkout_account_username = '';
+ $funkycommerce_checkout_account_notification_pending = $create_account;
+ if ( $create_account ) {
+ $requested_username = trim( (string) ( $context['account_username'] ?? '' ) );
+ $account_username = sanitize_user( $requested_username, true );
+ if (
+ $requested_username !== $account_username
+ || ! preg_match( '/^[A-Za-z0-9._-]{3,60}$/', $account_username )
+ || ! validate_username( $account_username )
+ ) {
+ throw new \Automattic\WooCommerce\StoreApi\Exceptions\RouteException(
+ 'registration-error-invalid-username',
+ __( 'Use 3–60 letters, numbers, dots, underscores, or hyphens for the account username.', 'funkycommerce-headless' ),
+ 400
+ );
+ }
+ if ( username_exists( $account_username ) ) {
+ throw new \Automattic\WooCommerce\StoreApi\Exceptions\RouteException(
+ 'registration-error-username-exists',
+ __( 'An account is already registered with that username. Please choose another.', 'woocommerce' ),
+ 400
+ );
+ }
+ $funkycommerce_checkout_account_username = $account_username;
+ $order->update_meta_data( '_funkycommerce_checkout_account_username', $account_username );
+ }
+
+ if ( $language ) {
+ $language = strtolower( $language );
+ $backend = strtolower( $backend );
+ $order->update_meta_data( '_funkycommerce_order_language', $language );
+ $order->update_meta_data( '_order_language', $backend );
+ if ( defined( 'ICL_SITEPRESS_VERSION' ) ) {
+ $order->update_meta_data( 'wpml_language', $backend );
+ }
+
+ if ( function_exists( 'pll_set_post_language' ) && $order->get_id() ) {
+ pll_set_post_language( $order->get_id(), $language );
+ }
+ }
+
+ $marketing_consent = ! empty( $context['marketing_consent'] );
+ $marketing_label = sanitize_text_field( (string) ( $context['marketing_consent_label'] ?? '' ) );
+ if ( '' === $marketing_label ) {
+ $marketing_label = 'Keep me posted about new drops, offers, and restocks by email.';
+ }
+ $order->update_meta_data( '_funkycommerce_marketing_consent', $marketing_consent ? 'yes' : 'no' );
+ $order->update_meta_data(
+ 'Email marketing consent',
+ sprintf( '%s - %s', $marketing_consent ? 'Yes' : 'No', $marketing_label )
+ );
+
+ if (
+ ! $order->meta_exists( '_wc_order_attribution_source_type' )
+ && has_action( 'woocommerce_order_save_attribution_data' )
+ ) {
+ do_action(
+ 'woocommerce_order_save_attribution_data',
+ $order,
+ array(
+ 'source_type' => 'utm',
+ 'utm_source' => 'storefront',
+ 'utm_medium' => 'headless',
+ 'session_entry' => esc_url_raw( (string) ( $context['session_entry'] ?? '' ) ),
+ 'referrer' => esc_url_raw( (string) ( $context['referrer'] ?? '' ) ),
+ 'user_agent' => sanitize_text_field( (string) ( $context['user_agent'] ?? '' ) ),
+ 'session_start_time' => sanitize_text_field( (string) ( $context['session_start_time'] ?? '' ) ),
+ 'session_pages' => '1',
+ 'session_count' => '1',
+ )
+ );
+ }
+}
+add_action( 'woocommerce_store_api_checkout_update_order_from_request', 'funkycommerce_apply_store_api_checkout_context', 5, 2 );
+
+/**
+ * Replace WooCommerce's generated Store API username with the validated checkout value.
+ */
+function funkycommerce_apply_store_api_checkout_username( $customer_data ) {
+ global $funkycommerce_checkout_account_username;
+ if (
+ ! empty( $funkycommerce_checkout_account_username )
+ && 'store-api' === ( $customer_data['source'] ?? '' )
+ ) {
+ $customer_data['user_login'] = $funkycommerce_checkout_account_username;
+ }
+ return $customer_data;
+}
+add_filter( 'woocommerce_new_customer_data', 'funkycommerce_apply_store_api_checkout_username', 20 );
+
+/**
+ * Attach the customer created by this Store API request to its order.
+ *
+ * WooCommerce normally persists this relationship itself. The explicit repair protects
+ * Cart-Token checkouts from integrations that leave the newly created order as a guest.
+ */
+function funkycommerce_link_store_api_checkout_customer( $order ) {
+ if ( ! $order instanceof \WC_Order ) {
+ return;
+ }
+
+ $username = sanitize_user( (string) $order->get_meta( '_funkycommerce_checkout_account_username' ), true );
+ $email = sanitize_email( (string) $order->get_billing_email() );
+ if ( '' === $username || '' === $email ) {
+ return;
+ }
+ $user = 0 < (int) $order->get_customer_id()
+ ? get_userdata( (int) $order->get_customer_id() )
+ : get_user_by( 'login', $username );
+ if (
+ ! $user instanceof \WP_User
+ || ! hash_equals( strtolower( (string) $user->user_email ), strtolower( $email ) )
+ ) {
+ return;
+ }
+
+ if ( (int) $order->get_customer_id() !== (int) $user->ID ) {
+ $order->set_customer_id( $user->ID );
+ }
+ $order->delete_meta_data( '_funkycommerce_checkout_account_username' );
+ $order->save();
+}
+add_action( 'woocommerce_store_api_checkout_order_processed', 'funkycommerce_link_store_api_checkout_customer', 5 );
+
+/**
+ * Let the newly authenticated headless customer claim the order from their checkout.
+ */
+function funkycommerce_can_claim_checkout_order() {
+ if ( funkycommerce_graphql_login_user_id() ) {
+ return true;
+ }
+ return new \WP_Error(
+ 'funkycommerce_order_claim_auth_required',
+ __( 'Sign in to link this order to your account.', 'funkycommerce-headless' ),
+ array( 'status' => 401 )
+ );
+}
+
+function funkycommerce_claim_checkout_order( \WP_REST_Request $request ) {
+ $order = funkycommerce_checkout_order_from_credentials(
+ $request['id'],
+ sanitize_text_field( (string) $request->get_param( 'key' ) ),
+ sanitize_email( (string) $request->get_param( 'email' ) )
+ );
+ if ( is_wp_error( $order ) ) {
+ return $order;
+ }
+
+ $user_id = funkycommerce_graphql_login_user_id();
+ $user = $user_id ? get_userdata( $user_id ) : false;
+ if (
+ ! $user instanceof \WP_User
+ || ! hash_equals( strtolower( (string) $user->user_email ), strtolower( (string) $order->get_billing_email() ) )
+ ) {
+ return new \WP_Error(
+ 'funkycommerce_order_claim_forbidden',
+ __( 'The signed-in account does not match this order.', 'funkycommerce-headless' ),
+ array( 'status' => 403 )
+ );
+ }
+
+ $current_customer_id = (int) $order->get_customer_id();
+ if ( $current_customer_id && $current_customer_id !== $user_id ) {
+ return new \WP_Error(
+ 'funkycommerce_order_already_claimed',
+ __( 'This order belongs to another account.', 'funkycommerce-headless' ),
+ array( 'status' => 409 )
+ );
+ }
+ if ( ! $current_customer_id ) {
+ $order->set_customer_id( $user_id );
+ $order->delete_meta_data( '_funkycommerce_checkout_account_username' );
+ $order->save();
+ }
+
+ return rest_ensure_response( array( 'customer_id' => $user_id ) );
+}
+
+function funkycommerce_register_checkout_order_claim_rest() {
+ register_rest_route(
+ 'funkycommerce/v1',
+ '/orders/(?P\d+)/claim-customer',
+ array(
+ 'methods' => \WP_REST_Server::CREATABLE,
+ 'callback' => 'funkycommerce_claim_checkout_order',
+ 'permission_callback' => 'funkycommerce_can_claim_checkout_order',
+ 'args' => array(
+ 'id' => array( 'required' => true, 'sanitize_callback' => 'absint' ),
+ 'key' => array( 'required' => true, 'sanitize_callback' => 'sanitize_text_field' ),
+ 'email' => array( 'required' => true, 'sanitize_callback' => 'sanitize_email' ),
+ ),
+ )
+ );
+}
+add_action( 'rest_api_init', 'funkycommerce_register_checkout_order_claim_rest' );
+
+/**
+ * Let a succeeded BLIK webhook finish an order previously moved to on-hold.
+ */
+function funkycommerce_allow_on_hold_blik_payment_processing( $statuses, $order ) {
+ if ( $order instanceof \WC_Order && 'stripe_blik' === $order->get_payment_method() ) {
+ $statuses[] = 'on-hold';
+ }
+ return array_values( array_unique( $statuses ) );
+}
+add_filter( 'wc_stripe_allowed_payment_processing_statuses', 'funkycommerce_allow_on_hold_blik_payment_processing', 10, 2 );
+
+/**
+ * Validate secret guest credentials before exposing or changing payment state.
+ */
+function funkycommerce_checkout_order_from_credentials( $order_id, $order_key, $billing_email ) {
+ $order = wc_get_order( absint( $order_id ) );
+ if ( ! $order instanceof \WC_Order ) {
+ return new \WP_Error(
+ 'funkycommerce_order_not_found',
+ __( 'Order not found.', 'funkycommerce-headless' ),
+ array( 'status' => 404 )
+ );
+ }
+
+ if (
+ '' === $order_key
+ || '' === $billing_email
+ || ! hash_equals( (string) $order->get_order_key(), (string) $order_key )
+ || ! hash_equals( strtolower( (string) $order->get_billing_email() ), strtolower( (string) $billing_email ) )
+ ) {
+ return new \WP_Error(
+ 'funkycommerce_order_credentials_invalid',
+ __( 'The order credentials are invalid or expired.', 'funkycommerce-headless' ),
+ array( 'status' => 403 )
+ );
+ }
+
+ return $order;
+}
+
+/**
+ * Reconcile a BLIK intent through Woo Stripe's own verified webhook processing path.
+ */
+function funkycommerce_reconcile_blik_order( \WP_REST_Request $request ) {
+ $order = funkycommerce_checkout_order_from_credentials(
+ $request['id'],
+ sanitize_text_field( (string) $request->get_param( 'key' ) ),
+ sanitize_email( (string) $request->get_param( 'email' ) )
+ );
+ if ( is_wp_error( $order ) ) {
+ return $order;
+ }
+ if ( 'stripe_blik' !== $order->get_payment_method() ) {
+ return new \WP_Error(
+ 'funkycommerce_not_blik_order',
+ __( 'This order was not placed with BLIK.', 'funkycommerce-headless' ),
+ array( 'status' => 400 )
+ );
+ }
+
+ funkycommerce_link_store_api_checkout_customer( $order );
+ $order = wc_get_order( $order->get_id() );
+ if ( $order->is_paid() ) {
+ return rest_ensure_response(
+ array(
+ 'payment_status' => 'success',
+ 'intent_status' => 'succeeded',
+ 'order_status' => $order->get_status(),
+ )
+ );
+ }
+
+ if (
+ ! class_exists( 'WC_Stripe_API' )
+ || ! class_exists( 'WC_Stripe_Order_Helper' )
+ || ! class_exists( 'WC_Stripe_Webhook_Handler' )
+ ) {
+ return new \WP_Error(
+ 'funkycommerce_stripe_unavailable',
+ __( 'WooCommerce Stripe is unavailable for BLIK verification.', 'funkycommerce-headless' ),
+ array( 'status' => 503 )
+ );
+ }
+
+ $order_helper = \WC_Stripe_Order_Helper::get_instance();
+ $intent_id = method_exists( $order_helper, 'get_intent_id_from_order' )
+ ? $order_helper->get_intent_id_from_order( $order )
+ : $order->get_meta( '_stripe_intent_id' );
+ if ( ! is_string( $intent_id ) || 0 !== strpos( $intent_id, 'pi_' ) ) {
+ return new \WP_Error(
+ 'funkycommerce_blik_intent_missing',
+ __( 'WooCommerce has not recorded the BLIK payment intent yet.', 'funkycommerce-headless' ),
+ array( 'status' => 409 )
+ );
+ }
+
+ $intent = \WC_Stripe_API::retrieve( 'payment_intents/' . rawurlencode( $intent_id ) . '?expand[]=latest_charge' );
+ if ( is_wp_error( $intent ) || ! is_object( $intent ) || ! empty( $intent->error ) ) {
+ return new \WP_Error(
+ 'funkycommerce_blik_intent_unavailable',
+ __( 'Stripe could not verify the BLIK payment intent.', 'funkycommerce-headless' ),
+ array( 'status' => 502 )
+ );
+ }
+
+ try {
+ if ( method_exists( $order_helper, 'validate_intent_for_order' ) ) {
+ $order_helper->validate_intent_for_order( $order, $intent );
+ } elseif ( ! hash_equals( $intent_id, (string) ( $intent->id ?? '' ) ) ) {
+ throw new \RuntimeException( 'Stripe intent does not match the order.' );
+ }
+
+ $intent_status = sanitize_key( (string) ( $intent->status ?? '' ) );
+ $event_type = '';
+ if ( 'succeeded' === $intent_status ) {
+ $event_type = 'payment_intent.succeeded';
+ } elseif ( 'processing' === $intent_status ) {
+ $event_type = 'payment_intent.processing';
+ } elseif ( in_array( $intent_status, array( 'canceled', 'requires_payment_method' ), true ) ) {
+ $event_type = 'payment_intent.payment_failed';
+ }
+
+ if ( $event_type ) {
+ $notification = (object) array(
+ 'type' => $event_type,
+ 'data' => (object) array( 'object' => $intent ),
+ );
+ $handler = new \WC_Stripe_Webhook_Handler();
+ $handler->process_payment_intent( $notification );
+ $order = wc_get_order( $order->get_id() );
+ }
+ } catch ( \Throwable $error ) {
+ error_log( sprintf( 'FunkyCommerce BLIK reconciliation failed for order %d: %s', $order->get_id(), $error->getMessage() ) );
+ funkycommerce_emit_notification(
+ 'theme.crypto_payment_failed',
+ __( 'Payment reconciliation failed', 'funkycommerce-headless' ),
+ __( 'A verified payment intent could not be reconciled with its WooCommerce order.', 'funkycommerce-headless' ),
+ array(
+ __( 'Order ID', 'funkycommerce-headless' ) => $order->get_id(),
+ __( 'Gateway', 'funkycommerce-headless' ) => 'stripe-blik',
+ ),
+ $order->get_edit_order_url()
+ );
+ return new \WP_Error(
+ 'funkycommerce_blik_reconciliation_failed',
+ __( 'WooCommerce could not reconcile the verified BLIK payment.', 'funkycommerce-headless' ),
+ array( 'status' => 502 )
+ );
+ }
+
+ $payment_status = $order->is_paid()
+ ? 'success'
+ : ( 'processing' === $intent_status ? 'processing' : ( in_array( $intent_status, array( 'canceled', 'requires_payment_method' ), true ) ? 'failure' : 'pending' ) );
+ if ( 'failure' === $payment_status ) {
+ funkycommerce_emit_notification(
+ 'theme.crypto_payment_failed',
+ __( 'Payment failed', 'funkycommerce-headless' ),
+ __( 'A BLIK payment was declined or cancelled.', 'funkycommerce-headless' ),
+ array(
+ __( 'Order ID', 'funkycommerce-headless' ) => $order->get_id(),
+ __( 'Gateway', 'funkycommerce-headless' ) => 'stripe-blik',
+ __( 'Intent status', 'funkycommerce-headless' ) => $intent_status,
+ ),
+ $order->get_edit_order_url()
+ );
+ }
+
+ return rest_ensure_response(
+ array(
+ 'payment_status' => $payment_status,
+ 'intent_status' => $intent_status,
+ 'order_status' => $order->get_status(),
+ 'message' => 'failure' === $payment_status
+ ? __( 'The BLIK payment was declined or canceled.', 'funkycommerce-headless' )
+ : '',
+ )
+ );
+}
+
+function funkycommerce_register_blik_reconciliation_rest() {
+ register_rest_route(
+ 'funkycommerce/v1',
+ '/orders/(?P\d+)/reconcile-blik',
+ array(
+ 'methods' => \WP_REST_Server::CREATABLE,
+ 'callback' => 'funkycommerce_reconcile_blik_order',
+ 'permission_callback' => '__return_true',
+ 'args' => array(
+ 'id' => array( 'required' => true, 'sanitize_callback' => 'absint' ),
+ 'key' => array( 'required' => true, 'sanitize_callback' => 'sanitize_text_field' ),
+ 'email' => array( 'required' => true, 'sanitize_callback' => 'sanitize_email' ),
+ ),
+ )
+ );
+}
+add_action( 'rest_api_init', 'funkycommerce_register_blik_reconciliation_rest' );
+
+/**
+ * Expose the bridged order language because WooGraphQL has no native language field.
+ */
+function funkycommerce_register_order_language_graphql_field() {
+ register_graphql_field(
+ 'Order',
+ 'funkycommerceLanguage',
+ array(
+ 'type' => 'String',
+ 'resolve' => function ( $source ) {
+ $order = funkycommerce_graphql_order_object( $source );
+ return $order ? (string) $order->get_meta( '_funkycommerce_order_language' ) : null;
+ },
+ )
+ );
+}
+add_action( 'graphql_register_types', 'funkycommerce_register_order_language_graphql_field', 20 );
diff --git a/inc/community.php b/inc/community.php
index e37b206..c02e169 100644
--- a/inc/community.php
+++ b/inc/community.php
@@ -88,6 +88,17 @@ function funkycommerce_register_community_content() {
)
);
+ register_post_meta(
+ 'community_post',
+ '_community_media_ids',
+ array(
+ 'type' => 'array',
+ 'single' => true,
+ 'default' => array(),
+ 'show_in_rest' => false,
+ )
+ );
+
register_post_meta(
'product',
'_seller_user_id',
@@ -212,7 +223,7 @@ function funkycommerce_render_community_profile_field( $user ) {
|
- FunkyCommerce.', 'funkycommerce-headless' ); ?>
+ Control Center.', 'funkycommerce-headless' ); ?>
|
@@ -221,6 +232,126 @@ function funkycommerce_render_community_profile_field( $user ) {
add_action( 'show_user_profile', 'funkycommerce_render_community_profile_field' );
add_action( 'edit_user_profile', 'funkycommerce_render_community_profile_field' );
+/**
+ * Render the media-library cover picker on user profile screens. Reuses the
+ * canonical `_community_cover_attachment_id` user meta so admin-picked covers
+ * stay in sync with the storefront's own community profile cover upload flow
+ * and are shown on both the community profile and journal author pages.
+ */
+function funkycommerce_render_community_cover_profile_field( $user ) {
+ if ( ! current_user_can( 'edit_user', $user->ID ) ) {
+ return;
+ }
+ $attachment_id = absint( get_user_meta( $user->ID, '_community_cover_attachment_id', true ) );
+ $cover = funkycommerce_community_profile_cover( $user->ID );
+ $url = $cover['url'] ?? '';
+ ?>
+
+
+ base, array( 'profile', 'user-edit' ), true ) ) {
+ return;
+ }
+ ?>
+
+ prefix . 'funkycommerce_community_follows';
+}
+
+/**
+ * Serialize follow creation with profile visibility changes.
+ */
+function funkycommerce_with_community_profile_lock( $user_id, callable $callback ) {
+ global $wpdb;
+ $lock_name = 'funkycommerce-community-profile-' . absint( $user_id );
+ $acquired = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT GET_LOCK(%s, %d)', $lock_name, 5 ) );
+ if ( 1 !== $acquired ) {
+ throw new RuntimeException( __( 'The community profile is busy. Try again.', 'funkycommerce-headless' ) );
+ }
+ try {
+ return $callback();
+ } finally {
+ $wpdb->get_var( $wpdb->prepare( 'SELECT RELEASE_LOCK(%s)', $lock_name ) );
+ }
+}
+
+/**
+ * Install the versioned graph table and import the former user-meta lists once.
+ */
+function funkycommerce_install_community_follows_table() {
+ $version = '1.0.0';
+ if ( $version === get_option( 'funkycommerce_community_follows_db_version' ) ) {
+ return;
+ }
+
+ global $wpdb;
+ require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+ $table_name = funkycommerce_community_follows_table();
+ $charset_collate = $wpdb->get_charset_collate();
+ dbDelta(
+ "CREATE TABLE {$table_name} (
+ id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+ follower_user_id bigint(20) unsigned NOT NULL,
+ followed_user_id bigint(20) unsigned NOT NULL,
+ status varchar(20) NOT NULL DEFAULT 'pending',
+ created_at datetime NOT NULL,
+ updated_at datetime NOT NULL,
+ PRIMARY KEY (id),
+ UNIQUE KEY follower_followed (follower_user_id, followed_user_id),
+ KEY followed_status (followed_user_id, status),
+ KEY follower_status (follower_user_id, status)
+ ) {$charset_collate};"
+ );
+
+ $legacy_users = get_users(
+ array(
+ 'fields' => 'ids',
+ 'meta_key' => '_community_following',
+ )
+ );
+ $now = current_time( 'mysql', true );
+ foreach ( $legacy_users as $follower_id ) {
+ $followed_ids = get_user_meta( $follower_id, '_community_following', true );
+ foreach ( array_unique( array_map( 'absint', is_array( $followed_ids ) ? $followed_ids : array() ) ) as $followed_id ) {
+ if ( ! $followed_id || $followed_id === (int) $follower_id || ! get_userdata( $followed_id ) ) {
+ continue;
+ }
+ $wpdb->query(
+ $wpdb->prepare(
+ "INSERT IGNORE INTO {$table_name} (follower_user_id, followed_user_id, status, created_at, updated_at)
+ VALUES (%d, %d, 'accepted', %s, %s)",
+ $follower_id,
+ $followed_id,
+ $now,
+ $now
+ )
+ );
+ }
+ }
+ update_option( 'funkycommerce_community_follows_db_version', $version, false );
+}
+add_action( 'init', 'funkycommerce_install_community_follows_table', 5 );
+
+function funkycommerce_community_relationship_status( $follower_id, $followed_id ) {
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ return (string) $wpdb->get_var(
+ $wpdb->prepare(
+ "SELECT status FROM {$table_name} WHERE follower_user_id = %d AND followed_user_id = %d",
+ absint( $follower_id ),
+ absint( $followed_id )
+ )
+ );
+}
+
+function funkycommerce_community_relationship_state( $profile_user_id, $viewer_id = 0 ) {
+ $profile_user_id = absint( $profile_user_id );
+ $viewer_id = $viewer_id ? absint( $viewer_id ) : funkycommerce_graphql_login_user_id();
+ if ( ! $viewer_id ) {
+ return 'none';
+ }
+ if ( $viewer_id === $profile_user_id || user_can( $viewer_id, 'manage_options' ) ) {
+ return 'owner';
+ }
+ if ( ! funkycommerce_community_followers_enabled() ) {
+ return 'none';
+ }
+ $status = funkycommerce_community_relationship_status( $viewer_id, $profile_user_id );
+ return in_array( $status, array( 'pending', 'accepted' ), true ) ? $status : 'none';
+}
+
+/**
+ * Central profile authorization used by every profile-scoped content resolver.
+ */
+function funkycommerce_can_access_community_profile( $profile_user_id, $viewer_id = 0 ) {
+ $profile_user_id = absint( $profile_user_id );
+ if ( ! $profile_user_id || ! get_userdata( $profile_user_id ) ) {
+ return false;
+ }
+ if ( funkycommerce_is_community_profile_public( $profile_user_id ) ) {
+ return true;
+ }
+ $state = funkycommerce_community_relationship_state( $profile_user_id, $viewer_id );
+ return 'owner' === $state || 'accepted' === $state;
+}
+
+function funkycommerce_community_accepted_ids( $user_id, $direction ) {
+ if ( ! funkycommerce_community_followers_enabled() ) {
+ return array();
+ }
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ $column = 'followers' === $direction ? 'followed_user_id' : 'follower_user_id';
+ $selected = 'followers' === $direction ? 'follower_user_id' : 'followed_user_id';
+ return array_map(
+ 'absint',
+ $wpdb->get_col(
+ $wpdb->prepare(
+ "SELECT {$selected} FROM {$table_name} WHERE {$column} = %d AND status = 'accepted' ORDER BY id ASC",
+ absint( $user_id )
+ )
+ )
+ );
+}
+
+function funkycommerce_community_relationship_count( $user_id, $direction ) {
+ if ( ! funkycommerce_community_followers_enabled() ) {
+ return 0;
+ }
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ $column = 'followers' === $direction ? 'followed_user_id' : 'follower_user_id';
+ return (int) $wpdb->get_var(
+ $wpdb->prepare(
+ "SELECT COUNT(*) FROM {$table_name} WHERE {$column} = %d AND status = 'accepted'",
+ absint( $user_id )
+ )
+ );
+}
+
+function funkycommerce_community_promote_pending_followers( $user_id ) {
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ $now = current_time( 'mysql', true );
+ $wpdb->query( 'START TRANSACTION' );
+ $updated = $wpdb->query(
+ $wpdb->prepare(
+ "UPDATE {$table_name} SET status = 'accepted', updated_at = %s WHERE followed_user_id = %d AND status = 'pending'",
+ $now,
+ absint( $user_id )
+ )
+ );
+ if ( false === $updated ) {
+ $wpdb->query( 'ROLLBACK' );
+ throw new RuntimeException( __( 'Pending followers could not be promoted.', 'funkycommerce-headless' ) );
+ }
+ $wpdb->query( 'COMMIT' );
+ return (int) $updated;
+}
+
+function funkycommerce_community_find_user_by_handle( $handle ) {
+ $handle = sanitize_title( rawurldecode( (string) $handle ) );
+ if ( ! $handle ) {
+ return null;
+ }
+ $users = get_users(
+ array(
+ 'meta_key' => '_community_profile_handle',
+ 'meta_value' => $handle,
+ 'number' => 1,
+ )
+ );
+ if ( $users ) {
+ return $users[0];
+ }
+ foreach ( get_users() as $user ) {
+ if ( $handle === funkycommerce_community_profile_handle( $user ) ) {
+ return $user;
+ }
+ }
+ return null;
+}
+
+function funkycommerce_community_assert_rate_limit( $user_id ) {
+ $key = 'funkycommerce_community_graph_rate_' . absint( $user_id );
+ $now = time();
+ $timestamps = array_values(
+ array_filter(
+ (array) get_transient( $key ),
+ fn( $timestamp ) => (int) $timestamp > $now - 300
+ )
+ );
+ if ( count( $timestamps ) >= 30 ) {
+ throw new \GraphQL\Error\UserError( __( 'Too many community relationship changes. Try again in a few minutes.', 'funkycommerce-headless' ) );
+ }
+ $timestamps[] = $now;
+ set_transient( $key, $timestamps, 5 * MINUTE_IN_SECONDS );
+}
+
+function funkycommerce_community_follow_target( $target_id ) {
+ if ( ! funkycommerce_community_followers_enabled() ) {
+ throw new \GraphQL\Error\UserError( __( 'The followers feature is disabled.', 'funkycommerce-headless' ) );
+ }
+ $viewer_id = funkycommerce_graphql_login_user_id();
+ $target_id = absint( $target_id );
+ if ( ! $viewer_id ) {
+ throw new \GraphQL\Error\UserError( __( 'Authentication is required.', 'funkycommerce-headless' ) );
+ }
+ if ( ! $target_id || $target_id === $viewer_id ) {
+ throw new \GraphQL\Error\UserError( __( 'You cannot follow this profile.', 'funkycommerce-headless' ) );
+ }
+ if ( ! get_userdata( $target_id ) ) {
+ throw new \GraphQL\Error\UserError( __( 'User not found.', 'funkycommerce-headless' ) );
+ }
+ funkycommerce_community_assert_rate_limit( $viewer_id );
+ return $viewer_id;
+}
+
+function funkycommerce_follow_community_profile( $target_id ) {
+ $viewer_id = funkycommerce_community_follow_target( $target_id );
+ $target_id = absint( $target_id );
+ try {
+ return funkycommerce_with_community_profile_lock(
+ $target_id,
+ function () use ( $viewer_id, $target_id ) {
+ $current = funkycommerce_community_relationship_status( $viewer_id, $target_id );
+ if ( 'accepted' === $current || 'pending' === $current ) {
+ return $current;
+ }
+ global $wpdb;
+ $status = funkycommerce_is_community_profile_public( $target_id ) ? 'accepted' : 'pending';
+ $table_name = funkycommerce_community_follows_table();
+ $now = current_time( 'mysql', true );
+ $inserted = $wpdb->insert(
+ $table_name,
+ array(
+ 'follower_user_id' => $viewer_id,
+ 'followed_user_id' => $target_id,
+ 'status' => $status,
+ 'created_at' => $now,
+ 'updated_at' => $now,
+ ),
+ array( '%d', '%d', '%s', '%s', '%s' )
+ );
+ if ( false === $inserted ) {
+ throw new \GraphQL\Error\UserError( __( 'The follow request could not be saved.', 'funkycommerce-headless' ) );
+ }
+ return $status;
+ }
+ );
+ } catch ( RuntimeException $error ) {
+ throw new \GraphQL\Error\UserError( $error->getMessage() );
+ }
+}
+
+function funkycommerce_unfollow_community_profile( $target_id ) {
+ $viewer_id = funkycommerce_community_follow_target( $target_id );
+ global $wpdb;
+ $deleted = $wpdb->delete(
+ funkycommerce_community_follows_table(),
+ array(
+ 'follower_user_id' => $viewer_id,
+ 'followed_user_id' => absint( $target_id ),
+ ),
+ array( '%d', '%d' )
+ );
+ if ( ! $deleted ) {
+ throw new \GraphQL\Error\UserError( __( 'There is no follow or request to remove.', 'funkycommerce-headless' ) );
+ }
+ return 'none';
+}
+
+function funkycommerce_manage_community_follower( $profile_user_id, $follower_user_id, $action ) {
+ if ( ! funkycommerce_community_followers_enabled() ) {
+ throw new \GraphQL\Error\UserError( __( 'The followers feature is disabled.', 'funkycommerce-headless' ) );
+ }
+ $viewer_id = funkycommerce_graphql_login_user_id();
+ $profile_user_id = absint( $profile_user_id ) ?: $viewer_id;
+ $follower_user_id = absint( $follower_user_id );
+ if ( ! $viewer_id || ( $viewer_id !== $profile_user_id && ! user_can( $viewer_id, 'manage_options' ) ) ) {
+ throw new \GraphQL\Error\UserError( __( 'You cannot manage this profile’s followers.', 'funkycommerce-headless' ) );
+ }
+ if ( ! $follower_user_id || ! get_userdata( $follower_user_id ) || $follower_user_id === $profile_user_id ) {
+ throw new \GraphQL\Error\UserError( __( 'Invalid follower.', 'funkycommerce-headless' ) );
+ }
+ funkycommerce_community_assert_rate_limit( $viewer_id );
+ $current = funkycommerce_community_relationship_status( $follower_user_id, $profile_user_id );
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ if ( 'approve' === $action ) {
+ if ( 'pending' !== $current ) {
+ throw new \GraphQL\Error\UserError( __( 'Only pending requests can be approved.', 'funkycommerce-headless' ) );
+ }
+ $updated = $wpdb->update(
+ $table_name,
+ array( 'status' => 'accepted', 'updated_at' => current_time( 'mysql', true ) ),
+ array( 'follower_user_id' => $follower_user_id, 'followed_user_id' => $profile_user_id, 'status' => 'pending' ),
+ array( '%s', '%s' ),
+ array( '%d', '%d', '%s' )
+ );
+ if ( 1 !== $updated ) {
+ throw new \GraphQL\Error\UserError( __( 'The follow request could not be approved.', 'funkycommerce-headless' ) );
+ }
+ return 'accepted';
+ }
+ if ( ( 'decline' === $action && 'pending' !== $current ) || ( 'remove' === $action && 'accepted' !== $current ) ) {
+ throw new \GraphQL\Error\UserError( __( 'That follower transition is not allowed.', 'funkycommerce-headless' ) );
+ }
+ if ( ! in_array( $action, array( 'decline', 'remove' ), true ) ) {
+ throw new \GraphQL\Error\UserError( __( 'Unknown follower action.', 'funkycommerce-headless' ) );
+ }
+ $deleted = $wpdb->delete(
+ $table_name,
+ array( 'follower_user_id' => $follower_user_id, 'followed_user_id' => $profile_user_id ),
+ array( '%d', '%d' )
+ );
+ if ( ! $deleted ) {
+ throw new \GraphQL\Error\UserError( __( 'The follower could not be removed.', 'funkycommerce-headless' ) );
+ }
+ return 'none';
+}
+
+function funkycommerce_community_profile_connection( $user_id, $direction, $args ) {
+ if ( ! funkycommerce_community_followers_enabled() || ! funkycommerce_can_access_community_profile( $user_id ) ) {
+ return array(
+ 'nodes' => array(),
+ 'totalCount' => 0,
+ 'pageInfo' => array( 'hasNextPage' => false, 'endCursor' => null ),
+ );
+ }
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ $column = 'followers' === $direction ? 'followed_user_id' : 'follower_user_id';
+ $selected = 'followers' === $direction ? 'follower_user_id' : 'followed_user_id';
+ $after_id = 0;
+ if ( ! empty( $args['after'] ) ) {
+ $decoded = base64_decode( (string) $args['after'], true );
+ $after_id = false !== $decoded && preg_match( '/^community:(\d+)$/', $decoded, $matches ) ? absint( $matches[1] ) : 0;
+ }
+ $first = min( 50, max( 1, absint( $args['first'] ?? 20 ) ) );
+ $rows = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT id, {$selected} AS user_id FROM {$table_name}
+ WHERE {$column} = %d AND status = 'accepted' AND id > %d
+ ORDER BY id ASC LIMIT %d",
+ absint( $user_id ),
+ $after_id,
+ $first + 1
+ ),
+ ARRAY_A
+ );
+ $has_next = count( $rows ) > $first;
+ $page = array_slice( $rows, 0, $first );
+ $ids = array_map( fn( $row ) => absint( $row['user_id'] ), $page );
+ return array(
+ 'nodes' => array_values( array_filter( array_map( 'get_userdata', $ids ) ) ),
+ 'totalCount' => funkycommerce_community_relationship_count( $user_id, $direction ),
+ 'pageInfo' => array(
+ 'hasNextPage' => $has_next,
+ 'endCursor' => $page ? base64_encode( 'community:' . absint( $page[ count( $page ) - 1 ]['id'] ) ) : null,
+ ),
+ );
+}
+
/**
* Resolve effective public visibility from the global gate and per-user preference.
*/
@@ -322,25 +854,24 @@ function funkycommerce_community_profile_handle( $user ) {
}
/**
- * Public profile IDs, plus the authenticated viewer so private content remains manageable.
+ * Public profile IDs used by directories, global feeds, search, and sitemap queries.
*/
function funkycommerce_visible_community_user_ids() {
- $user_ids = array();
- if ( funkycommerce_community_profiles_public_enabled() ) {
- $user_ids = array_filter(
- get_users(
- array(
- 'fields' => 'ids',
- )
- ),
- 'funkycommerce_is_community_profile_public'
- );
- }
- $viewer_id = funkycommerce_graphql_login_user_id();
- if ( $viewer_id ) {
- $user_ids[] = $viewer_id;
+ if ( ! funkycommerce_community_profiles_public_enabled() ) {
+ return array();
}
- return array_values( array_unique( array_map( 'absint', $user_ids ) ) );
+ return array_values(
+ array_map(
+ 'absint',
+ array_filter(
+ get_users( array( 'fields' => 'ids' ) ),
+ static function ( $user_id ) {
+ return funkycommerce_is_community_profile_public( $user_id )
+ && (bool) funkycommerce_community_member_types( $user_id );
+ }
+ )
+ )
+ );
}
/**
@@ -369,7 +900,16 @@ function funkycommerce_filter_community_post_connection( $query_args ) {
*/
function funkycommerce_protect_private_community_posts( $is_private, $model_name, $data ) {
if ( $data instanceof WP_Post && 'community_post' === $data->post_type ) {
- return $is_private || ! in_array( (int) $data->post_author, funkycommerce_visible_community_user_ids(), true );
+ return $is_private || ! funkycommerce_can_access_community_profile( (int) $data->post_author );
+ }
+ if ( $data instanceof WP_Post && 'product' === $data->post_type ) {
+ $seller_id = absint( get_post_meta( $data->ID, '_seller_user_id', true ) );
+ return $seller_id ? $is_private || ! funkycommerce_can_access_community_profile( $seller_id ) : $is_private;
+ }
+ if ( $data instanceof WP_Post && 'post' === $data->post_type ) {
+ $author = get_userdata( $data->post_author );
+ $scoped = $author && array_intersect( array( 'creator', 'collaborator' ), (array) $author->roles );
+ return $scoped ? $is_private || ! funkycommerce_can_access_community_profile( (int) $data->post_author ) : $is_private;
}
return $is_private;
}
@@ -407,63 +947,545 @@ function funkycommerce_sync_product_seller_to_author( $product_id, $product, $up
if ( $author_id ) {
update_post_meta( $product_id, '_seller_user_id', $author_id );
}
-}
-add_action( 'save_post_product', 'funkycommerce_sync_product_seller_to_author', 20, 3 );
+}
+add_action( 'save_post_product', 'funkycommerce_sync_product_seller_to_author', 20, 3 );
+
+/**
+ * Query a bounded, date-ordered set of products belonging to the requested sellers.
+ *
+ * Explicit seller metadata takes precedence. The native post author is used only
+ * for legacy products without a positive seller assignment.
+ */
+function funkycommerce_get_seller_product_ids( $seller_ids, $limit, $language = '' ) {
+ $seller_ids = array_values( array_unique( array_filter( array_map( 'absint', (array) $seller_ids ) ) ) );
+ $limit = min( 100, max( 1, absint( $limit ) ) );
+ if ( ! $seller_ids ) {
+ return array();
+ }
+
+ $common_query = array(
+ 'post_type' => 'product',
+ 'post_status' => 'publish',
+ 'posts_per_page' => $limit,
+ 'orderby' => array(
+ 'date' => 'DESC',
+ 'ID' => 'DESC',
+ ),
+ 'no_found_rows' => true,
+ );
+ if ( $language ) {
+ $common_query['lang'] = $language;
+ }
+
+ $assigned_products = get_posts(
+ array_merge(
+ $common_query,
+ array(
+ 'meta_query' => array(
+ array(
+ 'key' => '_seller_user_id',
+ 'value' => $seller_ids,
+ 'compare' => 'IN',
+ 'type' => 'NUMERIC',
+ ),
+ ),
+ )
+ )
+ );
+ $authored_products = get_posts(
+ array_merge(
+ $common_query,
+ array(
+ 'author__in' => $seller_ids,
+ 'meta_query' => array(
+ 'relation' => 'OR',
+ array(
+ 'key' => '_seller_user_id',
+ 'compare' => 'NOT EXISTS',
+ ),
+ array(
+ 'key' => '_seller_user_id',
+ 'value' => array( '', '0' ),
+ 'compare' => 'IN',
+ ),
+ ),
+ )
+ )
+ );
+
+ $products_by_id = array();
+ foreach ( array_merge( $assigned_products, $authored_products ) as $product ) {
+ $products_by_id[ $product->ID ] = $product;
+ }
+ $products = array_values( $products_by_id );
+ usort(
+ $products,
+ static function ( $left, $right ) {
+ $date_order = strcmp( $right->post_date_gmt ?: $right->post_date, $left->post_date_gmt ?: $left->post_date );
+ return 0 !== $date_order ? $date_order : (int) $right->ID <=> (int) $left->ID;
+ }
+ );
+
+ return array_map(
+ static fn( $product ) => (int) $product->ID,
+ array_slice( $products, 0, $limit )
+ );
+}
+
+/**
+ * Resolve a GraphQL model/post database ID.
+ */
+function funkycommerce_community_source_id( $source ) {
+ if ( $source instanceof WP_Post ) {
+ return (int) $source->ID;
+ }
+ if ( class_exists( 'WC_Product' ) && $source instanceof WC_Product ) {
+ return (int) $source->get_id();
+ }
+ if ( is_object( $source ) && isset( $source->databaseId ) ) {
+ return (int) $source->databaseId;
+ }
+ if ( is_object( $source ) && isset( $source->ID ) ) {
+ return (int) $source->ID;
+ }
+ return 0;
+}
+
+/**
+ * Decode a constrained image data URL into a WordPress attachment.
+ */
+function funkycommerce_create_graphql_attachment( $data_url, $title ) {
+ if ( ! $data_url ) {
+ return 0;
+ }
+ if ( ! preg_match( '#^data:image/(jpeg|png|gif|webp);base64,([a-zA-Z0-9+/=\r\n]+)$#', $data_url, $matches ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The uploaded image format is invalid.', 'funkycommerce-headless' ) );
+ }
+
+ $binary = base64_decode( $matches[2], true );
+ if ( false === $binary || strlen( $binary ) > 5 * MB_IN_BYTES ) {
+ throw new \GraphQL\Error\UserError( __( 'Images must be valid and no larger than 5 MB.', 'funkycommerce-headless' ) );
+ }
+
+ $image_info = getimagesizefromstring( $binary );
+ $expected_mime = array( 'jpeg' => 'image/jpeg', 'png' => 'image/png', 'gif' => 'image/gif', 'webp' => 'image/webp' );
+ if ( ! $image_info || $image_info['mime'] !== $expected_mime[ $matches[1] ] ) {
+ throw new \GraphQL\Error\UserError( __( 'The upload is not a valid image.', 'funkycommerce-headless' ) );
+ }
+
+ $extensions = array( 'jpeg' => 'jpg', 'png' => 'png', 'gif' => 'gif', 'webp' => 'webp' );
+ $filename = sanitize_file_name( sanitize_title( $title ) . '-' . wp_generate_password( 6, false ) . '.' . $extensions[ $matches[1] ] );
+ $upload = wp_upload_bits( $filename, null, $binary );
+ if ( ! empty( $upload['error'] ) ) {
+ throw new \GraphQL\Error\UserError( $upload['error'] );
+ }
+
+ $attachment_id = wp_insert_attachment(
+ array(
+ 'post_mime_type' => 'image/' . $matches[1],
+ 'post_title' => sanitize_text_field( $title ),
+ 'post_status' => 'inherit',
+ 'post_author' => get_current_user_id(),
+ ),
+ $upload['file']
+ );
+ if ( is_wp_error( $attachment_id ) ) {
+ wp_delete_file( $upload['file'] );
+ throw new \GraphQL\Error\UserError( $attachment_id->get_error_message() );
+ }
+
+ require_once ABSPATH . 'wp-admin/includes/image.php';
+ wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $upload['file'] ) );
+ return (int) $attachment_id;
+}
+
+/**
+ * Return the effective community upload controls with a deliberately narrow
+ * supported MIME set. Site controls may further restrict this list.
+ */
+function funkycommerce_community_upload_settings() {
+ $settings = function_exists( 'funkycommerce_control_center_settings' )
+ ? funkycommerce_control_center_settings()
+ : (array) get_option( 'funkycommerce_control_center', array() );
+ $supported_mimes = array(
+ 'image/jpeg' => 'jpg',
+ 'image/png' => 'png',
+ 'image/gif' => 'gif',
+ 'image/webp' => 'webp',
+ 'video/mp4' => 'mp4',
+ );
+ $configured_mimes = array_filter(
+ array_map(
+ 'trim',
+ explode( ',', strtolower( (string) ( $settings['community_upload_types'] ?? implode( ',', array_keys( $supported_mimes ) ) ) ) )
+ )
+ );
+
+ return array(
+ 'enabled' => 'no' !== ( $settings['community_upload_enabled'] ?? 'yes' ),
+ 'max_bytes' => min( 100, max( 1, absint( $settings['community_upload_max_mb'] ?? 5 ) ) ) * MB_IN_BYTES,
+ 'allowed_mimes' => array_intersect_key( $supported_mimes, array_fill_keys( $configured_mimes, true ) ),
+ );
+}
+
+/**
+ * Ordered attachment IDs for a community post. Legacy posts transparently use
+ * their featured image without requiring a destructive migration.
+ */
+function funkycommerce_community_media_ids( $post_id, $include_legacy = true ) {
+ $stored = get_post_meta( absint( $post_id ), '_community_media_ids', true );
+ $ids = is_array( $stored ) ? array_values( array_unique( array_filter( array_map( 'absint', $stored ) ) ) ) : array();
+ $ids = array_values(
+ array_filter(
+ $ids,
+ fn( $attachment_id ) => 'attachment' === get_post_type( $attachment_id ) && (bool) wp_get_attachment_url( $attachment_id )
+ )
+ );
+ if ( ! $ids && $include_legacy ) {
+ $thumbnail_id = get_post_thumbnail_id( $post_id );
+ if ( $thumbnail_id && wp_get_attachment_url( $thumbnail_id ) ) {
+ $ids[] = (int) $thumbnail_id;
+ }
+ }
+ return $ids;
+}
+
+/**
+ * Translation-group post IDs in a stable order, excluding the current post.
+ */
+function funkycommerce_community_translation_ids( $post_id ) {
+ $post_id = absint( $post_id );
+ if ( ! $post_id || ! function_exists( 'pll_get_post_translations' ) ) {
+ return array();
+ }
+
+ $translation_ids = array();
+ foreach ( (array) pll_get_post_translations( $post_id ) as $translated_id ) {
+ $translated_id = absint( $translated_id );
+ if (
+ ! $translated_id
+ || $translated_id === $post_id
+ || 'community_post' !== get_post_type( $translated_id )
+ || in_array( $translated_id, $translation_ids, true )
+ ) {
+ continue;
+ }
+ $translation_ids[] = $translated_id;
+ }
+ return $translation_ids;
+}
+
+/**
+ * Public/editor media for a translated community post.
+ *
+ * A translation's own media occupies the leading slots. Empty trailing slots
+ * are filled from its related translations by position, reusing attachment IDs
+ * rather than copying uploads. This keeps an explicitly localized first image
+ * or video authoritative while making the group's additional media available.
+ */
+function funkycommerce_resolved_community_media_ids( $post_id ) {
+ $explicit_ids = funkycommerce_community_media_ids( $post_id );
+ $slots = array_values( $explicit_ids );
+ $explicit_count = count( $explicit_ids );
+
+ foreach ( funkycommerce_community_translation_ids( $post_id ) as $translation_id ) {
+ foreach ( funkycommerce_community_media_ids( $translation_id ) as $index => $attachment_id ) {
+ if (
+ $index < $explicit_count
+ || isset( $slots[ $index ] )
+ || in_array( $attachment_id, $slots, true )
+ ) {
+ continue;
+ }
+ $slots[ $index ] = $attachment_id;
+ }
+ }
+
+ ksort( $slots, SORT_NUMERIC );
+ return array_slice( array_values( $slots ), 0, 5 );
+}
+
+/**
+ * Resolve one attachment into the public community media contract.
+ */
+function funkycommerce_community_media_item( $attachment_id ) {
+ $url = wp_get_attachment_url( $attachment_id );
+ $mime = (string) get_post_mime_type( $attachment_id );
+ if ( ! $url || ( 0 !== strpos( $mime, 'image/' ) && 'video/mp4' !== $mime ) ) {
+ return null;
+ }
+ $metadata = wp_get_attachment_metadata( $attachment_id );
+ $srcset = 0 === strpos( $mime, 'image/' ) ? wp_get_attachment_image_srcset( $attachment_id, 'large' ) : false;
+ $sizes = 0 === strpos( $mime, 'image/' ) ? wp_get_attachment_image_sizes( $attachment_id, 'large' ) : false;
+ return array(
+ 'databaseId' => (int) $attachment_id,
+ 'url' => $url,
+ 'mimeType' => $mime,
+ 'mediaType' => 'video/mp4' === $mime ? 'video' : 'image',
+ 'altText' => (string) get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ),
+ 'width' => is_array( $metadata ) && ! empty( $metadata['width'] ) ? (int) $metadata['width'] : null,
+ 'height' => is_array( $metadata ) && ! empty( $metadata['height'] ) ? (int) $metadata['height'] : null,
+ 'srcSet' => is_string( $srcset ) ? $srcset : '',
+ 'sizes' => is_string( $sizes ) ? $sizes : '',
+ );
+}
+
+function funkycommerce_community_admin_media_preview( $attachment_id, $compact = false ) {
+ $media = funkycommerce_community_media_item( $attachment_id );
+ if ( ! $media ) {
+ return '';
+ }
+ $size = $compact ? 'width:72px;height:72px;' : 'width:100%;height:180px;';
+ $style = $size . 'display:block;object-fit:cover;object-position:center;background:#000;border-radius:8px;';
+ if ( 'video' === $media['mediaType'] ) {
+ return sprintf(
+ '',
+ $compact ? 'muted' : 'controls',
+ esc_attr( $style ),
+ esc_url( $media['url'] ),
+ esc_attr( $media['mimeType'] )
+ );
+ }
+ return wp_get_attachment_image(
+ $attachment_id,
+ $compact ? 'thumbnail' : 'medium',
+ false,
+ array( 'style' => $style )
+ );
+}
+
+function funkycommerce_register_community_media_meta_box() {
+ add_meta_box(
+ 'funkycommerce-community-media',
+ __( 'Community media', 'funkycommerce-headless' ),
+ 'funkycommerce_render_community_media_meta_box',
+ 'community_post',
+ 'normal',
+ 'high'
+ );
+}
+add_action( 'add_meta_boxes_community_post', 'funkycommerce_register_community_media_meta_box' );
+
+function funkycommerce_render_community_media_meta_box( $post ) {
+ $attachment_ids = funkycommerce_community_media_ids( $post->ID );
+ if ( ! $attachment_ids ) {
+ echo '' . esc_html__( 'No community media is attached to this post.', 'funkycommerce-headless' ) . '
';
+ return;
+ }
+ echo '';
+ foreach ( $attachment_ids as $index => $attachment_id ) {
+ $media = funkycommerce_community_media_item( $attachment_id );
+ if ( ! $media ) {
+ continue;
+ }
+ $attachment_title = get_the_title( $attachment_id );
+ $edit_url = get_edit_post_link( $attachment_id, 'raw' );
+ echo '- ';
+ echo funkycommerce_community_admin_media_preview( $attachment_id ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ printf(
+ '
%1$s
%2$s%3$s
',
+ esc_html(
+ sprintf(
+ /* translators: 1: media position, 2: media type. */
+ __( '%1$d. %2$s', 'funkycommerce-headless' ),
+ $index + 1,
+ 'video' === $media['mediaType'] ? __( 'MP4 video', 'funkycommerce-headless' ) : __( 'Image', 'funkycommerce-headless' )
+ )
+ ),
+ esc_html( $attachment_title ?: wp_basename( (string) wp_parse_url( $media['url'], PHP_URL_PATH ) ) ),
+ $edit_url ? ' · ' . esc_html__( 'Edit attachment', 'funkycommerce-headless' ) . '' : ''
+ );
+ echo ' ';
+ }
+ echo '
';
+ echo '' . esc_html__( 'Media order is managed from the storefront community post editor.', 'funkycommerce-headless' ) . '
';
+}
+
+function funkycommerce_community_post_admin_columns( $columns ) {
+ $with_media = array();
+ foreach ( $columns as $key => $label ) {
+ $with_media[ $key ] = $label;
+ if ( 'title' === $key ) {
+ $with_media['community_media'] = __( 'Media', 'funkycommerce-headless' );
+ }
+ }
+ return $with_media;
+}
+add_filter( 'manage_community_post_posts_columns', 'funkycommerce_community_post_admin_columns' );
+
+function funkycommerce_render_community_post_admin_column( $column, $post_id ) {
+ if ( 'community_media' !== $column ) {
+ return;
+ }
+ $attachment_ids = funkycommerce_community_media_ids( $post_id );
+ if ( ! $attachment_ids ) {
+ echo '—';
+ return;
+ }
+ echo funkycommerce_community_admin_media_preview( $attachment_ids[0], true ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+ if ( count( $attachment_ids ) > 1 ) {
+ printf(
+ '%s',
+ esc_html(
+ sprintf(
+ /* translators: %d: number of additional media items. */
+ _n( '+%d more', '+%d more', count( $attachment_ids ) - 1, 'funkycommerce-headless' ),
+ count( $attachment_ids ) - 1
+ )
+ )
+ );
+ }
+}
+add_action( 'manage_community_post_posts_custom_column', 'funkycommerce_render_community_post_admin_column', 10, 2 );
+
+function funkycommerce_community_profile_cover( $user_id ) {
+ $attachment_id = absint( get_user_meta( absint( $user_id ), '_community_cover_attachment_id', true ) );
+ if ( ! $attachment_id || 'attachment' !== get_post_type( $attachment_id ) || 0 !== strpos( (string) get_post_mime_type( $attachment_id ), 'image/' ) ) {
+ return null;
+ }
+ return funkycommerce_community_media_item( $attachment_id );
+}
+
+/**
+ * Decode and save an owner-marked profile cover. Covers deliberately reject video.
+ */
+function funkycommerce_create_community_cover_attachment( $data_url, $user_id ) {
+ $settings = funkycommerce_community_upload_settings();
+ $allowed_mimes = array_filter(
+ $settings['allowed_mimes'],
+ fn( $extension, $mime ) => 0 === strpos( $mime, 'image/' ),
+ ARRAY_FILTER_USE_BOTH
+ );
+ if ( ! $settings['enabled'] ) {
+ throw new \GraphQL\Error\UserError( __( 'Community media uploads are disabled.', 'funkycommerce-headless' ) );
+ }
+ if ( ! preg_match( '#^data:([a-zA-Z0-9.+/-]+);base64,([a-zA-Z0-9+/=\r\n]+)$#', (string) $data_url, $matches ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The uploaded profile cover is invalid.', 'funkycommerce-headless' ) );
+ }
+ $declared_mime = strtolower( $matches[1] );
+ if ( ! isset( $allowed_mimes[ $declared_mime ] ) ) {
+ throw new \GraphQL\Error\UserError( __( 'Profile covers must use an allowed image type.', 'funkycommerce-headless' ) );
+ }
+ $encoded = preg_replace( '/\s+/', '', $matches[2] );
+ if ( strlen( $encoded ) > (int) ceil( $settings['max_bytes'] * 4 / 3 ) + 4 ) {
+ throw new \GraphQL\Error\UserError( __( 'The profile cover exceeds the site upload limit.', 'funkycommerce-headless' ) );
+ }
+ $binary = base64_decode( $encoded, true );
+ if ( false === $binary || ! $binary || strlen( $binary ) > $settings['max_bytes'] ) {
+ throw new \GraphQL\Error\UserError( __( 'The profile cover is invalid or exceeds the site upload limit.', 'funkycommerce-headless' ) );
+ }
+ $image_info = getimagesizefromstring( $binary );
+ $actual_mime = is_array( $image_info ) ? strtolower( (string) ( $image_info['mime'] ?? '' ) ) : '';
+ if ( ! $actual_mime || $actual_mime !== $declared_mime || ! isset( $allowed_mimes[ $actual_mime ] ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The profile cover is not a valid image.', 'funkycommerce-headless' ) );
+ }
-/**
- * Resolve a GraphQL model/post database ID.
- */
-function funkycommerce_community_source_id( $source ) {
- if ( $source instanceof WP_Post ) {
- return (int) $source->ID;
+ $filename = sanitize_file_name( 'community-cover-' . absint( $user_id ) . '-' . wp_generate_password( 6, false ) . '.' . $allowed_mimes[ $actual_mime ] );
+ $upload = wp_upload_bits( $filename, null, $binary );
+ if ( ! empty( $upload['error'] ) ) {
+ throw new \GraphQL\Error\UserError( $upload['error'] );
}
- if ( class_exists( 'WC_Product' ) && $source instanceof WC_Product ) {
- return (int) $source->get_id();
+ $attachment_id = wp_insert_attachment(
+ array(
+ 'post_mime_type' => $actual_mime,
+ 'post_title' => __( 'Community profile cover', 'funkycommerce-headless' ),
+ 'post_status' => 'inherit',
+ 'post_author' => absint( $user_id ),
+ ),
+ $upload['file']
+ );
+ if ( is_wp_error( $attachment_id ) ) {
+ wp_delete_file( $upload['file'] );
+ throw new \GraphQL\Error\UserError( $attachment_id->get_error_message() );
}
- if ( is_object( $source ) && isset( $source->databaseId ) ) {
- return (int) $source->databaseId;
+
+ try {
+ require_once ABSPATH . 'wp-admin/includes/image.php';
+ $metadata = wp_generate_attachment_metadata( $attachment_id, $upload['file'] );
+ if ( is_wp_error( $metadata ) || ! is_array( $metadata ) ) {
+ throw new RuntimeException( __( 'The profile cover could not be processed.', 'funkycommerce-headless' ) );
+ }
+ wp_update_attachment_metadata( $attachment_id, $metadata );
+ update_post_meta( $attachment_id, '_community_cover_owner_user_id', absint( $user_id ) );
+ update_post_meta( $attachment_id, '_wp_attachment_image_alt', __( 'Community profile cover', 'funkycommerce-headless' ) );
+ } catch ( \Throwable $error ) {
+ wp_delete_attachment( $attachment_id, true );
+ throw new \GraphQL\Error\UserError( $error->getMessage() );
}
- if ( is_object( $source ) && isset( $source->ID ) ) {
- return (int) $source->ID;
+ return (int) $attachment_id;
+}
+
+function funkycommerce_delete_owned_community_cover( $user_id, $attachment_id ) {
+ if ( absint( get_post_meta( $attachment_id, '_community_cover_owner_user_id', true ) ) === absint( $user_id ) ) {
+ wp_delete_attachment( $attachment_id, true );
}
- return 0;
}
+function funkycommerce_delete_profile_cover_with_user( $user_id ) {
+ funkycommerce_delete_owned_community_cover(
+ $user_id,
+ absint( get_user_meta( $user_id, '_community_cover_attachment_id', true ) )
+ );
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ $wpdb->query(
+ $wpdb->prepare(
+ "DELETE FROM {$table_name} WHERE follower_user_id = %d OR followed_user_id = %d",
+ absint( $user_id ),
+ absint( $user_id )
+ )
+ );
+}
+add_action( 'delete_user', 'funkycommerce_delete_profile_cover_with_user' );
/**
- * Decode a constrained image data URL into a WordPress attachment.
+ * Validate and save an image or MP4 data URL as post-owned community media.
*/
-function funkycommerce_create_graphql_attachment( $data_url, $title ) {
- if ( ! $data_url ) {
- return 0;
+function funkycommerce_create_community_media_attachment( $data_url, $title, $post_id ) {
+ $upload_settings = funkycommerce_community_upload_settings();
+ if ( ! $upload_settings['enabled'] ) {
+ throw new \GraphQL\Error\UserError( __( 'Community media uploads are disabled.', 'funkycommerce-headless' ) );
}
- if ( ! preg_match( '#^data:image/(jpeg|png|gif|webp);base64,([a-zA-Z0-9+/=\r\n]+)$#', $data_url, $matches ) ) {
- throw new \GraphQL\Error\UserError( __( 'The uploaded image format is invalid.', 'funkycommerce-headless' ) );
+ if ( ! preg_match( '#^data:([a-zA-Z0-9.+/-]+);base64,([a-zA-Z0-9+/=\r\n]+)$#', (string) $data_url, $matches ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The uploaded community media is invalid.', 'funkycommerce-headless' ) );
}
+ $mime = strtolower( $matches[1] );
+ if ( ! isset( $upload_settings['allowed_mimes'][ $mime ] ) ) {
+ throw new \GraphQL\Error\UserError( __( 'That community media type is not allowed.', 'funkycommerce-headless' ) );
+ }
+ $max_encoded_bytes = (int) ceil( $upload_settings['max_bytes'] * 4 / 3 ) + 4;
+ if ( strlen( preg_replace( '/\s+/', '', $matches[2] ) ) > $max_encoded_bytes ) {
+ throw new \GraphQL\Error\UserError( __( 'The community media file exceeds the site upload limit.', 'funkycommerce-headless' ) );
+ }
$binary = base64_decode( $matches[2], true );
- if ( false === $binary || strlen( $binary ) > 5 * MB_IN_BYTES ) {
- throw new \GraphQL\Error\UserError( __( 'Images must be valid and no larger than 5 MB.', 'funkycommerce-headless' ) );
+ if ( false === $binary || 0 === strlen( $binary ) || strlen( $binary ) > $upload_settings['max_bytes'] ) {
+ throw new \GraphQL\Error\UserError( __( 'The community media file is invalid or exceeds the site upload limit.', 'funkycommerce-headless' ) );
}
- $image_info = getimagesizefromstring( $binary );
- $expected_mime = array( 'jpeg' => 'image/jpeg', 'png' => 'image/png', 'gif' => 'image/gif', 'webp' => 'image/webp' );
- if ( ! $image_info || $image_info['mime'] !== $expected_mime[ $matches[1] ] ) {
- throw new \GraphQL\Error\UserError( __( 'The upload is not a valid image.', 'funkycommerce-headless' ) );
+ if ( 0 === strpos( $mime, 'image/' ) ) {
+ $image_info = getimagesizefromstring( $binary );
+ if ( ! $image_info || empty( $image_info['mime'] ) || strtolower( $image_info['mime'] ) !== $mime ) {
+ throw new \GraphQL\Error\UserError( __( 'The upload is not a valid image.', 'funkycommerce-headless' ) );
+ }
+ } elseif ( strlen( $binary ) < 12 || 'ftyp' !== substr( $binary, 4, 4 ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The upload is not a valid MP4 video.', 'funkycommerce-headless' ) );
}
- $extensions = array( 'jpeg' => 'jpg', 'png' => 'png', 'gif' => 'gif', 'webp' => 'webp' );
- $filename = sanitize_file_name( sanitize_title( $title ) . '-' . wp_generate_password( 6, false ) . '.' . $extensions[ $matches[1] ] );
- $upload = wp_upload_bits( $filename, null, $binary );
+ $filename = sanitize_file_name(
+ sanitize_title( $title ) . '-' . wp_generate_password( 6, false ) . '.' . $upload_settings['allowed_mimes'][ $mime ]
+ );
+ $upload = wp_upload_bits( $filename, null, $binary );
if ( ! empty( $upload['error'] ) ) {
throw new \GraphQL\Error\UserError( $upload['error'] );
}
$attachment_id = wp_insert_attachment(
array(
- 'post_mime_type' => 'image/' . $matches[1],
+ 'post_mime_type' => $mime,
'post_title' => sanitize_text_field( $title ),
'post_status' => 'inherit',
'post_author' => get_current_user_id(),
+ 'post_parent' => absint( $post_id ),
),
$upload['file']
);
@@ -472,11 +1494,150 @@ function funkycommerce_create_graphql_attachment( $data_url, $title ) {
throw new \GraphQL\Error\UserError( $attachment_id->get_error_message() );
}
- require_once ABSPATH . 'wp-admin/includes/image.php';
- wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $upload['file'] ) );
+ try {
+ require_once ABSPATH . 'wp-admin/includes/image.php';
+ if ( 'video/mp4' === $mime ) {
+ require_once ABSPATH . 'wp-admin/includes/media.php';
+ }
+ $metadata = wp_generate_attachment_metadata( $attachment_id, $upload['file'] );
+ if ( is_wp_error( $metadata ) ) {
+ throw new RuntimeException( $metadata->get_error_message() );
+ }
+ wp_update_attachment_metadata( $attachment_id, $metadata );
+ update_post_meta( $attachment_id, '_community_media_owner_post_id', absint( $post_id ) );
+ update_post_meta( $attachment_id, '_wp_attachment_image_alt', sanitize_text_field( $title ) );
+ } catch ( \Throwable $error ) {
+ wp_delete_attachment( $attachment_id, true );
+ throw new \GraphQL\Error\UserError( __( 'The community media file could not be processed.', 'funkycommerce-headless' ) );
+ }
return (int) $attachment_id;
}
+/**
+ * Resolve ordered mutation media inputs, retaining only media already attached
+ * to this post and rolling back every newly created attachment on failure.
+ */
+function funkycommerce_resolve_community_media_inputs( $post_id, array $media_inputs, $title, array $existing_ids = array() ) {
+ if ( count( $media_inputs ) < 1 || count( $media_inputs ) > 5 ) {
+ throw new \GraphQL\Error\UserError( __( 'Community posts require between one and five media files.', 'funkycommerce-headless' ) );
+ }
+ $resolved_ids = array();
+ $new_ids = array();
+ try {
+ foreach ( array_values( $media_inputs ) as $index => $media_input ) {
+ $attachment_id = absint( $media_input['attachmentId'] ?? 0 );
+ $data_url = trim( (string) ( $media_input['dataUrl'] ?? '' ) );
+ if ( ( $attachment_id && $data_url ) || ( ! $attachment_id && ! $data_url ) ) {
+ throw new \GraphQL\Error\UserError( __( 'Each community media item must retain one existing file or upload one new file.', 'funkycommerce-headless' ) );
+ }
+ if ( $attachment_id ) {
+ if ( ! in_array( $attachment_id, $existing_ids, true ) || in_array( $attachment_id, $resolved_ids, true ) ) {
+ throw new \GraphQL\Error\UserError( __( 'An existing community media item is invalid.', 'funkycommerce-headless' ) );
+ }
+ $resolved_ids[] = $attachment_id;
+ continue;
+ }
+ $new_id = funkycommerce_create_community_media_attachment( $data_url, $title . ' ' . ( $index + 1 ), $post_id );
+ $new_ids[] = $new_id;
+ $resolved_ids[] = $new_id;
+ }
+ } catch ( \Throwable $error ) {
+ foreach ( $new_ids as $new_id ) {
+ wp_delete_attachment( $new_id, true );
+ }
+ throw $error;
+ }
+ return array(
+ 'ids' => $resolved_ids,
+ 'new_ids' => $new_ids,
+ );
+}
+
+/**
+ * Persist ordered media and retain the first image as the featured image for
+ * compatibility with existing themes, feeds, and GraphQL clients.
+ */
+function funkycommerce_save_community_media( $post_id, array $attachment_ids ) {
+ $attachment_ids = array_values( array_map( 'absint', $attachment_ids ) );
+ update_post_meta( $post_id, '_community_media_ids', $attachment_ids );
+ if ( get_post_meta( $post_id, '_community_media_ids', true ) !== $attachment_ids ) {
+ throw new \GraphQL\Error\UserError( __( 'The community media order could not be saved.', 'funkycommerce-headless' ) );
+ }
+ $featured_id = 0;
+ foreach ( $attachment_ids as $attachment_id ) {
+ if ( 0 === strpos( (string) get_post_mime_type( $attachment_id ), 'image/' ) ) {
+ $featured_id = (int) $attachment_id;
+ break;
+ }
+ }
+ if ( $featured_id ) {
+ set_post_thumbnail( $post_id, $featured_id );
+ } else {
+ delete_post_thumbnail( $post_id );
+ }
+}
+
+/**
+ * Find another post that explicitly retains a shared community attachment.
+ */
+function funkycommerce_community_media_reference_post_id( $attachment_id, $exclude_post_id ) {
+ $post_ids = get_posts(
+ array(
+ 'post_type' => 'community_post',
+ 'post_status' => 'any',
+ 'posts_per_page' => -1,
+ 'fields' => 'ids',
+ 'meta_key' => '_community_media_ids',
+ 'suppress_filters' => true,
+ )
+ );
+ foreach ( $post_ids as $post_id ) {
+ if (
+ (int) $post_id !== absint( $exclude_post_id )
+ && in_array( absint( $attachment_id ), funkycommerce_community_media_ids( $post_id, false ), true )
+ ) {
+ return (int) $post_id;
+ }
+ }
+ return 0;
+}
+
+/**
+ * Delete an owned upload unless another translated post explicitly retained it.
+ */
+function funkycommerce_delete_or_transfer_community_media( $attachment_id, $owner_post_id ) {
+ $attachment_id = absint( $attachment_id );
+ $owner_post_id = absint( $owner_post_id );
+ if ( absint( get_post_meta( $attachment_id, '_community_media_owner_post_id', true ) ) !== $owner_post_id ) {
+ return;
+ }
+ $next_owner_id = funkycommerce_community_media_reference_post_id( $attachment_id, $owner_post_id );
+ if ( $next_owner_id ) {
+ update_post_meta( $attachment_id, '_community_media_owner_post_id', $next_owner_id );
+ wp_update_post(
+ array(
+ 'ID' => $attachment_id,
+ 'post_parent' => $next_owner_id,
+ )
+ );
+ return;
+ }
+ wp_delete_attachment( $attachment_id, true );
+}
+
+/**
+ * Remove only attachments explicitly created for this community post.
+ */
+function funkycommerce_delete_owned_community_media( $post_id ) {
+ if ( 'community_post' !== get_post_type( $post_id ) ) {
+ return;
+ }
+ foreach ( funkycommerce_community_media_ids( $post_id, false ) as $attachment_id ) {
+ funkycommerce_delete_or_transfer_community_media( $attachment_id, $post_id );
+ }
+}
+add_action( 'before_delete_post', 'funkycommerce_delete_owned_community_media' );
+
/**
* Keep only published WooCommerce product IDs that can be used as product relations.
*/
@@ -528,6 +1689,22 @@ function funkycommerce_require_post_owner( $post_id, $post_type ) {
return $post;
}
+/**
+ * Whether the current GraphQL viewer can manage one community post.
+ */
+function funkycommerce_can_manage_community_post( $post_id ) {
+ $post = get_post( absint( $post_id ) );
+ $user_id = funkycommerce_graphql_login_user_id();
+ return $post
+ && 'community_post' === $post->post_type
+ && $user_id
+ && (
+ (int) $post->post_author === $user_id
+ || current_user_can( 'edit_others_community_posts' )
+ || current_user_can( 'manage_options' )
+ );
+}
+
/**
* Persist basic SEO editing fields (slug is handled separately via
* `post_name`). Values are always stored under our own meta keys so editing
@@ -569,8 +1746,9 @@ function funkycommerce_associate_post_translation( $post_id, $translation_of_id
if ( $translation_of_id === (int) $post_id ) {
throw new \GraphQL\Error\UserError( __( 'A post cannot be linked as its own translation.', 'funkycommerce-headless' ) );
}
+ $source = get_post( $post_id );
$target = get_post( $translation_of_id );
- if ( ! $target || 'post' !== $target->post_type ) {
+ if ( ! $source || ! $target || $source->post_type !== $target->post_type ) {
throw new \GraphQL\Error\UserError( __( 'The selected translation source could not be found.', 'funkycommerce-headless' ) );
}
$current_user_id = funkycommerce_graphql_login_user_id();
@@ -707,10 +1885,98 @@ function funkycommerce_apply_marketplace_downloadable_settings( $product, array
return $new_attachment_ids;
}
+/**
+ * Validate and normalize a marketplace price without treating free listings as missing.
+ */
+function funkycommerce_validate_non_negative_marketplace_price( $value, $field_label = 'Price' ) {
+ if ( ! is_numeric( $value ) || ! is_finite( (float) $value ) || (float) $value < 0 ) {
+ throw new \GraphQL\Error\UserError(
+ sprintf(
+ /* translators: %s: price field label. */
+ __( '%s must be a finite non-negative number.', 'funkycommerce-headless' ),
+ $field_label
+ )
+ );
+ }
+ return wc_format_decimal( (float) $value, wc_get_price_decimals() );
+}
+
+/**
+ * Return the public member categories used by directory shortcode filters.
+ */
+function funkycommerce_community_member_types( $user ) {
+ $user = $user instanceof WP_User ? $user : get_userdata( absint( $user ) );
+ if ( ! $user ) {
+ return array();
+ }
+
+ $types = array();
+ $registered_roles = function_exists( 'wp_roles' ) ? wp_roles()->roles : array();
+ foreach ( array_map( 'sanitize_key', (array) $user->roles ) as $role ) {
+ $type = function_exists( 'funkycommerce_community_role_type' )
+ ? funkycommerce_community_role_type( $role )
+ : ( 'administrator' === $role ? 'admin' : $role );
+ if ( $type ) {
+ $types[] = $type;
+ }
+ $label = sanitize_title( (string) ( $registered_roles[ $role ]['name'] ?? '' ) );
+ if ( $label && $label !== $type ) {
+ $types[] = $label;
+ }
+ }
+ return array_values( array_unique( $types ) );
+}
+
/**
* Register public community fields and authenticated publishing mutations.
*/
function funkycommerce_register_community_graphql() {
+ register_graphql_object_type(
+ 'FunkycommerceCommunityMedia',
+ array(
+ 'description' => __( 'One ordered image or MP4 attached to a community post.', 'funkycommerce-headless' ),
+ 'fields' => array(
+ 'databaseId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'url' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'mimeType' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'mediaType' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'altText' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'width' => array( 'type' => 'Int' ),
+ 'height' => array( 'type' => 'Int' ),
+ 'srcSet' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'sizes' => array( 'type' => array( 'non_null' => 'String' ) ),
+ ),
+ )
+ );
+ register_graphql_input_type(
+ 'FunkycommerceCommunityMediaInput',
+ array(
+ 'description' => __( 'An existing post media attachment to retain or a new data URL to upload.', 'funkycommerce-headless' ),
+ 'fields' => array(
+ 'attachmentId' => array( 'type' => 'Int' ),
+ 'dataUrl' => array( 'type' => 'String' ),
+ ),
+ )
+ );
+ register_graphql_object_type(
+ 'CommunityProfilePageInfo',
+ array(
+ 'fields' => array(
+ 'hasNextPage' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
+ 'endCursor' => array( 'type' => 'String' ),
+ ),
+ )
+ );
+ register_graphql_object_type(
+ 'CommunityProfileConnection',
+ array(
+ 'fields' => array(
+ 'nodes' => array( 'type' => array( 'non_null' => array( 'list_of' => 'CommunityMemberProfile' ) ) ),
+ 'totalCount' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'pageInfo' => array( 'type' => array( 'non_null' => 'CommunityProfilePageInfo' ) ),
+ ),
+ )
+ );
register_graphql_object_type(
'CommunityMemberProfile',
array(
@@ -751,6 +2017,10 @@ function funkycommerce_register_community_graphql() {
);
},
),
+ 'cover' => array(
+ 'type' => 'FunkycommerceCommunityMedia',
+ 'resolve' => fn( $user ) => funkycommerce_community_profile_cover( $user->ID ),
+ ),
'communityRole' => array(
'type' => 'String',
'resolve' => function ( $user ) {
@@ -760,28 +2030,193 @@ function funkycommerce_register_community_graphql() {
return in_array( 'creator', (array) $user->roles, true ) ? 'creator' : 'member';
},
),
+ 'communityMemberTypes' => array(
+ 'type' => array( 'non_null' => array( 'list_of' => 'String' ) ),
+ 'resolve' => 'funkycommerce_community_member_types',
+ ),
'communityProfilePublic' => array(
'type' => array( 'non_null' => 'Boolean' ),
'resolve' => fn( $user ) => funkycommerce_is_community_profile_public( $user->ID ),
),
'followerCount' => array(
'type' => array( 'non_null' => 'Int' ),
- 'resolve' => fn( $user ) => max( 0, (int) get_user_meta( $user->ID, '_community_follower_count', true ) ),
+ 'resolve' => fn( $user ) => funkycommerce_community_relationship_count( $user->ID, 'followers' ),
),
'followingCount' => array(
'type' => array( 'non_null' => 'Int' ),
- 'resolve' => function ( $user ) {
- $following = get_user_meta( $user->ID, '_community_following', true );
- return is_array( $following ) ? count( $following ) : 0;
- },
+ 'resolve' => fn( $user ) => funkycommerce_community_relationship_count( $user->ID, 'following' ),
),
'isFollowedByViewer' => array(
'type' => array( 'non_null' => 'Boolean' ),
- 'resolve' => function ( $user ) {
+ 'resolve' => fn( $user ) => 'accepted' === funkycommerce_community_relationship_state( $user->ID ),
+ ),
+ 'relationshipState' => array(
+ 'type' => array( 'non_null' => 'String' ),
+ 'resolve' => fn( $user ) => funkycommerce_community_relationship_state( $user->ID ),
+ ),
+ 'canAccess' => array(
+ 'type' => array( 'non_null' => 'Boolean' ),
+ 'resolve' => fn( $user ) => funkycommerce_can_access_community_profile( $user->ID ),
+ ),
+ 'isLocked' => array(
+ 'type' => array( 'non_null' => 'Boolean' ),
+ 'resolve' => fn( $user ) => ! funkycommerce_can_access_community_profile( $user->ID ),
+ ),
+ 'followers' => array(
+ 'type' => array( 'non_null' => 'CommunityProfileConnection' ),
+ 'args' => array(
+ 'first' => array( 'type' => 'Int' ),
+ 'after' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => fn( $user, $args ) => funkycommerce_community_profile_connection( $user->ID, 'followers', $args ),
+ ),
+ 'following' => array(
+ 'type' => array( 'non_null' => 'CommunityProfileConnection' ),
+ 'args' => array(
+ 'first' => array( 'type' => 'Int' ),
+ 'after' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => fn( $user, $args ) => funkycommerce_community_profile_connection( $user->ID, 'following', $args ),
+ ),
+ 'pendingFollowRequests' => array(
+ 'type' => array( 'non_null' => 'CommunityProfileConnection' ),
+ 'args' => array(
+ 'first' => array( 'type' => 'Int' ),
+ 'after' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => function ( $user, $args ) {
$viewer_id = funkycommerce_graphql_login_user_id();
- if ( ! $viewer_id ) return false;
- $following = get_user_meta( $viewer_id, '_community_following', true );
- return is_array( $following ) && in_array( (int) $user->ID, array_map( 'intval', $following ), true );
+ if ( $viewer_id !== (int) $user->ID && ! user_can( $viewer_id, 'manage_options' ) ) {
+ throw new \GraphQL\Error\UserError( __( 'Only the profile owner can view follow requests.', 'funkycommerce-headless' ) );
+ }
+ if ( ! funkycommerce_community_followers_enabled() ) {
+ return array(
+ 'nodes' => array(),
+ 'totalCount' => 0,
+ 'pageInfo' => array( 'hasNextPage' => false, 'endCursor' => null ),
+ );
+ }
+ global $wpdb;
+ $table_name = funkycommerce_community_follows_table();
+ $after_id = 0;
+ if ( ! empty( $args['after'] ) ) {
+ $decoded = base64_decode( (string) $args['after'], true );
+ $after_id = false !== $decoded && preg_match( '/^community:(\d+)$/', $decoded, $matches ) ? absint( $matches[1] ) : 0;
+ }
+ $first = min( 50, max( 1, absint( $args['first'] ?? 20 ) ) );
+ $rows = $wpdb->get_results(
+ $wpdb->prepare(
+ "SELECT id, follower_user_id FROM {$table_name}
+ WHERE followed_user_id = %d AND status = 'pending' AND id > %d
+ ORDER BY id ASC LIMIT %d",
+ $user->ID,
+ $after_id,
+ $first + 1
+ ),
+ ARRAY_A
+ );
+ $has_next = count( $rows ) > $first;
+ $page = array_slice( $rows, 0, $first );
+ $ids = array_map( fn( $row ) => absint( $row['follower_user_id'] ), $page );
+ $total = (int) $wpdb->get_var(
+ $wpdb->prepare(
+ "SELECT COUNT(*) FROM {$table_name} WHERE followed_user_id = %d AND status = 'pending'",
+ $user->ID
+ )
+ );
+ return array(
+ 'nodes' => array_values( array_filter( array_map( 'get_userdata', $ids ) ) ),
+ 'totalCount' => $total,
+ 'pageInfo' => array(
+ 'hasNextPage' => $has_next,
+ 'endCursor' => $page ? base64_encode( 'community:' . absint( $page[ count( $page ) - 1 ]['id'] ) ) : null,
+ ),
+ );
+ },
+ ),
+ 'posts' => array(
+ 'type' => array( 'non_null' => array( 'list_of' => 'CommunityPost' ) ),
+ 'args' => array(
+ 'language' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => function ( $user, $args, $context ) {
+ if ( ! funkycommerce_can_access_community_profile( $user->ID ) ) {
+ return array();
+ }
+ $query_args = array(
+ 'post_type' => 'community_post',
+ 'post_status' => 'publish',
+ 'author' => $user->ID,
+ 'posts_per_page' => 100,
+ 'fields' => 'ids',
+ );
+ $language = sanitize_key( (string) ( $args['language'] ?? '' ) );
+ if ( $language ) {
+ $query_args['lang'] = $language;
+ }
+ $ids = get_posts(
+ $query_args
+ );
+ return array_map( fn( $id ) => $context->get_loader( 'post' )->load_deferred( $id ), $ids );
+ },
+ ),
+ 'articles' => array(
+ 'type' => array( 'non_null' => array( 'list_of' => 'Post' ) ),
+ 'args' => array(
+ 'language' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => function ( $user, $args, $context ) {
+ if ( ! funkycommerce_can_access_community_profile( $user->ID ) ) {
+ return array();
+ }
+ $query_args = array(
+ 'post_type' => 'post',
+ 'post_status' => 'publish',
+ 'author' => $user->ID,
+ 'posts_per_page' => 100,
+ 'fields' => 'ids',
+ );
+ $language = sanitize_key( (string) ( $args['language'] ?? '' ) );
+ if ( $language ) {
+ $query_args['lang'] = $language;
+ }
+ $ids = get_posts(
+ $query_args
+ );
+ return array_map( fn( $id ) => $context->get_loader( 'post' )->load_deferred( $id ), $ids );
+ },
+ ),
+ 'followingFeed' => array(
+ 'type' => array( 'non_null' => array( 'list_of' => 'CommunityPost' ) ),
+ 'args' => array(
+ 'language' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => function ( $user, $args, $context ) {
+ if ( ! funkycommerce_can_access_community_profile( $user->ID ) ) {
+ return array();
+ }
+ $author_ids = array_values(
+ array_filter(
+ funkycommerce_community_accepted_ids( $user->ID, 'following' ),
+ 'funkycommerce_can_access_community_profile'
+ )
+ );
+ if ( ! $author_ids ) {
+ return array();
+ }
+ $query_args = array(
+ 'post_type' => 'community_post',
+ 'post_status' => 'publish',
+ 'author__in' => $author_ids,
+ 'posts_per_page' => 100,
+ 'fields' => 'ids',
+ );
+ $language = sanitize_key( (string) ( $args['language'] ?? '' ) );
+ if ( $language ) {
+ $query_args['lang'] = $language;
+ }
+ $ids = get_posts( $query_args );
+ return array_map( fn( $id ) => $context->get_loader( 'post' )->load_deferred( $id ), $ids );
},
),
),
@@ -825,6 +2260,17 @@ function funkycommerce_register_community_graphql() {
},
)
);
+ register_graphql_field(
+ 'User',
+ 'communityCover',
+ array(
+ 'type' => 'FunkycommerceCommunityMedia',
+ 'resolve' => function ( $user ) {
+ $user_id = is_object( $user ) && isset( $user->databaseId ) ? (int) $user->databaseId : ( is_object( $user ) && isset( $user->ID ) ? (int) $user->ID : 0 );
+ return funkycommerce_community_profile_cover( $user_id );
+ },
+ )
+ );
register_graphql_field(
'User',
'followerCount',
@@ -832,7 +2278,7 @@ function funkycommerce_register_community_graphql() {
'type' => array( 'non_null' => 'Int' ),
'resolve' => function ( $user ) {
$user_id = is_object( $user ) && isset( $user->databaseId ) ? (int) $user->databaseId : ( is_object( $user ) && isset( $user->ID ) ? (int) $user->ID : 0 );
- return max( 0, (int) get_user_meta( $user_id, '_community_follower_count', true ) );
+ return funkycommerce_community_relationship_count( $user_id, 'followers' );
},
)
);
@@ -843,28 +2289,71 @@ function funkycommerce_register_community_graphql() {
'type' => array( 'non_null' => 'Int' ),
'resolve' => function ( $user ) {
$user_id = is_object( $user ) && isset( $user->databaseId ) ? (int) $user->databaseId : ( is_object( $user ) && isset( $user->ID ) ? (int) $user->ID : 0 );
- $following = get_user_meta( $user_id, '_community_following', true );
- return is_array( $following ) ? count( $following ) : 0;
+ return funkycommerce_community_relationship_count( $user_id, 'following' );
+ },
+ )
+ );
+ register_graphql_field(
+ 'RootQuery',
+ 'communityProfilesPublicEnabled',
+ array(
+ 'type' => array( 'non_null' => 'Boolean' ),
+ 'resolve' => 'funkycommerce_community_profiles_public_enabled',
+ )
+ );
+ register_graphql_field(
+ 'RootQuery',
+ 'communityFollowersEnabled',
+ array(
+ 'type' => array( 'non_null' => 'Boolean' ),
+ 'resolve' => 'funkycommerce_community_followers_enabled',
+ )
+ );
+
+ register_graphql_field(
+ 'CommunityPost',
+ 'description',
+ array(
+ 'type' => array( 'non_null' => 'String' ),
+ 'resolve' => function ( $post ) {
+ $content = (string) get_post_field( 'post_content', funkycommerce_community_source_id( $post ) );
+ return $content ? apply_filters( 'the_content', $content ) : '';
+ },
+ )
+ );
+ register_graphql_field(
+ 'CommunityPost',
+ 'media',
+ array(
+ 'type' => array( 'non_null' => array( 'list_of' => 'FunkycommerceCommunityMedia' ) ),
+ 'resolve' => function ( $post ) {
+ return array_values(
+ array_filter(
+ array_map(
+ 'funkycommerce_community_media_item',
+ funkycommerce_resolved_community_media_ids( funkycommerce_community_source_id( $post ) )
+ )
+ )
+ );
},
)
);
register_graphql_field(
- 'RootQuery',
- 'communityProfilesPublicEnabled',
+ 'CommunityPost',
+ 'canEdit',
array(
'type' => array( 'non_null' => 'Boolean' ),
- 'resolve' => 'funkycommerce_community_profiles_public_enabled',
+ 'resolve' => fn( $post ) => funkycommerce_can_manage_community_post( funkycommerce_community_source_id( $post ) ),
)
);
register_graphql_field(
- 'RootQuery',
- 'communityFollowersEnabled',
+ 'CommunityPost',
+ 'canDelete',
array(
'type' => array( 'non_null' => 'Boolean' ),
- 'resolve' => 'funkycommerce_community_followers_enabled',
+ 'resolve' => fn( $post ) => funkycommerce_can_manage_community_post( funkycommerce_community_source_id( $post ) ),
)
);
-
register_graphql_field(
'CommunityPost',
'likesCount',
@@ -954,8 +2443,7 @@ function funkycommerce_register_community_graphql() {
if ( ! $user_id ) {
$user_id = (int) get_post_field( 'post_author', $product_id );
}
- $viewer_id = funkycommerce_graphql_login_user_id();
- if ( $user_id && $viewer_id !== $user_id && ! funkycommerce_is_community_profile_public( $user_id ) ) {
+ if ( $user_id && ! funkycommerce_can_access_community_profile( $user_id ) ) {
return null;
}
return $user_id ? get_userdata( $user_id ) : null;
@@ -963,14 +2451,20 @@ function funkycommerce_register_community_graphql() {
)
);
register_graphql_field(
- 'Product',
- 'author',
+ 'CommunityMemberProfile',
+ 'products',
array(
- 'type' => 'User',
- 'resolve' => function ( $product, $args, $context ) {
- $product_id = funkycommerce_community_source_id( $product );
- $author_id = (int) get_post_field( 'post_author', $product_id );
- return $author_id ? $context->get_loader( 'user' )->load_deferred( $author_id ) : null;
+ 'type' => array( 'non_null' => array( 'list_of' => 'Product' ) ),
+ 'args' => array(
+ 'language' => array( 'type' => 'String' ),
+ ),
+ 'resolve' => function ( $user, $args, $context ) {
+ if ( ! funkycommerce_can_access_community_profile( $user->ID ) ) {
+ return array();
+ }
+ $language = sanitize_key( (string) ( $args['language'] ?? '' ) );
+ $ids = funkycommerce_get_seller_product_ids( array( $user->ID ), 100, $language );
+ return array_map( fn( $id ) => $context->get_loader( 'wc_post' )->load_deferred( $id ), $ids );
},
)
);
@@ -979,8 +2473,12 @@ function funkycommerce_register_community_graphql() {
'RootQuery',
'communityMembers',
array(
- 'type' => array( 'list_of' => 'CommunityMemberProfile' ),
- 'resolve' => function () {
+ 'type' => array( 'list_of' => 'CommunityMemberProfile' ),
+ 'args' => array(
+ 'search' => array( 'type' => 'String' ),
+ 'first' => array( 'type' => 'Int' ),
+ ),
+ 'resolve' => function ( $root, $args ) {
$visible_user_ids = funkycommerce_visible_community_user_ids();
if ( ! $visible_user_ids ) {
return array();
@@ -992,10 +2490,55 @@ function funkycommerce_register_community_graphql() {
'order' => 'ASC',
)
);
+ $search = sanitize_text_field( trim( (string) ( $args['search'] ?? '' ) ) );
+ if ( $search ) {
+ $users = array_values(
+ array_filter(
+ $users,
+ static function ( $user ) use ( $search ) {
+ $haystack = implode(
+ ' ',
+ array(
+ $user->display_name,
+ funkycommerce_community_profile_handle( $user ),
+ (string) get_user_meta( $user->ID, 'description', true ),
+ )
+ );
+ return function_exists( 'mb_stripos' )
+ ? false !== mb_stripos( $haystack, $search )
+ : false !== stripos( $haystack, $search );
+ }
+ )
+ );
+ }
+ if ( isset( $args['first'] ) ) {
+ $users = array_slice( $users, 0, min( max( absint( $args['first'] ), 1 ), 20 ) );
+ }
return $users;
},
)
);
+ register_graphql_field(
+ 'RootQuery',
+ 'communityProfileByHandle',
+ array(
+ 'type' => 'CommunityMemberProfile',
+ 'args' => array(
+ 'handle' => array( 'type' => array( 'non_null' => 'String' ) ),
+ ),
+ 'resolve' => function ( $root, $args ) {
+ $user = funkycommerce_community_find_user_by_handle( $args['handle'] ?? '' );
+ if ( ! $user ) {
+ return null;
+ }
+ $viewer_id = funkycommerce_graphql_login_user_id();
+ if ( ! funkycommerce_community_profiles_public_enabled() && $viewer_id !== (int) $user->ID && ! user_can( $viewer_id, 'manage_options' ) ) {
+ return null;
+ }
+ return $user;
+ },
+ )
+ );
if ( funkycommerce_has_woocommerce_graphql() ) {
register_graphql_field(
'RootQuery',
@@ -1012,33 +2555,24 @@ function funkycommerce_register_community_graphql() {
if ( ! $visible_user_ids ) {
return array();
}
- $query = array(
- 'post_type' => 'product',
- 'post_status' => 'publish',
- 'posts_per_page' => -1,
- 'fields' => 'ids',
- );
+ $language = '';
if ( ! empty( $args['language'] ) ) {
try {
- $query['lang'] = funkycommerce_normalize_content_language( $args['language'] );
+ $language = funkycommerce_normalize_content_language( $args['language'] );
} catch ( InvalidArgumentException $error ) {
throw new \GraphQL\Error\UserError( $error->getMessage() );
}
}
- $product_ids = get_posts( $query );
$requested_seller_id = absint( $args['sellerId'] ?? 0 );
- $product_ids = array_values(
- array_filter(
- $product_ids,
- function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
- $assigned_seller_id = (int) get_post_meta( $product_id, '_seller_user_id', true );
- $seller_id = $assigned_seller_id ?: (int) get_post_field( 'post_author', $product_id );
- return in_array( $seller_id, $visible_user_ids, true )
- && ( ! $requested_seller_id || $requested_seller_id === $seller_id );
- }
- )
+ if ( $requested_seller_id && ! in_array( $requested_seller_id, $visible_user_ids, true ) ) {
+ return array();
+ }
+ $seller_ids = $requested_seller_id ? array( $requested_seller_id ) : $visible_user_ids;
+ $product_ids = funkycommerce_get_seller_product_ids(
+ $seller_ids,
+ min( 48, max( 1, absint( $args['first'] ?? 24 ) ) ),
+ $language
);
- $product_ids = array_slice( $product_ids, 0, min( 48, max( 1, absint( $args['first'] ?? 24 ) ) ) );
return array_values(
array_filter(
array_map(
@@ -1056,10 +2590,15 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
'publishCommunityPost',
array(
'inputFields' => array(
- 'caption' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'title' => array( 'type' => 'String' ),
+ 'description' => array( 'type' => 'String' ),
'tags' => array( 'type' => array( 'list_of' => 'String' ) ),
- 'imageDataUrl' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'media' => array( 'type' => array( 'list_of' => 'FunkycommerceCommunityMediaInput' ) ),
'language' => array( 'type' => 'String' ),
+ 'translationOfId' => array( 'type' => 'Int' ),
+ // Legacy clients can continue sending caption plus one image.
+ 'caption' => array( 'type' => 'String' ),
+ 'imageDataUrl' => array( 'type' => 'String' ),
),
'outputFields' => array(
'communityPost' => array(
@@ -1069,16 +2608,25 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
),
'mutateAndGetPayload' => function ( $input ) {
funkycommerce_require_publishing_capability( 'publish_community_posts' );
- $caption = trim( wp_kses_post( $input['caption'] ?? '' ) );
- if ( '' === $caption ) {
- throw new \GraphQL\Error\UserError( __( 'A caption is required.', 'funkycommerce-headless' ) );
+ $legacy_caption = trim( wp_kses_post( $input['caption'] ?? '' ) );
+ $title = sanitize_text_field( $input['title'] ?? '' );
+ if ( ! $title && $legacy_caption ) {
+ $title = wp_trim_words( wp_strip_all_tags( $legacy_caption ), 10 );
+ }
+ if ( '' === trim( $title ) ) {
+ throw new \GraphQL\Error\UserError( __( 'A community post title is required.', 'funkycommerce-headless' ) );
+ }
+ $description = array_key_exists( 'description', $input ) ? trim( wp_kses_post( $input['description'] ) ) : $legacy_caption;
+ $media_inputs = array_values( (array) ( $input['media'] ?? array() ) );
+ if ( ! $media_inputs && ! empty( $input['imageDataUrl'] ) ) {
+ $media_inputs[] = array( 'dataUrl' => $input['imageDataUrl'] );
}
$post_id = wp_insert_post(
array(
'post_type' => 'community_post',
'post_status' => 'publish',
- 'post_title' => wp_trim_words( wp_strip_all_tags( $caption ), 10 ),
- 'post_content' => $caption,
+ 'post_title' => $title,
+ 'post_content' => $description,
'post_author' => get_current_user_id(),
),
true
@@ -1086,33 +2634,168 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
if ( is_wp_error( $post_id ) ) {
throw new \GraphQL\Error\UserError( $post_id->get_error_message() );
}
+ $new_media_ids = array();
try {
- funkycommerce_assign_post_language( $post_id, $input['language'] ?? '' );
- } catch ( InvalidArgumentException $error ) {
- wp_delete_post( $post_id, true );
- throw new \GraphQL\Error\UserError( $error->getMessage() );
- }
- $tags = array_values( array_filter( array_map( 'sanitize_text_field', $input['tags'] ?? array() ) ) );
- if ( $tags ) {
- $term_ids = funkycommerce_set_multilingual_terms( $post_id, $tags, 'community_tag', $input['language'] ?? '' );
+ $language = funkycommerce_assign_post_language( $post_id, $input['language'] ?? '' );
+ $tags = array_values( array_filter( array_map( 'sanitize_text_field', $input['tags'] ?? array() ) ) );
+ $term_ids = funkycommerce_set_multilingual_terms( $post_id, $tags, 'community_tag', $language );
if ( is_wp_error( $term_ids ) ) {
- wp_delete_post( $post_id, true );
throw new \GraphQL\Error\UserError( $term_ids->get_error_message() );
}
+ try {
+ $media = funkycommerce_resolve_community_media_inputs( $post_id, $media_inputs, $title );
+ $new_media_ids = $media['new_ids'];
+ funkycommerce_save_community_media( $post_id, $media['ids'] );
+ funkycommerce_associate_post_translation( $post_id, $input['translationOfId'] ?? 0 );
+ } catch ( \Throwable $error ) {
+ funkycommerce_emit_notification(
+ 'theme.community_media_rejected',
+ __( 'Community media rejected', 'funkycommerce-headless' ),
+ __( 'Community post media did not pass upload validation.', 'funkycommerce-headless' ),
+ array( __( 'Post ID', 'funkycommerce-headless' ) => $post_id ),
+ admin_url( 'edit.php?post_type=community_post' )
+ );
+ throw $error;
+ }
+ update_post_meta( $post_id, '_community_likes', 0 );
+ } catch ( \Throwable $error ) {
+ foreach ( $new_media_ids as $new_media_id ) {
+ wp_delete_attachment( $new_media_id, true );
+ }
+ wp_delete_post( $post_id, true );
+ if ( $error instanceof InvalidArgumentException ) {
+ throw new \GraphQL\Error\UserError( $error->getMessage() );
+ }
+ throw $error;
+ }
+ funkycommerce_emit_notification(
+ 'theme.community_post_published',
+ __( 'Community post published', 'funkycommerce-headless' ),
+ __( 'A community member published a new post.', 'funkycommerce-headless' ),
+ array(
+ __( 'Post ID', 'funkycommerce-headless' ) => $post_id,
+ __( 'Tag count', 'funkycommerce-headless' ) => count( $tags ),
+ ),
+ get_edit_post_link( $post_id, 'raw' )
+ );
+ return array( 'post_id' => $post_id );
+ },
+ )
+ );
+
+ register_graphql_mutation(
+ 'updateStorefrontCommunityPost',
+ array(
+ 'inputFields' => array(
+ 'postId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'title' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'description' => array( 'type' => 'String' ),
+ 'tags' => array( 'type' => array( 'list_of' => 'String' ) ),
+ 'media' => array( 'type' => array( 'list_of' => 'FunkycommerceCommunityMediaInput' ) ),
+ 'translationOfId' => array( 'type' => 'Int' ),
+ ),
+ 'outputFields' => array(
+ 'communityPost' => array(
+ 'type' => 'CommunityPost',
+ 'resolve' => fn( $payload, $args, $context ) => \WPGraphQL\Data\DataSource::resolve_post_object( $payload['post_id'], $context ),
+ ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ funkycommerce_require_publishing_capability( 'publish_community_posts' );
+ $post_id = absint( $input['postId'] ?? 0 );
+ $post = funkycommerce_require_post_owner( $post_id, 'community_post' );
+ $title = sanitize_text_field( $input['title'] ?? '' );
+ if ( '' === trim( $title ) ) {
+ throw new \GraphQL\Error\UserError( __( 'A community post title is required.', 'funkycommerce-headless' ) );
}
+
+ $old_media_meta = get_post_meta( $post_id, '_community_media_ids', true );
+ $old_media_ids = funkycommerce_community_media_ids( $post_id );
+ $old_resolved_ids = funkycommerce_resolved_community_media_ids( $post_id );
+ $old_thumbnail = get_post_thumbnail_id( $post_id );
+ $old_term_ids = wp_get_object_terms( $post_id, 'community_tag', array( 'fields' => 'ids' ) );
+ $old_term_ids = is_wp_error( $old_term_ids ) ? array() : array_map( 'absint', $old_term_ids );
+ $media = funkycommerce_resolve_community_media_inputs(
+ $post_id,
+ array_values( (array) ( $input['media'] ?? array() ) ),
+ $title,
+ $old_resolved_ids
+ );
+ $media_ids_to_save = $media['ids'] === $old_resolved_ids ? $old_media_ids : $media['ids'];
+
try {
- $image_id = funkycommerce_create_graphql_attachment( $input['imageDataUrl'] ?? '', get_the_title( $post_id ) );
- } catch ( \GraphQL\Error\UserError $error ) {
- wp_delete_post( $post_id, true );
+ $result = wp_update_post(
+ array(
+ 'ID' => $post_id,
+ 'post_title' => $title,
+ 'post_content' => trim( wp_kses_post( $input['description'] ?? '' ) ),
+ ),
+ true
+ );
+ if ( is_wp_error( $result ) ) {
+ throw new \GraphQL\Error\UserError( $result->get_error_message() );
+ }
+ $language = funkycommerce_post_language_slug( $post_id );
+ $tags = array_values( array_filter( array_map( 'sanitize_text_field', $input['tags'] ?? array() ) ) );
+ $term_ids = funkycommerce_set_multilingual_terms( $post_id, $tags, 'community_tag', $language );
+ if ( is_wp_error( $term_ids ) ) {
+ throw new \GraphQL\Error\UserError( $term_ids->get_error_message() );
+ }
+ funkycommerce_save_community_media( $post_id, $media_ids_to_save );
+ funkycommerce_associate_post_translation( $post_id, $input['translationOfId'] ?? 0 );
+ } catch ( \Throwable $error ) {
+ wp_update_post(
+ array(
+ 'ID' => $post_id,
+ 'post_title' => $post->post_title,
+ 'post_content' => $post->post_content,
+ )
+ );
+ wp_set_object_terms( $post_id, $old_term_ids, 'community_tag', false );
+ if ( is_array( $old_media_meta ) ) {
+ update_post_meta( $post_id, '_community_media_ids', $old_media_meta );
+ } else {
+ delete_post_meta( $post_id, '_community_media_ids' );
+ }
+ if ( $old_thumbnail ) {
+ set_post_thumbnail( $post_id, $old_thumbnail );
+ } else {
+ delete_post_thumbnail( $post_id );
+ }
+ foreach ( $media['new_ids'] as $new_id ) {
+ wp_delete_attachment( $new_id, true );
+ }
throw $error;
}
- set_post_thumbnail( $post_id, $image_id );
- update_post_meta( $post_id, '_community_likes', 0 );
+
+ foreach ( array_diff( $old_media_ids, $media_ids_to_save ) as $removed_id ) {
+ funkycommerce_delete_or_transfer_community_media( $removed_id, $post_id );
+ }
return array( 'post_id' => $post_id );
},
)
);
+ register_graphql_mutation(
+ 'deleteStorefrontCommunityPost',
+ array(
+ 'inputFields' => array(
+ 'postId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'outputFields' => array(
+ 'deletedPostId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ $post_id = absint( $input['postId'] ?? 0 );
+ funkycommerce_require_post_owner( $post_id, 'community_post' );
+ if ( ! wp_delete_post( $post_id, true ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The community post could not be deleted.', 'funkycommerce-headless' ) );
+ }
+ return array( 'deletedPostId' => $post_id );
+ },
+ )
+ );
+
register_graphql_mutation(
'toggleCommunityPostLike',
array(
@@ -1133,8 +2816,16 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
if ( ! $post || 'community_post' !== $post->post_type || 'publish' !== $post->post_status ) {
throw new \GraphQL\Error\UserError( __( 'The community post is unavailable.', 'funkycommerce-headless' ) );
}
+ if (
+ ! metadata_exists( 'post', $post_id, '_community_likes' )
+ && false === add_post_meta( $post_id, '_community_likes', 0, true )
+ && ! metadata_exists( 'post', $post_id, '_community_likes' )
+ ) {
+ throw new \GraphQL\Error\UserError( __( 'The community like counter could not be initialized.', 'funkycommerce-headless' ) );
+ }
$liked = get_user_meta( $user_id, '_community_liked_posts', true );
$liked = is_array( $liked ) ? array_values( array_unique( array_map( 'intval', $liked ) ) ) : array();
+ $previous_liked = $liked;
$index = array_search( $post_id, $liked, true );
if ( false === $index ) {
$liked[] = $post_id;
@@ -1143,15 +2834,21 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
unset( $liked[ $index ] );
$active = false;
}
- update_user_meta( $user_id, '_community_liked_posts', array_values( $liked ) );
+ if ( false === update_user_meta( $user_id, '_community_liked_posts', array_values( $liked ) ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The community like could not be saved.', 'funkycommerce-headless' ) );
+ }
global $wpdb;
- $wpdb->query(
+ $updated = $wpdb->query(
$wpdb->prepare(
"UPDATE {$wpdb->postmeta} SET meta_value = GREATEST(0, CAST(meta_value AS SIGNED) + %d) WHERE post_id = %d AND meta_key = '_community_likes'",
$active ? 1 : -1,
$post_id
)
);
+ if ( false === $updated ) {
+ update_user_meta( $user_id, '_community_liked_posts', $previous_liked );
+ throw new \GraphQL\Error\UserError( __( 'The community like could not be saved.', 'funkycommerce-headless' ) );
+ }
wp_cache_delete( $post_id, 'post_meta' );
$count = (int) get_post_meta( $post_id, '_community_likes', true );
return array( 'liked' => $active, 'likesCount' => $count );
@@ -1177,12 +2874,84 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
throw new \GraphQL\Error\UserError( __( 'Public community profiles are disabled by the site administrator.', 'funkycommerce-headless' ) );
}
$is_public = ! empty( $input['isPublic'] );
- update_user_meta( $user_id, '_community_profile_visibility', $is_public ? 'public' : 'private' );
+ $previous = get_user_meta( $user_id, '_community_profile_visibility', true );
+ try {
+ funkycommerce_with_community_profile_lock(
+ $user_id,
+ function () use ( $user_id, $is_public ) {
+ update_user_meta( $user_id, '_community_profile_visibility', $is_public ? 'public' : 'private' );
+ if ( $is_public ) {
+ funkycommerce_community_promote_pending_followers( $user_id );
+ }
+ }
+ );
+ } catch ( \Throwable $error ) {
+ if ( '' === $previous ) {
+ delete_user_meta( $user_id, '_community_profile_visibility' );
+ } else {
+ update_user_meta( $user_id, '_community_profile_visibility', $previous );
+ }
+ if ( $error instanceof \GraphQL\Error\UserError ) {
+ throw $error;
+ }
+ throw new \GraphQL\Error\UserError( $error->getMessage() );
+ }
+ if ( $is_public !== funkycommerce_is_community_profile_public( $user_id ) ) {
+ if ( '' === $previous ) {
+ delete_user_meta( $user_id, '_community_profile_visibility' );
+ } else {
+ update_user_meta( $user_id, '_community_profile_visibility', $previous );
+ }
+ throw new \GraphQL\Error\UserError( __( 'The community profile visibility could not be updated.', 'funkycommerce-headless' ) );
+ }
return array( 'isPublic' => funkycommerce_is_community_profile_public( $user_id ) );
},
)
);
+ register_graphql_mutation(
+ 'uploadCommunityProfileCover',
+ array(
+ 'inputFields' => array( 'dataUrl' => array( 'type' => array( 'non_null' => 'String' ) ) ),
+ 'outputFields' => array( 'cover' => array( 'type' => 'FunkycommerceCommunityMedia' ) ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ $user_id = funkycommerce_graphql_login_user_id();
+ if ( ! $user_id ) {
+ throw new \GraphQL\Error\UserError( __( 'Authentication is required.', 'funkycommerce-headless' ) );
+ }
+ $new_id = funkycommerce_create_community_cover_attachment( $input['dataUrl'] ?? '', $user_id );
+ $old_id = absint( get_user_meta( $user_id, '_community_cover_attachment_id', true ) );
+ if ( ! update_user_meta( $user_id, '_community_cover_attachment_id', $new_id ) ) {
+ funkycommerce_delete_owned_community_cover( $user_id, $new_id );
+ throw new \GraphQL\Error\UserError( __( 'The profile cover could not be saved.', 'funkycommerce-headless' ) );
+ }
+ if ( $old_id && $old_id !== $new_id ) {
+ funkycommerce_delete_owned_community_cover( $user_id, $old_id );
+ }
+ return array( 'cover' => funkycommerce_community_profile_cover( $user_id ) );
+ },
+ )
+ );
+
+ register_graphql_mutation(
+ 'removeCommunityProfileCover',
+ array(
+ 'outputFields' => array( 'removed' => array( 'type' => array( 'non_null' => 'Boolean' ) ) ),
+ 'mutateAndGetPayload' => function () {
+ $user_id = funkycommerce_graphql_login_user_id();
+ if ( ! $user_id ) {
+ throw new \GraphQL\Error\UserError( __( 'Authentication is required.', 'funkycommerce-headless' ) );
+ }
+ $attachment_id = absint( get_user_meta( $user_id, '_community_cover_attachment_id', true ) );
+ delete_user_meta( $user_id, '_community_cover_attachment_id' );
+ if ( $attachment_id ) {
+ funkycommerce_delete_owned_community_cover( $user_id, $attachment_id );
+ }
+ return array( 'removed' => true );
+ },
+ )
+ );
+
register_graphql_mutation(
'toggleFollowUser',
array(
@@ -1192,56 +2961,83 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
'outputFields' => array(
'isFollowed' => array( 'type' => array( 'non_null' => 'Boolean' ) ),
'followerCount' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'relationshipState' => array( 'type' => array( 'non_null' => 'String' ) ),
),
'mutateAndGetPayload' => function ( $input ) {
- if ( ! funkycommerce_community_followers_enabled() ) {
- throw new \GraphQL\Error\UserError( __( 'The followers feature is disabled.', 'funkycommerce-headless' ) );
- }
- $viewer_id = funkycommerce_graphql_login_user_id();
- if ( ! $viewer_id ) {
- throw new \GraphQL\Error\UserError( __( 'Authentication is required.', 'funkycommerce-headless' ) );
- }
$target_id = absint( $input['userId'] ?? 0 );
- if ( ! $target_id || $target_id === $viewer_id ) {
- throw new \GraphQL\Error\UserError( __( 'Invalid target user.', 'funkycommerce-headless' ) );
- }
- if ( ! get_userdata( $target_id ) ) {
- throw new \GraphQL\Error\UserError( __( 'User not found.', 'funkycommerce-headless' ) );
- }
+ $viewer_id = funkycommerce_graphql_login_user_id();
+ $current = $viewer_id ? funkycommerce_community_relationship_status( $viewer_id, $target_id ) : '';
+ $state = in_array( $current, array( 'pending', 'accepted' ), true )
+ ? funkycommerce_unfollow_community_profile( $target_id )
+ : funkycommerce_follow_community_profile( $target_id );
+ return array(
+ 'isFollowed' => 'accepted' === $state,
+ 'followerCount' => funkycommerce_community_relationship_count( $target_id, 'followers' ),
+ 'relationshipState' => $state,
+ );
+ },
+ )
+ );
- $following = get_user_meta( $viewer_id, '_community_following', true );
- $following = is_array( $following ) ? array_values( array_unique( array_map( 'intval', $following ) ) ) : array();
- $index = array_search( $target_id, $following, true );
+ register_graphql_mutation(
+ 'followCommunityProfile',
+ array(
+ 'inputFields' => array( 'userId' => array( 'type' => array( 'non_null' => 'Int' ) ) ),
+ 'outputFields' => array(
+ 'relationshipState' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'followerCount' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ $target_id = absint( $input['userId'] ?? 0 );
+ return array(
+ 'relationshipState' => funkycommerce_follow_community_profile( $target_id ),
+ 'followerCount' => funkycommerce_community_relationship_count( $target_id, 'followers' ),
+ );
+ },
+ )
+ );
- global $wpdb;
- if ( false === $index ) {
- // Follow.
- $following[] = $target_id;
- $is_followed = true;
- $wpdb->query(
- $wpdb->prepare(
- "INSERT INTO {$wpdb->usermeta} (user_id, meta_key, meta_value)
- VALUES (%d, '_community_follower_count', '1')
- ON DUPLICATE KEY UPDATE meta_value = GREATEST(0, CAST(meta_value AS SIGNED) + 1)",
- $target_id
- )
- );
- } else {
- // Unfollow.
- unset( $following[ $index ] );
- $is_followed = false;
- $wpdb->query(
- $wpdb->prepare(
- "UPDATE {$wpdb->usermeta} SET meta_value = GREATEST(0, CAST(meta_value AS SIGNED) - 1) WHERE user_id = %d AND meta_key = '_community_follower_count'",
- $target_id
- )
- );
- }
+ register_graphql_mutation(
+ 'unfollowCommunityProfile',
+ array(
+ 'inputFields' => array( 'userId' => array( 'type' => array( 'non_null' => 'Int' ) ) ),
+ 'outputFields' => array(
+ 'relationshipState' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'followerCount' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ $target_id = absint( $input['userId'] ?? 0 );
+ return array(
+ 'relationshipState' => funkycommerce_unfollow_community_profile( $target_id ),
+ 'followerCount' => funkycommerce_community_relationship_count( $target_id, 'followers' ),
+ );
+ },
+ )
+ );
- update_user_meta( $viewer_id, '_community_following', array_values( $following ) );
- wp_cache_delete( $target_id, 'user_meta' );
- $new_count = max( 0, (int) get_user_meta( $target_id, '_community_follower_count', true ) );
- return array( 'isFollowed' => $is_followed, 'followerCount' => $new_count );
+ register_graphql_mutation(
+ 'manageCommunityFollower',
+ array(
+ 'inputFields' => array(
+ 'followerUserId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ 'profileUserId' => array( 'type' => 'Int' ),
+ 'action' => array( 'type' => array( 'non_null' => 'String' ) ),
+ ),
+ 'outputFields' => array(
+ 'relationshipState' => array( 'type' => array( 'non_null' => 'String' ) ),
+ 'followerCount' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ $profile_user_id = absint( $input['profileUserId'] ?? 0 ) ?: funkycommerce_graphql_login_user_id();
+ $state = funkycommerce_manage_community_follower(
+ $profile_user_id,
+ $input['followerUserId'] ?? 0,
+ sanitize_key( $input['action'] ?? '' )
+ );
+ return array(
+ 'relationshipState' => $state,
+ 'followerCount' => funkycommerce_community_relationship_count( $profile_user_id, 'followers' ),
+ );
},
)
);
@@ -1372,6 +3168,27 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
)
);
+ register_graphql_mutation(
+ 'deleteCollaboratorPost',
+ array(
+ 'inputFields' => array(
+ 'postId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'outputFields' => array(
+ 'deletedPostId' => array( 'type' => array( 'non_null' => 'Int' ) ),
+ ),
+ 'mutateAndGetPayload' => function ( $input ) {
+ funkycommerce_require_publishing_capability( 'publish_collaborator_posts' );
+ $post_id = absint( $input['postId'] ?? 0 );
+ funkycommerce_require_post_owner( $post_id, 'post' );
+ if ( ! wp_delete_post( $post_id, true ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The article could not be deleted.', 'funkycommerce-headless' ) );
+ }
+ return array( 'deletedPostId' => $post_id );
+ },
+ )
+ );
+
if ( funkycommerce_has_woocommerce_graphql() ) {
register_graphql_input_type(
'FunkycommerceMarketplaceAttributeInput',
@@ -1395,11 +3212,17 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
'FunkycommerceMarketplaceVariationInput',
array(
'fields' => array(
+ 'variationId' => array( 'type' => 'Int' ),
'sku' => array( 'type' => 'String' ),
'price' => array( 'type' => array( 'non_null' => 'Float' ) ),
'regularPrice' => array( 'type' => 'Float' ),
'stockQuantity' => array( 'type' => 'Int' ),
'imageIndex' => array( 'type' => 'Int' ),
+ 'isVirtual' => array( 'type' => 'Boolean' ),
+ 'isDownloadable' => array( 'type' => 'Boolean' ),
+ 'downloadableFiles' => array( 'type' => array( 'list_of' => 'FunkycommerceDownloadableFileInput' ) ),
+ 'downloadLimit' => array( 'type' => 'Int' ),
+ 'downloadExpiryDays' => array( 'type' => 'Int' ),
'attributes' => array( 'type' => array( 'list_of' => 'FunkycommerceMarketplaceVariationAttributeInput' ) ),
),
)
@@ -1436,6 +3259,8 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
'downloadableFiles' => array( 'type' => array( 'list_of' => 'FunkycommerceDownloadableFileInput' ) ),
'downloadLimit' => array( 'type' => 'Int' ),
'downloadExpiryDays' => array( 'type' => 'Int' ),
+ 'externalUrl' => array( 'type' => 'String' ),
+ 'buttonText' => array( 'type' => 'String' ),
'imageDataUrl' => array( 'type' => 'String' ),
'imageDataUrls' => array( 'type' => array( 'list_of' => 'String' ) ),
'attributes' => array( 'type' => array( 'list_of' => 'FunkycommerceMarketplaceAttributeInput' ) ),
@@ -1454,7 +3279,7 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
if ( ! $seller_id ) {
throw new \GraphQL\Error\UserError( __( 'The authenticated product author could not be resolved.', 'funkycommerce-headless' ) );
}
- if ( ! class_exists( 'WC_Product_Simple' ) || ! class_exists( 'WC_Product_Variable' ) ) {
+ if ( ! class_exists( 'WC_Product_Simple' ) || ! class_exists( 'WC_Product_Variable' ) || ! class_exists( 'WC_Product_External' ) ) {
throw new \GraphQL\Error\UserError( __( 'WooCommerce is unavailable.', 'funkycommerce-headless' ) );
}
$base_currency = strtoupper( get_woocommerce_currency() );
@@ -1462,28 +3287,51 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
if ( $input_currency !== $base_currency ) {
throw new \GraphQL\Error\UserError( sprintf( __( 'Marketplace prices must be submitted in the store base currency (%s).', 'funkycommerce-headless' ), $base_currency ) );
}
- $product_type = 'variable' === sanitize_key( $input['productType'] ?? '' ) ? 'variable' : 'simple';
- $price = wc_format_decimal( max( 0, (float) ( $input['price'] ?? 0 ) ), wc_get_price_decimals() );
+ $product_type = sanitize_key( $input['productType'] ?? 'simple' );
+ if ( ! in_array( $product_type, array( 'simple', 'variable', 'external' ), true ) ) {
+ throw new \GraphQL\Error\UserError( __( 'The selected product type is not supported.', 'funkycommerce-headless' ) );
+ }
+ $price = funkycommerce_validate_non_negative_marketplace_price( $input['price'] ?? null );
$price_value = (float) $price;
$variations = array_slice( (array) ( $input['variations'] ?? array() ), 0, 100 );
- if ( '' === trim( $input['name'] ?? '' ) || ( 'simple' === $product_type && $price_value <= 0 ) || ( 'variable' === $product_type && ! $variations ) ) {
- throw new \GraphQL\Error\UserError( __( 'A product name and positive price are required.', 'funkycommerce-headless' ) );
+ $external_url = esc_url_raw( $input['externalUrl'] ?? '', array( 'http', 'https' ) );
+ if ( '' === trim( $input['name'] ?? '' ) || ( 'variable' === $product_type && ! $variations ) ) {
+ throw new \GraphQL\Error\UserError( __( 'A product name and non-negative price are required.', 'funkycommerce-headless' ) );
+ }
+ if ( 'external' === $product_type && ! $external_url ) {
+ throw new \GraphQL\Error\UserError( __( 'External products require a valid HTTP or HTTPS product URL.', 'funkycommerce-headless' ) );
+ }
+ if ( 'variable' === $product_type ) {
+ $product = new WC_Product_Variable();
+ } elseif ( 'external' === $product_type ) {
+ $product = new WC_Product_External();
+ } else {
+ $product = new WC_Product_Simple();
}
- $product = 'variable' === $product_type ? new WC_Product_Variable() : new WC_Product_Simple();
$product->set_name( sanitize_text_field( $input['name'] ) );
$product->set_status( 'publish' );
$product->set_catalog_visibility( 'visible' );
$product->set_description( wp_kses_post( $input['description'] ?? '' ) );
$product->set_short_description( sanitize_textarea_field( $input['subtitle'] ?? '' ) );
$product->set_sku( sanitize_text_field( $input['sku'] ?? '' ) );
- if ( 'simple' === $product_type ) {
- $regular_price = wc_format_decimal( max( $price_value, (float) ( $input['regularPrice'] ?? $price_value ) ), wc_get_price_decimals() );
+ if ( 'variable' !== $product_type ) {
+ $regular_price = null === ( $input['regularPrice'] ?? null )
+ ? $price
+ : funkycommerce_validate_non_negative_marketplace_price( $input['regularPrice'], __( 'Compare-at price', 'funkycommerce-headless' ) );
+ if ( (float) $regular_price < $price_value ) {
+ throw new \GraphQL\Error\UserError( __( 'Compare-at price cannot be lower than the price.', 'funkycommerce-headless' ) );
+ }
$product->set_regular_price( $regular_price );
$product->set_sale_price( $price_value < (float) $regular_price ? $price : '' );
$product->set_price( $price );
+ }
+ if ( 'simple' === $product_type ) {
$product->set_manage_stock( true );
$product->set_stock_quantity( max( 0, (int) ( $input['stockQuantity'] ?? 0 ) ) );
$product->set_stock_status( (int) ( $input['stockQuantity'] ?? 0 ) > 0 ? 'instock' : 'outofstock' );
+ } elseif ( 'external' === $product_type ) {
+ $product->set_product_url( $external_url );
+ $product->set_button_text( sanitize_text_field( $input['buttonText'] ?? '' ) );
} else {
$product_attributes = array();
foreach ( array_slice( (array) ( $input['attributes'] ?? array() ), 0, 3 ) as $attribute_input ) {
@@ -1532,14 +3380,12 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
}
}
if ( ! empty( $input['brand'] ) ) {
- if ( ! taxonomy_exists( 'product_brand' ) ) {
- wp_delete_post( $product_id, true );
- throw new \GraphQL\Error\UserError( __( 'WooCommerce product brands are unavailable.', 'funkycommerce-headless' ) );
- }
- $brand_result = funkycommerce_set_multilingual_terms( $product_id, array( $input['brand'] ), 'product_brand', $language );
- if ( is_wp_error( $brand_result ) ) {
- wp_delete_post( $product_id, true );
- throw new \GraphQL\Error\UserError( $brand_result->get_error_message() );
+ if ( taxonomy_exists( 'product_brand' ) ) {
+ $brand_result = funkycommerce_set_multilingual_terms( $product_id, array( $input['brand'] ), 'product_brand', $language );
+ if ( is_wp_error( $brand_result ) ) {
+ wp_delete_post( $product_id, true );
+ throw new \GraphQL\Error\UserError( $brand_result->get_error_message() );
+ }
}
}
$product->set_upsell_ids( funkycommerce_valid_related_product_ids( $input['upsellIds'] ?? array(), $product_id ) );
@@ -1557,25 +3403,33 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
$product->set_image_id( $attachment_ids[0] );
$product->set_gallery_image_ids( array_slice( $attachment_ids, 1 ) );
}
- $attachment_ids = array_merge( $attachment_ids, funkycommerce_apply_marketplace_downloadable_settings( $product, $input ) );
+ $image_attachment_ids = $attachment_ids;
+ if ( 'simple' === $product_type ) {
+ $attachment_ids = array_merge( $attachment_ids, funkycommerce_apply_marketplace_downloadable_settings( $product, $input ) );
+ } elseif ( 'variable' === $product_type ) {
+ $product->set_virtual( ! empty( $input['isVirtual'] ) );
+ }
$product->save();
if ( 'variable' === $product_type ) {
foreach ( $variations as $variation_input ) {
- $variation_price = wc_format_decimal( max( 0, (float) ( $variation_input['price'] ?? 0 ) ), wc_get_price_decimals() );
+ $variation_price = funkycommerce_validate_non_negative_marketplace_price( $variation_input['price'] ?? null );
$variation_price_value = (float) $variation_price;
- if ( $variation_price_value <= 0 ) {
- throw new \GraphQL\Error\UserError( __( 'Every variation requires a positive price.', 'funkycommerce-headless' ) );
- }
$variation = new WC_Product_Variation();
$variation->set_parent_id( $product_id );
$variation->set_sku( sanitize_text_field( $variation_input['sku'] ?? '' ) );
- $variation_regular_price = wc_format_decimal( max( $variation_price_value, (float) ( $variation_input['regularPrice'] ?? $variation_price_value ) ), wc_get_price_decimals() );
+ $variation_regular_price = null === ( $variation_input['regularPrice'] ?? null )
+ ? $variation_price
+ : funkycommerce_validate_non_negative_marketplace_price( $variation_input['regularPrice'], __( 'Variation compare-at price', 'funkycommerce-headless' ) );
+ if ( (float) $variation_regular_price < $variation_price_value ) {
+ throw new \GraphQL\Error\UserError( __( 'Variation compare-at price cannot be lower than the price.', 'funkycommerce-headless' ) );
+ }
$variation->set_regular_price( $variation_regular_price );
$variation->set_sale_price( $variation_price_value < (float) $variation_regular_price ? $variation_price : '' );
$variation->set_price( $variation_price );
$variation->set_manage_stock( true );
$variation->set_stock_quantity( max( 0, (int) ( $variation_input['stockQuantity'] ?? 0 ) ) );
$variation->set_stock_status( (int) ( $variation_input['stockQuantity'] ?? 0 ) > 0 ? 'instock' : 'outofstock' );
+ $attachment_ids = array_merge( $attachment_ids, funkycommerce_apply_marketplace_downloadable_settings( $variation, $variation_input ) );
$variation_attributes = array();
foreach ( (array) ( $variation_input['attributes'] ?? array() ) as $variation_attribute ) {
$name = sanitize_title( $variation_attribute['name'] ?? '' );
@@ -1586,8 +3440,8 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
}
$variation->set_attributes( $variation_attributes );
$image_index = (int) ( $variation_input['imageIndex'] ?? -1 );
- if ( isset( $attachment_ids[ $image_index ] ) ) {
- $variation->set_image_id( $attachment_ids[ $image_index ] );
+ if ( isset( $image_attachment_ids[ $image_index ] ) ) {
+ $variation->set_image_id( $image_attachment_ids[ $image_index ] );
}
$variation->save();
}
@@ -1630,6 +3484,8 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
'downloadableFiles' => array( 'type' => array( 'list_of' => 'FunkycommerceDownloadableFileInput' ) ),
'downloadLimit' => array( 'type' => 'Int' ),
'downloadExpiryDays' => array( 'type' => 'Int' ),
+ 'externalUrl' => array( 'type' => 'String' ),
+ 'buttonText' => array( 'type' => 'String' ),
'imageDataUrls' => array( 'type' => array( 'list_of' => 'String' ) ),
'attributes' => array( 'type' => array( 'list_of' => 'FunkycommerceMarketplaceAttributeInput' ) ),
'variations' => array( 'type' => array( 'list_of' => 'FunkycommerceMarketplaceVariationInput' ) ),
@@ -1654,24 +3510,39 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
throw new \GraphQL\Error\UserError( sprintf( __( 'Marketplace prices must be submitted in the store base currency (%s).', 'funkycommerce-headless' ), $base_currency ) );
}
$is_variable = $product instanceof WC_Product_Variable;
- $price = wc_format_decimal( max( 0, (float) ( $input['price'] ?? 0 ) ), wc_get_price_decimals() );
+ $is_external = $product instanceof WC_Product_External;
+ $price = funkycommerce_validate_non_negative_marketplace_price( $input['price'] ?? null );
$price_value = (float) $price;
$variations = array_slice( (array) ( $input['variations'] ?? array() ), 0, 100 );
- if ( '' === trim( $input['name'] ?? '' ) || ( ! $is_variable && $price_value <= 0 ) || ( $is_variable && isset( $input['variations'] ) && ! $variations ) ) {
- throw new \GraphQL\Error\UserError( __( 'A product name and positive price are required.', 'funkycommerce-headless' ) );
+ $external_url = esc_url_raw( $input['externalUrl'] ?? ( $is_external ? $product->get_product_url() : '' ), array( 'http', 'https' ) );
+ if ( '' === trim( $input['name'] ?? '' ) || ( $is_variable && isset( $input['variations'] ) && ! $variations ) ) {
+ throw new \GraphQL\Error\UserError( __( 'A product name and non-negative price are required.', 'funkycommerce-headless' ) );
+ }
+ if ( $is_external && ! $external_url ) {
+ throw new \GraphQL\Error\UserError( __( 'External products require a valid HTTP or HTTPS product URL.', 'funkycommerce-headless' ) );
}
$product->set_name( sanitize_text_field( $input['name'] ) );
$product->set_description( wp_kses_post( $input['description'] ?? '' ) );
$product->set_short_description( sanitize_textarea_field( $input['subtitle'] ?? '' ) );
$product->set_sku( sanitize_text_field( $input['sku'] ?? '' ) );
if ( ! $is_variable ) {
- $regular_price = wc_format_decimal( max( $price_value, (float) ( $input['regularPrice'] ?? $price_value ) ), wc_get_price_decimals() );
+ $regular_price = null === ( $input['regularPrice'] ?? null )
+ ? $price
+ : funkycommerce_validate_non_negative_marketplace_price( $input['regularPrice'], __( 'Compare-at price', 'funkycommerce-headless' ) );
+ if ( (float) $regular_price < $price_value ) {
+ throw new \GraphQL\Error\UserError( __( 'Compare-at price cannot be lower than the price.', 'funkycommerce-headless' ) );
+ }
$product->set_regular_price( $regular_price );
$product->set_sale_price( $price_value < (float) $regular_price ? $price : '' );
$product->set_price( $price );
- $product->set_manage_stock( true );
- $product->set_stock_quantity( max( 0, (int) ( $input['stockQuantity'] ?? 0 ) ) );
- $product->set_stock_status( (int) ( $input['stockQuantity'] ?? 0 ) > 0 ? 'instock' : 'outofstock' );
+ if ( $is_external ) {
+ $product->set_product_url( $external_url );
+ $product->set_button_text( sanitize_text_field( $input['buttonText'] ?? $product->get_button_text() ) );
+ } else {
+ $product->set_manage_stock( true );
+ $product->set_stock_quantity( max( 0, (int) ( $input['stockQuantity'] ?? 0 ) ) );
+ $product->set_stock_status( (int) ( $input['stockQuantity'] ?? 0 ) > 0 ? 'instock' : 'outofstock' );
+ }
} elseif ( isset( $input['attributes'] ) ) {
$product_attributes = array();
foreach ( array_slice( (array) ( $input['attributes'] ?? array() ), 0, 3 ) as $attribute_input ) {
@@ -1702,12 +3573,11 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
}
}
if ( ! empty( $input['brand'] ) ) {
- if ( ! taxonomy_exists( 'product_brand' ) ) {
- throw new \GraphQL\Error\UserError( __( 'WooCommerce product brands are unavailable.', 'funkycommerce-headless' ) );
- }
- $brand_result = funkycommerce_set_multilingual_terms( $product_id, array( $input['brand'] ), 'product_brand', $language );
- if ( is_wp_error( $brand_result ) ) {
- throw new \GraphQL\Error\UserError( $brand_result->get_error_message() );
+ if ( taxonomy_exists( 'product_brand' ) ) {
+ $brand_result = funkycommerce_set_multilingual_terms( $product_id, array( $input['brand'] ), 'product_brand', $language );
+ if ( is_wp_error( $brand_result ) ) {
+ throw new \GraphQL\Error\UserError( $brand_result->get_error_message() );
+ }
}
}
if ( array_key_exists( 'upsellIds', $input ) ) {
@@ -1727,28 +3597,39 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
$product->set_image_id( $attachment_ids[0] );
$product->set_gallery_image_ids( array_slice( $attachment_ids, 1 ) );
}
- $attachment_ids = array_merge( $attachment_ids, funkycommerce_apply_marketplace_downloadable_settings( $product, $input ) );
+ $image_attachment_ids = $attachment_ids;
+ if ( ! $is_external && ! $is_variable ) {
+ $attachment_ids = array_merge( $attachment_ids, funkycommerce_apply_marketplace_downloadable_settings( $product, $input ) );
+ } elseif ( $is_variable && array_key_exists( 'isVirtual', $input ) ) {
+ $product->set_virtual( ! empty( $input['isVirtual'] ) );
+ }
$product->save();
if ( $is_variable && isset( $input['variations'] ) ) {
- foreach ( $product->get_children() as $child_id ) {
- wp_delete_post( $child_id, true );
- }
+ $existing_child_ids = array_map( 'absint', $product->get_children() );
+ $saved_child_ids = array();
foreach ( $variations as $variation_input ) {
- $variation_price = wc_format_decimal( max( 0, (float) ( $variation_input['price'] ?? 0 ) ), wc_get_price_decimals() );
+ $variation_price = funkycommerce_validate_non_negative_marketplace_price( $variation_input['price'] ?? null );
$variation_price_value = (float) $variation_price;
- if ( $variation_price_value <= 0 ) {
- throw new \GraphQL\Error\UserError( __( 'Every variation requires a positive price.', 'funkycommerce-headless' ) );
+ $variation_id = absint( $variation_input['variationId'] ?? 0 );
+ $variation = $variation_id && in_array( $variation_id, $existing_child_ids, true ) ? wc_get_product( $variation_id ) : null;
+ if ( ! $variation instanceof WC_Product_Variation ) {
+ $variation = new WC_Product_Variation();
+ $variation->set_parent_id( $product_id );
}
- $variation = new WC_Product_Variation();
- $variation->set_parent_id( $product_id );
$variation->set_sku( sanitize_text_field( $variation_input['sku'] ?? '' ) );
- $variation_regular_price = wc_format_decimal( max( $variation_price_value, (float) ( $variation_input['regularPrice'] ?? $variation_price_value ) ), wc_get_price_decimals() );
+ $variation_regular_price = null === ( $variation_input['regularPrice'] ?? null )
+ ? $variation_price
+ : funkycommerce_validate_non_negative_marketplace_price( $variation_input['regularPrice'], __( 'Variation compare-at price', 'funkycommerce-headless' ) );
+ if ( (float) $variation_regular_price < $variation_price_value ) {
+ throw new \GraphQL\Error\UserError( __( 'Variation compare-at price cannot be lower than the price.', 'funkycommerce-headless' ) );
+ }
$variation->set_regular_price( $variation_regular_price );
$variation->set_sale_price( $variation_price_value < (float) $variation_regular_price ? $variation_price : '' );
$variation->set_price( $variation_price );
$variation->set_manage_stock( true );
$variation->set_stock_quantity( max( 0, (int) ( $variation_input['stockQuantity'] ?? 0 ) ) );
$variation->set_stock_status( (int) ( $variation_input['stockQuantity'] ?? 0 ) > 0 ? 'instock' : 'outofstock' );
+ $attachment_ids = array_merge( $attachment_ids, funkycommerce_apply_marketplace_downloadable_settings( $variation, $variation_input ) );
$variation_attributes = array();
foreach ( (array) ( $variation_input['attributes'] ?? array() ) as $variation_attribute ) {
$name = sanitize_title( $variation_attribute['name'] ?? '' );
@@ -1759,10 +3640,13 @@ function ( $product_id ) use ( $requested_seller_id, $visible_user_ids ) {
}
$variation->set_attributes( $variation_attributes );
$image_index = (int) ( $variation_input['imageIndex'] ?? -1 );
- if ( isset( $attachment_ids[ $image_index ] ) ) {
- $variation->set_image_id( $attachment_ids[ $image_index ] );
+ if ( isset( $image_attachment_ids[ $image_index ] ) ) {
+ $variation->set_image_id( $image_attachment_ids[ $image_index ] );
}
- $variation->save();
+ $saved_child_ids[] = $variation->save();
+ }
+ foreach ( array_diff( $existing_child_ids, $saved_child_ids ) as $removed_child_id ) {
+ wp_delete_post( $removed_child_id, true );
}
WC_Product_Variable::sync( $product_id );
}
diff --git a/inc/control-center-schema.php b/inc/control-center-schema.php
index c8719f1..edd9ce5 100644
--- a/inc/control-center-schema.php
+++ b/inc/control-center-schema.php
@@ -9,6 +9,339 @@
exit;
}
+/**
+ * Return the social platforms backed by bundled storefront icons.
+ */
+function funkycommerce_supported_social_icons() {
+ return apply_filters(
+ 'funkycommerce_supported_social_icons',
+ array(
+ 'behance' => __( 'Behance', 'funkycommerce-headless' ),
+ 'discord' => __( 'Discord', 'funkycommerce-headless' ),
+ 'facebook' => __( 'Facebook', 'funkycommerce-headless' ),
+ 'github' => __( 'GitHub', 'funkycommerce-headless' ),
+ 'google' => __( 'Google', 'funkycommerce-headless' ),
+ 'instagram' => __( 'Instagram', 'funkycommerce-headless' ),
+ 'linkedin' => __( 'LinkedIn', 'funkycommerce-headless' ),
+ 'patreon' => __( 'Patreon', 'funkycommerce-headless' ),
+ 'slack' => __( 'Slack', 'funkycommerce-headless' ),
+ 'tiktok' => __( 'TikTok', 'funkycommerce-headless' ),
+ 'twitch' => __( 'Twitch', 'funkycommerce-headless' ),
+ 'twitter' => __( 'Twitter', 'funkycommerce-headless' ),
+ 'x' => __( 'X (Twitter)', 'funkycommerce-headless' ),
+ 'youtube' => __( 'YouTube', 'funkycommerce-headless' ),
+ )
+ );
+}
+
+/**
+ * Return every plugin slug historically used by the AI Assistant companion.
+ */
+function funkycommerce_ai_assistant_plugin_slugs() {
+ return apply_filters(
+ 'funkycommerce_ai_assistant_plugin_slugs',
+ array(
+ 'funkycommerce-ai-shopping-assistant',
+ 'funkycommerce-ai-assistant-frame',
+ 'funkycommerce-ai-assistant',
+ 'ao-vector-search-plugin',
+ 'ao-vector-search',
+ )
+ );
+}
+
+/**
+ * Return the WordPress admin page slug owned by the AI Assistant companion.
+ */
+function funkycommerce_ai_assistant_admin_page_slug() {
+ return (string) apply_filters( 'funkycommerce_ai_assistant_admin_page_slug', 'ai-assistant' );
+}
+
+/**
+ * Return the bundled header-action icon presets and their matching setting keys.
+ *
+ * @return array>
+ */
+function funkycommerce_header_icon_definitions() {
+ return apply_filters(
+ 'funkycommerce_header_icon_definitions',
+ array(
+ 'search' => array(
+ 'graphKey' => 'search',
+ 'settingKey' => 'search',
+ 'name' => __( 'Search', 'funkycommerce-headless' ),
+ 'label' => __( 'Search icon', 'funkycommerce-headless' ),
+ 'default' => 'search',
+ 'options' => array(
+ 'search' => __( 'Search', 'funkycommerce-headless' ),
+ 'scan-search' => __( 'Scan search', 'funkycommerce-headless' ),
+ 'command' => __( 'Command', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'theme' => array(
+ 'graphKey' => 'theme',
+ 'settingKey' => 'theme',
+ 'name' => __( 'Theme mode', 'funkycommerce-headless' ),
+ 'label' => __( 'Theme-mode icon', 'funkycommerce-headless' ),
+ 'default' => 'moon',
+ 'options' => array(
+ 'moon' => __( 'Moon', 'funkycommerce-headless' ),
+ 'contrast' => __( 'Contrast', 'funkycommerce-headless' ),
+ 'sun-moon' => __( 'Sun and moon', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'account' => array(
+ 'graphKey' => 'account',
+ 'settingKey' => 'account',
+ 'name' => __( 'Account', 'funkycommerce-headless' ),
+ 'label' => __( 'Account icon', 'funkycommerce-headless' ),
+ 'default' => 'user',
+ 'options' => array(
+ 'user' => __( 'User', 'funkycommerce-headless' ),
+ 'circle-user' => __( 'User circle', 'funkycommerce-headless' ),
+ 'user-check' => __( 'Verified user', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'push' => array(
+ 'graphKey' => 'push',
+ 'settingKey' => 'push',
+ 'name' => __( 'Push notifications', 'funkycommerce-headless' ),
+ 'label' => __( 'Push-notification icon', 'funkycommerce-headless' ),
+ 'default' => 'bell',
+ 'options' => array(
+ 'bell' => __( 'Bell', 'funkycommerce-headless' ),
+ 'bell-ring' => __( 'Ringing bell', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'reading_list' => array(
+ 'graphKey' => 'readingList',
+ 'settingKey' => 'reading_list',
+ 'name' => __( 'Reading list', 'funkycommerce-headless' ),
+ 'label' => __( 'Reading-list icon', 'funkycommerce-headless' ),
+ 'default' => 'book-marked',
+ 'options' => array(
+ 'book-marked' => __( 'Marked book', 'funkycommerce-headless' ),
+ 'bookmark' => __( 'Bookmark', 'funkycommerce-headless' ),
+ 'library' => __( 'Library', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'wishlist' => array(
+ 'graphKey' => 'wishlist',
+ 'settingKey' => 'wishlist',
+ 'name' => __( 'Wishlist', 'funkycommerce-headless' ),
+ 'label' => __( 'Wishlist icon', 'funkycommerce-headless' ),
+ 'default' => 'heart',
+ 'options' => array(
+ 'heart' => __( 'Heart', 'funkycommerce-headless' ),
+ 'star' => __( 'Star', 'funkycommerce-headless' ),
+ 'gift' => __( 'Gift', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'cart' => array(
+ 'graphKey' => 'cart',
+ 'settingKey' => 'cart',
+ 'name' => __( 'Cart', 'funkycommerce-headless' ),
+ 'label' => __( 'Cart icon', 'funkycommerce-headless' ),
+ 'default' => 'shopping-cart',
+ 'options' => array(
+ 'shopping-cart' => __( 'Cart', 'funkycommerce-headless' ),
+ 'shopping-bag' => __( 'Bag', 'funkycommerce-headless' ),
+ 'shopping-basket' => __( 'Basket', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'menu' => array(
+ 'graphKey' => 'menu',
+ 'settingKey' => 'menu',
+ 'name' => __( 'Mobile menu', 'funkycommerce-headless' ),
+ 'label' => __( 'Mobile-menu icon', 'funkycommerce-headless' ),
+ 'default' => 'menu',
+ 'options' => array(
+ 'menu' => __( 'Menu', 'funkycommerce-headless' ),
+ 'align-justify' => __( 'Aligned lines', 'funkycommerce-headless' ),
+ 'panels-top-left' => __( 'Panels', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'assistant' => array(
+ 'graphKey' => 'assistant',
+ 'settingKey' => 'assistant',
+ 'name' => __( 'AI Assistant', 'funkycommerce-headless' ),
+ 'label' => __( 'AI Assistant icon', 'funkycommerce-headless' ),
+ 'default' => 'message-circle',
+ 'options' => array(
+ 'message-circle' => __( 'Message circle', 'funkycommerce-headless' ),
+ 'sparkles' => __( 'Sparkles', 'funkycommerce-headless' ),
+ 'command' => __( 'Command', 'funkycommerce-headless' ),
+ ),
+ ),
+ )
+ );
+}
+
+/**
+ * Return the reusable Control Center schema for header-action icon presets and custom media.
+ *
+ * @return array>
+ */
+function funkycommerce_header_icon_control_fields() {
+ $fields = array();
+ $settings = (array) get_option( 'funkycommerce_control_center', array() );
+ $push_enabled = funkycommerce_is_pro() && 'yes' === ( $settings['push_enabled'] ?? 'no' );
+
+ foreach ( funkycommerce_header_icon_definitions() as $definition ) {
+ $setting_key = $definition['settingKey'];
+ if ( 'push' === $setting_key && ! $push_enabled ) {
+ continue;
+ }
+ $fields[ 'header_icon_' . $setting_key ] = array(
+ 'label' => $definition['label'],
+ 'type' => 'select',
+ 'tier' => 'free',
+ 'default' => $definition['default'],
+ 'options' => $definition['options'],
+ );
+ $fields[ 'header_icon_' . $setting_key . '_media_url' ] = array(
+ /* translators: %s: header action name. */
+ 'label' => sprintf( __( '%s custom icon image', 'funkycommerce-headless' ), wp_strip_all_tags( $definition['name'] ) ),
+ 'type' => 'media',
+ 'tier' => 'free',
+ 'description' => __( 'Optional Media Library image URL. Leave blank to keep the bundled icon preset active.', 'funkycommerce-headless' ),
+ );
+ }
+
+ return $fields;
+}
+
+/**
+ * Canonical site-wide layout controls.
+ *
+ * The graphKey metadata is shared by the GraphQL type and resolver. Keeping defaults,
+ * allowlists and bounds here prevents the admin preview and public API drifting apart.
+ *
+ * @return array>
+ */
+function funkycommerce_layout_control_fields() {
+ $select = static function ( $label, $default, $values, $preview = '' ) {
+ return array(
+ 'label' => $label,
+ 'type' => 'select',
+ 'tier' => 'free',
+ 'default' => $default,
+ 'options' => array_combine( $values, array_map( static fn( $value ) => ucwords( str_replace( array( '-', '_' ), ' ', $value ) ), $values ) ),
+ 'preview' => $preview,
+ 'graphKey' => lcfirst( str_replace( ' ', '', ucwords( str_replace( '_', ' ', $preview ) ) ) ),
+ );
+ };
+ $toggle = static function ( $label, $default = 'yes', $preview = '' ) {
+ return array(
+ 'label' => $label,
+ 'type' => 'toggle',
+ 'tier' => 'free',
+ 'default' => $default,
+ 'preview' => $preview,
+ 'graphKey' => lcfirst( str_replace( ' ', '', ucwords( str_replace( '_', ' ', $preview ) ) ) ),
+ );
+ };
+
+ $fields = array(
+ 'layout_schema_version' => array( 'label' => __( 'Layout schema version', 'funkycommerce-headless' ), 'type' => 'readonly', 'tier' => 'free', 'default' => '1', 'graphKey' => 'schemaVersion' ),
+ 'layout_theme_max_width_px' => array( 'label' => __( 'Content maximum width (px)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '1280', 'min' => '960', 'max' => '1920', 'step' => '8', 'preview' => 'theme_max_width_px', 'graphKey' => 'themeMaxWidthPx' ),
+ 'layout_theme_radius_px' => array( 'label' => __( 'Base corner radius (px)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '16', 'min' => '0', 'max' => '32', 'step' => '1', 'preview' => 'theme_radius_px', 'graphKey' => 'themeRadiusPx' ),
+ 'layout_show_breadcrumbs' => $toggle( __( 'Show breadcrumbs', 'funkycommerce-headless' ), 'yes', 'show_breadcrumbs' ),
+ 'layout_brand_palette' => $select( __( 'Brand palette', 'funkycommerce-headless' ), 'violet', array( 'violet', 'sunset', 'ocean', 'forest', 'rose', 'indigo', 'coral', 'teal', 'amber', 'berry', 'slate', 'mint', 'plum', 'citrus', 'sky', 'ember', 'lagoon', 'blush', 'olive', 'midnight' ), 'brand_palette' ),
+ 'layout_brand_gradient_style' => $select( __( 'Brand colour treatment', 'funkycommerce-headless' ), 'gradient', array( 'gradient', 'flat' ), 'brand_gradient_style' ),
+ 'layout_show_newsletter_popup' => $toggle( __( 'Show newsletter popup', 'funkycommerce-headless' ), 'yes', 'show_newsletter_popup' ),
+ 'layout_newsletter_popup_variant' => $select( __( 'Newsletter popup layout', 'funkycommerce-headless' ), 'split', array( 'split', 'modern-card', 'modern-center' ), 'newsletter_popup_variant' ),
+ 'layout_newsletter_popup_cooldown_days' => array( 'label' => __( 'Newsletter dismissal cooldown (days)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '7', 'min' => '1', 'max' => '365', 'step' => '1', 'preview' => 'newsletter_popup_cooldown_days', 'graphKey' => 'newsletterPopupCooldownDays' ),
+
+ 'layout_product_page' => $select( __( 'Product page template', 'funkycommerce-headless' ), 'classic', array( 'classic', 'studio' ), 'product_page_layout' ),
+ 'layout_related_products_columns' => $select( __( 'Related products columns', 'funkycommerce-headless' ), '4', array( '2', '3', '4' ), 'related_products_columns' ),
+ 'layout_show_studio_related_products_under_meta' => $toggle( __( 'Show related products under categories and brands in Studio', 'funkycommerce-headless' ), 'no', 'show_studio_related_products_under_meta' ),
+ 'layout_checkout_store_mode' => $select( __( 'Checkout store mode', 'funkycommerce-headless' ), 'physical', array( 'physical', 'digital' ), 'checkout_store_mode' ),
+ 'layout_checkout_coupon_position' => $select( __( 'Checkout coupon position', 'funkycommerce-headless' ), 'inline', array( 'inline', 'top' ), 'checkout_coupon_position' ),
+ 'layout_checkout_payment_position' => $select( __( 'Checkout payment position', 'funkycommerce-headless' ), 'left', array( 'left', 'right' ), 'checkout_payment_position' ),
+ 'layout_checkout_summary_position' => $select( __( 'Checkout summary position', 'funkycommerce-headless' ), 'sticky', array( 'sticky', 'static' ), 'checkout_summary_position' ),
+ 'layout_checkout_hide_optional_billing' => $toggle( __( 'Hide optional billing fields', 'funkycommerce-headless' ), 'no', 'checkout_hide_optional_billing_fields' ),
+ 'layout_checkout_hide_optional_shipping' => $toggle( __( 'Hide optional shipping fields', 'funkycommerce-headless' ), 'no', 'checkout_hide_optional_shipping_fields' ),
+ 'layout_checkout_show_order_notes' => $toggle( __( 'Show checkout order notes', 'funkycommerce-headless' ), 'yes', 'checkout_show_order_notes' ),
+ 'layout_checkout_show_terms' => $toggle( __( 'Show checkout terms', 'funkycommerce-headless' ), 'yes', 'checkout_show_terms' ),
+ 'layout_checkout_show_privacy' => $toggle( __( 'Show checkout privacy notice', 'funkycommerce-headless' ), 'yes', 'checkout_show_privacy' ),
+
+ 'layout_show_announcement_bar' => $toggle( __( 'Show announcement bar', 'funkycommerce-headless' ), 'yes', 'show_announcement_bar' ),
+ 'layout_announcement_scroll_effect' => $toggle( __( 'Collapse announcement on scroll', 'funkycommerce-headless' ), 'yes', 'announcement_bar_scroll_effect' ),
+ 'layout_header_sticky' => $toggle( __( 'Sticky header', 'funkycommerce-headless' ), 'yes', 'header_sticky' ),
+ 'layout_header_search_variant' => $select( __( 'Header search layout', 'funkycommerce-headless' ), 'full-width', array( 'full-width', 'expandable' ), 'header_search_variant' ),
+ 'layout_header_logo_variant' => $select( __( 'Header logo layout', 'funkycommerce-headless' ), 'text-image', array( 'text', 'image', 'text-image' ), 'header_logo_variant' ),
+ 'layout_cart_trigger_variant' => $select( __( 'Header cart behavior', 'funkycommerce-headless' ), 'drawer', array( 'drawer', 'dropdown' ), 'cart_trigger_variant' ),
+ 'layout_show_cart_promoted_product' => $toggle( __( 'Show promoted product in empty cart', 'funkycommerce-headless' ), 'yes', 'show_cart_drawer_promoted_product' ),
+ 'layout_show_all_cart_promoted_products' => $toggle( __( 'Show all featured products in empty cart', 'funkycommerce-headless' ), 'no', 'show_all_cart_promoted_products' ),
+
+ 'layout_show_footer' => $toggle( __( 'Show footer', 'funkycommerce-headless' ), 'yes', 'show_footer' ),
+ 'layout_footer_columns' => $select( __( 'Footer columns', 'funkycommerce-headless' ), 'grid-4', array( 'grid-4', 'grid-2-wide', 'accordion-single' ), 'footer_columns_layout' ),
+ 'layout_footer_newsletter' => $select( __( 'Footer newsletter layout', 'funkycommerce-headless' ), 'banner', array( 'banner', 'centered', 'image-bg' ), 'footer_newsletter_layout' ),
+ 'layout_show_footer_newsletter' => $toggle( __( 'Show footer newsletter', 'funkycommerce-headless' ), 'yes', 'show_footer_newsletter' ),
+ 'layout_footer_assistant' => $select( __( 'Footer assistant / player layout', 'funkycommerce-headless' ), 'side-by-side', array( 'side-by-side', 'tabbed', 'stacked' ), 'footer_assistant_layout' ),
+ 'layout_footer_logo_variant' => $select( __( 'Footer logo layout', 'funkycommerce-headless' ), 'text-image', array( 'text', 'image', 'text-image' ), 'footer_logo_variant' ),
+ 'layout_footer_bottom_bar' => $select( __( 'Footer bottom bar layout', 'funkycommerce-headless' ), 'split', array( 'split', 'centered' ), 'footer_bottom_bar_layout' ),
+ 'layout_footer_extra_wrapper' => $select( __( 'Footer extra wrapper layout', 'funkycommerce-headless' ), 'inline', array( 'inline', 'full-bleed' ), 'footer_extra_wrapper_layout' ),
+ );
+
+ foreach ( array(
+ 'show_header_logo' => __( 'Show header logo', 'funkycommerce-headless' ),
+ 'show_header_search_icon' => __( 'Show header search', 'funkycommerce-headless' ),
+ 'show_header_language_switcher' => __( 'Show language switcher', 'funkycommerce-headless' ),
+ 'show_header_currency_switcher' => __( 'Show currency switcher', 'funkycommerce-headless' ),
+ 'show_header_dark_mode_toggle' => __( 'Show dark-mode toggle', 'funkycommerce-headless' ),
+ 'show_header_account_link' => __( 'Show account link', 'funkycommerce-headless' ),
+ 'show_header_reading_list_link' => __( 'Show reading-list link', 'funkycommerce-headless' ),
+ 'show_header_wishlist_link' => __( 'Show wishlist link', 'funkycommerce-headless' ),
+ 'show_header_cart_icon' => __( 'Show cart icon', 'funkycommerce-headless' ),
+ 'show_header_publish_button' => __( 'Show community publish button', 'funkycommerce-headless' ),
+ 'show_footer_logo' => __( 'Show footer logo', 'funkycommerce-headless' ),
+ 'show_footer_extra_wrapper' => __( 'Show footer extra wrapper', 'funkycommerce-headless' ),
+ 'show_footer_spotify_player' => __( 'Show footer player', 'funkycommerce-headless' ),
+ 'show_footer_assistant_frame' => __( 'Show footer assistant', 'funkycommerce-headless' ),
+ 'show_footer_payment_methods' => __( 'Show footer payment methods', 'funkycommerce-headless' ),
+ 'show_footer_social_links' => __( 'Show footer social links', 'funkycommerce-headless' ),
+ 'show_footer_copyright' => __( 'Show footer copyright', 'funkycommerce-headless' ),
+ ) as $key => $label ) {
+ $fields[ 'layout_' . $key ] = $toggle( $label, 'yes', $key );
+ }
+
+ foreach ( array( 'visa', 'mastercard', 'paypal', 'apay', 'gpay', 'stripe', 'blik', 'btc', 'eth' ) as $provider ) {
+ $key = 'show_footer_payment_' . $provider;
+ $fields[ 'layout_' . $key ] = $toggle( sprintf( __( 'Show %s payment mark', 'funkycommerce-headless' ), strtoupper( $provider ) ), 'yes', $key );
+ }
+ foreach ( funkycommerce_supported_social_icons() as $provider => $label ) {
+ $key = 'show_footer_social_' . $provider;
+ $fields[ 'layout_' . $key ] = $toggle( sprintf( __( 'Show %s social link', 'funkycommerce-headless' ), $label ), 'yes', $key );
+ }
+
+ $fields += array(
+ 'layout_home_hero' => $select( __( 'Home hero layout', 'funkycommerce-headless' ), 'classic', array( 'classic', 'cinematic', 'cinematic-slider' ), 'home_hero_layout' ),
+ 'layout_shop_product_card' => $select( __( 'Shop product card style', 'funkycommerce-headless' ), 'default', array( 'default', 'minimal', 'editorial', 'gallery', 'simple', 'variation', 'expandable' ), 'shop_product_card_variant' ),
+ 'layout_auth' => $select( __( 'Authentication layout', 'funkycommerce-headless' ), 'split', array( 'split', 'centered', 'image-bg' ), 'auth_layout' ),
+ 'layout_reading_list' => $select( __( 'Reading-list layout', 'funkycommerce-headless' ), 'cards', array( 'cards', 'editorial-2col' ), 'reading_list_layout' ),
+ 'layout_wishlist_card' => $select( __( 'Wishlist card style', 'funkycommerce-headless' ), 'default', array( 'default', 'minimal', 'editorial', 'gallery', 'simple', 'variation', 'expandable' ), 'wishlist_card_variant' ),
+ 'layout_community_feed' => $select( __( 'Community feed layout', 'funkycommerce-headless' ), 'grid-3', array( 'masonry', 'grid-3', 'grid-4', 'list', 'compact' ), 'community_feed_layout' ),
+ 'layout_community_feed_load_mode' => $select( __( 'Community feed loading', 'funkycommerce-headless' ), 'manual', array( 'manual', 'infinite' ), 'community_feed_load_mode' ),
+ 'layout_community_feed_page_size' => $select( __( 'Community feed page size', 'funkycommerce-headless' ), '6', array( '6', '12', '24' ), 'community_feed_page_size' ),
+ 'layout_community_feed_filters' => $select( __( 'Community feed tag filters', 'funkycommerce-headless' ), 'show', array( 'show', 'hide' ), 'community_feed_filters' ),
+ 'layout_community_profile_header' => $select( __( 'Community profile header', 'funkycommerce-headless' ), 'card', array( 'card', 'cover-banner', 'compact-list', 'immersive', 'split', 'strip' ), 'community_profile_header_layout' ),
+ 'layout_author_profile_header' => $select( __( 'Journal author profile header', 'funkycommerce-headless' ), 'card', array( 'card', 'cover-banner', 'compact-list', 'immersive', 'split', 'strip' ), 'author_profile_header_layout' ),
+ 'layout_cart' => $select( __( 'Cart layout', 'funkycommerce-headless' ), 'classic', array( 'classic', 'editorial' ), 'cart_layout' ),
+ 'layout_cart_summary' => $select( __( 'Cart summary position', 'funkycommerce-headless' ), 'sticky', array( 'sticky', 'static' ), 'cart_summary_position' ),
+ 'layout_product_archive_hero' => $select( __( 'Product archive hero', 'funkycommerce-headless' ), 'split', array( 'split', 'fullbleed', 'minimal' ), 'product_archive_hero_layout' ),
+ 'layout_post_archive_hero' => $select( __( 'Journal archive hero', 'funkycommerce-headless' ), 'split', array( 'split', 'fullbleed', 'minimal' ), 'post_archive_hero_layout' ),
+ 'layout_archive_description_hero' => $toggle( __( 'Show taxonomy description excerpt in archive hero', 'funkycommerce-headless' ), 'no', 'show_archive_description_in_hero' ),
+ 'layout_post_toc' => $select( __( 'Journal post table of contents', 'funkycommerce-headless' ), 'current', array( 'current', 'rail-left', 'rail-right', 'above' ), 'post_toc_layout' ),
+ 'layout_post_share' => $select( __( 'Journal post share buttons', 'funkycommerce-headless' ), 'above-toc', array( 'above-toc', 'on-image', 'below-toc-right' ), 'post_share_position' ),
+ 'layout_post_author' => $select( __( 'Journal post author card', 'funkycommerce-headless' ), 'fullwidth', array( 'fullwidth', 'compact', 'editorial' ), 'post_author_layout' ),
+ 'layout_discussion' => $select( __( 'Comments and reviews layout', 'funkycommerce-headless' ), 'stacked', array( 'stacked', 'split-left', 'split-right' ), 'discussion_layout' ),
+ );
+
+ return $fields;
+}
+
/**
* Return every setting owned by the theme, grouped for the admin interface.
*
@@ -17,6 +350,31 @@
*/
function funkycommerce_control_center_sections() {
$sections = array(
+ 'rendering' => array(
+ 'title' => __( 'Rendering mode', 'funkycommerce-headless' ),
+ 'description' => __( 'Choose whether WordPress serves the public theme or powers a separate headless storefront.', 'funkycommerce-headless' ),
+ 'fields' => array(
+ 'headless_mode' => array( 'label' => __( 'Headless mode', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes', 'description' => __( 'Enables frontend routing, builds, mount markers, and headless dependency guidance.', 'funkycommerce-headless' ) ),
+ 'admin_block_theme_styles' => array( 'label' => __( 'Apply block-theme styles to the WordPress dashboard', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no' ),
+ ),
+ ),
+ 'layout' => array(
+ 'title' => __( 'Layout', 'funkycommerce-headless' ),
+ 'description' => __( 'Canonical site-wide storefront composition. These global settings override frontend preferences for every visitor; administrators can temporarily preview alternatives in Layout Studio.', 'funkycommerce-headless' ),
+ 'preview' => true,
+ 'fields' => array_merge(
+ array(
+ 'layout_import_config' => array(
+ 'label' => __( 'Load Layout Studio configuration', 'funkycommerce-headless' ),
+ 'type' => 'json',
+ 'tier' => 'free',
+ 'default' => '',
+ 'description' => __( 'Paste a JSON configuration exported from Layout Studio, then save. Imported values are validated and applied to the controls below; this field is cleared after loading.', 'funkycommerce-headless' ),
+ ),
+ ),
+ funkycommerce_layout_control_fields()
+ ),
+ ),
'branding' => array(
'title' => __( 'Branding', 'funkycommerce-headless' ),
'description' => __( 'Store identity, typography, and favicon assets. Layout Studio keeps visual palette and radius previews on the frontend.', 'funkycommerce-headless' ),
@@ -36,22 +394,41 @@ function funkycommerce_control_center_sections() {
'dark_mode_default' => array( 'label' => __( 'Default colour mode', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'system', 'options' => array( 'system' => __( 'Follow device', 'funkycommerce-headless' ), 'light' => __( 'Light', 'funkycommerce-headless' ), 'dark' => __( 'Dark', 'funkycommerce-headless' ) ) ),
'favicon_svg_url' => array( 'label' => __( 'SVG favicon', 'funkycommerce-headless' ), 'type' => 'media', 'tier' => 'free' ),
'favicon_ico_url' => array( 'label' => __( 'ICO favicon', 'funkycommerce-headless' ), 'type' => 'media', 'tier' => 'free' ),
- 'apple_touch_url' => array( 'label' => __( 'Apple touch icon', 'funkycommerce-headless' ), 'type' => 'media', 'tier' => 'free' ),
+ 'apple_touch_url' => array( 'label' => __( 'Apple touch icon', 'funkycommerce-headless' ), 'type' => 'media', 'tier' => 'free', 'autocomplete' => 'off' ),
),
),
'header' => array(
'title' => __( 'Header', 'funkycommerce-headless' ),
- 'description' => __( 'Header content and icon assets. Visibility and layout previews remain in the frontend Layout Studio.', 'funkycommerce-headless' ),
+ 'description' => __( 'Header content, bundled action presets, and optional Media Library overrides. Visibility and layout previews remain in the frontend Layout Studio.', 'funkycommerce-headless' ),
+ 'fields' => array_merge(
+ array(
+ 'promo_text' => array( 'label' => __( 'Promotional message', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'free', 'sanitize' => 'html', 'description' => __( 'Safe formatting and links are allowed. Leave empty to hide the promotional bar.', 'funkycommerce-headless' ) ),
+ 'promo_color' => array( 'label' => __( 'Promotional bar colour', 'funkycommerce-headless' ), 'type' => 'color', 'tier' => 'free', 'default' => '#18181b' ),
+ ),
+ funkycommerce_header_icon_control_fields()
+ ),
+ ),
+ 'ai-assistant' => array(
+ 'title' => __( 'AI Assistant', 'funkycommerce-headless' ),
+ 'description' => __( 'Enable the storefront AI Assistant on any combination of surfaces and configure a secure iframe fallback.', 'funkycommerce-headless' ),
'fields' => array(
- 'promo_text' => array( 'label' => __( 'Promotional message', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free' ),
- 'promo_color' => array( 'label' => __( 'Promotional bar colour', 'funkycommerce-headless' ), 'type' => 'color', 'tier' => 'free', 'default' => '#18181b' ),
- 'header_icon_search' => array( 'label' => __( 'Search icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'search', 'options' => array( 'search' => __( 'Search', 'funkycommerce-headless' ), 'scan-search' => __( 'Scan search', 'funkycommerce-headless' ), 'command' => __( 'Command', 'funkycommerce-headless' ) ) ),
- 'header_icon_theme' => array( 'label' => __( 'Theme-mode icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'moon', 'options' => array( 'moon' => __( 'Moon', 'funkycommerce-headless' ), 'contrast' => __( 'Contrast', 'funkycommerce-headless' ), 'sun-moon' => __( 'Sun and moon', 'funkycommerce-headless' ) ) ),
- 'header_icon_account' => array( 'label' => __( 'Account icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'user', 'options' => array( 'user' => __( 'User', 'funkycommerce-headless' ), 'circle-user' => __( 'User circle', 'funkycommerce-headless' ), 'user-check' => __( 'Verified user', 'funkycommerce-headless' ) ) ),
- 'header_icon_reading_list' => array( 'label' => __( 'Reading-list icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'book-marked', 'options' => array( 'book-marked' => __( 'Marked book', 'funkycommerce-headless' ), 'bookmark' => __( 'Bookmark', 'funkycommerce-headless' ), 'library' => __( 'Library', 'funkycommerce-headless' ) ) ),
- 'header_icon_wishlist' => array( 'label' => __( 'Wishlist icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'heart', 'options' => array( 'heart' => __( 'Heart', 'funkycommerce-headless' ), 'star' => __( 'Star', 'funkycommerce-headless' ), 'gift' => __( 'Gift', 'funkycommerce-headless' ) ) ),
- 'header_icon_cart' => array( 'label' => __( 'Cart icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'shopping-cart', 'options' => array( 'shopping-cart' => __( 'Cart', 'funkycommerce-headless' ), 'shopping-bag' => __( 'Bag', 'funkycommerce-headless' ), 'shopping-basket' => __( 'Basket', 'funkycommerce-headless' ) ) ),
- 'header_icon_menu' => array( 'label' => __( 'Mobile-menu icon', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'menu', 'options' => array( 'menu' => __( 'Menu', 'funkycommerce-headless' ), 'align-justify' => __( 'Aligned lines', 'funkycommerce-headless' ), 'panels-top-left' => __( 'Panels', 'funkycommerce-headless' ) ) ),
+ 'ai_assistant_enabled' => array( 'label' => __( 'Assistant enabled', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no' ),
+ 'ai_assistant_show_header' => array( 'label' => __( 'Show in header', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no' ),
+ 'ai_assistant_show_footer' => array( 'label' => __( 'Show in footer', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
+ 'ai_assistant_show_fixed' => array( 'label' => __( 'Show fixed launcher', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no' ),
+ 'ai_assistant_iframe_url' => array(
+ 'label' => __( 'Secure iframe URL', 'funkycommerce-headless' ),
+ 'type' => 'url',
+ 'tier' => 'free',
+ 'description' => __( 'Optional HTTPS iframe source used only when the licensed native assistant is unavailable. The storefront always applies a fixed sandbox and referrer policy.', 'funkycommerce-headless' ),
+ ),
+ 'ai_assistant_iframe_title' => array(
+ 'label' => __( 'Iframe title', 'funkycommerce-headless' ),
+ 'type' => 'text',
+ 'tier' => 'free',
+ 'default' => __( 'AI Assistant', 'funkycommerce-headless' ),
+ 'description' => __( 'Accessible title announced when the secure iframe provider is rendered.', 'funkycommerce-headless' ),
+ ),
),
),
'footer' => array(
@@ -59,10 +436,13 @@ function funkycommerce_control_center_sections() {
'description' => __( 'Footer content, social profiles, and newsletter copy. Native WordPress menus own column assignments; layout alternatives remain in Layout Studio.', 'funkycommerce-headless' ),
'fields' => array(
'copyright_text' => array( 'label' => __( 'Copyright text', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free' ),
- 'social_links' => array( 'label' => __( 'Social links', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'free', 'default' => '[]', 'description' => __( 'JSON array of icon, URL, title, CSS class, enabled, and newTab values.', 'funkycommerce-headless' ) ),
+ 'social_links' => array( 'label' => __( 'Social profiles', 'funkycommerce-headless' ), 'type' => 'social_links', 'tier' => 'free', 'default' => array(), 'description' => __( 'Free theme feature. Add any supported platform more than once; every profile opens in a new tab.', 'funkycommerce-headless' ) ),
'newsletter_heading' => array( 'label' => __( 'Newsletter heading', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free' ),
'newsletter_text' => array( 'label' => __( 'Newsletter supporting text', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'free' ),
'newsletter_privacy_label' => array( 'label' => __( 'Newsletter privacy checkbox label', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free' ),
+ 'spotify_playlist_url' => array( 'label' => __( 'Spotify content URL', 'funkycommerce-headless' ), 'type' => 'spotify_playlist', 'tier' => 'free', 'description' => __( 'Paste a Spotify track, album, playlist, artist, show, or episode share URL.', 'funkycommerce-headless' ) ),
+ 'spotify_player_title' => array( 'label' => __( 'Radio title', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'description' => __( 'Optional storefront heading for your Spotify player. Leave empty to use the translated theme default.', 'funkycommerce-headless' ) ),
+ 'spotify_player_description' => array( 'label' => __( 'Radio description', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'free', 'description' => __( 'Describe the station, playlist, show, or podcast for your visitors. Leave empty to use the translated theme default.', 'funkycommerce-headless' ) ),
'footer_extra_content' => array( 'label' => __( 'Extra footer content', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'pro', 'sanitize' => 'html' ),
),
),
@@ -73,6 +453,48 @@ function funkycommerce_control_center_sections() {
'post_max_width' => array( 'label' => __( 'Post maximum width', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'default' => '720px' ),
'page_max_width' => array( 'label' => __( 'Page maximum width', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'default' => '1200px' ),
'reduced_motion_safe' => array( 'label' => __( 'Respect reduced-motion preferences', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
+ 'prism_theme_light' => array(
+ 'label' => __( 'Default code theme in light mode', 'funkycommerce-headless' ),
+ 'type' => 'select',
+ 'tier' => 'free',
+ 'default' => 'one-light',
+ 'options' => array(
+ 'one-light' => __( 'One Light', 'funkycommerce-headless' ),
+ 'one-dark' => __( 'One Dark', 'funkycommerce-headless' ),
+ 'dracula' => __( 'Dracula', 'funkycommerce-headless' ),
+ 'duotone-light' => __( 'Duotone Light', 'funkycommerce-headless' ),
+ 'duotone-dark' => __( 'Duotone Dark', 'funkycommerce-headless' ),
+ 'prism' => __( 'Prism Default', 'funkycommerce-headless' ),
+ 'coy' => __( 'Prism Coy', 'funkycommerce-headless' ),
+ 'dark' => __( 'Prism Dark', 'funkycommerce-headless' ),
+ 'funky' => __( 'Prism Funky', 'funkycommerce-headless' ),
+ 'okaidia' => __( 'Prism Okaidia', 'funkycommerce-headless' ),
+ 'solarized-light' => __( 'Prism Solarized Light', 'funkycommerce-headless' ),
+ 'tomorrow' => __( 'Prism Tomorrow Night', 'funkycommerce-headless' ),
+ 'twilight' => __( 'Prism Twilight', 'funkycommerce-headless' ),
+ ),
+ ),
+ 'prism_theme_dark' => array(
+ 'label' => __( 'Default code theme in dark mode', 'funkycommerce-headless' ),
+ 'type' => 'select',
+ 'tier' => 'free',
+ 'default' => 'one-dark',
+ 'options' => array(
+ 'one-light' => __( 'One Light', 'funkycommerce-headless' ),
+ 'one-dark' => __( 'One Dark', 'funkycommerce-headless' ),
+ 'dracula' => __( 'Dracula', 'funkycommerce-headless' ),
+ 'duotone-light' => __( 'Duotone Light', 'funkycommerce-headless' ),
+ 'duotone-dark' => __( 'Duotone Dark', 'funkycommerce-headless' ),
+ 'prism' => __( 'Prism Default', 'funkycommerce-headless' ),
+ 'coy' => __( 'Prism Coy', 'funkycommerce-headless' ),
+ 'dark' => __( 'Prism Dark', 'funkycommerce-headless' ),
+ 'funky' => __( 'Prism Funky', 'funkycommerce-headless' ),
+ 'okaidia' => __( 'Prism Okaidia', 'funkycommerce-headless' ),
+ 'solarized-light' => __( 'Prism Solarized Light', 'funkycommerce-headless' ),
+ 'tomorrow' => __( 'Prism Tomorrow Night', 'funkycommerce-headless' ),
+ 'twilight' => __( 'Prism Twilight', 'funkycommerce-headless' ),
+ ),
+ ),
'custom_css' => array( 'label' => __( 'Custom storefront CSS', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'free', 'sanitize' => 'css', 'description' => __( 'Loaded after Site Editor global styles and WordPress Additional CSS.', 'funkycommerce-headless' ) ),
),
),
@@ -80,6 +502,19 @@ function funkycommerce_control_center_sections() {
'title' => __( 'Checkout', 'funkycommerce-headless' ),
'description' => __( 'Theme-owned checkout wording and reassurance. Customer fields, shipping, coupons, payment rules, and component layout remain with WooCommerce or Layout Studio.', 'funkycommerce-headless' ),
'fields' => array(
+ 'checkout_account_mode' => array(
+ 'label' => __( 'Customer account mode', 'funkycommerce-headless' ),
+ 'type' => 'select',
+ 'tier' => 'free',
+ 'default' => 'optional',
+ 'options' => array(
+ 'guest' => __( 'Guest checkout only', 'funkycommerce-headless' ),
+ 'optional' => __( 'Guest checkout with optional account creation', 'funkycommerce-headless' ),
+ 'required' => __( 'Account required', 'funkycommerce-headless' ),
+ ),
+ 'description' => __( 'Controls account creation for the headless checkout independently from WooCommerce native checkout settings.', 'funkycommerce-headless' ),
+ ),
+ 'checkout_distraction_free' => array( 'label' => __( 'Distraction-free checkout navigation', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'Removes header, mobile, and footer navigation links on checkout. Recent-order notifications are always hidden there.', 'funkycommerce-headless' ) ),
'checkout_heading' => array( 'label' => __( 'Checkout heading', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'default' => __( 'Secure checkout', 'funkycommerce-headless' ) ),
'checkout_intro' => array( 'label' => __( 'Checkout introduction', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'free', 'default' => __( 'Complete your details and choose a payment method to place your order.', 'funkycommerce-headless' ) ),
'checkout_trust_message' => array( 'label' => __( 'Trust message', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'default' => __( 'Encrypted payment · Clear totals · Secure processing', 'funkycommerce-headless' ) ),
@@ -103,13 +538,22 @@ function funkycommerce_control_center_sections() {
'products_per_page' => array( 'label' => __( 'Products per page', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '12', 'min' => '1', 'max' => '100', 'step' => '1' ),
'stock_badge_enabled' => array( 'label' => __( 'Stock-status badges', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
'reviews_enabled' => array( 'label' => __( 'Product reviews and ratings', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
+ 'products_no_price_behavior' => array( 'label' => __( 'Products without a price', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'free', 'options' => array( 'free' => __( 'Treat as free', 'funkycommerce-headless' ), 'inquiry' => __( 'Show an inquiry form', 'funkycommerce-headless' ) ) ),
+ 'product_inquiry_heading' => array( 'label' => __( 'Product inquiry heading', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'default' => __( 'Product inquiry', 'funkycommerce-headless' ) ),
+ 'product_inquiry_button_label' => array( 'label' => __( 'Product inquiry button label', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free', 'default' => __( 'Ask about this product', 'funkycommerce-headless' ) ),
+ 'product_inquiry_copy' => array( 'label' => __( 'Product inquiry supporting copy', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'free', 'default' => __( 'Send us a message and we will follow up with availability and pricing.', 'funkycommerce-headless' ) ),
+ 'product_card_quick_view' => array( 'label' => __( 'Product-card quick view', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes', 'description' => __( 'When disabled, product cards send customers to the full product page for options.', 'funkycommerce-headless' ) ),
+ 'recent_orders_enabled' => array( 'label' => __( 'Show recent-order notifications', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Displays first names and purchased item names from recent processing or completed orders. No order IDs, surnames, email addresses, or addresses are exposed.', 'funkycommerce-headless' ) ),
+ 'recent_orders_item_count' => array( 'label' => __( 'Recent orders to rotate', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '5', 'min' => '1', 'max' => '10', 'step' => '1' ),
+ 'recent_orders_interval_seconds' => array( 'label' => __( 'Visible time per recent order (seconds)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '10', 'min' => '3', 'max' => '300', 'step' => '1' ),
+ 'recent_orders_quiet_seconds' => array( 'label' => __( 'Quiet time between recent orders (seconds)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '8', 'min' => '2', 'max' => '300', 'step' => '1', 'description' => __( 'Keeps the notification hidden between orders so it does not compete continuously with the storefront.', 'funkycommerce-headless' ) ),
+ 'recent_orders_links_new_tab' => array( 'label' => __( 'Open recent-order product links in a new tab', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes' ),
),
),
'payments' => array(
'title' => __( 'Payments', 'funkycommerce-headless' ),
'description' => __( 'Public payment presentation and theme-owned alternative payment configuration.', 'funkycommerce-headless' ),
'fields' => array(
- 'stripe_publishable_key' => array( 'label' => __( 'Stripe publishable key', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'free' ),
'blik_enabled' => array( 'label' => __( 'BLIK presentation', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
'bitcoin_enabled' => array( 'label' => __( 'Bitcoin payments', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
'bitcoin_wallet' => array( 'label' => __( 'Bitcoin wallet address', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
@@ -117,14 +561,15 @@ function funkycommerce_control_center_sections() {
'ethereum_wallet' => array( 'label' => __( 'Ethereum wallet address', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
'crypto_rate_lock' => array( 'label' => __( 'Crypto rate-lock minutes', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '15', 'min' => '1', 'max' => '120', 'step' => '1' ),
'cheque_bank_details' => array( 'label' => __( 'Cheque / bank-transfer details', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'free' ),
+ 'stripe_customer_portal_url' => array( 'label' => __( 'Stripe customer portal URL', 'funkycommerce-headless' ), 'type' => 'url', 'tier' => 'free', 'default' => '', 'description' => __( 'Optional hosted billing-management link shown beneath authenticated order history.', 'funkycommerce-headless' ) ),
),
),
'shipping' => array(
'title' => __( 'Shipping', 'funkycommerce-headless' ),
'description' => __( 'Quick storefront representation of WooCommerce shipping zones and free-shipping thresholds.', 'funkycommerce-headless' ),
'fields' => array(
- 'shipping_country_costs' => array( 'label' => __( 'Country and cost matrix', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '[]', 'description' => __( 'WooCommerce zones remain authoritative. Use JSON for storefront-only labels or overrides.', 'funkycommerce-headless' ) ),
- 'free_shipping_zones' => array( 'label' => __( 'Free-shipping thresholds', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '[]' ),
+ 'shipping_country_costs' => array( 'label' => __( 'Country and cost matrix — e.g. [{"countryCode":"DE","cost":9.90,"label":"Standard"}]', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '[]', 'description' => __( 'Use two-letter ISO country codes and costs in the WooCommerce base currency. WooCommerce shipping zones remain authoritative.', 'funkycommerce-headless' ) ),
+ 'free_shipping_zones' => array( 'label' => __( 'Free-shipping thresholds — e.g. [{"countryCode":"DE","minAmount":60}]', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '[]', 'description' => __( 'Set one non-negative minimum order amount per two-letter ISO country code, using the WooCommerce base currency.', 'funkycommerce-headless' ) ),
'shipping_estimator' => array( 'label' => __( 'Cart shipping estimator', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes' ),
),
),
@@ -162,24 +607,47 @@ function funkycommerce_control_center_sections() {
'sound_navigation' => array( 'label' => __( 'Navigation click sound', 'funkycommerce-headless' ), 'type' => 'media', 'tier' => 'pro' ),
),
),
+ 'loading' => array(
+ 'title' => __( 'Loading animation', 'funkycommerce-headless' ),
+ 'description' => __( 'Loading feedback shared by the native and headless storefronts.', 'funkycommerce-headless' ),
+ 'fields' => array(
+ 'loader_enabled' => array( 'label' => __( 'Loading animation', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
+ 'loader_custom_url' => array( 'label' => __( 'Custom loading animation', 'funkycommerce-headless' ), 'type' => 'media', 'tier' => 'free' ),
+ 'loader_size' => array( 'label' => __( 'Loader size (pixels)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '44', 'min' => '16', 'max' => '240', 'step' => '1' ),
+ 'loader_speed' => array( 'label' => __( 'Animation duration (milliseconds)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '1400', 'min' => '400', 'max' => '10000', 'step' => '50' ),
+ 'loader_primary_color' => array( 'label' => __( 'Primary crystal colour', 'funkycommerce-headless' ), 'type' => 'color', 'tier' => 'free', 'default' => '#7c3aed' ),
+ 'loader_glow_color' => array( 'label' => __( 'Crystal glow colour', 'funkycommerce-headless' ), 'type' => 'color', 'tier' => 'free', 'default' => '#c4b5fd' ),
+ 'loader_glow_opacity' => array( 'label' => __( 'Glow opacity', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '0.55', 'min' => '0', 'max' => '1', 'step' => '0.05' ),
+ ),
+ ),
'build' => array(
'title' => __( 'Build & Deploy', 'funkycommerce-headless' ),
'description' => __( 'Frontend routing, deployment hooks, and scheduled rebuilds.', 'funkycommerce-headless' ),
+ 'headless_only' => true,
'fields' => array(
'frontend_url' => array( 'label' => __( 'Frontend URL', 'funkycommerce-headless' ), 'type' => 'url', 'tier' => 'free', 'default' => 'https://funkycommerce.netlify.app', 'description' => __( 'Deployment target used by account emails and headless redirects. Authentication controls remain plugin-owned.', 'funkycommerce-headless' ) ),
+ 'artifact_mode' => array( 'label' => __( 'Dynamic content delivery', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'free', 'default' => 'build-webhook', 'options' => array( 'build-webhook' => __( 'Legacy build webhook', 'funkycommerce-headless' ), 'shadow' => __( 'Generate artifacts in shadow mode', 'funkycommerce-headless' ), 'artifact' => __( 'Serve generated artifacts', 'funkycommerce-headless' ) ), 'description' => __( 'Keep legacy mode until shadow generation and the production fallback have passed validation.', 'funkycommerce-headless' ) ),
+ 'artifact_site_key' => array( 'label' => __( 'Artifact site key', 'funkycommerce-headless' ), 'type' => 'slug', 'tier' => 'free', 'default' => '', 'description' => __( 'Stable lowercase deployment key. Multisite installations require a different key for every public site.', 'funkycommerce-headless' ) ),
+ 'artifact_signing_secret' => array( 'label' => __( 'Artifact signing secret', 'funkycommerce-headless' ), 'type' => 'password', 'tier' => 'free', 'default' => '', 'description' => __( 'At least 32 characters. Stored separately from public storefront settings and never returned by an API.', 'funkycommerce-headless' ) ),
+ 'artifact_cache_ttl' => array( 'label' => __( 'Artifact shared-cache TTL (seconds)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '60', 'min' => '0', 'max' => '3600', 'step' => '1' ),
+ 'artifact_retention_days' => array( 'label' => __( 'Artifact retention (days)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'free', 'default' => '30', 'min' => '1', 'max' => '365', 'step' => '1' ),
'build_webhook_url' => array( 'label' => __( 'Build webhook URL', 'funkycommerce-headless' ), 'type' => 'url', 'tier' => 'pro' ),
'periodic_rebuild' => array( 'label' => __( 'Periodic rebuilds', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
'rebuild_interval' => array( 'label' => __( 'Rebuild interval (hours)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '12', 'min' => '1', 'max' => '168', 'step' => '1' ),
'build_badge_id' => array( 'label' => __( 'Build status badge ID', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
+ 'backend_preview_enabled' => array( 'label' => __( 'Mirrored native previews', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes', 'description' => __( 'When an editor uses WordPress\' native Preview, style it with the current layout settings and show the real header/footer menus. Preview access itself always requires sign-in and edit permission, whether this is on or off.', 'funkycommerce-headless' ) ),
+ 'backend_redirect_enabled' => array( 'label' => __( 'Redirect public backend requests to the frontend', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'Sends ordinary (non-preview) visitors of this WordPress backend to their equivalent Frontend URL page. Admin, login, REST, GraphQL, cron, feeds, and native previews are never redirected.', 'funkycommerce-headless' ) ),
),
),
'seo' => array(
'title' => __( 'SEO & AI Files', 'funkycommerce-headless' ),
'description' => __( 'Search-engine directives, AI discovery documents, sitemap routing, and merchant verification.', 'funkycommerce-headless' ),
'fields' => array(
+ 'backend_noindex_enabled' => array( 'label' => __( 'Enforce backend noindex', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'For headless deployments only. Overrides WordPress and Yoast robots and sitemap settings on this backend origin without changing storefront SEO.', 'funkycommerce-headless' ) ),
+ 'backend_noindex_acknowledged' => array( 'label' => __( 'I acknowledge that this WordPress site is a headless backend with a separate public storefront', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'Required before backend noindex enforcement can be enabled.', 'funkycommerce-headless' ) ),
'sitemap_enabled' => array( 'label' => __( 'Frontend sitemap', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
'rss_feeds_enabled' => array( 'label' => __( 'RSS and Atom feeds', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes', 'description' => __( 'Publishes WordPress RSS/Atom feeds and XML aliases for static storefront discovery.', 'funkycommerce-headless' ) ),
- 'product_feed_enabled' => array( 'label' => __( 'Merchant product feed', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes', 'description' => __( 'Publishes WooCommerce products as product.feed.xml-compatible Google Merchant RSS.', 'funkycommerce-headless' ) ),
+ 'product_feed_enabled' => array( 'label' => __( 'Merchant product feed', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes', 'description' => __( 'Publishes WooCommerce products as Google Merchant RSS at product-feed.xml.', 'funkycommerce-headless' ) ),
'robots_enabled' => array( 'label' => __( 'Custom robots.txt', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
'robots_txt' => array( 'label' => __( 'robots.txt content', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'free', 'default' => "User-agent: *\nDisallow: /wp-admin/\nAllow: /" ),
'llms_enabled' => array( 'label' => __( 'llms.txt', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no' ),
@@ -196,7 +664,7 @@ function funkycommerce_control_center_sections() {
'ai_faq_json' => array( 'label' => __( 'ai-conversational-faq.json content', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '[]' ),
'ai_defense_enabled' => array( 'label' => __( 'AI hallucination defence', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
'ai_defense_txt' => array( 'label' => __( 'ai-hallucination-defense.txt content', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'pro' ),
- 'apple_merchant_file' => array( 'label' => __( 'Apple merchant association value', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'pro' ),
+ 'apple_merchant_file' => array( 'label' => __( 'Apple Pay domain association file', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'pro', 'sanitize' => 'raw', 'description' => __( 'Paste the complete apple-developer-merchantid-domain-association file downloaded for the storefront domain. Do not enter only the Merchant ID.', 'funkycommerce-headless' ) ),
),
),
'scripts' => array(
@@ -206,6 +674,7 @@ function funkycommerce_control_center_sections() {
'gtm_container_id' => array( 'label' => __( 'GTM container ID', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro', 'placeholder' => 'GTM-XXXXXXX' ),
'head_scripts' => array( 'label' => __( 'Head scripts', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'pro', 'sanitize' => 'scripts' ),
'body_scripts' => array( 'label' => __( 'Body scripts', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'pro', 'sanitize' => 'scripts' ),
+ 'footer_scripts' => array( 'label' => __( 'Footer scripts', 'funkycommerce-headless' ), 'type' => 'code', 'tier' => 'pro', 'sanitize' => 'scripts', 'description' => __( 'Loaded immediately before the closing body tag for deferred third-party integrations.', 'funkycommerce-headless' ) ),
'cookie_consent' => array( 'label' => __( 'Cookies Consent v2 configuration', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '{}' ),
),
),
@@ -220,7 +689,7 @@ function funkycommerce_control_center_sections() {
'security_remove_head_links' => array( 'label' => __( 'Remove legacy wp_head links', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes', 'description' => __( 'Removes RSD, WLW, shortlink, oEmbed discovery, generator, and relational links from the theme frontend.', 'funkycommerce-headless' ) ),
'security_disallow_file_edit' => array( 'label' => __( 'Disable theme/plugin file editor', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes', 'description' => __( 'Defines DISALLOW_FILE_EDIT on the next request unless wp-config.php already defines it.', 'funkycommerce-headless' ) ),
'security_disallow_file_mods' => array( 'label' => __( 'Disable plugin/theme installation and updates', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'High-impact deployment lock. Defines DISALLOW_FILE_MODS on the next request.', 'funkycommerce-headless' ) ),
- 'security_protect_uploads' => array( 'label' => __( 'Block script execution in uploads', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Opt-in server change. Writes a removable FunkyCommerce marker to the uploads .htaccess file on Apache-compatible servers.', 'funkycommerce-headless' ) ),
+ 'security_protect_uploads' => array( 'label' => __( 'Block script execution in uploads', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Opt-in server change. Writes a removable Superfunky marker to the uploads .htaccess file on Apache-compatible servers.', 'funkycommerce-headless' ) ),
'security_disable_upload_listing' => array( 'label' => __( 'Disable uploads directory listing', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
'security_block_author_queries' => array( 'label' => __( 'Block numeric author enumeration', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes' ),
'security_restrict_rest_users' => array( 'label' => __( 'Restrict public core REST users', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes', 'description' => __( 'Requires authentication for /wp/v2/users routes; custom storefront profile APIs remain available.', 'funkycommerce-headless' ) ),
@@ -228,7 +697,7 @@ function funkycommerce_control_center_sections() {
'security_headers_enabled' => array( 'label' => __( 'Send baseline security headers', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
'security_hsts_enabled' => array( 'label' => __( 'Send HSTS on HTTPS requests', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Enable only when the site and required subdomains are permanently HTTPS.', 'funkycommerce-headless' ) ),
'security_csp_enabled' => array( 'label' => __( 'Send Content Security Policy', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Test carefully: an incorrect policy can block the storefront, editor, embeds, payments, or analytics.', 'funkycommerce-headless' ) ),
- 'security_csp_policy' => array( 'label' => __( 'Content Security Policy', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'pro', 'default' => "default-src 'self' https: data: blob:; object-src 'none'; base-uri 'self'; frame-ancestors 'self'" ),
+ 'security_csp_policy' => array( 'label' => __( 'Content Security Policy', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'pro', 'default' => "default-src 'self' https: data: blob:; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; style-src-elem 'self' 'unsafe-inline' https://fonts.googleapis.com; style-src-attr 'unsafe-inline'; object-src 'none'; base-uri 'self'; frame-ancestors 'self'", 'description' => __( 'The storefront build constrains inline permission to style directives for React, Gutenberg, and reviewed widget styling. Script and default directives are not relaxed.', 'funkycommerce-headless' ) ),
'security_headers' => array( 'label' => __( 'Additional HTTP security headers', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '{}', 'description' => __( 'JSON object. Only approved security header names are accepted at runtime; values containing line breaks are rejected.', 'funkycommerce-headless' ) ),
'security_force_https' => array( 'label' => __( 'Force HTTPS redirects', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Enable only after WordPress and the reverse proxy report HTTPS correctly.', 'funkycommerce-headless' ) ),
'security_block_bad_bots' => array( 'label' => __( 'Block configured bot user agents', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
@@ -251,27 +720,13 @@ function funkycommerce_control_center_sections() {
'login_wave_background' => array( 'label' => __( 'Animated login background', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Respects prefers-reduced-motion.', 'funkycommerce-headless' ) ),
'login_footer_text' => array( 'label' => __( 'Login footer text', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
'redirect_rules' => array( 'label' => __( 'Frontend redirects', 'funkycommerce-headless' ), 'type' => 'json', 'tier' => 'pro', 'default' => '[]' ),
- 'svg_upload_enabled' => array( 'label' => __( 'Sanitised SVG uploads', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
+ 'svg_upload_enabled' => array( 'label' => __( 'Sanitised SVG uploads', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Allows SVG media only after removing scripts, event handlers, external resources, and unsupported markup.', 'funkycommerce-headless' ) ),
+ 'content_scripts_posts_enabled' => array( 'label' => __( 'Execute scripts in blog posts', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'Only trusted editors should publish Custom HTML scripts.', 'funkycommerce-headless' ) ),
+ 'content_scripts_pages_enabled' => array( 'label' => __( 'Execute scripts in pages', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no', 'description' => __( 'Only trusted editors should publish Custom HTML scripts.', 'funkycommerce-headless' ) ),
+ 'content_scripts_products_enabled' => array( 'label' => __( 'Execute scripts in products', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no', 'description' => __( 'Pro control for trusted Custom HTML scripts in product content.', 'funkycommerce-headless' ) ),
'hide_visit_store' => array( 'label' => __( 'Hide “Visit Store” admin-bar link', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'yes' ),
),
),
- 'email' => array(
- 'title' => __( 'Email & Newsletter', 'funkycommerce-headless' ),
- 'description' => __( 'SMTP delivery, newsletter provider, and transactional customer templates.', 'funkycommerce-headless' ),
- 'fields' => array(
- 'mailgun_api_key' => array( 'label' => __( 'Mailgun API key', 'funkycommerce-headless' ), 'type' => 'password', 'tier' => 'pro' ),
- 'mailgun_domain' => array( 'label' => __( 'Mailgun domain', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
- 'email_from_name' => array( 'label' => __( 'From name', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
- 'email_from_address' => array( 'label' => __( 'From address', 'funkycommerce-headless' ), 'type' => 'email', 'tier' => 'pro' ),
- 'newsletter_provider' => array( 'label' => __( 'Newsletter provider', 'funkycommerce-headless' ), 'type' => 'select', 'tier' => 'pro', 'default' => 'local', 'options' => array( 'local' => __( 'Local subscribers', 'funkycommerce-headless' ), 'mailpoet' => 'MailPoet', 'mailchimp' => 'Mailchimp' ) ),
- 'mailchimp_api_key' => array( 'label' => __( 'Mailchimp API key', 'funkycommerce-headless' ), 'type' => 'password', 'tier' => 'pro' ),
- 'mailchimp_audience_id' => array( 'label' => __( 'Mailchimp audience ID', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
- 'newsletter_double_optin' => array( 'label' => __( 'Newsletter double opt-in', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes' ),
- 'order_email_subject' => array( 'label' => __( 'Order email subject', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro' ),
- 'order_email_template' => array( 'label' => __( 'Order email HTML template', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'pro', 'sanitize' => 'html' ),
- 'form_autoresponder' => array( 'label' => __( 'Form autoresponder template', 'funkycommerce-headless' ), 'type' => 'textarea', 'tier' => 'pro', 'sanitize' => 'html' ),
- ),
- ),
'forms' => array(
'title' => __( 'Forms & Newsletter', 'funkycommerce-headless' ),
'description' => __( 'Core submission endpoint, spam checks, notification routing, and upload restrictions.', 'funkycommerce-headless' ),
@@ -281,15 +736,14 @@ function funkycommerce_control_center_sections() {
'forms_notification_email' => array( 'label' => __( 'Notification email', 'funkycommerce-headless' ), 'type' => 'email', 'tier' => 'free' ),
'forms_upload_enabled' => array( 'label' => __( 'File uploads', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'no' ),
'forms_allowed_types' => array( 'label' => __( 'Allowed upload extensions', 'funkycommerce-headless' ), 'type' => 'text', 'tier' => 'pro', 'default' => 'jpg,jpeg,png,pdf' ),
- 'forms_max_upload_mb' => array( 'label' => __( 'Maximum upload size (MB)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '5', 'min' => '1', 'max' => '100', 'step' => '1' ),
+ 'forms_max_upload_mb' => array( 'label' => __( 'Maximum upload size (MB)', 'funkycommerce-headless' ), 'type' => 'number', 'tier' => 'pro', 'default' => '5', 'min' => '1', 'max' => '20', 'step' => '1' ),
),
),
'push' => array(
'title' => __( 'Push', 'funkycommerce-headless' ),
- 'description' => __( 'Web-push availability and the public application-server key.', 'funkycommerce-headless' ),
+ 'description' => __( 'Web-push availability. VAPID keys are configured securely in wp-config.php.', 'funkycommerce-headless' ),
'fields' => array(
'push_enabled' => array( 'label' => __( 'Push notifications', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'pro', 'default' => 'yes' ),
- 'vapid_public_key' => array( 'label' => __( 'VAPID public key', 'funkycommerce-headless' ), 'type' => 'readonly', 'tier' => 'pro', 'source_option' => 'funkycommerce_vapid_public_key' ),
),
),
'advanced' => array(
@@ -297,7 +751,6 @@ function funkycommerce_control_center_sections() {
'description' => __( 'Diagnostics and extension points for developers and managed deployments.', 'funkycommerce-headless' ),
'fields' => array(
'debug_mode' => array( 'label' => __( 'Theme debug mode', 'funkycommerce-headless' ), 'type' => 'toggle', 'tier' => 'free', 'default' => 'no' ),
- 'license_key' => array( 'label' => __( 'Pro licence key', 'funkycommerce-headless' ), 'type' => 'password', 'tier' => 'free' ),
),
),
);
@@ -314,10 +767,11 @@ function funkycommerce_control_center_sections() {
function funkycommerce_premium_companion_catalog() {
$companions = array(
'ai-shopping-assistant' => array(
- 'name' => __( 'AI Shopping Assistant', 'funkycommerce-headless' ),
+ 'name' => __( 'AI Assistant', 'funkycommerce-headless' ),
'product_id' => 'ai-shopping-assistant',
- 'plugin_slugs' => array( 'funkycommerce-ai-shopping-assistant', 'funkycommerce-ai-assistant-frame', 'funkycommerce-ai-assistant', 'ao-vector-search-plugin', 'ao-vector-search' ),
- 'description' => __( 'Configurable storefront shopping assistant with placement, consent, branding, and service connection controls.', 'funkycommerce-headless' ),
+ 'plugin_slugs' => funkycommerce_ai_assistant_plugin_slugs(),
+ 'description' => __( 'Configurable storefront AI assistant with placement, consent, branding, and service connection controls.', 'funkycommerce-headless' ),
+ 'product_url' => 'https://superfunky.pro/product/ai-shopping-assistant/',
'settings' => array(
__( 'Assistant service URL and authentication', 'funkycommerce-headless' ),
__( 'Storefront placement and visibility rules', 'funkycommerce-headless' ),
@@ -329,6 +783,7 @@ function funkycommerce_premium_companion_catalog() {
'product_id' => 'google-maps-locations',
'plugin_slugs' => array( 'funkycommerce-google-maps-locations', 'funkycommerce-locations' ),
'description' => __( 'Store locator data and shortcode rendering designed for the headless storefront.', 'funkycommerce-headless' ),
+ 'product_url' => 'https://superfunky.pro/product/google-maps-locations/',
'settings' => array(
__( 'Google Maps API and map defaults', 'funkycommerce-headless' ),
__( 'Location records, hours, contact details, and markers', 'funkycommerce-headless' ),
@@ -340,6 +795,7 @@ function funkycommerce_premium_companion_catalog() {
'product_id' => 'slack-notifications',
'plugin_slugs' => array( 'funkycommerce-slack-notifications', 'funkycommerce-notifications' ),
'description' => __( 'Theme-agnostic Slack notification center for WordPress, WooCommerce, forms, and custom connector events.', 'funkycommerce-headless' ),
+ 'product_url' => 'https://superfunky.pro/product/slack-notifications/',
'settings' => array(
__( 'Secure incoming webhook and Slack presentation', 'funkycommerce-headless' ),
__( 'Independent WordPress, WooCommerce, form, and system events', 'funkycommerce-headless' ),
@@ -351,6 +807,7 @@ function funkycommerce_premium_companion_catalog() {
'product_id' => 'discord-notifications',
'plugin_slugs' => array( 'funkycommerce-discord-notifications' ),
'description' => __( 'Theme-agnostic Discord notification center with native embeds and the same connector coverage as Slack.', 'funkycommerce-headless' ),
+ 'product_url' => 'https://superfunky.pro/product/discord-notifications/',
'settings' => array(
__( 'Secure Discord webhook and embed presentation', 'funkycommerce-headless' ),
__( 'Independent WordPress, WooCommerce, form, and system events', 'funkycommerce-headless' ),
@@ -362,6 +819,7 @@ function funkycommerce_premium_companion_catalog() {
'product_id' => 'abandoned-cart-pro',
'plugin_slugs' => array( 'funkycommerce-abandoned-cart-pro', 'funkycommerce-abandoned-carts' ),
'description' => __( 'Persistent cart recovery for the headless checkout, with customer timelines and automated sequences.', 'funkycommerce-headless' ),
+ 'product_url' => 'https://superfunky.pro/product/abandoned-carts/',
'settings' => array(
__( 'Cart capture, consent, and abandonment timing', 'funkycommerce-headless' ),
__( 'Recovery archive, customer timeline, and conversion status', 'funkycommerce-headless' ),
diff --git a/inc/control-center.php b/inc/control-center.php
index 2264e4a..2f6ae37 100644
--- a/inc/control-center.php
+++ b/inc/control-center.php
@@ -45,9 +45,47 @@ function funkycommerce_control_center_settings() {
$saved['frontend_url'] = (string) get_option( 'funkycommerce_frontend_url', $defaults['frontend_url'] );
}
+ $legacy_script_scope = sanitize_key( $saved['content_script_scope'] ?? 'disabled' );
+ foreach (
+ array(
+ 'post' => 'content_scripts_posts_enabled',
+ 'page' => 'content_scripts_pages_enabled',
+ 'product' => 'content_scripts_products_enabled',
+ ) as $post_type => $setting_key
+ ) {
+ if ( ! array_key_exists( $setting_key, $saved ) ) {
+ $saved[ $setting_key ] = in_array( $legacy_script_scope, array( 'all', $post_type ), true ) ? 'yes' : 'no';
+ }
+ }
+
return array_merge( $defaults, $saved );
}
+/**
+ * Return a normalized public layout object from schema defaults and saved values.
+ *
+ * @return array
+ */
+function funkycommerce_storefront_layout_settings() {
+ $settings = funkycommerce_control_center_settings();
+ $layout = array( 'schemaVersion' => 1 );
+
+ foreach ( funkycommerce_layout_control_fields() as $key => $field ) {
+ if ( 'readonly' === $field['type'] || empty( $field['graphKey'] ) ) {
+ continue;
+ }
+ $value = funkycommerce_sanitize_control_field( $key, $field, $settings[ $key ] ?? ( $field['default'] ?? '' ), $field['default'] ?? '' );
+ if ( 'toggle' === $field['type'] ) {
+ $value = 'yes' === $value;
+ } elseif ( 'number' === $field['type'] ) {
+ $value = (int) $value;
+ }
+ $layout[ $field['graphKey'] ] = $value;
+ }
+
+ return $layout;
+}
+
/**
* Register the single option that owns all theme controls.
*/
@@ -71,6 +109,110 @@ function funkycommerce_sanitize_custom_css( $value ) {
return preg_replace( '#]*>#i', '', wp_unslash( (string) $value ) );
}
+function funkycommerce_normalize_spotify_playlist_url( $value ) {
+ $url = esc_url_raw( trim( wp_unslash( (string) $value ) ), array( 'https' ) );
+ $parts = $url ? wp_parse_url( $url ) : array();
+ $path = trim( (string) ( $parts['path'] ?? '' ), '/' );
+ if ( 'open.spotify.com' !== strtolower( $parts['host'] ?? '' ) || ! preg_match( '#^(?:(?:embed|intl-[a-z-]+)/)?(track|album|playlist|artist|show|episode)/([A-Za-z0-9]{10,64})$#i', $path, $matches ) ) {
+ return '';
+ }
+ return 'https://open.spotify.com/' . $matches[1] . '/' . $matches[2];
+}
+
+function funkycommerce_spotify_playlist_embed_url( $value ) {
+ $url = funkycommerce_normalize_spotify_playlist_url( $value );
+ return $url ? preg_replace( '#^https://open\.spotify\.com/#', 'https://open.spotify.com/embed/', $url ) : '';
+}
+
+/**
+ * Normalize saved or submitted social-link rows.
+ *
+ * Legacy JSON rows using icon/href/title are accepted so existing settings migrate
+ * to the repeatable control without data loss.
+ */
+function funkycommerce_clean_social_links( $value, &$invalid = false ) {
+ $invalid = false;
+ if ( is_string( $value ) ) {
+ $value = trim( wp_unslash( $value ) );
+ if ( '' === $value ) {
+ return array();
+ }
+ $value = json_decode( $value, true );
+ if ( ! is_array( $value ) ) {
+ $invalid = true;
+ return array();
+ }
+ }
+
+ if ( null === $value ) {
+ return array();
+ }
+ if ( ! is_array( $value ) ) {
+ $invalid = true;
+ return array();
+ }
+
+ $platforms = funkycommerce_supported_social_icons();
+ $links = array();
+ $used_ids = array();
+ foreach ( array_values( $value ) as $index => $row ) {
+ if ( ! is_array( $row ) ) {
+ $invalid = true;
+ continue;
+ }
+ if ( isset( $row['enabled'] ) && ! filter_var( $row['enabled'], FILTER_VALIDATE_BOOLEAN ) ) {
+ continue;
+ }
+
+ $platform = sanitize_key( wp_unslash( (string) ( $row['platform'] ?? $row['icon'] ?? '' ) ) );
+ $raw_url = trim( wp_unslash( (string) ( $row['url'] ?? $row['href'] ?? '' ) ) );
+ $raw_label = trim( wp_unslash( (string) ( $row['label'] ?? $row['title'] ?? '' ) ) );
+ if ( '' === $platform && '' === $raw_url && '' === $raw_label ) {
+ continue;
+ }
+
+ $url = esc_url_raw( $raw_url, array( 'http', 'https' ) );
+ if ( ! isset( $platforms[ $platform ] ) || '' === $url || ! preg_match( '#^https?://#i', $url ) ) {
+ $invalid = true;
+ continue;
+ }
+
+ $id = sanitize_key( wp_unslash( (string) ( $row['id'] ?? '' ) ) );
+ if ( '' === $id || isset( $used_ids[ $id ] ) ) {
+ $id = 'social-' . substr( md5( $index . '|' . $platform . '|' . $url ), 0, 12 );
+ }
+ while ( isset( $used_ids[ $id ] ) ) {
+ $id .= '-2';
+ }
+ $used_ids[ $id ] = true;
+ $links[] = array(
+ 'id' => $id,
+ 'platform' => $platform,
+ 'url' => $url,
+ 'label' => sanitize_text_field( $raw_label ) ?: wp_strip_all_tags( $platforms[ $platform ] ),
+ );
+ }
+
+ return $links;
+}
+
+/**
+ * Validate the complete social-link collection as one atomic setting.
+ */
+function funkycommerce_sanitize_social_links( $value, $previous ) {
+ $links = funkycommerce_clean_social_links( $value, $invalid );
+ if ( ! $invalid ) {
+ return $links;
+ }
+
+ add_settings_error(
+ 'funkycommerce_control_center',
+ 'invalid_social_links',
+ __( 'Social profiles were not saved. Choose a supported platform and enter a complete HTTP or HTTPS URL for every row.', 'funkycommerce-headless' )
+ );
+ return funkycommerce_clean_social_links( $previous );
+}
+
/**
* Sanitize one Control Center field according to its schema definition.
*/
@@ -78,7 +220,11 @@ function funkycommerce_sanitize_control_field( $key, $field, $value, $previous )
$type = $field['type'];
if ( 'toggle' === $type ) {
- return empty( $value ) ? 'no' : 'yes';
+ if ( is_bool( $value ) ) {
+ return $value ? 'yes' : 'no';
+ }
+ $value = strtolower( trim( (string) $value ) );
+ return in_array( $value, array( '1', 'yes', 'true', 'on' ), true ) ? 'yes' : 'no';
}
if ( 'multicheck' === $type ) {
@@ -86,7 +232,7 @@ function funkycommerce_sanitize_control_field( $key, $field, $value, $previous )
}
if ( 'currencies' === $type ) {
- $available = function_exists( 'get_woocommerce_currencies' ) ? array_keys( get_woocommerce_currencies() ) : array( 'EUR', 'USD', 'GBP', 'PLN' );
+ $available = array_keys( funkycommerce_currency_names() );
$selected = array_values( array_intersect( $available, array_map( 'strtoupper', (array) $value ) ) );
$base = function_exists( 'get_woocommerce_currency' ) ? get_woocommerce_currency() : 'EUR';
if ( ! in_array( $base, $selected, true ) ) {
@@ -107,13 +253,26 @@ function funkycommerce_sanitize_control_field( $key, $field, $value, $previous )
return (string) $number;
}
+ if ( 'social_links' === $type ) {
+ return funkycommerce_sanitize_social_links( $value, $previous );
+ }
+
if ( 'json' === $type ) {
- $value = trim( wp_unslash( (string) $value ) );
- if ( '' === $value ) {
+ $submitted = trim( (string) $value );
+ if ( '' === $submitted ) {
return $field['default'] ?? '';
}
- json_decode( $value, true );
- if ( JSON_ERROR_NONE !== json_last_error() ) {
+ json_decode( $submitted, true );
+ if ( JSON_ERROR_NONE === json_last_error() ) {
+ $value = $submitted;
+ } else {
+ $value = trim( wp_unslash( $submitted ) );
+ json_decode( $value, true );
+ if ( JSON_ERROR_NONE !== json_last_error() ) {
+ $value = null;
+ }
+ }
+ if ( null === $value ) {
add_settings_error(
'funkycommerce_control_center',
'invalid_json_' . $key,
@@ -131,13 +290,54 @@ function funkycommerce_sanitize_control_field( $key, $field, $value, $previous )
if ( 'password' === $type ) {
$value = trim( wp_unslash( (string) $value ) );
+ if ( 'artifact_signing_secret' === $key ) {
+ if ( '' === $value ) {
+ return funkycommerce_artifact_signing_secret() ? '__stored__' : '';
+ }
+ if ( strlen( $value ) < 32 || strlen( $value ) > 256 || preg_match( '/[\x00-\x20\x7F]/', $value ) ) {
+ add_settings_error(
+ 'funkycommerce_control_center',
+ 'invalid_artifact_signing_secret',
+ __( 'The artifact signing secret must contain 32 to 256 non-whitespace characters.', 'funkycommerce-headless' )
+ );
+ return $previous;
+ }
+ update_option( 'funkycommerce_artifact_signing_secret', $value, false );
+ return '__stored__';
+ }
return '' === $value ? $previous : sanitize_text_field( $value );
}
+ if ( 'ai_assistant_iframe_url' === $key ) {
+ $clean_url = funkycommerce_ai_assistant_iframe_url( $value );
+ if ( '' !== trim( wp_unslash( (string) $value ) ) && '' === $clean_url ) {
+ add_settings_error(
+ 'funkycommerce_control_center',
+ 'invalid_ai_assistant_iframe_url',
+ __( 'AI Assistant iframe URL was not saved. Use HTTPS, except for a local development host.', 'funkycommerce-headless' )
+ );
+ return $previous;
+ }
+ return $clean_url;
+ }
+
+ if ( 'ai_assistant_iframe_title' === $key ) {
+ return funkycommerce_ai_assistant_iframe_title( $value );
+ }
+
if ( 'url' === $type || 'media' === $type ) {
return esc_url_raw( $value );
}
+ if ( 'spotify_playlist' === $type ) {
+ $normalized = funkycommerce_normalize_spotify_playlist_url( $value );
+ if ( '' !== trim( (string) $value ) && '' === $normalized ) {
+ add_settings_error( 'funkycommerce_control_center', 'invalid_spotify_playlist', __( 'Use a complete open.spotify.com track, album, playlist, artist, show, or episode share URL.', 'funkycommerce-headless' ) );
+ return funkycommerce_normalize_spotify_playlist_url( $previous );
+ }
+ return $normalized;
+ }
+
if ( 'email' === $type ) {
return sanitize_email( $value );
}
@@ -163,6 +363,10 @@ function funkycommerce_sanitize_control_field( $key, $field, $value, $previous )
return funkycommerce_sanitize_custom_css( $value );
}
+ if ( 'code' === $type && 'raw' === ( $field['sanitize'] ?? '' ) ) {
+ return wp_check_invalid_utf8( wp_unslash( (string) $value ), true );
+ }
+
if ( 'code' === $type || 'textarea' === $type ) {
$value = wp_unslash( (string) $value );
if ( 'html' === ( $field['sanitize'] ?? '' ) ) {
@@ -185,10 +389,41 @@ function funkycommerce_sanitize_control_center( $input ) {
$previous = (array) get_option( 'funkycommerce_control_center', array() );
$output = array();
+ $layout_import = trim( wp_unslash( (string) ( $input['layout_import_config'] ?? '' ) ) );
+ if ( '' !== $layout_import ) {
+ $decoded = json_decode( $layout_import, true );
+ $layout = is_array( $decoded ) && isset( $decoded['layout'] ) && is_array( $decoded['layout'] ) ? $decoded['layout'] : $decoded;
+ if ( ! is_array( $layout ) ) {
+ add_settings_error(
+ 'funkycommerce_control_center',
+ 'invalid_layout_import',
+ __( 'The Layout Studio configuration was not loaded because it is not valid JSON.', 'funkycommerce-headless' )
+ );
+ } else {
+ foreach ( funkycommerce_layout_control_fields() as $key => $field ) {
+ $graph_key = $field['graphKey'] ?? '';
+ if ( 'readonly' === $field['type'] || '' === $graph_key || ! array_key_exists( $graph_key, $layout ) ) {
+ continue;
+ }
+ $input[ $key ] = 'toggle' === $field['type'] ? ( filter_var( $layout[ $graph_key ], FILTER_VALIDATE_BOOLEAN ) ? 'yes' : '' ) : $layout[ $graph_key ];
+ }
+ add_settings_error(
+ 'funkycommerce_control_center',
+ 'layout_import_loaded',
+ __( 'Layout Studio configuration loaded. Review the controls below and save again if you make further changes.', 'funkycommerce-headless' ),
+ 'updated'
+ );
+ }
+ }
+
foreach ( funkycommerce_control_center_fields() as $key => $field ) {
if ( 'readonly' === $field['type'] ) {
continue;
}
+ if ( 'layout_import_config' === $key ) {
+ $output[ $key ] = '';
+ continue;
+ }
// Pro-tier fields are preserved from the previous value when Pro is inactive.
if ( ! funkycommerce_field_accessible( $key, $field ) ) {
if ( isset( $previous[ $key ] ) ) {
@@ -199,12 +434,22 @@ function funkycommerce_sanitize_control_center( $input ) {
$value = $input[ $key ] ?? null;
$output[ $key ] = funkycommerce_sanitize_control_field( $key, $field, $value, $previous[ $key ] ?? ( $field['default'] ?? '' ) );
}
+ $output['layout_schema_version'] = 1;
+
+ if ( 'yes' === ( $output['backend_noindex_enabled'] ?? 'no' ) && 'yes' !== ( $output['backend_noindex_acknowledged'] ?? 'no' ) ) {
+ add_settings_error(
+ 'funkycommerce_control_center',
+ 'backend_noindex_acknowledgement_required',
+ __( 'Backend noindex was not enabled. Confirm that this WordPress site is a headless backend with a separate public storefront.', 'funkycommerce-headless' )
+ );
+ $output['backend_noindex_enabled'] = $previous['backend_noindex_enabled'] ?? 'no';
+ $output['backend_noindex_acknowledged'] = $previous['backend_noindex_acknowledged'] ?? 'no';
+ }
$languages = function_exists( 'funkycommerce_available_language_slugs' ) ? funkycommerce_available_language_slugs() : array();
foreach ( $languages as $language ) {
- foreach ( array( 'store_tagline_', 'promo_text_' ) as $prefix ) {
- $output[ $prefix . $language ] = sanitize_text_field( wp_unslash( $input[ $prefix . $language ] ?? '' ) );
- }
+ $output[ 'store_tagline_' . $language ] = sanitize_text_field( wp_unslash( $input[ 'store_tagline_' . $language ] ?? '' ) );
+ $output[ 'promo_text_' . $language ] = wp_kses_post( wp_unslash( $input[ 'promo_text_' . $language ] ?? '' ) );
$key = 'ui_strings_' . $language;
$field = array(
@@ -222,8 +467,24 @@ function funkycommerce_sanitize_control_center( $input ) {
* Keep old option consumers working while the rest of the backend is migrated.
*/
function funkycommerce_sync_control_center_legacy_options( $old_value, $value ) {
+ $old_value = is_array( $old_value ) ? $old_value : array();
$value = is_array( $value ) ? $value : array();
+ $was_noindex = 'yes' === ( $old_value['backend_noindex_enabled'] ?? 'no' );
+ $is_noindex = 'yes' === ( $value['backend_noindex_enabled'] ?? 'no' );
+ if ( $is_noindex && ! $was_noindex ) {
+ if ( false === get_option( 'funkycommerce_backend_noindex_previous_blog_public', false ) ) {
+ add_option( 'funkycommerce_backend_noindex_previous_blog_public', (string) get_option( 'blog_public', '1' ), '', false );
+ }
+ update_option( 'blog_public', '0' );
+ } elseif ( ! $is_noindex && $was_noindex ) {
+ $previous_blog_public = get_option( 'funkycommerce_backend_noindex_previous_blog_public', false );
+ if ( false !== $previous_blog_public ) {
+ update_option( 'blog_public', (string) $previous_blog_public );
+ delete_option( 'funkycommerce_backend_noindex_previous_blog_public' );
+ }
+ }
+
update_option( 'funkycommerce_custom_css', $value['custom_css'] ?? '' );
update_option( 'funkycommerce_currencies', (array) ( $value['enabled_currencies'] ?? array() ) );
update_option( 'funkycommerce_currency_rate_mode', $value['currency_rate_mode'] ?? 'automatic' );
@@ -258,6 +519,14 @@ function funkycommerce_sync_control_center_legacy_options( $old_value, $value )
}
add_action( 'update_option_funkycommerce_control_center', 'funkycommerce_sync_control_center_legacy_options', 10, 2 );
+/**
+ * Apply option side effects when the Control Center option is created for the first time.
+ */
+function funkycommerce_initialize_control_center_legacy_options( $option, $value ) {
+ funkycommerce_sync_control_center_legacy_options( array(), $value );
+}
+add_action( 'add_option_funkycommerce_control_center', 'funkycommerce_initialize_control_center_legacy_options', 10, 2 );
+
/**
* Apply the configured public order-number prefix.
*/
@@ -272,15 +541,112 @@ function funkycommerce_control_center_order_number( $order_number ) {
}
add_filter( 'woocommerce_order_number', 'funkycommerce_control_center_order_number' );
+/**
+ * Return a secure AI Assistant iframe URL or an empty string when unset/invalid.
+ */
+function funkycommerce_ai_assistant_iframe_url( $value ) {
+ $value = trim( wp_unslash( (string) $value ) );
+ if ( '' === $value ) {
+ return '';
+ }
+
+ $url = esc_url_raw( $value, array( 'http', 'https' ) );
+ $parts = wp_parse_url( $url );
+ if (
+ ! is_array( $parts )
+ || empty( $parts['scheme'] )
+ || empty( $parts['host'] )
+ || isset( $parts['user'] )
+ || isset( $parts['pass'] )
+ || isset( $parts['fragment'] )
+ ) {
+ return '';
+ }
+ if ( 'https' === strtolower( $parts['scheme'] ) ) {
+ return $url;
+ }
+ $host = strtolower( trim( $parts['host'], '[]' ) );
+ return 'http' === strtolower( $parts['scheme'] ) && in_array( $host, array( 'localhost', '127.0.0.1', '::1' ), true )
+ ? $url
+ : '';
+}
+
+/**
+ * Return the accessible AI Assistant iframe title with a stable fallback.
+ */
+function funkycommerce_ai_assistant_iframe_title( $value ) {
+ $title = sanitize_text_field( wp_unslash( (string) $value ) );
+ return '' === $title ? __( 'AI Assistant', 'funkycommerce-headless' ) : $title;
+}
+
+/**
+ * Return the fixed sandbox policy for AI Assistant iframe embeds.
+ */
+function funkycommerce_ai_assistant_iframe_sandbox() {
+ return 'allow-scripts allow-forms allow-popups';
+}
+
+/**
+ * Return the fixed referrer policy for AI Assistant iframe embeds.
+ */
+function funkycommerce_ai_assistant_iframe_referrer_policy() {
+ return 'strict-origin-when-cross-origin';
+}
+
+/**
+ * Whether any supported AI Assistant companion slug is active on the site.
+ */
+function funkycommerce_ai_assistant_native_provider_active() {
+ return funkycommerce_extension_is_active(
+ function_exists( 'funkycommerce_ai_assistant_plugin_slugs' )
+ ? funkycommerce_ai_assistant_plugin_slugs()
+ : array()
+ );
+}
+
+/**
+ * Return the preset names and optional media overrides for header action icons.
+ *
+ * @return array{icons: array, media: array}
+ */
+function funkycommerce_storefront_header_icon_settings( $settings ) {
+ $icons = array();
+ $media = array();
+
+ foreach ( function_exists( 'funkycommerce_header_icon_definitions' ) ? funkycommerce_header_icon_definitions() : array() as $definition ) {
+ $setting_key = $definition['settingKey'];
+ $graph_key = $definition['graphKey'];
+ $icons[ $graph_key ] = (string) ( $settings[ 'header_icon_' . $setting_key ] ?? $definition['default'] );
+ $media_url = esc_url_raw( $settings[ 'header_icon_' . $setting_key . '_media_url' ] ?? '' );
+ $media[ $graph_key ] = '' !== $media_url ? $media_url : null;
+ }
+
+ return array(
+ 'icons' => $icons,
+ 'media' => $media,
+ );
+}
+
/**
* Return the subset currently consumed by the typed storefront configuration.
*/
function funkycommerce_storefront_control_settings( $language = '' ) {
- $settings = funkycommerce_control_center_settings();
- $enabled = static fn( $key, $default = 'yes' ) => $default === ( $settings[ $key ] ?? $default );
- $language = sanitize_key( $language );
+ $settings = funkycommerce_control_center_settings();
+ $enabled = static fn( $key, $default = 'yes' ) => $default === ( $settings[ $key ] ?? $default );
+ $language = sanitize_key( $language );
$localized_tagline = $language ? ( $settings[ 'store_tagline_' . $language ] ?? '' ) : '';
$localized_promo = $language ? ( $settings[ 'promo_text_' . $language ] ?? '' ) : '';
+ $header_icon_data = funkycommerce_storefront_header_icon_settings( $settings );
+ $iframe_url = funkycommerce_ai_assistant_iframe_url( $settings['ai_assistant_iframe_url'] ?? '' );
+ $saved_settings = (array) get_option( 'funkycommerce_control_center', array() );
+ $has_surface_settings = array_key_exists( 'ai_assistant_show_header', $saved_settings )
+ || array_key_exists( 'ai_assistant_show_footer', $saved_settings )
+ || array_key_exists( 'ai_assistant_show_fixed', $saved_settings );
+ $legacy_placement = (string) ( $saved_settings['ai_assistant_placement'] ?? 'footer' );
+ $assistant_show_header = $has_surface_settings ? 'yes' === $settings['ai_assistant_show_header'] : 'header' === $legacy_placement;
+ $assistant_show_footer = $has_surface_settings ? 'yes' === $settings['ai_assistant_show_footer'] : 'footer' === $legacy_placement;
+ $assistant_show_fixed = $has_surface_settings ? 'yes' === $settings['ai_assistant_show_fixed'] : 'fixed' === $legacy_placement;
+ $assistant_placement = $assistant_show_header ? 'header' : ( $assistant_show_fixed ? 'fixed' : 'footer' );
return array(
'branding' => array(
@@ -289,16 +655,51 @@ function funkycommerce_storefront_control_settings( $language = '' ) {
'tagline' => $localized_tagline ?: ( $settings['store_tagline'] ?: get_bloginfo( 'description' ) ),
'logoUrl' => esc_url_raw( $settings['logo_url'] ),
'iconUrl' => esc_url_raw( $settings['icon_url'] ?: get_site_icon_url() ),
- 'promoText' => $localized_promo ?: ( $settings['promo_text'] ?: __( 'Free shipping over €60 · Dispatch in 24h · 30-day returns', 'funkycommerce-headless' ) ),
+ 'promoHtml' => (string) ( $localized_promo ?: $settings['promo_text'] ),
+ 'promoText' => wp_strip_all_tags( (string) ( $localized_promo ?: $settings['promo_text'] ) ),
+ ),
+ 'headerIcons' => $header_icon_data['icons'],
+ 'headerIconMedia' => $header_icon_data['media'],
+ 'aiAssistant' => array(
+ 'enabled' => 'yes' === ( $settings['ai_assistant_enabled'] ?? 'no' ),
+ 'provider' => 'native-first',
+ 'placement' => $assistant_placement,
+ 'showHeader' => $assistant_show_header,
+ 'showFooter' => $assistant_show_footer,
+ 'showFixed' => $assistant_show_fixed,
+ 'nativeProviderActive' => funkycommerce_ai_assistant_native_provider_active(),
+ 'iframeUrl' => '' !== $iframe_url ? $iframe_url : null,
+ 'iframeTitle' => funkycommerce_ai_assistant_iframe_title( $settings['ai_assistant_iframe_title'] ?? '' ),
+ 'iframeSandbox' => funkycommerce_ai_assistant_iframe_sandbox(),
+ 'iframeReferrerPolicy' => funkycommerce_ai_assistant_iframe_referrer_policy(),
),
- 'headerIcons' => array(
- 'search' => $settings['header_icon_search'],
- 'theme' => $settings['header_icon_theme'],
- 'account' => $settings['header_icon_account'],
- 'readingList' => $settings['header_icon_reading_list'],
- 'wishlist' => $settings['header_icon_wishlist'],
- 'cart' => $settings['header_icon_cart'],
- 'menu' => $settings['header_icon_menu'],
+ 'footer' => array(
+ 'socialLinks' => funkycommerce_clean_social_links( $settings['social_links'] ?? array() ),
+ 'newsletterHeading' => (string) ( $settings['newsletter_heading'] ?? '' ),
+ 'newsletterText' => (string) ( $settings['newsletter_text'] ?? '' ),
+ 'newsletterPrivacyLabel' => (string) ( $settings['newsletter_privacy_label'] ?? '' ),
+ 'extraHtml' => (string) ( $settings['footer_extra_content'] ?? '' ),
+ 'copyrightText' => (string) ( $settings['copyright_text'] ?? '' ),
+ 'spotifyPlaylistUrl' => funkycommerce_normalize_spotify_playlist_url( $settings['spotify_playlist_url'] ?? '' ),
+ 'spotifyPlaylistEmbedUrl' => funkycommerce_spotify_playlist_embed_url( $settings['spotify_playlist_url'] ?? '' ),
+ 'spotifyPlayerTitle' => sanitize_text_field( (string) ( $settings['spotify_player_title'] ?? '' ) ),
+ 'spotifyPlayerDescription' => sanitize_textarea_field( (string) ( $settings['spotify_player_description'] ?? '' ) ),
+ ),
+ 'recentOrders' => array(
+ 'enabled' => funkycommerce_is_pro() && 'yes' === ( $settings['recent_orders_enabled'] ?? 'no' ),
+ 'itemCount' => max( 1, min( 10, (int) ( $settings['recent_orders_item_count'] ?? 5 ) ) ),
+ 'intervalSeconds' => max( 3, min( 300, (int) ( $settings['recent_orders_interval_seconds'] ?? 10 ) ) ),
+ 'quietSeconds' => max( 2, min( 300, (int) ( $settings['recent_orders_quiet_seconds'] ?? 8 ) ) ),
+ 'openLinksInNewTab' => 'yes' === ( $settings['recent_orders_links_new_tab'] ?? 'yes' ),
+ ),
+ 'loading' => array(
+ 'enabled' => 'yes' === ( $settings['loader_enabled'] ?? 'yes' ),
+ 'customUrl' => esc_url_raw( $settings['loader_custom_url'] ?? '' ),
+ 'size' => (int) ( $settings['loader_size'] ?? 44 ),
+ 'speed' => (int) ( $settings['loader_speed'] ?? 1400 ),
+ 'primaryColor' => (string) ( $settings['loader_primary_color'] ?? '#7c3aed' ),
+ 'glowColor' => (string) ( $settings['loader_glow_color'] ?? '#c4b5fd' ),
+ 'glowOpacity' => (float) ( $settings['loader_glow_opacity'] ?? 0.55 ),
),
'features' => array(
'promo' => $enabled( 'promo_enabled' ),
@@ -309,11 +710,29 @@ function funkycommerce_storefront_control_settings( $language = '' ) {
'wishlist' => $enabled( 'wishlist_enabled' ),
'readingList' => $enabled( 'reading_list_enabled' ),
'cart' => $enabled( 'cart_enabled' ),
+ 'push' => funkycommerce_is_pro() && $enabled( 'push_enabled' ),
'communityProfiles' => $enabled( 'community_profiles_public_enabled' ),
'communityFollowers' => $enabled( 'community_followers_enabled' ),
+ 'quickView' => $enabled( 'product_card_quick_view' ),
'crypto' => function_exists( 'funkycommerce_crypto_is_enabled' ) && funkycommerce_crypto_is_enabled(),
),
+ 'payments' => array(
+ 'blikEnabled' => funkycommerce_is_pro() && 'yes' === ( $settings['blik_enabled'] ?? 'no' ),
+ ),
+ 'productPresentation' => array(
+ 'noPriceBehavior' => (string) $settings['products_no_price_behavior'],
+ 'inquiryHeading' => (string) $settings['product_inquiry_heading'],
+ 'inquiryButtonLabel' => (string) $settings['product_inquiry_button_label'],
+ 'inquiryCopy' => (string) $settings['product_inquiry_copy'],
+ ),
+ 'codeHighlighting' => array(
+ 'lightTheme' => (string) $settings['prism_theme_light'],
+ 'darkTheme' => (string) $settings['prism_theme_dark'],
+ ),
+ 'stripeCustomerPortalUrl' => esc_url_raw( $settings['stripe_customer_portal_url'] ),
'checkout' => array(
+ 'accountMode' => in_array( $settings['checkout_account_mode'] ?? 'optional', array( 'guest', 'optional', 'required' ), true ) ? $settings['checkout_account_mode'] : 'optional',
+ 'distractionFree' => 'yes' === ( $settings['checkout_distraction_free'] ?? 'no' ),
'heading' => (string) $settings['checkout_heading'],
'intro' => (string) $settings['checkout_intro'],
'trustMessage' => (string) $settings['checkout_trust_message'],
@@ -327,24 +746,61 @@ function funkycommerce_storefront_control_settings( $language = '' ) {
}
/**
- * Add the Control Center below Appearance.
+ * Add the top-level Superfunky administration section.
*/
function funkycommerce_add_control_center_page() {
- add_theme_page(
- __( 'FunkyCommerce Control Center', 'funkycommerce-headless' ),
- __( 'FunkyCommerce', 'funkycommerce-headless' ),
+ add_menu_page(
+ __( 'Superfunky Control Center', 'funkycommerce-headless' ),
+ __( 'Superfunky', 'funkycommerce-headless' ),
+ 'manage_options',
+ 'funkycommerce-control-center',
+ 'funkycommerce_render_control_center',
+ 'dashicons-superhero-alt',
+ 59
+ );
+ add_submenu_page(
+ 'funkycommerce-control-center',
+ __( 'Superfunky Control Center', 'funkycommerce-headless' ),
+ __( 'Control Center', 'funkycommerce-headless' ),
'manage_options',
'funkycommerce-control-center',
'funkycommerce_render_control_center'
);
}
-add_action( 'admin_menu', 'funkycommerce_add_control_center_page' );
+add_action( 'admin_menu', 'funkycommerce_add_control_center_page', 5 );
+
+/**
+ * Redirect the old Appearance and Settings page locations to their top-level
+ * Superfunky equivalents while retaining the stable internal page slugs.
+ */
+function funkycommerce_redirect_legacy_admin_pages() {
+ if ( ! is_admin() || ! current_user_can( 'manage_options' ) ) {
+ return;
+ }
+ global $pagenow;
+ $page = sanitize_key( wp_unslash( $_GET['page'] ?? '' ) );
+ $legacy_locations = array(
+ 'themes.php' => array(
+ 'funkycommerce-control-center' => 'funkycommerce-control-center',
+ 'funkycommerce-newsletter-submissions' => 'funkycommerce-newsletter-submissions',
+ 'funkycommerce-form-submissions' => 'funkycommerce-form-submissions',
+ 'superfunky-web-push' => 'funkycommerce-web-push',
+ ),
+ 'options-general.php' => array( 'superfunky-pro-licence' => 'superfunky-pro-licence' ),
+ );
+ if ( ! isset( $legacy_locations[ $pagenow ][ $page ] ) ) {
+ return;
+ }
+ wp_safe_redirect( add_query_arg( 'page', $legacy_locations[ $pagenow ][ $page ], admin_url( 'admin.php' ) ) );
+ exit;
+}
+add_action( 'admin_init', 'funkycommerce_redirect_legacy_admin_pages' );
/**
* Load admin media and code-editor dependencies only on the Control Center.
*/
function funkycommerce_control_center_assets( $hook_suffix ) {
- if ( 'appearance_page_funkycommerce-control-center' !== $hook_suffix ) {
+ if ( 'toplevel_page_funkycommerce-control-center' !== $hook_suffix ) {
return;
}
wp_enqueue_media();
@@ -358,6 +814,9 @@ function funkycommerce_control_center_assets( $hook_suffix ) {
* Report whether a saved field is currently consumed by theme runtime code.
*/
function funkycommerce_control_field_is_live( $key ) {
+ if ( str_starts_with( $key, 'layout_' ) ) {
+ return true;
+ }
if ( preg_match( '/^(store_tagline|promo_text|ui_strings)_[a-z0-9_-]+$/', $key ) ) {
return true;
}
@@ -368,6 +827,10 @@ function funkycommerce_control_field_is_live( $key ) {
'logo_url',
'icon_url',
'promo_text',
+ 'copyright_text',
+ 'footer_extra_content',
+ 'prism_theme_light',
+ 'prism_theme_dark',
'header_icon_search',
'header_icon_theme',
'header_icon_account',
@@ -375,6 +838,13 @@ function funkycommerce_control_field_is_live( $key ) {
'header_icon_wishlist',
'header_icon_cart',
'header_icon_menu',
+ 'ai_assistant_enabled',
+ 'ai_assistant_show_header',
+ 'ai_assistant_show_footer',
+ 'ai_assistant_show_fixed',
+ 'ai_assistant_iframe_url',
+ 'ai_assistant_iframe_title',
+ 'social_links',
'custom_css',
'checkout_heading',
'checkout_intro',
@@ -388,7 +858,12 @@ function funkycommerce_control_field_is_live( $key ) {
'currency_rate_mode',
'currency_manual_rates',
'order_prefix',
- 'stripe_publishable_key',
+ 'products_no_price_behavior',
+ 'product_inquiry_heading',
+ 'product_inquiry_button_label',
+ 'product_inquiry_copy',
+ 'product_card_quick_view',
+ 'stripe_customer_portal_url',
'default_content_language',
'community_multilingual',
'inherit_comment_language',
@@ -453,8 +928,19 @@ function funkycommerce_control_field_is_live( $key ) {
'login_link_color',
'login_wave_background',
'login_footer_text',
+ 'svg_upload_enabled',
+ 'content_scripts_posts_enabled',
+ 'content_scripts_pages_enabled',
+ 'content_scripts_products_enabled',
'hide_visit_store',
);
+
+ foreach ( function_exists( 'funkycommerce_header_icon_definitions' ) ? funkycommerce_header_icon_definitions() : array() as $definition ) {
+ $setting_key = $definition['settingKey'];
+ $live_fields[] = 'header_icon_' . $setting_key;
+ $live_fields[] = 'header_icon_' . $setting_key . '_media_url';
+ }
+
return in_array( $key, $live_fields, true );
}
@@ -470,6 +956,36 @@ function funkycommerce_control_coverage_counts() {
return $counts;
}
+/**
+ * Render one repeatable social-profile row.
+ */
+function funkycommerce_render_social_link_row( $name, $index, $link = array() ) {
+ $platforms = funkycommerce_supported_social_icons();
+ $platform = sanitize_key( (string) ( $link['platform'] ?? '' ) );
+ $row_id = (string) ( $link['id'] ?? '' );
+ $url = (string) ( $link['url'] ?? '' );
+ $label = (string) ( $link['label'] ?? '' );
+ $id_prefix = 'fc-social-' . $index;
+ ?>
+
+
+
+
+
+
+
+