camaliga dla TYPO3

Do większości list w TYPO3 nie potrzeba własnego rozszerzenia

Firma chce pokazać referencje na stronie: logo, nazwa klienta, branża, krótki opis. Inna chce wylistować pracowników: zdjęcie, imię i nazwisko, dział, telefon. Trzecia potrzebuje przeglądu produktów: obraz, tytuł, cena, link do strony szczegółowej. Trzy różne wymagania, jeden wspólny wzorzec: ustrukturyzowane listy z konfigurowalnymi polami. camaliga rozwiązuje ten wzorzec jako generyczne rozszerzenie listowe, zamiast rozwijać osobne rozszerzenie dla każdego typu listy.

Rozszerzenie autorstwa quizpalme jest od lat dostępne w TYPO3 Extension Repository i aktywnie utrzymywane. Jego zaleta: jeden typ rekordu z elastycznymi polami pokrywa 80% wszystkich wymagań listowych. Wada: kto potrzebuje bardzo specyficznych modeli danych (zagnieżdżone relacje, wielojęzyczność na poziomie pól, złożona walidacja), natrafia na ograniczenia.

Typowe scenariusze zastosowania

Listy referencji i klientów. Najczęstsze zastosowanie: loga i opisy klientów lub projektów w prezentacji gridowej. camaliga dostarcza gotowe layouty: grid, karuzela, akordeon, prezentacja zakładkowa. Dane są utrzymywane w backendzie TYPO3 jako rekordy, prezentacja sterowana przez szablony Fluid. U klienta ze 120 referencjami strona referencji oparta na camaliga była gotowa w 3 dni, włącznie z filtrowaniem po branży.

Strony zespołu i pracowników. Zdjęcie, imię i nazwisko, stanowisko, dane kontaktowe, opcjonalnie krótki tekst. camaliga odwzorowuje to przez swoje standardowe pola: tytuł, podtytuł, obraz, opis, link. Dla dodatkowych pól (numer telefonu, dział) można dodać pola niestandardowe przez TCA-Override. Alternatywą byłby EXT:tt_address, który jednak jest wyspecjalizowany w danych adresowych i dla stron zespołu często oferuje jednocześnie za dużo i za mało.

Proste przeglądy produktów bez funkcji sklepu. Przedsiębiorstwa, które chcą prezentować produkty, ale nie sprzedawać, nie potrzebują sklepu. camaliga dostarcza listę produktów z obrazem, tytułem, polem ceny i linkiem do karty katalogowej. Filtrowanie po kategorii jest możliwe przez zintegrowane przypisanie kategorii. Dla 50-200 produktów bez koszyka to wydajniejsze niż Aimeos czy bernetshop.

Architektura techniczna

camaliga opiera się na Extbase/Fluid i podąża za wzorcem MVC. Centralny typ rekordu nosi nazwę tx_camaliga_domain_model_content i zawiera pola dla tytułu, podtytułu, opisu, krótkiego opisu, obrazu, linku, kategorii i kilku pól niestandardowych. Pola są zdefiniowane w TCA i mogą być rozszerzane lub redukowane przez TCA-Override w sitepackage.

Prezentacja odbywa się przez plugin frontendowy z konfigurowalnym layoutem. W FlexForm pluginu redaktor wybiera: którą kategorię wyświetlić, jaki layout zastosować, ile wpisów na stronę, czy paginacja jest aktywna. Layouty to szablony Fluid nadpisywane w sitepackage. camaliga dostarcza około 15 gotowych layoutów, od prostej listy po filtrowany grid z animacją Isotope.

Filtrowanie po kategorii wykorzystuje kategorie systemowe TYPO3. Każdy rekord camaliga może być przypisany do jednej lub wielu kategorii. Na frontendzie generowane jest menu filtrów, które filtruje przez JavaScript (Isotope lub filtry CSS) lub przez wywołanie strony. Wariant JavaScript jest szybszy, wariant z wywołaniem strony bardziej przyjazny dla SEO.

Do sortowania camaliga oferuje kilka opcji: po tytule, po dacie utworzenia, po ręcznym sortowaniu (Drag-and-Drop w backendzie). Ręczne sortowanie wykorzystuje pole sorting bazy danych i działa przez standardowy mechanizm sortowania TYPO3 w module List.

Częste problemy i rozwiązania

Layouty wyglądają inaczej niż oczekiwano. Dołączone layouty camaliga opierają się na określonych frameworkach CSS (Bootstrap 3/4) lub bibliotekach JavaScript (Isotope, Masonry). Gdy strona używa innego frameworka, style kolidują. Rozwiązanie: nigdy nie używać standardowych szablonów, lecz tworzyć własne szablony Fluid w sitepackage. Nakład pracy na własny szablon to 1-2 godziny, po czym prezentacja jest w pełni kontrolowalna.

Wydajność przy ponad 500 rekordach. camaliga domyślnie ładuje wszystkie rekordy kategorii i filtruje na frontendzie przez JavaScript. Przy 500+ wpisach początkowy czas ładowania staje się odczuwalny (3-5 sekund przy 1000 rekordach z obrazami). Rozwiązanie: aktywacja paginacji i ograniczenie liczby stron do 20-50 wpisów. Dla filtrowania opartego na JavaScript: aktywacja lazy loading obrazów i doładowywanie danych przez AJAX.

Wielojęzyczność wymaga obejścia. camaliga obsługuje obsługę języków TYPO3, ale tłumaczenie każdego pojedynczego rekordu przy 200+ wpisach jest pracochłonne. Rozwiązanie: dla list czysto wizualnych (loga bez tekstu) wystarczy jeden rekord per język. Dla list z dużą ilością tekstu - przyspieszenie tłumaczenia przez przepływ pracy Inline-Translation TYPO3 lub napisanie skryptu migracji importującego tłumaczenia DeepL-API do wersji językowych.

Migracja i kompatybilność wersji

camaliga jest aktywnie utrzymywane i obsługuje TYPO3 v11, v12 oraz według aktualnej mapy drogowej również v13. Rozszerzenie podąża za cyklem wydań TYPO3 z krótkim opóźnieniem. Instalacja przez Composer z Packagist jest możliwa, instalacja z TER również.

Kto migruje z niestandardowego rozszerzenia na camaliga, musi przenieść dane z niestandardowej tabeli do tx_camaliga_domain_model_content. To zadanie SQL, które w większości przypadków da się wykonać w mniej niż jeden dzień. W drugą stronę: kto przechodzi z camaliga na własne rozszerzenie Extbase, może wykorzystać strukturę danych jako wzór.

Dla bardziej złożonych wymagań (zagnieżdżone rekordy, relacje między listami, sterowanie przepływem pracy) zamiast camaliga zaleca się własne rozszerzenie Extbase lub EXT:mask. Gosign doradza w kwestii odpowiedniego rozwiązania i implementuje zarówno szybkie rozwiązania oparte na camaliga, jak i indywidualne rozszerzenia.