' . esc_html__('Sarcio', 'sarcio') . '

'; $this->renderCheckNotice(); $this->renderStatus(); echo '

'; settings_fields(self::GROUP); $connected = (string) Options::get('site_key') !== '' && (string) Options::get('sidecar_key') !== ''; echo '

' . esc_html($connected ? __('Keys', 'sarcio') : __('Or enter the keys yourself', 'sarcio')) . '

'; echo '

' . esc_html($connected ? __('Connect to Sarcio filled these in. You can also paste keys from your Sarcio dashboard.', 'sarcio') : __('If you would rather copy them from your Sarcio dashboard, paste both keys and save.', 'sarcio')) . '

'; echo ''; do_settings_fields(self::SLUG, 'sarcio_connect'); echo ''; echo '

' . esc_html($titles['sarcio_look']['title'] ?? '') . '

'; echo '

'; echo ''; do_settings_fields(self::SLUG, 'sarcio_look'); echo ''; echo '

' . esc_html($titles['sarcio_assistant']['title'] ?? '') . '

'; echo '

'; echo ''; do_settings_fields(self::SLUG, 'sarcio_assistant'); echo ''; $this->renderLauncherPreview(); echo '

'; echo '

' . esc_html__('Advanced settings', 'sarcio') . '

'; foreach (self::ADVANCED_SECTIONS as $section) { echo '

' . esc_html($titles[$section]['title'] ?? '') . '

'; echo ''; do_settings_fields(self::SLUG, $section); echo ''; } echo '

'; submit_button(__('Save settings', 'sarcio')); echo '

'; } public function checkNow(): void { if (!current_user_can('manage_options')) { wp_die(esc_html__('You are not allowed to do that.', 'sarcio'), 403); } check_admin_referer(self::CHECK_ACTION); $ok = Options::serverTransport() === 'pull' && (new Pull($this->plugin))->run(); wp_safe_redirect(add_query_arg('sarcio-checked', $ok ? '1' : '0', self::url())); exit; } /** @param array{help:string,key:string,link:string,type:string} $args */ public function renderField(array $args): void { $key = $args['key']; $id = 'sarcio_field_' . $key; $name = Options::OPTION . '[' . $key . ']'; $locked = Options::isLocked($key); $value = Options::get($key); $disabled = $locked ? ' disabled' : ''; switch ($args['type']) { case 'checkbox': printf( '', esc_attr($id), esc_attr($name), checked((bool) $value, true, false), esc_attr($disabled), ); break; case 'password': printf( '', esc_attr($id), esc_attr($name), esc_attr((string) $value !== '' ? __('Saved (leave blank to keep it)', 'sarcio') : ''), esc_attr($disabled), ); break; case 'color': printf( '', esc_attr($id), esc_attr($name), esc_attr((string) $value !== '' ? (string) $value : '#10b981'), esc_attr($disabled), ); break; case 'abilities': $disabled = \Sarcio\WordPress\Assistant\Catalog::disabled(); echo '

' . esc_html__('What the assistant may do', 'sarcio') . '

'; printf('', esc_attr(Options::OPTION . '[assistant_switches]')); foreach (\Sarcio\WordPress\Assistant\Catalog::all() as $ability) { printf( ' %5$s (%6$s)', esc_attr(Options::OPTION . '[assistant_enabled][]'), esc_attr($ability->name), checked(!in_array($ability->name, $disabled, true), true, false), esc_attr($disabled !== [] && $locked ? ' disabled' : ($locked ? ' disabled' : '')), esc_html($ability->label), esc_html($ability->kind === \Sarcio\WordPress\Assistant\Ability::WRITE ? __('changes something', 'sarcio') : __('only looks', 'sarcio')), ); } echo '

'; $bridged = \Sarcio\WordPress\Recognised::bridged(); $refused = \Sarcio\WordPress\Assistant\AbilitiesBridge::refused(); if ($bridged !== [] || $refused !== []) { echo '

