Find dla TYPO3

Wbudowane wyszukiwanie TYPO3 wystarcza do 500 stron, potem potrzebny jest Solr

Standardowe wyszukiwanie w TYPO3 (EXT:indexed_search) przeszukuje wyrenderowany HTML i przechowuje go w tabeli bazy danych. Dla małych witryn z 50-500 stronami to działa. Od 1000 stron wyszukiwanie staje sie wolne (czasy odpowiedzi powyżej 2 sekund), od 5000 stron nieużywalne. EXT:find to oparte na Solr rozszerzenie wyszukiwania, oferujące alternatywę dla ugruntowanego stosu EXT:solr: bardziej elastyczna konfiguracja, własny Query-Builder i inne podejście do wyszukiwania fasetowego.

Wybór między EXT:find a EXT:solr to nie kwestia jakości, lecz architektury. EXT:solr ma większą społeczność i więcej funkcji od razu. EXT:find oferuje większą elastyczność w konfiguracji zapytań i nadaje się dla projektów z nietypowymi wymaganiami wyszukiwania.

Typowe scenariusze zastosowania

Portale fachowe z wyszukiwaniem domenowym. Portal prawniczy z 15 000 dokumentów potrzebuje jednoczesnego wyszukiwania paragrafów, sygnatur i słów kluczowych. EXT:find pozwala definiować różne typy zapytań per pole: dokładne wyszukiwanie dla sygnatur, fuzzy dla tekstu swobodnego, filtry zakresowe dla pól daty. U wydawcy fachowego z 22 000 dokumentów EXT:find dostarczał wyniki wyszukiwania w poniżej 100 milisekund, niezależnie od złożoności filtrowania.

Wyszukiwanie e-commerce z atrybutami produktów. Produkty mają atrybuty (kolor, rozmiar, waga, cena), które służą jako facety w wyszukiwaniu. Odwiedzający szuka “śruba M8”, filtruje po materiale “stal nierdzewna” i cenie “poniżej 5 EUR”. EXT:find mapuje te facety bezpośrednio na pola Solr i automatycznie generuje nawigację filtrów z konfiguracji Solr.

Wielojęzyczne wyszukiwanie pełnotekstowe. Międzynarodowe witryny potrzebują wyszukiwania uwzględniającego specyfikę językową: niemieckie złożenia, polską deklinację, hiszpańskie akcenty. Solr dostarcza analizatory językowe dla 30+ języków. EXT:find konfiguruje per język odpowiedni analizator i tworzy specyficzne rdzenie Solr dla każdego języka.

Architektura techniczna

EXT:find komunikuje się z serwerem Apache Solr przez HTTP/JSON. Architektura składa się z trzech komponentów: serwera Solr (indeksowanie i wyszukiwanie), indeksera (zapisuje treści TYPO3 do Solr) i pluginu frontendowego (pole wyszukiwania, wyniki, facety).

Indekser przechodzi przez strukturę stron TYPO3 i wysyła treść każdej strony jako dokument JSON do Solr. Indeksowane są nie tylko widoczne treści, ale też metadane: tytuł strony, opis, kategorie, słowa kluczowe i pola niestandardowe. Indeksowanie działa jako zadanie Schedulera (zalecenie: po każdej zmianie treści lub w nocy jako pełny indeks).

EXT:find różni się od EXT:solr na poziomie zapytań. Zamiast stałej struktury zapytania, find oferuje konfigurowalny Query-Builder: przez TypoScript lub FlexForm można definiować, które pola Solr są przeszukiwane, z jaką wagą (Boosting), jakie filtry są automatycznie stosowane i jak wyniki są sortowane.

Konfiguracja facetów odbywa się przez definicje pól Solr. Każde pole, które ma służyć jako facet, musi być zdefiniowane w konfiguracji schematu Solr jako pole facet. EXT:find odczytuje dostępne facety z konfiguracji Solr i renderuje je jako menu filtrów na frontendzie. Filtry działają przez parametry GET, co umożliwia przyjazne SEO adresy URL dla filtrowanych stron wyników.

Częste problemy i rozwiązania

Konfiguracja i utrzymanie serwera Solr. Solr to serwer oparty na Javie, który musi być prowadzony oddzielnie. Dla agencji TYPO3 bez doświadczenia z Javą konfiguracja jest barierą: konfiguracja JVM, zarządzanie rdzeniami Solr, aktualizacja schematu, monitoring. Rozwiązanie: użycie Managed Solr (np. Websolr, SearchStax) lub uruchomienie Solr jako kontenera Docker. Oficjalny obraz Docker Solr redukuje konfigurację do 3 poleceń.

Jakość wyszukiwania jest słaba. Odwiedzający szukają “kontakt” i znajdują 200 wyników, bo słowo pojawia się na każdej stronie w stopce. Rozwiązanie: konfiguracja wag pól. Trafienia w tytule są ważone 10x wyżej niż w treści, trafienia H2 5x wyżej niż tekst ciągły. EXT:find pozwala na tę wagę przez TypoScript: plugin.tx_find.settings.boostFields.title = 10.

Indeks nie jest aktualizowany. Redaktorzy zmieniają treści, ale wyszukiwanie pokazuje stare wyniki. Przyczyna: zadanie Schedulera indeksera nie działa lub zakończyło się błędem. Rozwiązanie: ustawienie zadania Schedulera na krótkie interwały (co 15 minut dla indeksu delta, w nocy dla pełnego indeksu) i konfiguracja alertu monitoringu powiadamiającego o błędach indeksu.

Migracja i kompatybilność wersji

EXT:find obsługuje TYPO3 v10 i v11 z Solr 8 i 9. Dla TYPO3 v12 istnieje wersja beta na GitHubie. Rozszerzenie jest utrzymywane przez dział badań i rozwoju SUB Getynga i ma akademicką bazę użytkowników.

EXT:solr jest popularniejszą alternatywą z oficjalnym wsparciem v12 i komercyjnymi opcjami wsparcia (dkd Internet Service GmbH). Dla większości projektów TYPO3 EXT:solr jest bezpiecznym wyborem. EXT:find jest zalecany dla projektów ze specjalnymi wymaganiami zapytań (wyszukiwanie akademickie, bazy fachowe, scenariusze multi-indeksowe).

Migracja z EXT:indexed_search na Solr (niezależnie czy find czy solr) wymaga: konfiguracji serwera Solr, konfiguracji schematu, indeksowania treści i dostosowania szablonów frontendowych. Nakład pracy to 3-5 dni dla standardowej strony i 1-2 tygodnie dla złożonych portali. Gosign doradza w kwestii odpowiedniego stosu wyszukiwania i przejmuje konfigurację, setup i dostrajanie jakości wyszukiwania.