Pakiet treści SEO: konfiguracja i pomoc

Prześlij i zainstaluj osobno każdy plik ZIP komponentu przez Moduły > "Menedżer modułów" > "Prześlij moduł". Opis obejmuje moduły mprseoimagesalttags, mprseoimageslazytags, mprinternallinking, mprsubtitles i mprsecondcategorydescription. Pakiet nie ma wspólnego ekranu konfiguracji. W starszych wersjach PrestaShop użyj odpowiedniej strony modułów.

Otwórz Konfiguruj dla każdego zainstalowanego modułu. Zacznij od jednego języka i jednego produktu/kategorii, aby sprawdzić zmiany. Przypisz jeden moduł do każdego rodzaju generowanej zawartości, jeśli motyw lub inny moduł już ją tworzy.

Otwórz SEO Images Alt Tags > Konfiguracja. Ogólne zawiera Włącz moduł, Nadpisuj istniejące tagi alt i Maksymalna długość tekstu alt. Szablony zawiera trzy szablony.

• Włącz moduł. Włącza lub wyłącza automatyczne generowanie podpisów obrazów; domyślnie: 1. Ustaw w SEO Images Alt Tags → Konfiguracja.
• Nadpisuj istniejące tagi alt. Po włączeniu zastępuje istniejące podpisy, a po wyłączeniu uzupełnia tylko puste; domyślnie: 0.
• Maksymalna długość tekstu alt. Ogranicza wygenerowany tekst alt do tej liczby znaków, korzystając z pobliskiej granicy słowa, jeśli jest dostępna; długie słowa mogą zostać ucięte; domyślnie: 125.
• Szablon strony produktu. Steruje tekstem alt obrazów na stronie produktu; domyślnie: {product_name} - {manufacturer}.
• Szablon listingu produktów. Steruje tekstem alt obrazów w kategoriach, wynikach wyszukiwania i listach; domyślnie: {product_name} - {category}.
• Szablon obrazów kategorii. Steruje tekstem alt obrazów kategorii w obsługiwanych presenterach kategorii; domyślnie: {category_name}.

Pozostaw Nadpisuj istniejące tagi alt wyłączone, jeśli chcesz zachować ręcznie napisane podpisy obrazów. Włącz tylko wtedy, gdy szablon ma zastępować te prezentowane podpisy. Zmienne produktu obejmują też {isbn}, {upc}, {mpn} i {image_position}. Szablony kategorii obsługują {category_name} i {category_description}. Wartość {image_position} jest przekazywana tylko dla obrazów galerii na stronach produktów, bez obrazów głównych, domyślnych i obrazów na listach.

Moduł zmienia prezentowane podpisy przez actionPresentProduct, actionPresentProductListing i, gdy jest dostępny, actionPresentCategory. Główne obrazy kategorii wymagają tego hooka, dostępnego w PrestaShop 9.1 lub nowszym. Rekordy obrazów w bazie nie są masowo edytowane. Te zmienne nie są rozwijane w zwykłych opisach produktów.

Otwórz ekran Konfiguracja modułu Lazy Tags.

• Włącz lazy loading. Włącza lub wyłącza wstawianie atrybutów opóźnionego ładowania; domyślnie: 1. Ustaw w Automatic SEO Images Lazy Tags → Konfiguracja.
• Klasa CSS wykluczenia. Steruje wykluczeniem pasujących obrazów w treści HTML z opóźnionego ładowania; nie gwarantuje zachowania wszystkich atrybutów obrazu bez zmian; domyślnie: no-autolazy.
• Dodaj decoding="async". Dodaje dekodowanie asynchroniczne tam, gdzie moduł dodaje lub uzupełnia atrybuty obrazów; domyślnie: 1.