'; if ($bridged !== []) { echo esc_html(sprintf( /* translators: %s: plugin namespaces with counts. */ __('Other plugins offering their own abilities here: %s.', 'sarcio'), implode(', ', array_map(static fn (string $namespace, int $count): string => $namespace . ' (' . $count . ')', array_keys($bridged), $bridged)), )); } if ($refused !== []) { echo ' ' . esc_html(sprintf( /* translators: %s: ability names. */ __('Never offered, because they run code or read files on the server: %s.', 'sarcio'), implode(', ', $refused), )); } echo '

'; } break; case 'icons': echo '

' . esc_html__('Icon', 'sarcio') . '

'; foreach (Launcher::ICON_LABELS as $icon => $label) { $path = Launcher::ICONS[$icon] !== '' ? Launcher::ICONS[$icon] : self::BUBBLE_PATH; printf( '%1$s', esc_attr($label), esc_attr($name), esc_attr($icon), checked((string) $value, $icon, false), esc_attr($disabled), esc_attr($path), ); } echo '

'; break; case 'select': $labels = self::CHOICE_LABELS[$key] ?? []; printf('', esc_attr($id), esc_attr($name), esc_attr($disabled)); foreach ($labels as $choice => $label) { printf( '%s', esc_attr($choice), selected((string) $value, $choice, false), esc_html($label), ); } echo ''; break; default: printf( '', esc_attr($args['type']), esc_attr($id), esc_attr($name), esc_attr((string) $value), esc_attr($disabled), ); } if ($locked) { echo '

' . esc_html(sprintf( /* translators: %s: PHP constant name. */ __('Set in wp-config.php (%s).', 'sarcio'), Options::CONSTANTS[$key] ?? '', )) . '

'; } if ($args['help'] !== '') { echo '

' . wp_kses($args['help'], ['code' => [], 'strong' => []]); if ($args['link'] !== '') { printf( ' %s', esc_url(self::dashboardUrl($args['link'] === 'keys' ? self::sitePath() : '/sites')), esc_html__('Open your Sarcio dashboard', 'sarcio'), ); } echo '

