Jak tworzyć szablony pojedynczych produktów

W tym momencie można bezpiecznie założyć, że już wiesz, że
Easy Digital Downloads (EDD) zostało opracowane do pracy z każdym motywem. Istnieje jednak kilka rzeczy, które można zrobić, aby upewnić się, że Twój motyw w pełni wykorzystuje możliwości EDD.

W tym artykule omówimy podstawy tworzenia szablonów pojedynczych produktów dla Twojego motywu. Dla jasności, szablon pojedynczego produktu służy do wyświetlania strony front-end, utworzonej podczas dodawania nowego Produktu do Twojej witryny.

Hierarchia szablonów WordPress

Najpierw musimy zrobić krok wstecz i zbadać, jak sam WordPress działa. Motywy WordPress to nic innego jak zbiór plików, które współpracują ze sobą, aby wyświetlać Twoją witrynę. Niektóre z tych plików motywu to szablony i komponenty szablonów, które razem tworzą strukturę HTML Twojej witryny.

WordPress używa
hierarchii szablonów, aby określić, kiedy i jak używać tych plików szablonów. Nie zagłębimy się w szczegóły całej hierarchii, ale oto wizualizacja pokazująca, jak różne pliki szablonów są ze sobą powiązane.

Omówimy tutaj szablon pojedynczego wpisu i jego wpływ na sposób wyświetlania stron Twoich pojedynczych produktów. Zacznijmy.

Szablon pojedynczego wpisu (i pojedynczy)

Bezpośrednio z
wordpress.org, oto hierarchia szablonów dla pojedynczych wpisów:

1. single-{post-type}-{slug}.php – (Od wersji 4.4) Najpierw WordPress szuka szablonu dla konkretnego wpisu. Na przykład, jeśli typem wpisu jest product, a identyfikatorem wpisu jest dmc-12, WordPress będzie szukał single-product-dmc-12.php.
2. single-{post-type}.php – Jeśli typem wpisu jest product, WordPress będzie szukał single-product.php.
3. single.php – Następnie WordPress wraca do single.php.
4. singular.php – Następnie wraca do singular.php.
5. index.php – Na koniec, jak wspomniano powyżej, WordPress ostatecznie wraca do index.php.

Oznacza to, że nazwa pliku szablonu mówi WordPressowi, kiedy powinien być używany i jaka jest jego „pozycja” w hierarchii dla danego przypadku użycia.

Najczęstszą nazwą pliku w tym momencie jest najprawdopodobniej
single.php. Szablon single.php służy do wyświetlania pojedynczych wpisów na blogu. Jak można sobie wyobrazić, wielu użytkowników publikuje na swoich witrynach WordPress więcej wpisów na blogu niż czegokolwiek innego. Więc chociaż single.php nie ma najwyższej rangi ogólnie, to
jest najwyżej w hierarchii dla ogólnych szablonów pojedynczych wpisów.

Jest duża szansa, że Twój aktywny motyw (lub motyw nadrzędny, jeśli używasz
motywu potomnego) ma plik single.php w swoim głównym folderze. Jeśli tak, jest on używany do wyświetlania pojedynczych wpisów na blogu. Istnieje jednak również szansa, że nie masz pliku single.php, ale zamiast tego plik singular.php. Staje się to coraz częstsze. Jego podstawowym celem jest bycie bardziej „uniwersalnym” szablonem dla wszystkich stron front-endowych, które podpadają pod definicję WordPressa „singular”, takich jak wpisy na blogu, strony i wpisy dla podstawowych niestandardowych typów wpisów.

Omówimy, jak EDD używa tych szablonów i jak możesz to zmienić.

single.php

Jak wspomniano powyżej, plik
single.php to podstawowy szablon używany do wyświetlania pojedynczych wpisów na blogu. Po odwiedzeniu adresu URL wpisu na blogu, WordPress przeszuka strukturę motywu w poszukiwaniu odpowiedniego pliku szablonu do wyświetlenia tego wpisu. Plik single.php jest powszechnym rozwiązaniem.

Mając to na uwadze, musisz również wiedzieć, że Wpisy (i Strony) to to, co WordPress nazywa „typami wpisów”. Istnieje kilka domyślnych typów wpisów wbudowanych w WordPressa, ale deweloperzy mogą również tworzyć własne, zwane Niestandardowymi Typami Wpisów.

Sam EDD wprowadza kilka niestandardowych typów wpisów do Twojego systemu, z których jednym jest
Download. To jedyny, który tutaj omówimy.

Jeśli przewiniesz w górę, aby ponownie przyjrzeć się hierarchii szablonów dla pojedynczych wpisów, zauważysz, że
single-{post-type}.php ma wyższą rangę niż single.php. Oznacza to dwie rzeczy:

1. Jeśli single-{post-type}.php pasuje do scenariusza, zostanie użyty przed single.php.
2. Jeśli nie istnieje szablon single-{post-type}.php, następnym wyborem jest single.php.

