add View::createAbsoluteUrl() method as a shortcut to `CApplication…

…::createAbsoluteUrl()`

CHANGELOG.md

@@ -6,6 +6,7 @@ Yii1 Symfony Mailer extension
 
 - Enh: Added passing email message instance via `$_message` context variable to the template (klimov-paul)
 - Enh: Added passing template context variables to the layout template (klimov-paul)
+- Enh: Added `View::createAbsoluteUrl()` method as a shortcut to `CApplication::createAbsoluteUrl()` (klimov-paul)
 
 
 1.0.0, May 10, 2024

README.md

@@ -170,6 +170,8 @@ $this->layout = 'particular-layout';
 ?>
 <h1>Greetings</h1>
 <p>Context var "name" = <?php echo CHtml::encode($name) ?></p>
+
+<a href="<?php $this->createAbsoluteUrl('mail/unsubscribe', ['email' => $_message->getTo()[0]->getAddress()]) ?>">Unsubscribe</a>
 ```
 
 

src/View.php

@@ -271,4 +271,20 @@ public function endClip(): void
     {
         $this->endWidget(ClipWidget::class);
     }
+
+    /**
+     * Creates an absolute URL based on the given controller and action information.
+     *
+     * @since 1.0.1
+     *
+     * @param string $route the URL route. This should be in the format of 'ControllerID/ActionID'.
+     * @param array $params additional GET parameters (name=>value). Both the name and value will be URL-encoded.
+     * @param string $schema schema to use (e.g. http, https). If empty, the schema used for the current request will be used.
+     * @param string $ampersand the token separating name-value pairs in the URL.
+     * @return string the constructed URL
+     */
+    public function createAbsoluteUrl(string $route, array $params = [], string $schema = '', string $ampersand = '&'): string
+    {
+        return Yii::app()->createAbsoluteUrl($route, $params, $schema, $ampersand);
+    }
 }