links.php: TAdd a TODO about badges, and fragment search

Author: adriendupuis

tools/links/links.config.php

@@ -113,14 +113,14 @@ function (string $url, string $location, string $file = null): bool {
         },
     ],
     'fragment' => [
-        function (string $url, string $file = null): bool {
+        /*function (string $url, string $file = null): bool {
             return str_ends_with($file, '.md') && (
                     // ## Commerce [[% include 'snippets/commerce_badge.md' %]]
                     str_ends_with($url, '/permission_use_cases.md#commerce')
                     // ### Ensure proper Captcha behavior [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]]
                     || str_ends_with($url, '/reverse_proxy.md#ensure-proper-captcha-behavior')
                 );
-        },
+        },*/
         function (string $url, string $file = null): bool {
             return str_starts_with($url, 'https://classic.yarnpkg.com/en/docs/')
                 || str_starts_with($url, 'https://ddev.readthedocs.io/');

tools/links/links.php

@@ -316,8 +316,11 @@ public static function testUrl(string $url, bool $external = null, bool $testFra
                     $fragmentFound = $contents && 1 === preg_match("@(id|name)=\"$fragment\"@", $contents);
                     if (!$fragmentFound && !self::isExternalUrl($url)) {
                         if ('md' === pathinfo(TestableUrl::getUrlWithoutFragment($url), PATHINFO_EXTENSION)) {
-                            $pattern = '@^#+\W*' . str_replace('-', '\W+', $fragment) . '\W*$@mi';
+                            //TODO: MarkDown fragment search pattern should be a config.
+                            //$pattern = '@^#+\W*' . str_replace('-', '\W+', $fragment) . '\W*$@mi';
+                            $pattern = '@^#+\W*' . str_replace('-', '\W+', $fragment) . '\W*( \[\[% include \'.+_badge.md\' %\]\])*$@mi';
                             $fragmentFound = (bool)preg_match($pattern, $contents);
+                            //TODO: Alternatively, Markdown headers could extracted, converted to anchors, and then compared
                         }
                     }
                 }