Add better support for Arrayable options when resizing, add html find/replace twig filter

Author: Bradie Tilley

Plugin.php

@@ -11,6 +11,7 @@
 use Artisan;
 use DB;
 use Event;
+use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Database\QueryException;
 use Symfony\Component\Console\Output\ConsoleOutput;
 use System\Classes\PluginBase;
@@ -41,12 +42,36 @@ public function registerMarkupTags()
                 'resize' => function ($image, $width, $height = null, $options = []) {
                     $resizer = new Resizer((string) $image);
 
-                    return $resizer->resize((int) $width, (int) $height, (array) $options);
+                    $width = ($width !== null) ? (int) $width : null;
+                    $height = ($height !== null) ? (int) $height : null;
+                    $options = ($options instanceof Arrayable) ? $options->toArray() : (array) $options;
+
+                    return $resizer->resize($width, $height, $options);
                 },
                 'modify' => function ($image, $options = []) {
                     $resizer = new Resizer((string) $image);
 
-                    return $resizer->resize(null, null, (array) $options);
+                    $width = null;
+                    $height = null;
+                    $options = ($options instanceof Arrayable) ? $options->toArray() : (array) $options;
+
+                    return $resizer->resize($width, $height, $options);
+                },
+                'filterHtmlImageResize' => function ($html, $width, $height = null, $options = []) {
+                    $html = (string) $html;
+                    $width = ($width !== null) ? (int) $width : null;
+                    $height = ($height !== null) ? (int) $height : null;
+                    $options = ($options instanceof Arrayable) ? $options->toArray() : (array) $options;
+
+                    return Resizer::parseFindReplaceImages($html, $width, $height, $options);
+                },
+                'filterHtmlImageModify' => function ($html, $options = []) {
+                    $html = (string) $html;
+                    $width = null;
+                    $height = null;
+                    $options = ($options instanceof Arrayable) ? $options->toArray() : (array) $options;
+
+                    return Resizer::parseFindReplaceImages($html, $width, $height, $options);
                 }
             ]
         ];

classes/Resizer.php

@@ -933,4 +933,59 @@ public static function clearFiles(Carbon $minAge = null, string $directory = nul
 
         return count($files);
     }
+
+    /**
+     * Parse a given HTML string for images and replace them with the resized copies as per the given modifications.
+     * 
+     * CAUTION: Experimental
+     *
+     * This uses regex to find and replace HTML content which is often frowned upon. You may supply your own custom
+     * regexes, or you may rely on the defaults (which may change in future versions of this plugin soo beware).
+     * 
+     * By default this will search img elements with a src, data-src or lazy-src attribute, as well as any "style"
+     * attribute with a background or background-image CSS rule (of which contains a "url()" to an image)
+     * 
+     * Example Usage (a richeditor field that contains custom embedded images that require OTF optimisation or resizing):
+     *      {{ service.description | filterHtmlImageResize(600, 600, { mode: 'contain' }) }}
+     *      {{ service.description | filterHtmlImageModifiy({ quality: 60 }) }}
+     * 
+     * @param string $html The HTML to find/replace images
+     * @param int|null $width
+     * @param int|null $height
+     * @param array $options
+     * @param array $regexes List of regexes (keys) and callbacks (values) to use in the preg_replace_callback.
+     * @param int $limit See preg_replace_callback $limit docs
+     * @return string The same HTML but with images replaced with their resized URL equivalents
+     */
+    public static function parseFindReplaceImages(
+        string $html,
+        int $width = null,
+        int $height = null,
+        array $options = [],
+        array $regexes = null,
+        int $limit = 255
+    ): string {
+        $regexes = ($regexes !== null) ? $regexes : [
+            '/(<img [^>]*(?:src|data-src|lazy-src)=)"([^"]+)"/' => function ($match) use ($width, $height, $options) {
+                $resizer = new Resizer((string) $match[2]);
+
+                $url = $resizer->resize($width, $height, $options);
+
+                return $match[1] . '"' . $url . '"';
+            },
+            '/(style="([^"]*)background(-image)?:(\s*[^"]+)?url\(\'?)(.+?)(\'?\))"/' => function ($match) use ($width, $height, $options) {
+                $resizer = new Resizer((string) $match[2]);
+
+                $url = $resizer->resize($width, $height, $options);
+
+                return $match[1] . $url . $match[6];
+            },
+        ];
+
+        foreach ($regexes as $regex => $callback) {
+            $html = preg_replace_callback($regex, $callback, $html, $limit);
+        }
+
+        return $html;
+    }
 }

updates/version.yaml

@@ -38,4 +38,6 @@
 2.1.6:
   - Fix migration (2.1.2 migration) that causes installations to fail (due to plugin settings not existing for new projects at time of execution)
 2.1.7:
-  - Fix - Update plugin's boot method to not directly reference Settings until DB connection is established
+  - Fix - Update plugin's boot method to not directly reference Settings until DB connection is established
+2.1.8:
+  - Added twig filter to parse and resize/modify images (via regex) using twig filter(s)