.", Talkward prüft ±5 Minuten). * * @package Talkward */ defined( 'ABSPATH' ) || exit; class Talkward_Api { const OPTION = 'talkward_verbindung'; /** Gespeicherte Verbindung: konto, geheimnis, marke, widget_schluessel, widget_url, seit, daten, daten_ab. */ public static function verbindung(): array { $v = get_option( self::OPTION, array() ); return is_array( $v ) ? $v : array(); } public static function verbunden(): bool { $v = self::verbindung(); return ! empty( $v['konto'] ) && ! empty( $v['geheimnis'] ); } /** * Nimmt Talkward Bestellungen an? Verbinden und Chat gehen in jedem Tarif, die Bestelldaten erst ab einem * höheren (Talkward meldet das beim Verbinden und bei jedem Status). Ohne Angabe (ältere Verbindung): ja. */ public static function daten(): bool { $v = self::verbindung(); return self::verbunden() && ( ! array_key_exists( 'daten', $v ) || ! empty( $v['daten'] ) ); } /** Name des Tarifs, ab dem es die Bestelldaten gibt (für den Hinweis auf der Admin-Seite). */ public static function daten_ab(): string { return (string) ( self::verbindung()['daten_ab'] ?? '' ); } /** Antwort von Talkward auswerten: `daten` und `daten_ab` in der Verbindung merken. */ public static function daten_merken( array $antwort ): void { if ( ! array_key_exists( 'daten', $antwort ) || ! self::verbunden() ) { return; } $v = self::verbindung(); $v['daten'] = ! empty( $antwort['daten'] ); $v['daten_ab'] = sanitize_text_field( $antwort['daten_ab'] ?? ( $v['daten_ab'] ?? '' ) ); update_option( self::OPTION, $v, false ); } public static function url( string $pfad = '' ): string { return rtrim( TALKWARD_URL, '/' ) . $pfad; } /** Die Seite, wie Talkward sie kennt (ohne Schema-Abweichungen). */ public static function seite(): string { return untrailingslashit( home_url() ); } public static function umgebung(): array { global $wp_version; return array( 'version' => TALKWARD_VERSION, 'wc' => defined( 'WC_VERSION' ) ? WC_VERSION : '', 'wp' => (string) $wp_version, ); } /** * Einmal-Code aus dem Rückweg gegen Konto + Geheimnis tauschen. * * @return true|WP_Error */ public static function verbinden( string $code ) { $antwort = wp_remote_post( self::url( '/api/woo-plugin/verbinden' ), array( 'timeout' => 20, 'headers' => array( 'Content-Type' => 'application/json' ), 'body' => wp_json_encode( array_merge( array( 'code' => $code, 'seite' => self::seite() ), self::umgebung() ) ), ) ); $d = self::auswerten( $antwort ); if ( is_wp_error( $d ) ) { return $d; } update_option( self::OPTION, array( 'konto' => sanitize_text_field( $d['konto'] ?? '' ), 'geheimnis' => sanitize_text_field( $d['geheimnis'] ?? '' ), 'marke' => array( 'key' => sanitize_key( $d['marke']['key'] ?? '' ), 'name' => sanitize_text_field( $d['marke']['name'] ?? '' ), ), 'widget_schluessel' => sanitize_text_field( $d['widget_schluessel'] ?? '' ), 'widget_url' => esc_url_raw( $d['widget_url'] ?? '' ), 'seit' => time(), 'daten' => ! array_key_exists( 'daten', $d ) || ! empty( $d['daten'] ), 'daten_ab' => sanitize_text_field( $d['daten_ab'] ?? '' ), ), false ); return true; } /** * Signierte Anfrage an /api/woo-plugin/. * * @return array|WP_Error Antwort als Array; Code talkward_getrennt, wenn Talkward die Verbindung nicht mehr kennt. */ public static function senden( string $pfad, array $daten, int $timeout = 30 ) { $v = self::verbindung(); if ( empty( $v['konto'] ) || empty( $v['geheimnis'] ) ) { return new WP_Error( 'talkward_getrennt', __( 'Not connected to Talkward.', 'talkward' ) ); } $body = wp_json_encode( $daten ); $zeit = (string) time(); $antwort = wp_remote_post( self::url( '/api/woo-plugin/' . ltrim( $pfad, '/' ) ), array( 'timeout' => $timeout, 'headers' => array( 'Content-Type' => 'application/json', 'X-Talkward-Konto' => $v['konto'], 'X-Talkward-Zeit' => $zeit, 'X-Talkward-Signatur' => hash_hmac( 'sha256', $zeit . '.' . $body, $v['geheimnis'] ), ), 'body' => $body, ) ); $d = self::auswerten( $antwort ); if ( is_wp_error( $d ) && in_array( $d->get_error_code(), array( 'woocommerce.getrennt', 'woocommerce.signatur_ungueltig' ), true ) ) { // In Talkward getrennt oder Schlüssel ersetzt: lokal aufräumen, die Admin-Seite erklärt es. self::lokal_trennen( 'remote' ); return new WP_Error( 'talkward_getrennt', __( 'The connection was ended in Talkward.', 'talkward' ) ); } return $d; } /** @return array|WP_Error */ private static function auswerten( $antwort ) { if ( is_wp_error( $antwort ) ) { return $antwort; } $code = (int) wp_remote_retrieve_response_code( $antwort ); $d = json_decode( (string) wp_remote_retrieve_body( $antwort ), true ); if ( $code >= 200 && $code < 300 && is_array( $d ) ) { return $d; } $fehler = is_array( $d ) && ! empty( $d['fehler'] ) ? (string) $d['fehler'] : 'http_' . $code; return new WP_Error( $fehler, self::fehlertext( $fehler ), array( 'status' => $code ) ); } public static function fehlertext( string $fehler ): string { $texte = array( 'woocommerce.code_ungueltig' => __( 'The connection code has expired or was already used. Please start again.', 'talkward' ), 'woocommerce.getrennt' => __( 'The connection was ended in Talkward.', 'talkward' ), ); /* translators: %s: technical error code */ return $texte[ $fehler ] ?? sprintf( __( 'Talkward could not be reached (%s).', 'talkward' ), $fehler ); } /** Verbindung lokal vergessen; $grund merken für den Hinweis auf der Admin-Seite. */ public static function lokal_trennen( string $grund = '' ): void { delete_option( self::OPTION ); delete_option( Talkward_Sync::OPTION_STAND ); if ( $grund ) { update_option( 'talkward_getrennt_grund', $grund, false ); } if ( function_exists( 'as_unschedule_all_actions' ) ) { as_unschedule_all_actions( '', array(), 'talkward' ); } wp_clear_scheduled_hook( 'talkward_status' ); } }