settings = $settings; $this->registerProviders(); } /** * Register built-in providers */ private function registerProviders() { $this->registerProvider( new RecaptchaProvider() ); $this->registerProvider( new HCaptchaProvider() ); $this->registerProvider( new TurnstileProvider() ); // Allow custom providers via filter $this->providers = apply_filters( 'subtleforms/captcha/providers', $this->providers ); } /** * Register a CAPTCHA provider * * @param CaptchaProviderInterface $provider */ public function registerProvider( CaptchaProviderInterface $provider ) { $this->providers[ $provider->getName() ] = $provider; } /** * Check if CAPTCHA is enabled globally * * @return bool */ public function isEnabled() { $enabled = (bool) $this->settings->get( 'captcha_enabled', false ); return apply_filters( 'subtleforms/captcha/enabled', $enabled ); } /** * Get active provider name (DEPRECATED - use getConfiguredProviders) * * @deprecated 1.7.2 Use getConfiguredProviders() instead * @return string */ public function getActiveProviderName() { $provider = $this->settings->get( 'captcha_provider', '' ); return apply_filters( 'subtleforms/captcha/provider', $provider ); } /** * Get active provider instance (DEPRECATED - use getProviderByType) * * @deprecated 1.7.2 Use getProviderByType() instead * @return CaptchaProviderInterface|null */ public function getActiveProvider() { if ( ! $this->isEnabled() ) { return null; } $provider_name = $this->getActiveProviderName(); if ( empty( $provider_name ) || ! isset( $this->providers[ $provider_name ] ) ) { return null; } return $this->providers[ $provider_name ]; } /** * Get all configured providers * * @return array Array of provider names that are enabled AND configured */ public function getConfiguredProviders() { if ( ! $this->isEnabled() ) { return array(); } $configured = array(); foreach ( $this->providers as $name => $provider ) { if ( $this->isProviderEnabled( $name ) && $this->isProviderConfigured( $name ) ) { $configured[] = $name; } } return $configured; } /** * Check if a specific provider is enabled * * @param string $type Provider type (recaptcha, hcaptcha, turnstile) * @return bool */ public function isProviderEnabled( $type ) { $setting_key = 'captcha_' . $type . '_enabled'; return (bool) $this->settings->get( $setting_key, false ); } /** * Get provider instance by type * * @param string $type Provider type (recaptcha, hcaptcha, turnstile) * @return CaptchaProviderInterface|null */ public function getProviderByType( $type ) { return $this->providers[ $type ] ?? null; } /** * Check if a specific provider is properly configured * * @param string $type Provider type (recaptcha, hcaptcha, turnstile) * @return bool */ public function isProviderConfigured( $type ) { $provider = $this->getProviderByType( $type ); if ( ! $provider ) { return false; } return $provider->isConfigured(); } /** * Check if active provider is properly configured (DEPRECATED) * * @deprecated 1.7.2 Use isProviderConfigured($type) instead * @return bool */ public function isConfigured() { $provider = $this->getActiveProvider(); if ( ! $provider ) { $provider_name = $this->getActiveProviderName(); Logger::error( "SubtleForms CAPTCHA: Provider '{$provider_name}' not found in registered providers" ); return false; } $is_configured = $provider->isConfigured(); if ( ! $is_configured ) { Logger::error( 'CAPTCHA: Provider ' . $provider->getName() . ' is not configured (missing keys)' ); } return $is_configured; } /** * Render CAPTCHA widget * * @return string HTML markup */ public function render() { if ( ! $this->isEnabled() || ! $this->isConfigured() ) { return ''; } $provider = $this->getActiveProvider(); $config = $this->getProviderConfig( $provider->getName() ); Logger::error( 'CAPTCHA: Rendering with config: ' . wp_json_encode( array( 'provider' => $provider->getName(), 'has_site_key' => ! empty( $config['site_key'] ), 'site_key_len' => strlen( $config['site_key'] ?? '' ), 'version' => $config['version'] ?? 'v2', ) ) ); $html = $provider->render( $config ); Logger::debug( 'CAPTCHA: Provider rendered HTML length: ' . strlen( $html ) ); return $html; } /** * Verify CAPTCHA response * * @param array $request Request data containing CAPTCHA response * @param string|null $provider_type Optional specific provider type to verify * @return array ['success' => bool, 'error' => string|null] */ public function verify( $request, $provider_type = null ) { if ( ! $this->isEnabled() ) { return array( 'success' => true ); // CAPTCHA disabled, pass through } // If provider type specified, verify that specific provider if ( $provider_type ) { if ( ! $this->isProviderEnabled( $provider_type ) ) { return array( 'success' => false, 'error' => __( 'CAPTCHA provider is not enabled.', 'subtleforms' ), ); } if ( ! $this->isProviderConfigured( $provider_type ) ) { return array( 'success' => false, 'error' => __( 'CAPTCHA is not properly configured.', 'subtleforms' ), ); } $provider = $this->getProviderByType( $provider_type ); if ( ! $provider ) { return array( 'success' => false, 'error' => __( 'CAPTCHA provider not found.', 'subtleforms' ), ); } return $this->verifyWithProvider( $provider, $request ); } // Legacy behavior: try to detect provider from request $detected_provider = $this->detectProviderFromRequest( $request ); if ( $detected_provider && $this->isProviderEnabled( $detected_provider ) ) { $provider = $this->getProviderByType( $detected_provider ); if ( $provider && $this->isProviderConfigured( $detected_provider ) ) { return $this->verifyWithProvider( $provider, $request ); } } // Fallback to deprecated single-provider behavior if ( ! $this->isConfigured() ) { return array( 'success' => false, 'error' => __( 'CAPTCHA is not properly configured.', 'subtleforms' ), ); } $provider = $this->getActiveProvider(); if ( ! $provider ) { return array( 'success' => false, 'error' => __( 'CAPTCHA provider not found.', 'subtleforms' ), ); } return $this->verifyWithProvider( $provider, $request ); } /** * Detect provider from request payload * * @param array $request * @return string|null Provider type or null if not detected */ private function detectProviderFromRequest( $request ) { if ( isset( $request['g-recaptcha-response'] ) ) { return 'recaptcha'; } if ( isset( $request['h-captcha-response'] ) ) { return 'hcaptcha'; } if ( isset( $request['cf-turnstile-response'] ) ) { return 'turnstile'; } return null; } /** * Verify CAPTCHA with specific provider * * @param CaptchaProviderInterface $provider * @param array $request * @return array ['success' => bool, 'error' => string|null] */ private function verifyWithProvider( $provider, $request ) { $provider_name = $provider->getName(); // Get response token from request $response = $this->extractResponseToken( $request, $provider_name ); if ( empty( $response ) ) { return array( 'success' => false, 'error' => __( 'CAPTCHA verification failed. Please try again.', 'subtleforms' ), ); } // Get secret key $config = $this->getProviderConfig( $provider_name ); $secret_key = $config['secret_key'] ?? ''; if ( empty( $secret_key ) ) { return array( 'success' => false, 'error' => __( 'CAPTCHA secret key is missing.', 'subtleforms' ), ); } // Get client IP $remote_ip = $this->getClientIp(); // Verify with provider return $provider->verify( $response, $secret_key, $remote_ip ); } /** * Get provider configuration * * @param string $provider_name * @return array */ private function getProviderConfig( $provider_name ) { $config = array(); switch ( $provider_name ) { case 'recaptcha': $config = array( 'site_key' => $this->settings->get( 'captcha_recaptcha_site_key', '' ), 'secret_key' => $this->settings->get( 'captcha_recaptcha_secret_key', '' ), 'version' => $this->settings->get( 'captcha_recaptcha_version', 'v2' ), ); break; case 'hcaptcha': $config = array( 'site_key' => $this->settings->get( 'captcha_hcaptcha_site_key', '' ), 'secret_key' => $this->settings->get( 'captcha_hcaptcha_secret_key', '' ), ); break; case 'turnstile': $config = array( 'site_key' => $this->settings->get( 'captcha_turnstile_site_key', '' ), 'secret_key' => $this->settings->get( 'captcha_turnstile_secret_key', '' ), ); break; } return apply_filters( 'subtleforms/captcha/provider_config', $config, $provider_name ); } /** * Extract CAPTCHA response token from request * * @param array $request * @param string $provider_name * @return string */ private function extractResponseToken( $request, $provider_name ) { // Standard field names per provider $field_map = array( 'recaptcha' => 'g-recaptcha-response', 'hcaptcha' => 'h-captcha-response', 'turnstile' => 'cf-turnstile-response', ); $field_name = $field_map[ $provider_name ] ?? ''; if ( empty( $field_name ) ) { return ''; } return $request[ $field_name ] ?? ''; } /** * Get client IP address * * @return string */ private function getClientIp() { return \SubtleForms\Security\ClientIp::get(); } /** * Get JavaScript URL for active provider * * @return string */ /** * Widget HTML for one field, using that field's site key. * * @param string $provider_name Provider slug. * @param string $site_key Site key. * @return string */ public function widgetFor( $provider_name, $site_key ) { $provider = $this->getProviderByType( $provider_name ); if ( ! $provider || ! is_string( $site_key ) || '' === $site_key ) { return ''; } $config = $this->getProviderConfig( $provider_name ); $config['site_key'] = $site_key; return $provider->render( $config ); } /** * Global keys for one provider. Empty strings when Settings has none. * * @param string $provider_name Provider slug. * @return array{site_key: string, secret_key: string} */ public function keysFor( $provider_name ) { $config = $this->getProviderConfig( $provider_name ); return array( 'site_key' => isset( $config['site_key'] ) && is_string( $config['site_key'] ) ? $config['site_key'] : '', 'secret_key' => isset( $config['secret_key'] ) && is_string( $config['secret_key'] ) ? $config['secret_key'] : '', ); } /** * Check a token with a secret that may belong to the field, not Settings. * * @param string $provider_name Provider slug. * @param string $secret Secret key. * @param array $request Submitted values. * @return array{success: bool, error?: string} */ public function verifyField( $provider_name, $secret, array $request ) { $provider = $this->getProviderByType( $provider_name ); if ( ! $provider ) { return array( 'success' => false, 'error' => __( 'CAPTCHA provider not found.', 'subtleforms' ), ); } $response = $this->extractResponseToken( $request, $provider_name ); if ( '' === $response ) { return array( 'success' => false, 'error' => __( 'Please complete the CAPTCHA.', 'subtleforms' ), ); } if ( ! is_string( $secret ) || '' === $secret ) { return array( 'success' => false, 'error' => __( 'CAPTCHA secret key is missing.', 'subtleforms' ), ); } return $provider->verify( $response, $secret, $this->getClientIp() ); } /** * Script URL for one provider, even when Settings has CAPTCHA off. * * @param string $provider_name Provider slug. * @return string */ public function scriptUrlFor( string $provider_name ): string { $provider = $this->getProviderByType( $provider_name ); if ( ! $provider ) { return ''; } $config = $this->getProviderConfig( $provider->getName() ); return (string) $provider->getScriptUrl( $config ); } public function getScriptUrl() { if ( ! $this->isEnabled() || ! $this->isConfigured() ) { return ''; } $provider = $this->getActiveProvider(); $config = $this->getProviderConfig( $provider->getName() ); return $provider->getScriptUrl( $config ); } /** * Get all available providers * * @return array */ public function getProviders() { return $this->providers; } }