Payload CMS
Otwartoźródłowy headless CMS w TypeScripcie, z panelem generowanym z konfiguracji w kodzie.
CMS i treściUżywam od 2023 · Wyróżniony projekt: Budzowska Fiutowski i Partnerzy
- Kategoria
- CMS i treści
- Używam od
- 2023
- Wyróżniony projekt
- Budzowska Fiutowski i Partnerzy
W praktyce
Payload CMS wybieram najczęściej wtedy, gdy redaktorzy mają dostać własny panel, a cały system ma żyć w jednym repozytorium z kodem strony. W Budzowska Fiutowski i Partnerzy kancelaria sama edytuje treści, bez programisty, a Next.js czyta je z tej samej konfiguracji.
Czym jest Payload CMS?
Payload CMS to otwartoźródłowy headless CMS napisany w TypeScripcie. Kolekcje i pola opisujesz w pliku konfiguracji, a Payload generuje z niego panel administracyjny, API REST i GraphQL, logowanie oraz reguły dostępu.
Działa jako część aplikacji Next.js, więc panel i strona mogą dzielić repozytorium i jedno wdrożenie. Dane leżą w bazie, którą wybierasz, podłączonej przez adapter.
- Licencja
- MIT
- Język
- TypeScript
- Bazy danych
- PostgreSQL, MongoDB, SQLite
- Schemat
- Konfiguracja w kodzie
Jak pracuję z Payload CMS
Zaczynam od redaktora, nie od wyglądu strony. Najpierw ustalam, kto co edytuje, bo od tego zależą kolekcje, bloki i uprawnienia.
Kolekcje i bloki
Opisuję kolekcje oraz własne bloki treści w konfiguracji, żeby redaktor składał stronę z gotowych elementów i nie wychodził poza układ.
Migracja treści
Gdy strona przechodzi ze starego systemu, przenoszę treści i obrazy do Payload i pilnuję, żeby adresy URL zostały takie same.
Strona i wdrożenie
Stronę buduję w Next.js, dane trzymam w PostgreSQL, a całość uruchamiam w Dockerze na serwerze VPS.
Kiedy tak, a kiedy nie
Payload ma sens tam, gdzie CMS jest częścią projektu, a nie osobnym narzędziem.
Sprawdza się, gdy
- Strona firmowa, na której redaktorzy sami zarządzają całą treścią.
- Serwis dwujęzyczny z własnymi blokami treści.
- Aplikacja z rezerwacjami albo fakturami, w której CMS jest jednym z modułów.
- Migracja ze starego systemu z zachowaniem adresów URL.
Nie sprawdza się, gdy
- Wizytówka z kilkoma podstronami, którą ktoś zmieni raz w roku.
- Zespół, w którym nikt nie utrzyma konfiguracji w kodzie.
- Redaktorzy, którzy sami mają projektować nowe typy treści w panelu.
- Baza MySQL albo MariaDB, której nie wolno zmienić.
W tych przypadkach sprawdzam Strapi, a przy prostej stronie także WordPressa.
Payload czy Strapi?
Oba to headless CMS-y z własnym panelem. Różnią się tym, gdzie powstaje model treści i z czym łączą się w projekcie.
| Kryterium | Payload CMS | Strapi |
|---|---|---|
| Model danych | Kolekcje i pola w konfiguracji | Content-type Builder w panelu, lokalnie |
| Bazy danych | PostgreSQL, MongoDB i SQLite | PostgreSQL, MySQL, MariaDB i SQLite |
| API | REST i GraphQL z konfiguracji | REST domyślnie, GraphQL jako wtyczka |
| Uprawnienia | Reguły dostępu w kodzie, do pola | Wbudowane role ustawiane w panelu |
| Panel edytora | Generowany z konfiguracji pól | Gotowy, rozszerzany wtyczkami |
Wybierz Payload, gdy
schemat ma być w repozytorium i przechodzić przez code review, a CMS ma działać w tej samej aplikacji co strona w Next.js. Dostajesz kontrolę nad modelem, ale zmiany robi programista.
Wybierz Strapi, gdy
potrzebujesz bazy MySQL albo MariaDB albo zespół zna już Strapi. Modelowanie w panelu jest wygodne na starcie, tylko pamiętaj, że działa wyłącznie lokalnie.
W Kuma.de użyłem Strapi z własnymi rolami i uprawnieniami, a w Budzowska Fiutowski i Partnerzy Payload CMS 3 z własnymi blokami treści.
Pułapki z praktyki
Stary HTML w nowym edytorze
Z projektu Budzowska Fiutowski i Partnerzy
W Budzowska Fiutowski i Partnerzy największym wyzwaniem było przeniesienie treści i obrazów ze starej bazy MariaDB do Payload CMS. Stary HTML trzeba było zamienić na format Lexical rich text, bez utraty istniejących adresów URL i wartości SEO.
Często zadawane pytania
Planujesz stronę z panelem dla redaktorów?
Napisz, kto ma edytować treści i skąd mają przejść. Powiem wprost, czy Payload ma tu sens, czy lepiej sięgnąć po Strapi albo prostsze narzędzie.