PrestaShop Product SEO Subtitles — Dokumentacja
Dodaje dedykowane podtytuły SEO po głównym nagłówku na stronach produktów, kategorii, CMS, producentów i dostawców. Zamiast zmieniać nazwę produktu lub kategorii, możesz dodać drugą linię, na przykład korzyść, frazę long-tail, szczegół dotyczący rozmiaru, materiał, markę albo komunikat kampanii.
Podtytuły SEO produktów
Każda ważna strona w sklepie ma główny tytuł, ale jeden tytuł często nie jest w stanie zawrzeć wszystkich fraz, których szukają klienci. SEO Subtitles daje osobny rekord podtytułu, który może być wyświetlany bezpośrednio po H1 strony, jako prawdziwy element HTML, taki jak h2, h3, p, span lub div.
Moduł nie ogranicza się do jednego, sztywno zakodowanego pola produktu. Zarządza regułami podtytułów w dedykowanej sekcji Back Office, gdzie każdy podtytuł może mieć własny tekst, wybór celu, tag HTML, klasę CSS, priorytet i status aktywności.
Typy stron/encji obsługiwane w kodzie modułu:
product
category
cms
manufacturer
supplier
Kompatybilność: PrestaShop 1.6 do 9.0 (latest), PHP 7.1+. Nadal wspieramy kolejne wersje PrestaShop.
Jak to działa
Po instalacji moduł dodaje nowe menu SEO Subtitles w Back Office. Z tego miejsca możesz tworzyć rekordy podtytułów i decydować, gdzie mają się pojawiać.
Rekord podtytułu zawiera:
Subtitle Text
Name
Target Entities
HTML Tag
CSS Class
Priority
Active
Podtytuł jest renderowany przez hook modułu:
{hook h='displayMprSubtitle'}
Dla list produktów lub niestandardowych miejsc w szablonie hook może również otrzymać ID produktu i opcje wyświetlania:
{hook h='displayMprSubtitle' id_product=$product.id}
{hook h='displayMprSubtitle' id_product=$product.id tag='h3'}
{hook h='displayMprSubtitle' tag='h3' css_class='category-subtitle'}
Wynik w sklepie to prawdziwy element HTML z klasami CSS modułu:
<h2 class="mpr-subtitle mpr-subtitle-product mpr-seo-subtitle">
Walk-in shower tray with anti-slip stone resin surface
</h2>
Jeśli nie istnieje pasujący aktywny podtytuł, nic nie jest wyświetlane, a strona zachowuje swój normalny układ.
Instalacja
- W Back Office przejdź do Modules → Module Manager
- Kliknij Upload a module i wybierz plik ZIP
- Zainstaluj moduł
- Otwórz SEO Subtitles w menu Back Office
- Użyj Templates, aby przeskanować szablon i dodać hook podtytułu tam, gdzie jest potrzebny
- Utwórz pierwszy podtytuł w sekcji Subtitles
Konfiguracja
Ustawienia domyślne
Moduł zapisuje główne ustawienia w swojej tabeli konfiguracji, używając tych kluczy:
default_tag = h2
default_class = mpr-seo-subtitle
display_mode = single
Ekran konfiguracji zawiera:
Default HTML Tag
Default CSS Class
Display Mode
Tag HTML
Możesz wybrać tag używany dla podtytułu. Dozwolone wartości to:
h2
h3
h4
h5
h6
p
span
div
Dla większości stron produktów i kategorii h2 jest najlepszym punktem wyjścia, ponieważ główny tytuł strony zwykle jest już elementem h1.
Przykład podtytułu z użyciem domyślnego tagu nagłówka:
Ultra-slim shower tray, stone resin finish, easy-clean surface
Przykład, gdy mniejszy nagłówek będzie bardziej odpowiedni:
HTML Tag: h3
Subtitle Text: Compatible with low-profile walk-in shower installation
Tryb wyświetlania
Moduł może pokazać jeden podtytuł albo wiele pasujących podtytułów.
single = show only the highest-priority matching subtitle
all = show all matching subtitles, sorted by priority
Priorytet jest sortowany od najwyższego do najniższego:
Priority 100 → shown before priority 10
Priority 10 → default priority
Klasa CSS
Każdy podtytuł zawsze otrzymuje bazowe klasy modułu:
mpr-subtitle
mpr-subtitle-product
mpr-subtitle-category
mpr-subtitle-cms
mpr-subtitle-manufacturer
mpr-subtitle-supplier
Twoja własna klasa jest dodawana po tych klasach. Przykład:
CSS Class: homepage-product-subtitle
Wynik na stronie produktu:
<h2 class="mpr-subtitle mpr-subtitle-product homepage-product-subtitle">
Made-to-measure shower screen in clear safety glass
</h2>
Template Manager
Moduł zawiera Template Manager, który skanuje pliki aktywnego szablonu, znajduje miejsca z nagłówkami i może wstawić hook podtytułu po wybranym nagłówku.
Wstrzyknięte hooki są otaczane markerami, aby można było je później śledzić i usuwać:
{* MPR_SUBTITLE_INJECT *}{hook h='displayMprSubtitle'}{* /MPR_SUBTITLE_INJECT *}
Manager sprawdza pliki szablonu w katalogu themes sklepu i działa tylko z plikami .tpl. Jeśli w tym samym pliku znajdzie istniejący, nieoznaczony hook displayMprSubtitle, zgłasza go zamiast dodawać duplikat.
Smart Tags
Tekst podtytułu obsługuje placeholdery. Są przydatne, gdy jedna reguła podtytułu ma automatycznie dopasowywać się do każdego produktu.
Popularne placeholdery produktu:
{name}
{reference}
{ean13}
{price}
{manufacturer}
{category}
{feature:Feature name}
{attribute:Attribute group name}
Przykłady:
{name} from {manufacturer} — available from {price}
{category} product with reference {reference}
{feature:Material} shower tray with {attribute:Color} finish
Dla stron kategorii, CMS, producenta i dostawcy {name} jest rozwiązywane jako nazwa bieżącej encji:
{name} — selected products and practical buying information
Kierowanie podtytułów
Podczas tworzenia podtytułu użyj Target Entities, aby zdecydować, gdzie ma się pojawić. Moduł obsługuje kierowanie na konkretne encje oraz szersze reguły wyboru.
Pojedynczy podtytuł produktu może być użyty dla jednego produktu:
Target: specific product
Subtitle Text: Low-profile shower tray with stone resin surface
HTML Tag: h2
Priority: 10
Active: Yes
Szersza reguła produktu może obejmować produkty według kategorii, producenta lub dostawcy, jeśli dane selektora używają takich warunków. Resolver obsługuje również wykluczenia, więc reguła może działać szeroko, pomijając wybrane produkty.
Obsługiwane metody kierowania produktów w resolverze:
all
specific
by_category
by_manufacturer
by_supplier
Obsługiwane wykluczenia:
specific
by_category
Praktyczne przykłady
Podtytuł produktu
Product name:
Shower Tray 90x90
Subtitle:
Ultra-slim stone resin tray with easy-clean anti-slip surface
Podtytuł kategorii
Category name:
Walk-in Shower Screens
Subtitle:
Frameless glass panels for modern wetroom and walk-in shower layouts
Podtytuł strony CMS
CMS page:
Delivery Information
Subtitle:
Shipping times, carrier options and delivery notes for bathroom products
Dynamiczny podtytuł produktu
{name} by {manufacturer} — {feature:Material}, available from {price}
Wskazówki
- Użyj podtytułu, aby dodać informacje, które nie mieszczą się naturalnie w tytule strony: materiał, rozmiar, typ montażu, wykończenie, kompatybilność albo frazę long-tail.
- Unikaj powtarzania nazwy produktu lub kategorii słowo w słowo. Podtytuł powinien dodawać użyteczny kontekst.
- Dbaj o to, aby podtytuły produktów były na tyle zwięzłe, by dobrze czytało się je na ekranach mobilnych.
- Używaj placeholderów dla powtarzalnych wzorców obejmujących wiele produktów.
- Używaj priorytetu, gdy kilka reguł podtytułów może pasować do tej samej strony.
- Zacznij od najważniejszych stron produktów i kategorii, a następnie rozszerzaj konfigurację na szersze reguły.
Najczęściej zadawane pytania
Czy podtytuł zmieni nazwę mojego produktu?
Nie. Podtytuł jest wyświetlany osobno. Nie zmienia nazwy produktu, kategorii, strony CMS, producenta ani dostawcy.
Czy podtytuł zmienia meta title?
Nie. Moduł renderuje treść podtytułu na stronie. Nie nadpisuje meta title strony.
Czy mogę zostawić puste podtytuły dla niektórych stron?
Tak. Jeśli do strony nie pasuje żaden aktywny podtytuł, moduł nie zwraca żadnego wyniku.
Czy mogę używać różnych podtytułów w różnych językach?
Tak. Tekst podtytułu jest wielojęzyczny, więc możesz wprowadzić osobny tekst dla każdego języka w sklepie.
Czy mogę wyświetlić więcej niż jeden podtytuł na tej samej stronie?
Tak. Ustaw tryb wyświetlania na all. W domyślnym trybie single pokazywany jest tylko pasujący podtytuł o najwyższym priorytecie.
Czy to zadziała z moim obecnym szablonem?
Moduł używa hooka Smarty i zawiera Template Manager do umieszczania tego hooka po nagłówku strony. Standardowe szablony PrestaShop powinny działać normalnie. Niestandardowe szablony mogą wymagać użycia Template Managera albo ręcznego umieszczenia hooka.
Jakiego hooka używa moduł?
Główny hook to:
{hook h='displayMprSubtitle'}
Dostępny jest także alias zgodności dla szablonów używających:
{hook h='displayProductSubtitle'}