# Automatyczne Linkowanie Wewnętrzne dla Shopware 6 > Wprowadzenie DfInternalLinking automatyzuje linkowanie wewnętrzne Twojego sklepu Shopware 6. Definiujesz reguły wiążące słowo kluczowe ze stroną docelową (produktem, kategorią albo dowolnym adresem URL), a moduł zamienia wystąpienia tego słowa kluczowego… - Strona: - Język: pl - Zaktualizowano: 2026-07-29 - Inne języki: [fr](https://www.datafirefly.com/documentation/shopware-internal-linking/index.md), [en](https://www.datafirefly.com/en/documentation/shopware-internal-linking/index.md), [de](https://www.datafirefly.com/de/documentation/shopware-internal-linking/index.md), [es](https://www.datafirefly.com/es/documentation/shopware-internal-linking/index.md), [it](https://www.datafirefly.com/it/documentation/shopware-internal-linking/index.md), [nl](https://www.datafirefly.com/nl/documentation/shopware-internal-linking/index.md), [pt](https://www.datafirefly.com/pt/documentation/shopware-internal-linking/index.md) - Indeks: ## Wprowadzenie DfInternalLinking automatyzuje linkowanie wewnętrzne Twojego sklepu Shopware 6. Definiujesz reguły wiążące słowo kluczowe ze stroną docelową (produktem, kategorią albo dowolnym adresem URL), a moduł zamienia wystąpienia tego słowa kluczowego w kontekstowe linki w opisach produktów i blokach treści CMS. **Wstrzykiwanie nieinwazyjne:** linki są dodawane wyłącznie w momencie renderowania strony. Twoja treść w bazie danych nigdy nie jest modyfikowana. Wyłączenie modułu sprawia, że wszystkie linki znikają, nie zostawiając żadnego śladu. ## Zgodność - Shopware 6.5.x, 6.6.x i 6.7.x - PHP 8.1 lub nowszy, zgodnie z wymaganiami Twojej wersji Shopware - Wielokanałowość: niezależna konfiguracja per kanał sprzedaży - Administracja przetłumaczona na angielski, niemiecki, francuski, hiszpański i włoski ## Instalacja ### Z poziomu administracji 1. Przejdź do **Rozszerzenia > Moje rozszerzenia**. 2. Kliknij **Prześlij rozszerzenie** i wybierz plik ZIP modułu. 3. Kliknij **Zainstaluj**, a następnie aktywuj rozszerzenie przełącznikiem. ### Z wiersza poleceń Rozpakuj katalog pluginu do `custom/plugins/`, a następnie wykonaj: ``` bin/console plugin:refresh bin/console plugin:install --activate DfInternalLinking bin/console cache:clear ``` Jeśli instalujesz ze źródeł, a nie z prekompilowanego ZIP-a, przebuduj administrację: ``` ./bin/build-administration.sh ``` ## Konfiguracja ogólna Otwórz **Ustawienia > System > Rozszerzenia**, a następnie ustawienia DfInternalLinking. Każdą opcję można zdefiniować globalnie albo per kanał sprzedaży. - **Włącz linkowanie**: włącza albo wyłącza wstrzykiwanie linków. Wartość domyślna: włączone. - **Maksymalna liczba linków na stronę**: globalny budżet linków wstrzykiwanych na jednej stronie, łącznie ze wszystkich reguł. Wartość domyślna: 5. - **Tryb silosowy**: stosuje regułę tylko wtedy, gdy jej cel dzieli gałąź kategorii z bieżącą stroną. Wartość domyślna: wyłączone. - **Dodaj nofollow**: dodaje atrybut rel nofollow do generowanych linków. Wartość domyślna: wyłączone. - **Klasa CSS linków**: klasa stosowana do każdego generowanego linku, do stylowania w Twoim motywie. Wartość domyślna: df-internal-link. ## Utworzenie reguły słowa kluczowego Moduł dodaje pozycję **Linkowanie wewnętrzne** w menu **Marketing** administracji. Kliknij **Dodaj regułę**, aby otworzyć formularz. - **Słowo kluczowe**: wyrażenie do wykrycia w Twoich treściach. Wykrywanie jest niewrażliwe na wielkość liter i respektuje granice słów. - **Typ celu**: Produkt, Kategoria albo Własny adres URL. - **Produkt / Kategoria docelowa**: wyświetlany selektor zależy od wybranego typu. Kanoniczny adres SEO jest generowany automatycznie przez Shopware dla bieżącego kanału. - **Docelowy adres URL**: pole wyświetlane wyłącznie dla typu Własny adres URL. Przyjmuje adres bezwzględny albo ścieżkę względną. - **Maksymalna liczba linków na stronę**: limit właściwy dla tej reguły, stosowany dodatkowo do budżetu globalnego. - **Priorytet**: reguły są przetwarzane według rosnącego priorytetu. Przy równym priorytecie jako pierwsze stosowane jest dłuższe słowo kluczowe. - **Język**: ogranicza regułę do jednego języka. Zostaw puste, aby stosować ją do wszystkich. - **Kanał sprzedaży**: ogranicza regułę do jednego kanału. Zostaw puste, aby stosować ją do wszystkich. - **Aktywna**: pozwala tymczasowo wyłączyć regułę bez jej usuwania. Zacznij od niewielkiej liczby bardzo precyzyjnych reguł, ze słowami kluczowymi z dwóch albo trzech wyrazów. Zbyt ogólne słowa kluczowe tworzą szum i rozmywają linkowanie. ## Gdzie wstrzykiwane są linki Moduł przetwarza następujące treści: - Opis produktu na stronach produktów - Bloki treści typu tekst i HTML na stronach produktów, stronach nawigacji (kategoriach) i landing page'ach Analiza jest wykonywana na drzewie HTML i obejmuje wyłącznie węzły tekstowe. Następujące obszary są systematycznie pomijane: - Wnętrze istniejących linków - Nagłówki poziomów od 1 do 6 - Znaczniki script i style - Przyciski To zachowanie uzupełniają dwa zabezpieczenia: granice słów Unicode uniemożliwiają jakąkolwiek podmianę wewnątrz wyrazu, a strona nigdy nie linkuje sama do siebie. ## Tryb silosowy Tryb silosowy jest przeznaczony dla katalogów zorganizowanych w tematyczne uniwersa. Po włączeniu reguła jest stosowana wyłącznie wtedy, gdy jej cel dzieli co najmniej jedną gałąź kategorii z aktualnie renderowaną stroną. Konkretnie: na karcie produktu umieszczonego w gałęzi Turystyka piesza stosowane będą tylko reguły wskazujące na inne produkty albo kategorie z tej gałęzi. Reguły wskazujące na inną gałąź są pomijane. To koncentruje moc linkowania wewnątrz każdego silosu i wzmacnia spójność tematyczną odbieraną przez wyszukiwarki. Reguły typu Własny adres URL nie podlegają filtrowaniu silosowemu, ponieważ nie mają przypisania kategorialnego. ## Raport stron osieroconych Z listy reguł kliknij **Raport stron osieroconych**. Raport wymienia: - Aktywne produkty, które nie są celem żadnej aktywnej reguły - Aktywne kategorie typu strona, które nie są celem żadnej aktywnej reguły Każdej tabeli towarzyszą trzy statystyki: łączna liczba aktywnych elementów, liczba elementów podlinkowanych i liczba osieroconych. Traktuj ten raport jak mapę drogową: każda strona osierocona to strona, która nie otrzymuje żadnego linku wewnętrznego z Twojego katalogu. ## Cache i wdrożenie na produkcję Ponieważ linki są wstrzykiwane przy renderowaniu, każde utworzenie albo zmiana reguły pojawia się w sklepie dopiero po unieważnieniu cache HTTP storefrontu. Wyczyść cache po sesji edycji reguł: ``` bin/console cache:clear ``` Możesz też użyć przycisku czyszczenia cache dostępnego w administracji Shopware. ## Rozwiązywanie problemów ### Żaden link nie pojawia się w sklepie - Sprawdź, czy linkowanie jest włączone w konfiguracji dla danego kanału sprzedaży. - Sprawdź, czy reguła jest aktywna oraz czy jej język i kanał odpowiadają przeglądanej stronie. - Wyczyść cache storefrontu. - Upewnij się, że słowo kluczowe faktycznie występuje w opisie, poza linkiem i poza nagłówkiem. ### Mniej linków niż oczekiwano Globalny budżet na stronę został wyczerpany. Zwiększ wartość w konfiguracji albo obniż limit reguł o niższym priorytecie. ### Reguła jest pomijana na niektórych stronach Prawdopodobnie aktywny jest tryb silosowy, a cel reguły należy do innej gałęzi kategorii. Wyłącz tryb silosowy albo przypisz cel do właściwej gałęzi. ### Słowo kluczowe linkuje w złe miejsce Dwie konkurujące reguły celują w ten sam tekst. Skoryguj priorytet: najniższa wartość jest przetwarzana jako pierwsza. ## Odinstalowanie Przy odinstalowaniu, jeśli nie zaznaczysz opcji zachowania danych, tabela reguł zostanie usunięta. Twoje opisy produktów i treści CMS pozostają nietknięte, ponieważ nigdy nie były modyfikowane.