[FEATURE] Provide ways to work with automated tests

Classes/Configuration.php

@@ -4,10 +4,12 @@
 
 namespace StudioMitte\FriendlyCaptcha;
 
+use Psr\Http\Message\RequestInterface;
 use TYPO3\CMS\Core\Core\Environment;
-use TYPO3\CMS\Core\Site\Entity\NullSite;
+use TYPO3\CMS\Core\Http\ServerRequest;
 use TYPO3\CMS\Core\Site\Entity\Site;
 use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Utility\DebuggerUtility;
 
 class Configuration
 {
@@ -25,7 +27,7 @@ public function __construct(Site $site = null)
         if ($site === null) {
             $site = $GLOBALS['TYPO3_REQUEST']->getAttribute('site');
         }
-        if ($site === null || $site instanceof NullSite) {
+        if ($site === null) {
             return;
         }
         $siteConfiguration = $site->getConfiguration();
@@ -39,7 +41,7 @@ public function __construct(Site $site = null)
 
     public function isEnabled(): bool
     {
-        return $this->siteKey !== '' && $this->siteSecretKey !== '' && $this->puzzleUrl !== '' && $this->verifyUrl !== '';
+        return $this->siteKey !== '' && $this->siteSecretKey !== '' && $this->puzzleUrl !== '' && $this->verifyUrl !== '' && !$this->hasSkipHeaderValidation();
     }
 
     public function getSiteKey(): string
@@ -77,4 +79,15 @@ public function hasSkipDevValidation(): bool
     {
         return Environment::getContext()->isDevelopment() && $this->skipDevValidation;
     }
+
+    public function hasSkipHeaderValidation(): bool
+    {
+        /** @var ServerRequest $request */
+        $request = $GLOBALS['TYPO3_REQUEST'];
+        $validationName = (string)($_ENV['FRIENDLYCAPTCHA_SKIP_HEADER_VALIDATION'] ?? '');
+        if (strlen($validationName) < 30) {
+            return false;
+        }
+        return $request && $request->hasHeader('X-FriendlyCaptcha-Skip-Validation') && in_array($validationName, $request->getHeader('X-FriendlyCaptcha-Skip-Validation'), truex);
+    }
 }

Documentation/Configuration/Integration.rst

@@ -24,3 +24,11 @@ A new tab **Friendly Captcha** is available which includes all configuration opt
     After finishing the configuration, you are ready to use Friendly Captcha on your site.
 
     This is described in the :ref:`using` section!
+
+
+Working with automated tests
+============================
+If you are using automated tests you might want to skip the captcha.
+This can be achieved by setting the folloowing ENV variable `FRIENDLYCAPTCHA_SKIP_HEADER_VALIDATION` to a string with minimum length of 30.
+
+Now provide the same string with with the request header `X-FriendlyCaptcha-Skip-Validation`.