blocks
5 days ago
build
5 days ago
fonts
2 years ago
genericons
6 months ago
lib
5 days ago
shared
5 days ago
accessible-focus.js
6 years ago
blogging-prompts.php
2 months ago
class.jetpack-provision.php
8 months ago
content-guidelines-ai.js
1 month ago
content-guidelines-ai.php
5 days ago
crowdsignal-shortcode.js
1 year ago
crowdsignal-survey.js
6 years ago
deprecate.js
9 months ago
facebook-embed.js
4 years ago
gallery-settings.js
6 years ago
genericons.php
1 year ago
jetpack-admin.js
3 years ago
jetpack-deactivate-dialog.js
1 year ago
jetpack-modules.js
3 weeks ago
jetpack-modules.models.js
3 weeks ago
jetpack-modules.views.js
3 weeks ago
polldaddy-shortcode.js
1 month ago
site-switcher-endpoint.php
7 months ago
site-switcher.jsx
5 days ago
site-switcher.php
6 months ago
social-logos.php
4 months ago
twitter-timeline.js
2 months ago
content-guidelines-ai.php
122 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Content Guidelines AI — Jetpack AI integration. |
| 4 | * |
| 5 | * Enqueues a standalone JS bundle on the Content Guidelines admin page |
| 6 | * that adds AI-powered guideline generation via Jetpack. |
| 7 | * |
| 8 | * @package automattic/jetpack |
| 9 | */ |
| 10 | |
| 11 | use Automattic\Jetpack\Assets; |
| 12 | use Automattic\Jetpack\Status\Host; |
| 13 | use Automattic\Jetpack\Status\Visitor; |
| 14 | use Automattic\Jetpack\Tracking; |
| 15 | |
| 16 | if ( ! defined( 'ABSPATH' ) ) { |
| 17 | exit( 0 ); |
| 18 | } |
| 19 | |
| 20 | /** |
| 21 | * Enqueue content-guidelines-ai script on the Content Guidelines admin page. |
| 22 | * |
| 23 | * @since 16.0 |
| 24 | * |
| 25 | * @param string $hook_suffix The current admin page hook suffix. |
| 26 | */ |
| 27 | function jetpack_content_guidelines_ai_enqueue_scripts( $hook_suffix ) { |
| 28 | if ( 'settings_page_guidelines-wp-admin' !== $hook_suffix ) { |
| 29 | return; |
| 30 | } |
| 31 | |
| 32 | // Content Guidelines AI is only offered on WordPress.com platform sites |
| 33 | // (Simple and Atomic) and WordPress VIP sites — a hard gate the |
| 34 | // jetpack_ai_enabled filter below cannot widen. Free-tier sites still load |
| 35 | // the bundle so the upgrade path can be shown — the paid-plan requirement |
| 36 | // is enforced by the suggest-guidelines API. |
| 37 | $host = new Host(); |
| 38 | if ( ! $host->is_wpcom_platform() && ! $host->is_vip_site() ) { |
| 39 | return; |
| 40 | } |
| 41 | |
| 42 | // Bail when Jetpack AI is disabled for the site: the AI settings master |
| 43 | // switch and other site-wide disables ride this filter. |
| 44 | /** This filter is documented in projects/plugins/jetpack/_inc/lib/class-jetpack-ai-helper.php */ |
| 45 | if ( ! apply_filters( 'jetpack_ai_enabled', true ) ) { |
| 46 | return; |
| 47 | } |
| 48 | |
| 49 | // Bail when build artifacts are missing rather than enqueueing a script |
| 50 | // with guessed (and likely wrong) dependencies. |
| 51 | if ( ! file_exists( JETPACK__PLUGIN_DIR . '_inc/build/content-guidelines-ai.min.asset.php' ) ) { |
| 52 | return; |
| 53 | } |
| 54 | |
| 55 | // The bundle records Tracks events via @automattic/jetpack-analytics, |
| 56 | // which only queues into window._tkq. Enqueue the Tracks client (w.js) |
| 57 | // so events send without relying on whichever platform widgets happen |
| 58 | // to load it. |
| 59 | Tracking::register_tracks_functions_scripts( true ); |
| 60 | |
| 61 | // Handles dependencies/version from the asset file, JS translations for |
| 62 | // the text domain, the CSS (including the .rtl.css variant), and style |
| 63 | // dependencies derived from the script's. |
| 64 | Assets::register_script( |
| 65 | 'jetpack-content-guidelines-ai', |
| 66 | '_inc/build/content-guidelines-ai.min.js', |
| 67 | JETPACK__PLUGIN_FILE, |
| 68 | array( |
| 69 | 'in_footer' => true, |
| 70 | 'textdomain' => 'jetpack', |
| 71 | 'css_path' => '_inc/build/content-guidelines-ai.css', |
| 72 | 'enqueue' => true, |
| 73 | ) |
| 74 | ); |
| 75 | |
| 76 | // Jetpack_AI_Helper backs both preloaded values below: the per-user |
| 77 | // "banner dismissed" flag and the AI feature state. |
| 78 | if ( ! class_exists( 'Jetpack_AI_Helper' ) && is_readable( JETPACK__PLUGIN_DIR . '_inc/lib/class-jetpack-ai-helper.php' ) ) { |
| 79 | require_once JETPACK__PLUGIN_DIR . '_inc/lib/class-jetpack-ai-helper.php'; |
| 80 | } |
| 81 | |
| 82 | // Preload the per-user "banner dismissed" flag so the empty-state banner |
| 83 | // doesn't flash before an async read. Persisted via the |
| 84 | // guidelines-banner-dismissed REST endpoint, but read via Jetpack_AI_Helper |
| 85 | // rather than the endpoint class: on Simple sites the wpcom-endpoints |
| 86 | // classes are only loaded in REST requests, so a class_exists() check on |
| 87 | // the endpoint always failed here and permanently suppressed the banner |
| 88 | // and upgrade notice. |
| 89 | $initial_state = array( |
| 90 | 'bannerDismissed' => class_exists( 'Jetpack_AI_Helper' ) && Jetpack_AI_Helper::is_guidelines_banner_dismissed(), |
| 91 | // Tags every Tracks event fired from this page as internal traffic. The |
| 92 | // feature is new and low-volume, so Automattician testing is otherwise a |
| 93 | // visible share of the numbers with no way to filter it out after the fact. |
| 94 | 'isA11n' => ( new Visitor() )->is_tracking_automattician(), |
| 95 | ); |
| 96 | |
| 97 | // Resolve the AI feature state server-side so the bundle can hydrate the |
| 98 | // wordpress-com/plans store at boot and render the correct locked/unlocked |
| 99 | // buttons on first paint, with no client-side plan fetch. On WordPress.com |
| 100 | // Simple this is a synchronous local lookup; on Atomic/self-hosted it is |
| 101 | // transient-cached with a blocking remote refresh when cold. On failure |
| 102 | // the key is omitted and the bundle renders no AI UI for this load (fail |
| 103 | // closed) rather than guessing. |
| 104 | if ( class_exists( 'Jetpack_AI_Helper' ) ) { |
| 105 | $ai_feature = Jetpack_AI_Helper::get_ai_assistance_feature(); |
| 106 | if ( ! is_wp_error( $ai_feature ) ) { |
| 107 | $initial_state['aiFeature'] = $ai_feature; |
| 108 | } |
| 109 | } |
| 110 | |
| 111 | wp_add_inline_script( |
| 112 | 'jetpack-content-guidelines-ai', |
| 113 | 'window.jetpackContentGuidelinesAi = ' . wp_json_encode( |
| 114 | $initial_state, |
| 115 | JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT |
| 116 | ) . ';', |
| 117 | 'before' |
| 118 | ); |
| 119 | } |
| 120 | |
| 121 | add_action( 'admin_enqueue_scripts', 'jetpack_content_guidelines_ai_enqueue_scripts' ); |
| 122 |