Produkty specjalne kategorii - wtyczka dla aplikacji "Sklep"

Opis i ustawienia

Wtyczka "Produkty specjalne kategorii" generuje i wyświetla listy ulubionych produktów dla danej kategorii. Funkcjonalność wtyczki jest podobna do list dynamicznych wbudowanych w aplikacją "Sklep", ale wybór produktów do listy jest dokonywany z bieżącej lub określonej kategorii, a nie ze wszystkich produktów sklepu.

Wyświetlenie listy nad główną listą produktów w kategorii pozwala zwrócić uwagę klienta na nowe produkty, najpopularniejsze produkty, oferty rabatowe na produkty, które znajdują się w kategorii przeglądanej przez potencjalnego klienta.

Listy są tworzone bez parametrów sortowania i filtrowania w kategorii, jeśli odwiedzający je ustawił.

Maksymalna liczba produktów na liście jest określona w ustawieniach wtyczki. Nie podawaj niepotrzebnie bardzo dużej liczby, 6-12 produktów na każdej liście będzie w zupełności wystarczające. Dokładna liczba produktów w wyniku może być mniejsza od podanej, jeśli dana kategoria nie ma odpowiedniej liczby produktów. Lista może być nawet pusta.

Wtyczka generuje cztery rodzaje list:

• Nowe produkty - lista najnowszych produktów w danej kategorii. Jest to lista produktów z danej kategorii, uporządkowanych malejąco według daty utworzenia. Najnowszy produkt jest pierwszym. Można również ustawić limit dni, po upływie których produkt jest uznawany za nowy. Następnie towary utworzone wcześniej nie trafią do wyboru.
• Najlepiej sprzedające się - lista towarów uporządkowanych według liczby sprzedaży i posortowanych malejąco. Produkty o tej samej liczbie sprzedaży są sortowane według nazwy.
• Najlepiej oceniane - produkty uporządkowane według oceny w kolejności malejącej. Produkty o tej samej ocenie są również sortowane według nazwy.
• Najkorzystniejsze - produkty z najwyższym rabatem liczbowym. Rabat jest obliczany jako różnica między ceną "przekreśloną" a ceną sprzedaży. Towary z tą samą zniżką są również sortowane według nazwy. Towary bez rabatu (z rabatem równym zero lub o wartości ujemnej) oraz towary, których cena nie jest przekreślona, nie są uwzględniane w wykazie.

Ustawienia sklepu wpływające na działanie wtyczki

• Sprzedaż produktów niedostępnych w magazynie. Jeśli użytkownik ma możliwość zamawiania produktów niedostępnych w magazynie, takie produkty są umieszczane na listach. Jeśli pozycje niedostępne w magazynie nie są dopuszczone do sprzedaży, nie będą wyświetlane na listach.
• Wyświetlanie produktów z podkategorii. Produkty są wyświetlane zgodnie z ustawieniem "Uwzględniaj produkty z podkategorii". Jeśli w ustawieniach kategorii umożliwiono pokazywanie produktów z podkategorii, to takie produkty będą brane pod uwagę przy tworzeniu list. I odwrotnie.

Zarządzanie wyświetlaniem list

Funkcje wbudowanego szablonu

W szablonie osadzonym dostępne są trzy zmienne, z których dwie wa_theme_url i wa_theme_path są podobne do zmiennych szablonów motywów głównej aplikacji. Można ich użyć na przykład do dołączenia standardowego szablonu z motywu projektu do wyświetlania list, zwykle list-thumbs.html lub list-thumbs-mini.html. Może to pomóc w ujednoliceniu wyglądu z pozostałymi częściami motywu.

Szablon wbudowany przekazuje również zmienną lists jako tablicę asocjacyjną z identyfikatorami list jako kluczami i produktami jako wartościami.

Dozwolone klucze to: newest, top_rated, top_selling i best_buys.

array(
'najnowsze' => array(/* tablica towarów */),
'top_rated' => array(/* tablica towarów */),
'top_selling' => array(/* tablica towarów */),
'best_buys' => array(/* tablica towarów */)
);

Każda lista ma taki sam format, jak tablica produktów w kategorii lub lista produktów.

Wyświetlanie przy użyciu haka frontend_category

Wbudowany szablon jest wyświetlany w miejscu określonym przez hak frontend_category. W ustawieniach wtyczki można opcjonalnie określić, że szablon jest wyświetlany tylko na pierwszej stronie kategorii, jeśli używasz nawigacji stronicowej. Można także całkowicie wyłączyć obsługę haków.

Wyświetlanie wbudowanego szablonu w dowolnym miejscu

Jeśli chcesz wyświetlić wynik działania wtyczki przy użyciu wbudowanego szablonu w dowolnym miejscu na stronie kategorii, możesz użyć metody shopFeaprocatPlugin::render($category_id) zastępując $category_id na ID kategorii (oczywiście może być inny niż aktualny, ale po co?).

Przykład wywołania z pliku category.html:

Pobieranie danych bez użycia wbudowanego szablonu

Można po prostu pobierać dane jako tablicę i nie używać wbudowanych opcji szablonów lub wtyczek. W tym celu należy wywołać metodę shopFeaprocatPlugin::getProducts($options), gdzie $options jest tablicą z ustawieniami. Format tablicy ustawień:

$options = array(
'category_id' => id_категории /* ID kategorii. Wymagany klucz */
'list_types' => array( /* tablica żądanych list. Identyfikator listy powinien */
'newest'=> 1, /* być kluczem tablicy, a wartość powinna być */
... /* więcej 0 */
),
'max_products' => 12, /* Maksymalna liczba produktów na liście, domyślnie 12 */
'days_new' => 30 /* Ograniczenie do "wieku" nowych produktów, określ */
/* 0, aby wyłączyć. Domyślnie 30 dni */
)