W treści HTML istniejące wartości loading są zachowywane. Przy włączonym dekodowaniu asynchronicznym obraz z istniejącym atrybutem loading może otrzymać decoding="async" przed sprawdzeniem klasy wykluczenia. Dane obrazów produktów otrzymują loading="lazy" i opcjonalnie decoding="async" niezależnie od tej klasy; szablony produktów muszą wypisywać te wartości. Moduł nie kompresuje obrazów, nie tworzy plików WebP ani nie konfiguruje CDN.

Otwórz Internal Linking > Konfiguracja. Ustawienia są pogrupowane w Ogólne, Reguły, Wyświetlanie i Wykluczenia.

• Maksymalna liczba linków na stronę. Ustawia globalny limit generowanych linków na stronie; 0 oznacza brak limitu; domyślnie: 5.
• Maksymalna liczba linków na grupę. Ustawia domyślny limit jednej grupy linków; Maks. linków z tej grupy może go nadpisać dla pojedynczej grupy; domyślnie: 3.
• Domyślny cel linku. Ustawia atrybut target generowanych linków, chyba że grupa go nadpisze; domyślnie: _self.
• Domyślny atrybut rel linku. Ustawia atrybut rel generowanych linków, chyba że grupa go nadpisze; domyślnie: puste.
• Domyślna klasa CSS linku. Dodaje klasę CSS do generowanych linków, chyba że grupa ją nadpisze; domyślnie: mpr-autolink.
• Włącz profilowanie debugowania. Dodaje informacje diagnostyczne o generowaniu linków jako komentarz HTML; domyślnie: 0.
• Adresy IP debugowania. Przy włączonym debugowaniu ogranicza diagnostykę do adresów IP rozdzielonych przecinkami; domyślnie: puste.
• Zapobiegaj duplikatom href. Zmiana tego ustawienia nie ma wpływu na wynik. Istniejące linki do celu zawsze wliczają się do dodatniego limitu grupy; domyślnie: 1.
• Zapobiegaj linkowi w już zlinkowanym elemencie nadrzędnym. Zmiana tego ustawienia nie ma wpływu na wynik. Tekst wewnątrz linku jest pomijany, ale pozostały tekst w tym samym elemencie nadrzędnym może otrzymać linki; domyślnie: 0.
• Zapobiegaj wielu automatycznym linkom w tym samym elemencie. Ogranicza linki w każdym ciągłym fragmencie tekstu. Zagnieżdżone elementy i kolejne grupy mogą dodawać dalsze linki w tym samym elemencie nadrzędnym; domyślnie: 1.
• Proporcjonalna dystrybucja limitu globalnego. Dzieli globalny limit strony między grupy, gdy suma ich limitów jest większa; domyślnie: 1.
• Równomierny rozkład linków w tekście. Zmiana tego ustawienia nie ma wpływu na wynik. Linki są dodawane według kolejności obszarów treści, grup, słów kluczowych i dopasowań w tekście; domyślnie: 1.
• Uwzględnione selektory CSS. Określa kwalifikujące się obszary strony, gdy nie wybrano strefy treści grupy; domyślnie: .product-description, #description, .page-content, .post-content.
• Uwzględnione tagi HTML. Określa elementy HTML, w których można umieszczać linki; domyślnie: p,div,span,blockquote,li,td.
• Pomiń URL bieżącej strony. Zapobiega linkowaniu strony do samej siebie; domyślnie: 1.
• Wyklucz nagłówki. Zapobiega generowaniu linków wewnątrz h1 do h6; domyślnie: 1.
• Wyklucz tekst pogrubiony. Zapobiega generowaniu linków wewnątrz <strong> lub <b>; domyślnie: 0.
• "Wykluczone strony". Pozwala wykluczyć wybrane strony CMS ze wstawiania linków; domyślnie: puste.

Podczas testów zachowaj początkowe limity. Zmień Uwzględnione selektory CSS, jeśli motyw używa innych kontenerów treści. Istniejące kotwice nie są zamieniane w zagnieżdżone linki. Moduł edytuje kwalifikujący się HTML sklepu przez actionOutputHTMLBefore; nie przepisuje zapisanych opisów.

Utwórz grupę linków

