ADD default badge in config

enricodelazzari · enricodelazzari · commit acaa9cd4f77f · 2025-10-17T14:40:06.000+02:00
diff --git a/README.md b/README.md
@@ -71,6 +71,18 @@ return [
     |
     */
     'score_threshold' => env('GOOGLE_RECAPTCHA_V3_SCORE_THRESHOLD', 0.5),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Badge
+    |--------------------------------------------------------------------------
+    |
+    | The default badge position for the reCAPTCHA badge.
+    | Available options: 'bottomright', 'bottomleft', 'inline', 'hidden'.
+    | Default is 'bottomright'.
+    |
+    */
+    'badge' => env('GOOGLE_RECAPTCHA_V3_BADGE', 'bottomright'),
 ];
 ```
 
@@ -83,6 +95,7 @@ GOOGLE_RECAPTCHA_V3_ENABLED=true
 GOOGLE_RECAPTCHA_V3_SITE_KEY=your-site-key-here
 GOOGLE_RECAPTCHA_V3_SECRET_KEY=your-secret-key-here
 GOOGLE_RECAPTCHA_V3_SCORE_THRESHOLD=0.5
+GOOGLE_RECAPTCHA_V3_BADGE=bottomright
 ```
 
 You can obtain your site key and secret key from the [Google reCAPTCHA Admin Console](https://www.google.com/recaptcha/admin).
@@ -91,7 +104,13 @@ You can obtain your site key and secret key from the [Google reCAPTCHA Admin Con
 
 ### Frontend Integration
 
-Add the reCAPTCHA script to your Blade templates using the `@recaptcha` directive. You can customize the badge position by passing one of the available badge positions:
+Add the reCAPTCHA script to your Blade templates using the `@recaptcha` directive:
+
+```blade
+@recaptcha
+```
+
+You can also customize the badge position by passing one of the available badge positions:
 
 ```blade
 <!DOCTYPE html>
diff --git a/config/google-recaptcha-v3.php b/config/google-recaptcha-v3.php
@@ -45,4 +45,16 @@
     |
     */
     'score_threshold' => null,
+
+    /*
+    |--------------------------------------------------------------------------
+    | Badge
+    |--------------------------------------------------------------------------
+    |
+    | The default badge position for the reCAPTCHA badge.
+    | Available options: 'bottomright', 'bottomleft', 'inline', 'hidden'.
+    | Default is 'bottomright'.
+    |
+    */
+    'badge' => null,
 ];
diff --git a/src/GoogleRecaptchaV3.php b/src/GoogleRecaptchaV3.php
@@ -13,7 +13,7 @@ class GoogleRecaptchaV3
 {
     public function boot(): void
     {
-        Blade::directive('recaptcha', fn (string $expression) => (
+        Blade::directive('recaptcha', fn (string $expression = '') => (
             "<?php echo app(\Maize\GoogleRecaptchaV3\GoogleRecaptchaV3::class)->renderHtml({$expression}); ?>"
         ));
 
@@ -69,8 +69,10 @@ private function getHiddenBadgeStyle(): string
         CSS;
     }
 
-    public function renderHtml(Badge $badge): string
+    public function renderHtml(?Badge $badge = null): string
     {
+        $badge ??= Config::getBadge();
+
         if (! Config::isEnabled()) {
             return '';
         }
diff --git a/src/Support/Config.php b/src/Support/Config.php
@@ -3,6 +3,7 @@
 namespace Maize\GoogleRecaptchaV3\Support;
 
 use Illuminate\Support\Uri;
+use Maize\GoogleRecaptchaV3\Enums\Badge;
 
 class Config
 {
@@ -53,4 +54,19 @@ public static function getScoreThreshold(): float
 
         return blank($threshold) ? 0.5 : floatval($threshold);
     }
+
+    public static function getBadge(): Badge
+    {
+        $badge = config('google-recaptcha-v3.badge');
+
+        if ($badge instanceof Badge) {
+            return $badge;
+        }
+
+        if (is_string($badge)) {
+            return Badge::tryFrom($badge) ?? Badge::BOTTOMRIGHT;
+        }
+
+        return Badge::BOTTOMRIGHT;
+    }
 }
diff --git a/tests/ConfigTest.php b/tests/ConfigTest.php
@@ -1,5 +1,6 @@
 <?php
 
+use Maize\GoogleRecaptchaV3\Enums\Badge;
 use Maize\GoogleRecaptchaV3\Support\Config;
 
 it('returns base js script url with render parameter', function () {
@@ -94,3 +95,20 @@
     'null defaults to 0.5' => [null, 0.5],
     'empty string defaults to 0.5' => ['', 0.5],
 ]);
+
+it('returns badge correctly', function (mixed $value, Badge $expected) {
+    config()->set('google-recaptcha-v3.badge', $value);
+
+    expect(Config::getBadge())->toBe($expected);
+})->with([
+    'Badge enum BOTTOMRIGHT' => [Badge::BOTTOMRIGHT, Badge::BOTTOMRIGHT],
+    'Badge enum BOTTOMLEFT' => [Badge::BOTTOMLEFT, Badge::BOTTOMLEFT],
+    'Badge enum INLINE' => [Badge::INLINE, Badge::INLINE],
+    'Badge enum HIDDEN' => [Badge::HIDDEN, Badge::HIDDEN],
+    'string bottomright' => ['bottomright', Badge::BOTTOMRIGHT],
+    'string bottomleft' => ['bottomleft', Badge::BOTTOMLEFT],
+    'string inline' => ['inline', Badge::INLINE],
+    'string hidden' => ['hidden', Badge::HIDDEN],
+    'null defaults to BOTTOMRIGHT' => [null, Badge::BOTTOMRIGHT],
+    'invalid string defaults to BOTTOMRIGHT' => ['invalid', Badge::BOTTOMRIGHT],
+]);

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ class GoogleRecaptchaV3`
`13`	`13`	`{`
`14`	`14`	`public function boot(): void`
`15`	`15`	`{`
`16`		`- Blade::directive('recaptcha', fn (string $expression) => (`
	`16`	`+ Blade::directive('recaptcha', fn (string $expression = '') => (`
`17`	`17`	`"<?php echo app(\Maize\GoogleRecaptchaV3\GoogleRecaptchaV3::class)->renderHtml({$expression}); ?>"`
`18`	`18`	`));`
`19`	`19`
`@@ -69,8 +69,10 @@ private function getHiddenBadgeStyle(): string`
`69`	`69`	`CSS;`
`70`	`70`	`}`
`71`	`71`
`72`		`- public function renderHtml(Badge $badge): string`
	`72`	`+ public function renderHtml(?Badge $badge = null): string`
`73`	`73`	`{`
	`74`	`+ $badge ??= Config::getBadge();`
	`75`	`+`
`74`	`76`	`if (! Config::isEnabled()) {`
`75`	`77`	`return '';`
`76`	`78`	`}`