> $items * @param list $hints a domain, an account name, anything naming the brand * @return list> */ public static function suggestFirst(array $items, array $hints, string $nameKey = 'name'): array { // Hints are tried in priority order and the first one that matches // anything wins outright. // // Pooling them meant a weaker signal could badge a second answer beside // the right one. Advertising iblockads.org from the // MidoWeb-WWBlog-GMT-RSOC account badged both IBlockAds and WWBlog-Hub, // and the stable sort left the wrong one on top: the account name is // incidental, the page being advertised is the point. foreach (array_filter($hints) as $hint) { $words = self::words([$hint]); if ($words === []) { continue; } $matched = false; foreach ($items as $i => $item) { $items[$i]['suggested'] = self::matches((string) ($item[$nameKey] ?? ''), $words); $matched = $matched || $items[$i]['suggested']; } if (! $matched) { continue; } // Stable, so an already-sensible order survives underneath the match. usort($items, fn (array $a, array $b): int => ($b['suggested'] ?? false) <=> ($a['suggested'] ?? false)); return $items; } return $items; } /** * The words worth matching on, from any number of hints. * * "https://www.stockprices.com/offer" and "StockPrices" both reduce to * "stockprices", which is what makes an account name find its own Page. * * @param list $hints * @return list */ public static function words(array $hints): array { $words = []; foreach (array_filter($hints) as $hint) { // A URL is only useful as its host; the path is about the offer, // not about the brand. $source = str_contains((string) $hint, '://') ? (parse_url((string) $hint, PHP_URL_HOST) ?: '') : (string) $hint; foreach (preg_split('/[^a-z0-9]+/', strtolower($source)) ?: [] as $word) { if (strlen($word) > 2 && ! in_array($word, self::NOISE, true)) { $words[] = $word; } } } return array_values(array_unique($words)); } /** @param list $words */ public static function matches(string $name, array $words): bool { $name = strtolower($name); foreach ($words as $word) { if (str_contains($name, $word)) { return true; } } return false; } }