Otwórz stronę grup modułu, dodaj grupę i wypełnij te pola:

• Nazwa. Zapisuje wewnętrzną nazwę grupy linków; domyślnie: puste.
• Encja docelowa. Wybiera produkt, kategorię, stronę CMS, producenta lub dostawcę, aby automatycznie ustalić docelowy URL; domyślnie: puste.
• Docelowy URL. Ustawia URL, do którego będą prowadzić dopasowane słowa kluczowe; domyślnie: puste.
• Docelowy URL (nadpisanie językowe). Po wypełnieniu zastępuje docelowy URL dla danego języka; domyślnie: puste.
• Słowa kluczowe. Ustawia oddzielone przecinkami słowa kluczowe, wzorce z symbolami wieloznacznymi lub warianty do dopasowania; domyślnie: puste.
• Słowa kluczowe (nadpisanie językowe). Po wypełnieniu zastępuje listę słów kluczowych dla danego języka; domyślnie: puste.
• Strefy treści. Ogranicza wstawianie do wybranych stref, takich jak opis produktu, opis kategorii, treść CMS, treść bloga, opis producenta lub dostawcy; domyślnie: puste.
• Typy stron. Ogranicza grupę do stron produktów, kategorii, CMS, bloga, producentów, dostawców lub strony głównej; domyślnie: puste.
• Pozycja linku. Zapisuje first, middle, last lub spread, ale nie zmienia rozmieszczenia; dopasowania są przetwarzane w kolejności treści; domyślnie: first.
• Maks. linków z tej grupy. Ogranicza linki tej grupy na stronie; 0 używa globalnej wartości domyślnej; domyślnie: 0.
• Ignoruj wielkość liter. Dopasowuje słowa kluczowe bez uwzględniania wielkości liter; domyślnie: 1.
• Dodaj tag <strong>. Otacza wygenerowany tekst kotwicy znacznikiem <strong>; domyślnie: 0.
• Włącz ogólny limit linków. Wlicza istniejące linki w treści do limitu tej grupy; domyślnie: 0.
• Cel linku. Nadpisuje globalny atrybut target dla tej grupy; domyślnie: puste.
• Atrybut rel linku. Nadpisuje globalną wartość rel dla tej grupy; domyślnie: puste.
• Klasa CSS linku. Nadpisuje globalną klasę CSS dla tej grupy; domyślnie: puste.
• Selektory CSS (zaawansowane). Nadpisuje selektory dla tej grupy, gdy nie wybrano stref treści; domyślnie: puste.
• Tagi HTML (zaawansowane). Nadpisuje dozwolone znaczniki HTML dla tej grupy; domyślnie: puste.
• Priorytet. Steruje kolejnością przetwarzania; niższe liczby są obsługiwane najpierw; domyślnie: 0.
• Aktywny. Włącza lub wyłącza grupę; domyślnie: 1.

Przykładowo użyj Nazwa Shower trays, Docelowy URL /shower-trays, Słowa kluczowe shower tray, walk-in tray, wet room tray, Maks. linków z tej grupy 3, Pozycja linku first i Aktywny Tak. Ogranicz Strefy treści i Typy stron do zamierzonych stron. Używaj wielojęzycznych nadpisań, gdy słowa kluczowe lub cele różnią się zależnie od języka.

Import/eksport CSV używa pól pokazanych w poniższym przykładzie. Wyeksportuj grupę przed przygotowaniem większego importu, aby dopasować oczekiwane kolumny.

Otwórz SEO Subtitles > Konfiguracja.

• "Domyślny znacznik HTML". Ustawia domyślny znacznik podtytułu; domyślnie: h2. Ustaw w SEO Subtitles → Konfiguracja.
• "Domyślna klasa CSS". Dodaje dodatkową klasę CSS do podtytułów; domyślnie: mpr-seo-subtitle.
• "Tryb wyświetlania". Pokazuje tylko podtytuł o najwyższym priorytecie lub wszystkie pasujące podtytuły; domyślnie: single.

