- Added youtube embed url and youtube thumbnail methods

- Added google embed url methods

Author: dash8x

docs/modules/available-methods.md

@@ -37,3 +37,45 @@ $formatted = number_format_exact('1120.500', max_decimals: 2); // '1,120.50'
 $formatted = number_format_exact('1120.500', max_decimals: 0); // '1,120.5'
 $formatted = number_format_exact('1120.000', max_decimals: 0); // '1,120'
 ```
+
+## youtube_video_id
+
+Extracts the video id from YouTube URLs.
+
+```php
+$video_id = youtube_video_id('https://www.youtube.com/watch?v=p7P8DmTbjUY'); // 'p7P8DmTbjUY'
+```
+
+## youtube_embed_url
+
+Generates the YouTube embed URL from a YouTube link
+
+```php
+$embed_url = youtube_embed_url('https://www.youtube.com/watch?v=p7P8DmTbjUY'); // 'https://www.youtube.com/embed/p7P8DmTbjUY'
+```
+
+## youtube_thumbnail_url
+
+Finds the YouTube thumbnail URL from a YouTube link. Supports `'sd'`, `'mq'`, `'hq'`, and `'max'` as the second argument to get image in different sizes. The default is `'max'`. 
+
+```php
+$thumbnail = youtube_thumbnail_url('https://www.youtube.com/watch?v=p7P8DmTbjUY'); // 'https://img.youtube.com/vi/p7P8DmTbjUY/maxresdefault.jpg'
+$thumbnail = youtube_thumbnail_url('https://www.youtube.com/watch?v=p7P8DmTbjUY', 'hq'); // 'https://img.youtube.com/vi/p7P8DmTbjUY/hqdefault.jpg'
+```
+
+## google_drive_file_id
+
+Extracts the file id from Google Drive URLs.
+
+```php
+$file_id = google_drive_file_id('https://drive.google.com/file/d/13YYH0OlibUYzT2q7uRPOQotbE03rdsDr/view?usp=drive_link'); // '13YYH0OlibUYzT2q7uRPOQotbE03rdsDr'
+```
+
+## google_drive_embed_url
+
+Generates a Google Drive embed URL from a file link
+
+```php
+$embed_url = google_drive_embed_url('https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf'); // 'https://docs.google.com/viewer?embedded=true&url=https%3A%2F%2Fwww.w3.org%2FWAI%2FER%2Ftests%2Fxhtml%2Ftestfiles%2Fresources%2Fpdf%2Fdummy.pdf'
+$embed_url = google_drive_embed_url('https://drive.google.com/file/d/13YYH0OlibUYzT2q7uRPOQotbE03rdsDr/view?usp=drive_link'); // 'https://drive.google.com/file/d/13YYH0OlibUYzT2q7uRPOQotbE03rdsDr/preview'
+```

src/helpers.php

@@ -930,3 +930,101 @@ function relative_date(Carbon $date, $locale = null) {
             __(':time ago', ['time' => $diff], $locale);
     }
 }
+
+if (! function_exists('youtube_thumbnail_url')) {
+
+    /**
+     * Get the video thumbnail from a youtube url
+     *
+     * @param string
+     * @return string
+     */
+    function youtube_thumbnail_url(?string $url, string $resolution = 'max'): ?string
+    {
+        $resolutions = [
+            'sd' => 'sddefault.jpg',
+            'mq' => 'mqdefault.jpg',
+            'hq' => 'hqdefault.jpg',
+            'max' => 'maxresdefault.jpg',
+        ];
+
+        $youtube_id = youtube_video_id($url);
+
+        if ($youtube_id) {
+            return 'https://img.youtube.com/vi/' . $youtube_id . '/' . $resolutions[$resolution];
+        }
+
+        return null;
+    }
+}
+
+if (! function_exists('youtube_embed_url')) {
+    /**
+     * Get the video id from a youtube url
+     *
+     * @param string
+     * @return string
+     */
+    function youtube_embed_url(?string $url): string {
+        $video_id = youtube_video_id($url);
+        return $video_id ? 'https://www.youtube.com/embed/'.$video_id : '';
+    }
+}
+
+if (! function_exists('youtube_video_id')) {
+    /**
+     * Get the video id from a youtube url
+     *
+     * @param string
+     * @return string
+     */
+    function youtube_video_id(?string $url): ?string {
+        if ($url) {
+            return (preg_match('%(?:youtube(?:-nocookie)?\.com/(?:[^/]+/.+/|(?:v|e(?:mbed)?)/|.*[?&]v=)|youtu\.be/)([^"&?/ ]{11})%i', $url, $match)) ? $match[1] : null;
+        }
+
+        return null;
+    }
+}
+
+if (! function_exists('google_drive_embed_url')) {
+    /**
+     * Get Google Drive embed url
+     *
+     * @param string
+     * @return string
+     */
+    function google_drive_embed_url(?string $url): string {
+        $file_id = google_drive_file_id($url);
+        return $file_id ? "https://drive.google.com/file/d/$file_id/preview" : "https://docs.google.com/viewer?embedded=true&url=".urlencode($url);
+    }
+}
+
+if (! function_exists('google_drive_file_id')) {
+    /**
+     * Get the file id from a Google Drive url
+     * https://stackoverflow.com/questions/55663035/i-want-to-get-id-from-the-google-drive-file-using-php
+     *
+     * @param string
+     * @return string
+     */
+    function google_drive_file_id(?string $url): ?string {
+        if ($url && Str::startsWith($url, 'https://drive.google.com')) {
+            $url_parts = parse_url($url);
+
+            if ($query = ($url_parts['query'] ?? '')) {
+                $query_parts = [];
+
+                parse_str($query, $query_parts);
+
+                if (! empty($query_parts['id'])) {
+                    return $query_parts['id'];
+                }
+            }
+
+            return explode('/', $url_parts['path'])[3] ?? null;
+        }
+
+        return null;
+    }
+}

tests/Unit/HelpersTest.php

@@ -13,6 +13,40 @@ protected function defineEnvironment($app)
         config()->set('filesystems.disks.local.serve', false);
     }
 
+    #[Test]
+    public function it_can_extract_youtube_thumbnail_from_youtube_url()
+    {
+        $this->assertEquals('https://img.youtube.com/vi/p7P8DmTbjUY/maxresdefault.jpg', youtube_thumbnail_url('https://www.youtube.com/watch?v=p7P8DmTbjUY'));
+        $this->assertEquals('https://img.youtube.com/vi/p7P8DmTbjUY/hqdefault.jpg', youtube_thumbnail_url('https://www.youtube.com/watch?v=p7P8DmTbjUY', 'hq'));
+    }
+
+    #[Test]
+    public function it_can_extract_youtube_video_id_from_youtube_url()
+    {
+        $this->assertEquals('p7P8DmTbjUY', youtube_video_id('https://www.youtube.com/watch?v=p7P8DmTbjUY'));
+        $this->assertEquals('p7P8DmTbjUY', youtube_video_id('https://youtu.be/p7P8DmTbjUY?si=cYqLYlT73rHBnx8F'));
+    }
+
+    #[Test]
+    public function it_can_get_youtube_embed_url_from_youtube_url()
+    {
+        $this->assertEquals('https://www.youtube.com/embed/p7P8DmTbjUY', youtube_embed_url('https://www.youtube.com/watch?v=p7P8DmTbjUY'));
+        $this->assertEquals('https://www.youtube.com/embed/p7P8DmTbjUY', youtube_embed_url('https://youtu.be/p7P8DmTbjUY?si=cYqLYlT73rHBnx8F'));
+    }
+
+    #[Test]
+    public function it_can_get_google_drive_file_id_from_google_drive_url()
+    {
+        $this->assertEquals('13YYH0OlibUYzT2q7uRPOQotbE03rdsDr', google_drive_file_id('https://drive.google.com/file/d/13YYH0OlibUYzT2q7uRPOQotbE03rdsDr/view?usp=drive_link'));
+    }
+
+    #[Test]
+    public function it_can_get_google_drive_embed_url_from_url()
+    {
+        $this->assertEquals('https://drive.google.com/file/d/13YYH0OlibUYzT2q7uRPOQotbE03rdsDr/preview', google_drive_embed_url('https://drive.google.com/file/d/13YYH0OlibUYzT2q7uRPOQotbE03rdsDr/view?usp=drive_link'));
+        $this->assertEquals('https://docs.google.com/viewer?embedded=true&url=https%3A%2F%2Fwww.w3.org%2FWAI%2FER%2Ftests%2Fxhtml%2Ftestfiles%2Fresources%2Fpdf%2Fdummy.pdf', google_drive_embed_url('https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf'));
+    }
+
     #[Test]
     public function it_can_convert_seconds_to_human_readable_time_with_zeros_omitted()
     {