Strona sklepu nie musi od razu przybierać formy rozbudowanego szablonu. W praktyce to właśnie shortcode woocommerce pozwala szybko osadzić koszyk, listing produktów albo przycisk zakupu tam, gdzie zwykły układ strony byłby zbyt ciężki. W tym artykule pokazuję, jak działa ten mechanizm, które skróty są dziś najważniejsze i kiedy lepiej wybrać bloki zamiast shortcode’ów.
Najważniejsze informacje na start
- Shortcode’y WooCommerce służą do wstawiania funkcji sklepu w treść strony bez pisania własnego szablonu.
- Najbardziej elastyczny jest
[products], bo potrafi zastąpić kilka starszych wariantów wyświetlania produktów. - W nowych sklepach koszyk i kasa częściej działają na blokach, ale shortcode’y nadal są przydatne na landing page’ach i w treści wpisów.
-
[add_to_cart]i[shop_messages]są szczególnie użyteczne poza standardowymi stronami sklepu. - Najczęstsze błędy wynikają z błędnych atrybutów, złych stron systemowych i zbyt ciężkich list produktów.
Czym są shortcode’y WooCommerce i kiedy naprawdę się przydają
Shortcode to krótka instrukcja zamknięta w nawiasach kwadratowych, którą WordPress interpretuje jako gotowy fragment funkcji. W sklepie internetowym to bardzo praktyczne: zamiast budować osobną sekcję od zera, mogę wstawić kategorię produktów, przycisk zakupu, komunikat sklepu albo formularz śledzenia zamówienia dokładnie tam, gdzie tego potrzebuję.
Ja traktuję shortcode’y jako szybkie klocki do składania treści sprzedażowej, a nie jako fundament całej architektury sklepu. Dobrze sprawdzają się na stronach kampanii, w artykułach blogowych, na stronach kategorii przygotowanych pod SEO i tam, gdzie chcę połączyć treść z ofertą bez dodatkowego kodowania. Gorzej wypadają, gdy próbuję nimi zastąpić cały system nawigacji albo rozbudowany układ strony głównej.
W oficjalnej dokumentacji WooCommerce widać też przesunięcie w stronę bloków: koszyk i kasa są dziś w wielu wdrożeniach obsługiwane właśnie w ten sposób, natomiast część starszych zastosowań nadal działa przez shortcode’y. To ważne, bo nie chodzi o to, żeby wymienić wszystko na siłę, tylko dobrać narzędzie do konkretnego celu. Z tego wynika następny krok: trzeba wiedzieć, które skróty są naprawdę warte zapamiętania.
Najważniejsze shortcode’y, które warto znać
Jeśli ktoś ma ogarnąć tylko kilka najważniejszych skrótów, wystarczy skupić się na tych, które realnie pomagają sprzedawać, porządkować ofertę i usprawniać obsługę klienta. Poniżej zestawiam te, które najczęściej wykorzystuję w praktyce.
| Shortcode | Do czego służy | Kiedy ma sens | Na co uważać |
|---|---|---|---|
[products] |
Wyświetla produkty według kategorii, tagów, SKU, ID, atrybutów i filtrów sprzedażowych. | Gdy chcesz zbudować elastyczną sekcję ofertową, promocję albo landing page. | Najbardziej uniwersalny, ale też najłatwiej przesadzić z liczbą wyników. |
[product_category] |
Pokazuje produkty z jednej konkretnej kategorii. | Na stronach kategorii, kampaniach tematycznych i pod SEO. | Trzeba podać poprawny slug, nazwę albo ID kategorii. |
[product_categories] |
Pokazuje siatkę kategorii produktów. | Na stronie głównej sklepu lub jako nawigację wejściową do oferty. | Nie wszystkie kategorie muszą się pokazać, jeśli są puste albo źle filtrowane. |
[add_to_cart] |
Wyświetla przycisk dodania do koszyka i cenę wybranego produktu. | Na landing page’ach i stronach kampanii, gdzie nie chcesz odsyłać do karty produktu. | Działa najlepiej z konkretnym ID lub SKU. |
[add_to_cart_url] |
Zwraca sam adres dodający produkt do koszyka. | Gdy budujesz własny przycisk CTA albo link w treści wpisu. | To tylko URL, więc cały wygląd projektujesz osobno. |
[shop_messages] |
Pokazuje komunikaty WooCommerce na stronach spoza sklepu. | Gdy wstawiasz przycisk kupna poza standardowymi podstronami WooCommerce. | Bez tego klient może nie zobaczyć potwierdzenia dodania produktu. |
[woocommerce_my_account] |
Wyświetla konto klienta. | Na stronie „Moje konto” i w sekcjach obsługi zamówień. | To nadal istotny shortcode, mimo że część sklepu działa dziś na blokach. |
[woocommerce_order_tracking] |
Pokazuje formularz śledzenia zamówienia. | Gdy chcesz uprościć obsługę klienta i ograniczyć pytania do supportu. | To skrót bardziej funkcjonalny niż sprzedażowy, ale bardzo praktyczny. |
[woocommerce_cart] i [woocommerce_checkout]
|
Obsługują odpowiednio koszyk i kasę w starszym modelu opartym o shortcode’y. | W starszych instalacjach i tam, gdzie sklep nadal bazuje na klasycznym układzie. | W nowych wdrożeniach zwykle lepiej postawić na bloki. |
Oficjalna dokumentacja WooCommerce pokazuje, że [products] potrafi zastąpić kilka starszych wariantów, takich jak osobne skróty dla produktów promocyjnych, bestsellerów czy nowości. To upraszcza pracę: zamiast pamiętać kilka różnych kodów, można zbudować jedną sekcję i kontrolować ją atrybutami. W praktyce daje to więcej elastyczności i mniej bałaganu w treści.
Jeśli chcesz korzystać z tych skrótów świadomie, warto najpierw wiedzieć, jak wstawić je do strony i nie zepsuć działania sklepu. Właśnie tu najczęściej pojawiają się pierwsze techniczne potknięcia.
Jak wstawić shortcode do strony bez błędów
Wstawienie shortcode’a samo w sobie jest proste, ale liczy się kontekst. Ja zawsze sprawdzam, czy dany fragment ma trafić do strony, wpisu, opisu produktu, czy do systemowej podstrony sklepu, bo od tego zależy dalsze zachowanie WooCommerce.
- Otwórz stronę lub wpis w edytorze WordPress.
- Jeśli pracujesz w edytorze blokowym, dodaj blok Shortcode.
- Wklej sam shortcode bez dodatkowych znaków, spacji i formatowania.
- Zapisz zmiany i sprawdź efekt na froncie strony, nie tylko w podglądzie edytora.
- Przy koszyku, kasie i koncie klienta upewnij się, że są przypisane do właściwych stron w ustawieniach sklepu.
Uwaga: koszyk, kasa i konto klienta powinny być osobnymi stronami. Łączenie ich w jedną podstronę zwykle kończy się przekierowaniami, dziwnym zachowaniem formularzy albo problemami z płatnościami. To nie jest detal techniczny, tylko rzecz, która może bezpośrednio uderzyć w konwersję.
[products limit="8" columns="4" category="hoodies" orderby="popularity"]Taki przykład pokazuje osiem produktów z jednej kategorii, w czterech kolumnach, posortowanych według popularności. To dobry wzorzec dla sekcji typu „najczęściej kupowane” albo dla kampanii sezonowej, która ma sprzedawać bez przeładowania strony. Następny krok to zrozumienie, które atrybuty naprawdę zmieniają efekt, a które są tylko kosmetyką.
Jak sterować wyglądem i zakresem wyświetlania
Największa przewaga shortcode’ów polega na tym, że nie pokazują „wszystkiego albo nic”. Można nimi dokładnie sterować liczbą elementów, kolejnością, układem siatki i zakresem pobieranych produktów. To właśnie atrybuty decydują, czy sekcja wygląda jak schludny blok sprzedażowy, czy jak przypadkowy zrzut katalogu.
Atrybuty dla list produktów
| Atrybut | Co robi | Praktyczna uwaga |
|---|---|---|
limit |
Określa liczbę produktów, np. 8 lub 4. |
Domyślnie może pokazać wszystko, więc na dużym katalogu lepiej ustawić limit ręcznie. |
columns |
Ustawia liczbę kolumn, najczęściej 4. |
Na mobile i tak układ się zwęzi, ale na desktopie wpływa na odbiór sekcji. |
paginate |
Włącza paginację przy dłuższych listach. | Przydaje się, gdy nie chcesz ładować kilkudziesięciu produktów naraz. |
orderby |
Sortuje po tytule, dacie, ID, popularności, ocenie lub losowo. |
rand wygląda efektownie, ale na stronach z cache może dawać nieoczekiwany wynik. |
order |
Ustala kierunek sortowania: ASC albo DESC. |
Najczęściej używam DESC przy nowościach i ASC przy porządku katalogowym. |
category |
Filtruje po kategorii lub kategoriach. | Najlepiej używać slugów, bo są czytelniejsze i mniej podatne na pomyłki. |
tag |
Pobiera produkty z wybranym tagiem. | Dobre do sezonowych kolekcji, np. „lato”, „outlet”, „preorder”. |
cat_operator |
Kontroluje logikę kategorii: IN, NOT IN lub AND. |
Przydaje się, gdy sekcja ma pokazywać tylko bardzo konkretny wycinek oferty. |
Przy dużych katalogach szczególnie pilnuję dwóch rzeczy: limitu i sortowania. Jeśli ustawisz zbyt szeroki zakres, strona zacznie działać ciężej, a klient zobaczy ścianę produktów zamiast konkretnej propozycji. Jeśli ustawisz losową kolejność na mocno cache’owanej stronie, efekt może być nieprzewidywalny. To nie jest wada shortcode’ów jako takich, tylko sygnał, że trzeba je dobrać do skali sklepu.
Przeczytaj również: WooCommerce checkout - Jak nie tracić klientów?
Atrybuty dla kategorii
| Atrybut | Co robi | Praktyczna uwaga |
|---|---|---|
category w [product_category]
|
Wskazuje jedną kategorię po slugu, nazwie albo ID. | To obowiązkowy parametr, bez którego shortcode nie wie, co pokazać. |
ids w [product_categories]
|
Pokazuje tylko wybrane kategorie po ID. | Dobry wybór, gdy chcesz ręcznie sterować kolejnością lub zakresem listy. |
parent |
Wybiera kategorie podrzędne albo tylko główne, gdy ustawisz 0. |
Świetne na stronach wejściowych do sklepu, gdzie chcesz zacząć od głównych działów. |
hide_empty |
Ukrywa puste kategorie, gdy ma wartość 1. |
Przydaje się, żeby klient nie trafiał na puste półki. |
orderby |
Sortuje kategorie według nazwy, ID, sluga albo menu order. | Jeśli zależy Ci na ręcznym układzie, menu order jest zwykle najwygodniejsze. |
order |
Ustala kolejność rosnącą lub malejącą. | Najczęściej stosuję go razem z orderby, żeby zachować pełną kontrolę nad układem. |
limit / number
|
Określa liczbę wyświetlanych pozycji. | W praktyce 0 albo brak parametru oznacza pokazanie wszystkiego. |
To właśnie tutaj najłatwiej zbudować sensowną nawigację sklepu: najpierw główne kategorie, potem konkretne produkty. Taki układ jest prostszy dla użytkownika i zwykle lepiej wspiera SEO niż przypadkowo ustawione bloki z losową zawartością. Na tym tle dobrze widać, kiedy shortcode wygrywa z blokami, a kiedy lepiej nie walczyć z trendem w stronę nowych rozwiązań.
Kiedy shortcode lepiej służy sklepowi niż bloki
Nie jestem zwolennikiem zasady „albo wszystko na shortcode’ach, albo wszystko na blokach”. W praktyce wybór zależy od tego, co budujesz. Jeśli potrzebujesz wstawić jeden konkretny element sprzedażowy do treści, shortcode bywa szybszy i lżejszy. Jeśli projektujesz cały koszyk albo kasę, blok zwykle daje bezpieczniejszy i czytelniejszy efekt.
| Sytuacja | Shortcode | Blok |
|---|---|---|
| Landing page z jednym produktem | Świetny do [add_to_cart] i [shop_messages]. |
Może być zbyt rozbudowany jak na prostą kampanię. |
| Strona kategorii z kilkoma sekcjami | Dobry do szybkiego osadzania list produktów. | Lepszy, gdy zespół często edytuje układ wizualnie. |
| Koszyk i kasa | Starsze rozwiązanie, przydatne głównie w legacy setupach. | Najczęściej lepszy wybór w nowych sklepach. |
| Konto klienta | Nadal bardzo użyteczne i wspierane. | Nie zawsze zastąpi całe działanie konta. |
| Landing page z wpisu blogowego | Naturalny wybór, bo wklejasz tylko potrzebny fragment. | Może być nadmiarowy, jeśli potrzebujesz jednego CTA. |
W praktyce korzystam z bardzo prostej zasady: shortcode tam, gdzie chcę szybko dołożyć funkcję sprzedażową do treści, blok tam, gdzie zależy mi na całym doświadczeniu zakupowym. To podejście oszczędza czas i zmniejsza ryzyko, że sklep będzie wyglądał jak zlepiony z przypadkowych komponentów. Zanim jednak uznasz wdrożenie za gotowe, warto sprawdzić kilka błędów, które najczęściej psują efekt.
Najczęstsze błędy, które psują wynik
- Wklejenie złego sluga kategorii zamiast poprawnego ID lub nazwy, przez co shortcode zwraca pusty wynik.
- Ustawienie zbyt dużego limitu produktów, co robi z sekcji ciężką ścianę treści.
- Liczenie na losowe sortowanie przy aktywnym cache, co potrafi dać pozornie „zamrożony” układ.
- Brak
[shop_messages]na stronie spoza sklepu, gdy używasz[add_to_cart]i klient nie dostaje potwierdzenia akcji. - Próba połączenia koszyka, kasy i konta klienta w jedną stronę.
- Mylenie shortcode’a z gotowym układem wizualnym i oczekiwanie, że sam zadba o wygląd całej sekcji.
Najwięcej problemów widzę nie przy samym kodzie, tylko przy założeniu, że shortcode „sam się obroni”. On działa dobrze dopiero wtedy, gdy ma jasny cel: pokazać konkretną kategorię, konkretny produkt albo konkretny etap ścieżki zakupowej. Jeśli nie ma takiego celu, lepiej uprościć układ niż dokładać kolejne skróty.
Jak używać shortcode’ów tak, żeby wspierały sprzedaż, a nie ją rozpraszały
Ja patrzę na shortcode’y jak na narzędzie merchandisingowe. Ich zadaniem nie jest „zapełnić stronę”, tylko poprowadzić użytkownika do następnego logicznego kroku. W sklepie internetowym to może być przejście z artykułu do produktu, z kategorii do bestsellera albo z landing page’a prosto do dodania produktu do koszyka.
- Do promowania pojedynczej oferty używaj
[add_to_cart]albo[add_to_cart_url], a nie całej strony katalogowej. - Do strony startowej sklepu lepsza bywa siatka kategorii niż od razu pełna lista produktów.
- Do akcji sezonowych stosuj
[products]z limitem4lub8i czytelnym sortowaniem. - Do treści blogowej wybieraj skróty, które naturalnie domykają intencję czytelnika, a nie odrywają go od artykułu.
- Po wdrożeniu sprawdzaj widok na mobile, bo tam źle dobrane kolumny szybciej ujawniają chaos.
Jeśli mam wskazać jedną rzecz, która robi największą różnicę, powiedziałbym tak: dobieraj shortcode do celu biznesowego, nie do samej możliwości technicznej. Gdy sekcja ma sprzedawać, potrzebuje prostoty, jasnego CTA i sensownej liczby produktów, a nie imponującej liczby parametrów. Właśnie dlatego dobrze użyte shortcode’y nadal są jednym z najbardziej praktycznych narzędzi w sklepie opartym na WooCommerce.