Utwórz rekordy na liście podtytułów:

• Tekst podtytułu. Zapisuje wielojęzyczny tekst podtytułu i obsługuje zmienne takie jak {name}, {category}, {manufacturer}, {price} i {reference}; domyślnie: puste.
• Nazwa. Zapisuje wewnętrzną nazwę reguły podtytułu; domyślnie: puste.
• Docelowe encje. Wybiera obiekty, do których podtytuł ma zastosowanie; domyślnie: puste.
• Tag HTML. Nadpisuje domyślny znacznik dla tego podtytułu; domyślnie: h2.
• Klasa CSS. Dodaje dodatkową klasę do tego podtytułu; domyślnie: puste.
• Priorytet. Decyduje, który podtytuł wygrywa w trybie pojedynczym; domyślnie: 10.
• Aktywny. Włącza lub wyłącza regułę podtytułu; domyślnie: 1.

Wyższe wartości priorytetu wygrywają w trybie single. Tryb wielokrotny wyświetla pasujące podtytuły posortowane według malejącego priorytetu. Wynik zawiera także klasę CSS określającą typ obiektu.

Podtytuł wymaga miejsca w motywie. Użyj narzędzi modułu do umieszczania w szablonach obsługiwanego motywu lub dodaj displayMprSubtitle ręcznie. Sam włączony rekord nie tworzy widocznego miejsca. Wybierz konkretne produkty, kategorie, strony CMS, producentów lub dostawców albo użyj obsługiwanych reguł selektora.

Otwórz Second Category Description > Ustawienia.

• "Włącz moduł". Pokazuje lub ukrywa drugie opisy na stronach kategorii; domyślnie: 1. Ustaw w Second Category Description → Ustawienia.
• "Tryb wyświetlania". Wybiera default, fullwidth lub inject; domyślnie: default.
• "Tylko pierwsza strona". Pomija drugi opis, gdy parametr żądania page jest większy niż 1; domyślnie: 1.
• "Klasa CSS". Ustawia klasę kontenera bloku opisu kategorii; domyślnie: mprscd-description.
• "Znacznik HTML kontenera". Ustawia element kontenera: div, section, article lub aside; domyślnie: div.

Edytuj kategorię i wypełnij jej wielojęzyczne pole tekstu sformatowanego Drugi opis kategorii. Tryb domyślny renderuje przez displayFooterCategory wewnątrz kolumny listy. Tryb pełnej szerokości dodaje w tym miejscu klasę CSS wychodzącą poza kolumnę. Tryb wstrzykiwania używa displayMprSecondCatDesc umieszczonego w szablonie. Użyj Szablony, jeśli chcesz zarządzać umiejscowieniem. Moduł automatycznie zarządza szczegółami umiejscowienia. Wynik w trybie wstrzykiwania używa klasy pełnej szerokości. Dopóki moduł nie zarejestruje aktywnego zarządzanego umiejscowienia, displayFooterCategory nadal wyświetla blok w tym trybie; dodanie ręcznego hooka może więc go powielić.

Blok pojawia się tylko na stronach kategorii i tylko wtedy, gdy bieżący język ma treść. Przy włączonym "Tylko pierwsza strona" jest pomijany, gdy page jest większe niż 1. Ta kontrola nie obejmuje paginacji używającej wyłącznie p.

Szablony tekstu alt mogą używać zmiennych produktu i kategorii:

Product Page Template:
{product_name} - {manufacturer} | {reference}

Product Listing Template:
{product_name} in {category}

Category Image Template:
{category_name} - {category_description}

Obrazy w edytowalnej treści HTML mogą pomijać opóźnione ładowanie dzięki skonfigurowanej klasie wykluczenia:

Grupę linków można zaimportować lub opisać za pomocą tych samych pól, których używa eksport CSV modułu:

name,target_url,keywords,link_position,max_links,ignore_case,add_strong,link_target,link_rel,link_class,content_zones,page_types,entity_type,entity_id,position,active
Walk-in shower drains,/shower-drains,"linear drain, shower drain, shower*",first,2,1,0,_self,,mpr-autolink,"[""product_description"",""category_description""]","[""product"",""category""]",category,12,0,1

Umiejscowienie podtytułu można wywołać z szablonu motywu, gdy potrzebujesz ręcznego pozycjonowania:

{hook h='displayMprSubtitle'}
{hook h='displayMprSubtitle' id_product=$product.id_product tag='h3' css_class='mpr-seo-subtitle'}

Wynikowy podtytuł zawsze zawiera klasy bazowe, więc CSS może obejmować wszystkie podtytuły lub jeden typ obiektu:

.mpr-subtitle {
  margin-top: 0;
  margin-bottom: .5rem;
}

.mpr-subtitle-product.mpr-seo-subtitle {
  font-size: 1rem;
  color: #666;
}

Second Category Description można umieścić przez jego niestandardowy hook, gdy tryb wyświetlania to inject:

{hook h='displayMprSecondCatDesc'}

Kontener drugiego opisu można stylizować przez skonfigurowaną klasę:

.mprscd-description {
  margin-top: 1.5rem;
  padding: 1.25rem;
}

.mprscd-description .mprscd-content img {
  max-width: 100%;
  height: auto;
}

Przykłady Smarty należą do szablonów motywu. Edytor CMS sam nie interpretuje składni hooków Smarty. Dodaj klasę wykluczenia do edytowalnych obrazów HTML. Zmiany wyglądu w CSS umieść w arkuszu stylów motywu.

1. Otwórz produkt z pustym podpisem obrazu. Sprawdź wyrenderowany alt. Jeśli istniejący tekst pozostaje bez zmian, sprawdź Nadpisuj istniejące tagi alt, zanim uznasz to za błąd.
2. Sprawdź loading i decoding obrazu w treści oraz obrazu produktu. Jeśli brakuje atrybutów produktu, potwierdź, że szablon wypisuje wartości presentera.
3. Otwórz stronę zawierającą słowo kluczowe grupy linków. Sprawdź wygenerowany cel, klasę i liczbę. Jeśli link nie powstaje, sprawdź nadpisanie językowe, selektory, dozwolone znaczniki, typ strony, wykluczenia istniejących linków i ochronę przed linkowaniem do samej siebie.
4. Otwórz wybrany obiekt podtytułu i sprawdź umiejscowienie hooka oraz priorytet. Jeśli brakuje drugiego opisu kategorii, sprawdź bieżący język, tryb wyświetlania i paginację.
5. Przetestuj odświeżenie listy, jeśli motyw zastępuje treść kategorii przez AJAX. Po zmianie umiejscowień w motywie wyczyść odpowiedni cache wyrenderowanych stron/szablonów.
6. Użyj strony Integralność każdego modułu, jeśli brakuje wymaganej tabeli lub hooka. Wyłącz profilowanie po sprawdzeniu wstawiania linków.

Wyłączaj komponenty osobno w "Menedżer modułów" albo używaj ich opcji "Włącz", gdy są dostępne. Wyeksportuj grupy linków i wykonaj kopię rekordów podtytułów/drugich opisów przed odinstalowaniem.

Alt Tags i Lazy Tags usuwają swoją konfigurację. Internal Linker usuwa konfigurację i schemat modułu. Subtitles zachowuje dane podtytułów i usuwa swoje ustawienia. Usuwa zarządzane umiejscowienia w motywie, gdy SEO Revolution nie jest zainstalowany; przy zainstalowanym SEO Revolution odinstalowanie wymaga aktywnego przejęcia obsługi podtytułów i zachowuje te umiejscowienia. Second Category Description próbuje usunąć zarządzane wstawki, usuwa swój schemat i wymienione ustawienia. Sprawdź motyw pod kątem ręcznie dodanych fragmentów hooków. Odinstalowanie nie przywraca wcześniejszej edycji motywu wykonanej poza narzędziami modułu.

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.