'; } } private function renderLauncherPreview(): void { $icon = (string) Options::get('launcher_icon'); $path = (Launcher::ICONS[$icon] ?? '') !== '' ? Launcher::ICONS[$icon] : self::BUBBLE_PATH; $color = (string) Options::get('launcher_color') !== '' ? (string) Options::get('launcher_color') : '#10b981'; $classes = trim( (Options::get('launcher_style') === 'label' ? 'is-label ' : '') . (Options::get('launcher_position') === 'left' ? 'is-left' : ''), ); printf( '', Options::get('widget_mode') === 'dark' ? ' is-dark' : '', esc_attr(self::BUBBLE_PATH), esc_html__('Preview', 'sarcio'), esc_attr($classes), esc_attr($color), esc_attr($path), Options::get('launcher_style') === 'label' ? '' : ' hidden', esc_html((string) Options::get('launcher_label')), ); } private static function url(): string { return admin_url('options-general.php?page=' . self::SLUG); } private static function dashboardUrl(string $path): string { $workspace = Embed::workspaceUrl(); return $workspace !== null ? $workspace . $path : Connect::homeUrl() . '/'; } private static function sitePath(): string { $siteKey = (string) Options::get('site_key'); return $siteKey === '' ? '/sites' : '/sites/' . rawurlencode($siteKey); } private function renderConnectButtons(): void { if (!current_user_can('manage_options')) { return; } echo ''; } private function renderUsage(): void { $usage = Usage::get(); if ($usage === null) { return; } echo ''; } private function renderCheckNotice(): void { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only: the outcome of Connect::finish(), which checked its pending marker. $connectError = isset($_GET['sarcio-connect-error']) ? sanitize_key(wp_unslash($_GET['sarcio-connect-error'])) : null; if ($connectError !== null) { $messages = [ 'expired' => __('That connection had expired. Click Connect to Sarcio again.', 'sarcio'), 'keys' => __('This site already has two active secret keys in Sarcio. Revoke one under Sites → Manage → Keys, then connect again.', 'sarcio'), ]; printf( '', esc_html($messages[$connectError] ?? __('Sarcio could not finish connecting this site. Please try again.', 'sarcio')), ); } // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only: the result of checkNow(), which verified its nonce. $checked = isset($_GET['sarcio-checked']) ? sanitize_key(wp_unslash($_GET['sarcio-checked'])) : null; if ($checked === null) { return; } printf( '', $checked === '1' ? 'success' : 'error', esc_html($checked === '1' ? __('Checked with Sarcio: this site has its latest fixes.', 'sarcio') : __('Could not reach Sarcio. Check the secret key; the fixes already on this site keep working.', 'sarcio')), ); } private function renderStatus(): void { $tone = 'ok'; $lines = []; $canCheck = false; $transport = Options::serverTransport(); $shim = $this->plugin->shim(); if ((string) Options::get('site_key') === '') { $tone = 'warning'; $title = __('Not connected yet', 'sarcio'); $lines[] = __('Connect this site with one click. Sarcio fills in the keys for you.', 'sarcio'); } elseif (!Autoloader::shimAvailable()) { $tone = 'error'; $title = __('Connected, but server-side fixes are off', 'sarcio'); $lines[] = __('Part of the plugin is missing. Install it again (the same way you installed it) to turn server-side fixes back on.', 'sarcio'); } elseif ($transport === 'none' || $shim === null) { $tone = 'warning'; $title = __('Connected for page fixes', 'sarcio'); $lines[] = __('The bug reporter and page fixes are on. Connect to Sarcio, or add the secret key, to receive server-side fixes as well.', 'sarcio'); } elseif ($transport === 'sidecar') { $client = Client::connect((string) Options::get('sidecar_dsn'), 1.0); $healthy = $client !== null && $client->health(1.0); $client?->close(); $tone = $healthy ? 'ok' : 'error'; $title = $healthy ? __('Connected to Sarcio through the sidecar', 'sarcio') : __('The Sarcio sidecar is not answering', 'sarcio'); $lines[] = $healthy ? __('New fixes go live within seconds.', 'sarcio') : __('Your site runs as normal, without server-side fixes, until the sidecar is back.', 'sarcio'); $lines[] = $this->activeFixesLine(count($shim->routeSet())); } else { $canCheck = true; $pull = Pull::status(); $title = __('Connected to Sarcio', 'sarcio'); if ($pull === []) { $lines[] = __('Not checked for fixes yet. It happens on its own shortly, or check now.', 'sarcio'); } elseif (!empty($pull['ok'])) { $lines[] = sprintf( /* translators: %s: human time difference, e.g. "2 mins". */ __('Last checked for fixes %s ago.', 'sarcio'), human_time_diff((int) $pull['at']), ); } else { $tone = 'error'; $lines[] = sprintf( /* translators: %s: human time difference, e.g. "2 mins". */ __('The last check, %s ago, could not reach Sarcio. Check the secret key; the fixes already on this site keep working.', 'sarcio'), human_time_diff((int) $pull['at']), ); } $lines[] = $this->activeFixesLine(count($shim->routeSet())); $lines[] = sprintf( /* translators: %d: number of seconds. */ __('New fixes go live within %d seconds of being approved.', 'sarcio'), (int) Options::get('pull_refresh_sec'), ); } if ($transport !== 'none' && Options::get('server_scope') === 'off') { $lines[] = __('Server-side fixes are switched off under Advanced settings.', 'sarcio'); } printf(''; } private function activeFixesLine(int $count): string { return $count === 0 ? __('No server-side fixes active right now.', 'sarcio') : sprintf( /* translators: %d: number of active server-side fixes. */ _n('%d server-side fix active.', '%d server-side fixes active.', $count, 'sarcio'), $count, ); } }