- added also contains

README.md

@@ -34,7 +34,7 @@ php artisan vendor:publish --tag="utm-parameter"
 
 ### Middleware Configuration
 
-Once the package is installed, you need to add the UtmParameters middleware to your Laravel application. Open the `bootstrap/app.php` file and append the `UtmParameters::class` inside the web-group. Also, take a look at how to set an [alias for the middleware](https://github.com/toni-suarez/laravel-utm-parameter/wiki/Installation-Guide#step-3-alias-configuration-optional).
+Once the package is installed, you need to add the UtmParameters middleware to your Laravel application. Open the `bootstrap/app.php` file and append the `UtmParameters::class` inside the web-group.
 
 ```php
 # Laravel 11
@@ -49,6 +49,8 @@ return Application::configure(basePath: dirname(__DIR__))
   ...
 ```
 
+Also, take a look at how to set an [alias for the middleware](https://github.com/toni-suarez/laravel-utm-parameter/wiki/Installation-Guide#step-3-alias-configuration-optional).
+
 ## Configuration
 
 The configuration file `config/utm-parameter.php` allows you to control the behavior of the UTM parameters handling.
@@ -137,6 +139,34 @@ Simply use:
  }
 ```
 
+### contains_utm()
+
+Sometimes you want to show or do something, if user might have some or specific utm-parameters.
+
+Simply use:
+- `contains_utm('source|medium|campaign|term|content', 'value')`
+- `contains_not_utm('source|medium|campaign|term|content', 'value')`
+
+```blade
+@containsUtm('source', 'weekly')
+  <div>Some Weekly related stuff</div>
+@endhasUtm
+
+@containsNotUtm('sales')
+  <p>Some not Sales stuff</p>
+@endhasNotUtm
+```
+
+```php
+ if (contains_utm('campaign', 'weekly')) {
+   redirect('to/special/page');
+ }
+
+ if (contains_not_utm('campaign', 'sale')) {
+   session()->flash('Did you know, we have a newsletter?');
+ }
+```
+
 ## Extending the Middleware
 
 You can extend the middleware to customize the behavior of accepting UTM parameters. For example, you can override the `shouldAcceptUtmParameter` method.
@@ -187,7 +217,6 @@ use App\Http\Middleware\CustomMiddleware;
 })
 ```
 
-
 ## Resources
 Explore additional use cases and resources on the [wiki pages](https://github.com/toni-suarez/laravel-utm-parameter/wiki)
 

src/Providers/UtmParameterServiceProvider.php

@@ -35,5 +35,14 @@ public function boot()
         Blade::if('hasNotUtm', function (string $key, string|null $value = null) {
             return has_not_utm($key, $value);
         });
+
+        Blade::if('containsUtm', function (string $key, string|null $value = null) {
+            return contains_utm($key, $value);
+        });
+
+        Blade::if('containsNotUtm', function (string $key, string|null $value = null) {
+            return contains_not_utm($key, $value);
+        });
+
     }
 }

src/helper.php

@@ -29,3 +29,18 @@ function has_not_utm($key, $value = null)
         return !UtmParameter::has($key, $value);
     }
 }
+
+
+if (!function_exists('contains_utm')) {
+    function contains_utm($key, $value)
+    {
+        return UtmParameter::contains($key, $value);
+    }
+}
+
+if (!function_exists('contains_not_utm')) {
+    function contains_not_utm($key, $value)
+    {
+        return !UtmParameter::contains($key, $value);
+    }
+}

tests/UtmParameterTest.php

@@ -181,6 +181,20 @@ public function test_it_should_determine_if_an_utm_contains_a_non_string_value()
         $this->assertFalse($medium);
     }
 
+    public function test_it_should_determine_if_a_utm_parameter_contains_a_value()
+    {
+        $isGoogle = contains_utm('source', 'goog');
+        $this->assertIsBool($isGoogle);
+        $this->assertTrue($isGoogle);
+    }
+
+    public function test_it_should_determine_if_a_utm_parameter_not_contains_a_value()
+    {
+        $isRandomSource = has_not_utm('source', 'random');
+        $this->assertIsBool($isRandomSource);
+        $this->assertTrue($isRandomSource);
+    }
+
     public function test_it_should_clear_and_remove_the_utm_parameter_again()
     {
         $source = UtmParameter::get('source');