Chyba że Twój motyw został napisany specjalnie dla EDD, Twoja sytuacja domyślnie wpada w drugi scenariusz. Biorąc pod uwagę, że niestandardowy typ wpisu Download w EDD jest rejestrowany jako „download”, chyba że Twój motyw zawiera plik
single-download.php (lub pozycję nr 1 w hierarchii pojedynczych wpisów, której nie będziemy omawiać), WordPress poszuka pliku single.php.

Oznacza to, że sposób wyświetlania Twoich wpisów na blogu będzie taki sam, jak sposób wyświetlania Twoich pobrań EDD. Jeśli Twoje wpisy na blogu zawierają informacje o autorze, nawigację między wpisami lub cokolwiek innego, będzie to również wyświetlane dla Twoich pobrań.

Dla wielu użytkowników nie stanowi to problemu. Dla innych może to dodać niechciane informacje do wyświetlania produktu. Lub być może niektórzy użytkownicy po prostu nie chcą, aby ich strony produktów były wyświetlane w taki sam sposób jak wpisy na blogu, co jest zrozumiałe.

single-download.php

Aby poinformować WordPressa, że chcesz wyświetlać swoje pojedyncze strony produktów inaczej niż pojedyncze wpisy na blogu, musisz skorzystać z hierarchii szablonów pojedynczych wpisów, tworząc plik
single-download.php w głównym folderze swojego aktywnego motywu (co oznaczałoby Twój motyw potomny, jeśli go używasz).

Gdy ten plik znajdzie się w głównym folderze aktywnego motywu, wyświetlenie strony front-endowej jednego z Twoich produktów spowoduje wywołanie szablonu specyficznego dla pobierania zamiast szablonu wpisu na blogu. W tym momencie masz kontrolę nad swoim szablonem
single-download.php i możesz go zbudować tak, jak chcesz.

Oto bardzo przydatna wskazówka dotycząca tworzenia szablonu
single-download.php:

Chyba że jesteś deweloperem motywów, który już wie, co robi, najlepszym sposobem na utworzenie początkowego pliku
single-download.php jest skopiowanie pliku single.php Twojego motywu, a następnie zmiana nazwy kopii na single-download.php. W tym momencie nic się nie zmieni w wyświetlaniu stron Twoich produktów. Jednak możesz teraz swobodnie edytować nowy plik szablonu, a wpłynie to tylko na strony Twoich produktów.

Jeśli używasz motywu potomnego, oznacza to, że musiałbyś skopiować szablon pojedynczego wpisu z motywu nadrzędnego, aby umieścić go w głównym folderze swojego motywu potomnego.

singular.php

Tutaj sprawy stają się nieco bardziej skomplikowane. Plik
singular.php jest dość nowy i chociaż nie jest tak powszechnie używany jak plik single.php, nadal jest popularny. Jak wspomniano wcześniej, WordPress zawiera kilka już wbudowanych typów postów i obsługuje tworzenie niestandardowych typów postów. *Wszystkie* te typy postów są uważane za pojedyncze.

Oznacza to, że motyw nie musi zawierać pliku single.php, ani nawet pliku page.php (szablon używany do wyświetlania stron WordPress). Jeśli plik singular.php jest obecny, a żadne bardziej specyficzne szablony nie są dostępne, WordPress użyje go dla wszystkich typów postów.

Nie trzeba dodawać, że ten plik szablonu często musi używać logiki warunkowej. Oznacza to:

Jeśli odwiedzany adres URL to strona, użyj tego kodu, aby wyświetlić stronę. Jeśli odwiedzany adres URL to wpis, użyj tego kodu, aby wyświetlić wpis.

Wszystko to dzieje się w jednym pliku szablonu. W przypadku witryn zawierających tylko wpisy i strony jest to proste. Kiedy wprowadzasz niestandardowe typy postów, może to być trudne, ponieważ deweloper motywu najprawdopodobniej nie stworzył warunku dla niestandardowego typu postu Pobieranie, to znaczy, jeśli motyw nie został napisany z myślą o EDD.

Chociaż nie jest to miejsce, aby zagłębiać się w szczegóły tworzenia motywu, w tym scenariuszu jest tak samo, jak w przypadku zastępowania
single.php dla szablonów produktów. Możesz użyć pliku singular.php do utworzenia (poprzez duplikację) pliku single-download.php. Jedyna różnica polega na tym, że będziesz musiał lepiej zrozumieć kod w tym pliku, aby zmodyfikować go do użytku z produktami.

Szablony pojedynczych produktów - Podsumowanie

Nie jest to przewodnik po tworzeniu motywów WordPress. Zamiast tego celem jest pokazanie, jak EDD współpracuje z WordPress, abyś mógł używać szablonów pojedynczych produktów do wyświetlania stron swoich produktów.

Jeśli nie jesteś deweloperem motywów WordPress, może to być coś, co chcesz zlecić komuś z doświadczeniem w tej dziedzinie. Utworzenie niezbędnego pliku to tylko jeden krok. Tworzenie (lub edycja) kodu w pliku to zupełnie inne zadanie, które wymaga pewnego doświadczenia lub przynajmniej znajomości HTML i PHP.