KS Pretty URLs

1. Opis modułu

KS Pretty URLs to profesjonalny moduł dla PrestaShop 8.x, który usuwa identyfikatory numeryczne (ID) z adresów URL, tworząc czyste, przyjazne dla SEO linki.

2. Funkcjonalności

Obsługiwane typy encji

Kluczowe cechy

• Automatyczne przekierowania 301 Stare URL-e z ID automatycznie przekierowują na nowe
• Wielojęzyczność Osobne pretty URL-e dla każdego języka
• Multishop Pełna obsługa wielu sklepów
• Opcjonalne prefiksy Możliwość dodania prefiksów jak /c/, /p/
• Panel zarządzania Edycja, usuwanie i regeneracja URL-i
• Statystyki przekierowań Monitoring użycia starych linków
• Automatyczna aktualizacja Nowe URL-e generowane przy zapisie encji
• Obsługa konfliktów Automatyczne dodawanie sufiksów dla duplikatów

3. Wymagania systemowe

Zgodność z modułami

4. Struktura plików

modules/ks_prettyurls/
├── ks_prettyurls.php          # Główny plik modułu
├── config.xml                  # Konfiguracja XML
├── LICENSE.txt                 # Licencja
├── logo.png                    # Logo modułu (32x32)
├── index.php                   # Plik bezpieczeństwa
│
├── classes/
│   ├── KsPrettyUrlsManager.php # Klasa zarządzająca URL-ami
│   ├── KsTabManager.php        # Klasa menu KamikStudio
│   └── index.php
│
├── controllers/
│   └── admin/
│       ├── AdminKsPrettyUrlsController.php
│       └── index.php
│
├── views/
│   ├── css/
│   │   ├── admin.css
│   │   └── index.php
│   └── templates/
│       └── admin/
│           └── index.php
│
├── sql/
│   └── index.php
│
├── translations/
│   └── index.php
│
└── upgrade/
    └── index.php

override/classes/
├── Link.php                    # Override generowania linków
└── Dispatcher.php              # Override routingu

5. Instalacja

# Przez SCP
scp -r ks_prettyurls/ user@server:/var/www/prestashop/modules/

# Lub przez FTP - prześlij folder ks_prettyurls do /modules/

scp Link.php user@server:/var/www/prestashop/override/classes/
scp Dispatcher.php user@server:/var/www/prestashop/override/classes/

rm -f /var/www/prestashop/var/cache/prod/class_index.php
rm -f /var/www/prestashop/var/cache/dev/class_index.php

6. Konfiguracja

Dostęp do konfiguracji

Menu: KamikStudio → KS Pretty URLs → Konfiguruj
Lub: Moduły → KS Pretty URLs → Konfiguruj

Typy encji (włącz/wyłącz)

Prefiksy URL (opcjonalne)

Prefiksy pozwalają uniknąć konfliktów URL-i między różnymi typami encji.

Ustawienia przekierowań

7. Użytkowanie

Panel zarządzania URL-ami

Menu: KamikStudio → KS Pretty URLs

Automatyczne generowanie

URL-e są generowane automatycznie gdy:

• Tworzysz nową kategorię/produkt/stronę CMS
• Edytujesz istniejącą encję i zmieniasz slug (link_rewrite)

Ręczna edycja URL-a

1. Przejdź do listy URL-i
2. Kliknij ikonę edycji przy wybranym wpisie
3. Zmień pole "Pretty URL"
4. Zapisz

8. Baza danych

Tabela: ps_ks_pretty_urls

Przechowuje mapowanie pretty URL → encja.

CREATE TABLE `ps_ks_pretty_urls` (
    `id_pretty_url` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT,
    `entity_type` VARCHAR(50) NOT NULL,
    `id_entity` INT(11) UNSIGNED NOT NULL,
    `id_lang` INT(11) UNSIGNED NOT NULL,
    `id_shop` INT(11) UNSIGNED NOT NULL,
    `pretty_url` VARCHAR(255) NOT NULL,
    `original_url` VARCHAR(255) NOT NULL,
    `active` TINYINT(1) NOT NULL DEFAULT 1,
    `date_add` DATETIME NOT NULL,
    `date_upd` DATETIME NOT NULL,
    
    PRIMARY KEY (`id_pretty_url`),
    UNIQUE KEY `unique_pretty` (`pretty_url`, `id_lang`, `id_shop`),
    UNIQUE KEY `unique_entity` (`entity_type`, `id_entity`, `id_lang`, `id_shop`)
);

Tabela: ps_ks_pretty_urls_redirects

Przechowuje przekierowania ze starych URL-i.

CREATE TABLE `ps_ks_pretty_urls_redirects` (
    `id_redirect` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT,
    `old_url` VARCHAR(255) NOT NULL,
    `new_url` VARCHAR(255) NOT NULL,
    `id_lang` INT(11) UNSIGNED NOT NULL,
    `id_shop` INT(11) UNSIGNED NOT NULL,
    `redirect_type` SMALLINT(3) NOT NULL DEFAULT 301,
    `hits` INT(11) UNSIGNED NOT NULL DEFAULT 0,
    `last_hit` DATETIME DEFAULT NULL,
    `active` TINYINT(1) NOT NULL DEFAULT 1,
    `date_add` DATETIME NOT NULL,
    
    PRIMARY KEY (`id_redirect`),
    UNIQUE KEY `unique_old_url` (`old_url`, `id_lang`, `id_shop`)
);

9. Jak to działa

Generowanie URL-i

Generowanie linków (Frontend)

Rozwiązywanie URL-i (Request)

10. System menu KamikStudio

Moduł automatycznie integruje się z centralnym menu KamikStudio w panelu administracyjnym.

Jak to działa

1. Pierwszy moduł KS instalowany → KsTabManager tworzy główną zakładkę "KamikStudio" + zakładkę modułu
2. Kolejny moduł KS instalowany → Dodaje tylko zakładkę nowego modułu
3. Ostatni moduł KS odinstalowany → Usuwa główną zakładkę i pliki override

Struktura menu

📁 KamikStudio
    ├── 🏠 KS Homepage
    ├── 📋 KS Listing Pro
    └── 🔗 KS Pretty URLs

11. Rozwiązywanie problemów

# Sprawdź pliki override
ls -la override/classes/Link.php
ls -la override/classes/Dispatcher.php

# Usuń cache klas
rm -f var/cache/prod/class_index.php
rm -f var/cache/dev/class_index.php

// Sprawdź czy override jest załadowany (tymczasowo w index.php)
var_dump(get_parent_class('Link'));
// Powinno zwrócić: "LinkCore"

cd ~/public_html/sklep && php -r "
require 'config/config.inc.php';
require 'modules/ks_prettyurls/classes/KsTabManager.php';
KsTabManager::installTab('ks_prettyurls', 'AdminKsPrettyUrls', 'KS Pretty URLs', 'link');
echo 'Gotowe!';
"
rm -f var/cache/prod/class_index.php

12. FAQ

13. Licencja

14. Changelog

15. Wsparcie