1. Zawartość
Jest to aplikacja wyłącznie Command Line Interface (CLI).
Generowana mapa witryny jest zgodna ze schematami www.sitemaps.org.
Generator działa w środowisku Unix oraz Windows.
Wsparcie dla witryn posiadających dziesiątki/setki tysięcy elementów, największa strona (sklep), na której generator był testowany to baza zawierająca około 150000 aktywnych produktów Hikashop.
1.1. Główna mapa (map index) jest dostępna w głównym katalogu instalacji Joomla w pliku sitemap.xml.
1.2. Właściwe mapy z urlami dla poszczególnych elementów dostępne są w podkatalogu sitemap znajdującym się w głównym katalogu instalacji Joomla (/sitemap/*).
1.3. Mapy zawierają także zdjęcia elementów (kategorii, artykułów, produktów etc.).
1.4. Każdy zbiór elementów znajduje się w osobnej mapie (kategorie Joomla osobno, artykuły Joomla osobno, produkty Hikashop osobno, kategorie Hikashop osobno, kategorie K2 osobno, artykuły K2 osobno i użytkownicy K2 osobno).
1.5. Maksymalna ilość URL na jedną mapę to 49999, w przypadku występowania większej ilości urli, elementy dzielone są na kilka plików.
2. Wymagania
2.1. Konieczne jest wypełnienie canonical url dla produktów i dla kategorii Hikashop. W konfiguracji Hikashop dobrze mieć włączone autowypełnianie canonical urls.
2.2. Konieczne jest utworzenie przynajmniej jednej pozycji menu kategorii K2.
2.3. Dla poprawnego działania na witrynach wielojęzycznych, konieczne jest powiązane elementów, aby w mapie witryny był zawarty link alternatywny do innych wersji językowych danego urla. Konieczne jest włączenie pluginu wielojęzyczności. Każdy element, np. artykuł Joomla, kategoria K2 itp., musi mieć określony język, w jakim został napisany. Jeżeli witryna jest w jednym jeżyku, nie jest konieczne określanie w jakim języku jest dany element.
2.4. Domyślny język witryny (frontu) jest to podstawowa lokalizacja, np. gdy frontowy język to en-GB - główny url elementu będzie posiadał "/en/" w adresie, w przypadku kolejnego innego języka np. pl-PL - będzie określony link alternatywny "/pl/" w adresie url wraz z odpowiednim aliasem elementu (plugin wielojęzyczności musi być włączony).
2.5. Jeżeli element nie ma być zawarty w mapie strony, to musi mieć w opcjach metadata (jeżeli takie są dostępne w danym komponencie) parametr robots ustawiony na "noindex[...]". Może to być określone w danym elemencie, np. artykule Joomla, ale można także to określić w pozycjach menu Joomla przypisanych do danych elementów.
2.6. Jeżeli elementy mają być zawarte w mapie witryny, muszą być włączone oraz muszą mieć ustawiony dostęp publiczny (nie wymagający logowania się), w przeciwnym razie będzie indeksowana strona logowania zamiast docelowa.
2.7. Sugerowane wymagania systemowe strony: Unix/Windows, PHP 7.x, MySQL >=5.6, Joomla 3.x.
2.8. Parametr wejściowy baseUrl to adres domeny, której dotyczy mapa strony. Jeżeli baseUrl nie został podany, to główny adres domeny jest pobierany z konfiguracji Joomla (pole live site), a jeżeli pole live site także nie jest wypełnione, to skrypt zakończy działanie z odpowiednim komunikatem, nie generując mapy strony. Parametr baseUrl lub live site jest wymagany do wygenerowania mapy strony Joomla.
3. Instrukcja instalacji
Pobierz zakupione rozszerzenie Sitemap generator dla Joomla za pośrednictwem swojego konta klienta dostępnego na naszej stronie.
Na swojej stronie w panelu administratora Joomla przejdź do: Rozszerzenia -> Instalacje -> Instalowanie.
Wybierz zakładkę Instaluj z pakietu.
Wybierz plik o nazwie file_sitemap_generator.zip ze swojego dysku, aby go zainstalować.
4. Przykładowe użycie
4.1. CLI Unix:
/usr/bin/php "/your_joomla_base_directory_path/cli/ignisdev_sitemap.php" --baseUrl="http://www.twojastrona.com"
4.2. CLI Windows Xampp:
C:\xampp\php\php.exe "C:\xampp\htdocs\your_joomla_directory\cli\ignisdev_sitemap.php" --baseUrl="http://www.twojastrona.com"
4.3. Jak ustawić Cron?
Cron można ustawić na dowolną godzinę, lecz najlepszą opcją jest ustawienie Cron na godziny nocne, gdy jest najmniejszy ruch na stronie, jest to szczególnie ważne, gdy strona zawiera dziesiątki/setki tysięcy elementów. Unix php Cron wykonywany o 2:00 nad ranem ze ścieżką do ignisdev_sitemap.php powinien wyglądać podobnie do poniższego:
0 0 2 * * * * /usr/bin/php "/sciezka_do_twojego_katalogu_joomla/cli/ignisdev_sitemap.php" --baseUrl="http://www.twojastrona.com"
4.4. Zgłoszenie do Google search Console lub innych narzędzi dla webmasterów
W Google Search Console podajemy tylko adres głównej mapy, czyli http://www.twojastrona.com/sitemap.xml, ponieważ jest to indeks wszystkich map dostępnych elementów znajdujących się w podkatalogu sitemap, który znajduje się w głównym katalogu Twojej strony Joomla.