' . esc_html__( 'Quando BitHub Accessibility è abilitato, il browser del visitatore invia ai server BitHub la chiave pubblica del servizio e il dominio del sito. Come per ogni richiesta HTTP, i server possono ricevere dati tecnici quali indirizzo IP e user agent. Se la licenza è valida, viene caricato il widget dal dominio licence.bithub.it. Un token temporaneo può essere memorizzato nel sessionStorage del browser per ridurre le verifiche ripetute.', 'bithub-accessibility' ) . '

' . sprintf( /* translators: %s: BitHub website link. */ wp_kses_post( __( 'Il servizio è fornito da BitHub. Consulta anche l’informativa privacy di BitHub. Il titolare del sito deve descrivere questo trattamento nella propria informativa.', 'bithub-accessibility' ) ), esc_url( 'https://www.bithub.it/' ), esc_url( 'https://www.bithub.it/privacy-cookie/' ) ) . '

'; wp_add_privacy_policy_content( esc_html__( 'BitHub Accessibility', 'bithub-accessibility' ), wp_kses_post( wpautop( $content, false ) ) ); } /** * Adds the settings link to the Plugins screen. * * @param string[] $links Existing action links. * @return string[] */ public function add_plugin_action_links( $links ) { $settings_link = sprintf( '%s', esc_url( $this->get_settings_page_url() ), esc_html__( 'Impostazioni', 'bithub-accessibility' ) ); array_unshift( $links, $settings_link ); return $links; } /** * Adds the page under the Settings menu. * * @return void */ public function add_settings_page() { add_options_page( esc_html__( 'BitHub Accessibility', 'bithub-accessibility' ), esc_html__( 'BitHub Accessibility', 'bithub-accessibility' ), 'manage_options', self::PAGE_SLUG, array( $this, 'render_settings_page' ) ); } /** * Registers settings, sections, and fields. * * @return void */ public function register_settings() { register_setting( self::SETTINGS_GROUP, BitHub_Accessibility::OPTION_NAME, array( 'type' => 'array', 'sanitize_callback' => array( $this, 'sanitize_settings' ), 'default' => array(), ) ); add_settings_section( 'bithub_accessibility_connection', esc_html__( 'Collegamento al servizio', 'bithub-accessibility' ), array( $this, 'render_connection_section' ), self::PAGE_SLUG ); add_settings_field( 'bithub_accessibility_license_key', esc_html__( 'Chiave di licenza', 'bithub-accessibility' ), array( $this, 'render_license_key_field' ), self::PAGE_SLUG, 'bithub_accessibility_connection' ); add_settings_field( 'bithub_accessibility_service_consent', esc_html__( 'Servizio esterno', 'bithub-accessibility' ), array( $this, 'render_service_consent_field' ), self::PAGE_SLUG, 'bithub_accessibility_connection' ); add_settings_field( 'bithub_accessibility_enabled', esc_html__( 'Widget', 'bithub-accessibility' ), array( $this, 'render_enabled_field' ), self::PAGE_SLUG, 'bithub_accessibility_connection' ); } /** * Validates and normalizes all settings. * * @param mixed $input Submitted option value. * @return array{license_key:string,enabled:int,service_consent:int} */ public function sanitize_settings( $input ) { $input = is_array( $input ) ? $input : array(); $key = isset( $input['license_key'] ) ? sanitize_text_field( wp_unslash( $input['license_key'] ) ) : ''; $key = strtoupper( trim( $key ) ); if ( '' !== $key && ! preg_match( '/^[A-Z0-9-]{8,32}$/', $key ) ) { add_settings_error( BitHub_Accessibility::OPTION_NAME, 'bithub_accessibility_invalid_key', esc_html__( 'La chiave deve contenere da 8 a 32 caratteri: lettere, numeri e trattini.', 'bithub-accessibility' ), 'error' ); $key = ''; } $consent = empty( $input['service_consent'] ) ? 0 : 1; $enabled = empty( $input['enabled'] ) ? 0 : 1; if ( $enabled && ( '' === $key || ! $consent ) ) { $enabled = 0; add_settings_error( BitHub_Accessibility::OPTION_NAME, 'bithub_accessibility_incomplete_settings', esc_html__( 'Per abilitare il widget devi inserire la chiave e accettare il collegamento al servizio esterno.', 'bithub-accessibility' ), 'error' ); } return array( 'license_key' => $key, 'enabled' => $enabled, 'service_consent' => $consent, ); } /** * Prints the settings page. * * @return void */ public function render_settings_page() { if ( ! current_user_can( 'manage_options' ) ) { return; } $settings = BitHub_Accessibility::get_settings(); ?>

render_verification_notice(); ?>


%s

', esc_html__( 'Quando il widget è abilitato, il browser dei visitatori contatta i server BitHub per verificare il dominio e caricare il widget. Nessuna chiamata viene effettuata finché non abiliti esplicitamente il servizio.', 'bithub-accessibility' ) ); } /** * Prints the license key input. * * @return void */ public function render_license_key_field() { $settings = BitHub_Accessibility::get_settings(); printf( '', esc_attr( BitHub_Accessibility::OPTION_NAME ), esc_attr( $settings['license_key'] ) ); echo '

' . esc_html__( 'La chiave è visibile nel sito e non è considerata una password.', 'bithub-accessibility' ) . '

'; } /** * Prints the external service consent checkbox. * * @return void */ public function render_service_consent_field() { $settings = BitHub_Accessibility::get_settings(); ?>

10, 'redirection' => 0, 'headers' => array( 'Content-Type' => 'application/json' ), 'body' => wp_json_encode( array( 'key' => $settings['license_key'], 'domain' => BitHub_Accessibility::get_site_domain(), ) ), ) ); if ( is_wp_error( $response ) ) { $status = 'unavailable'; } else { $code = wp_remote_retrieve_response_code( $response ); $body = json_decode( wp_remote_retrieve_body( $response ), true ); if ( 200 === $code && is_array( $body ) && ! empty( $body['ok'] ) ) { $status = 'valid'; } elseif ( 403 === $code ) { $status = 'denied'; } else { $status = 'unavailable'; } } } wp_safe_redirect( add_query_arg( 'bithub_status', $status, $this->get_settings_page_url() ) ); exit; } /** * Prints the result of an explicit license verification. * * @return void */ private function render_verification_notice() { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only status set by our nonce-protected redirect. $status = isset( $_GET['bithub_status'] ) ? sanitize_key( wp_unslash( $_GET['bithub_status'] ) ) : ''; $notices = array( 'valid' => array( 'success', __( 'Licenza valida per questo dominio.', 'bithub-accessibility' ) ), 'denied' => array( 'error', __( 'Licenza non valida, non attiva, scaduta o associata a un altro dominio.', 'bithub-accessibility' ) ), 'unavailable' => array( 'warning', __( 'Il servizio BitHub non è raggiungibile oppure ha restituito una risposta non valida.', 'bithub-accessibility' ) ), 'incomplete' => array( 'warning', __( 'Inserisci la chiave e accetta il collegamento al servizio prima della verifica.', 'bithub-accessibility' ) ), ); if ( ! isset( $notices[ $status ] ) ) { return; } printf( '

%2$s

', esc_attr( $notices[ $status ][0] ), esc_html( $notices[ $status ][1] ) ); } /** * Returns the absolute settings URL. * * @return string */ private function get_settings_page_url() { return admin_url( 'options-general.php?page=' . self::PAGE_SLUG ); } }