KS Pretty URLs

1. Module overview

KS Pretty URLs is a professional module for PrestaShop 8.x that removes numeric identifiers (IDs) from URLs, creating clean, SEO-friendly links.

2. Features

Supported entity types

Key features

• Automatic 301 redirects Old URLs with IDs automatically redirect to the new ones
• Multilingual Separate pretty URLs for every language
• Multishop Full multi-store support
• Optional prefixes Ability to add prefixes such as /c/, /p/
• Management panel Edit, delete and regenerate URLs
• Redirect statistics Monitoring of old link usage
• Automatic updates New URLs generated when an entity is saved
• Conflict handling Automatic suffixes for duplicates

3. System requirements

Module compatibility

4. File structure

modules/ks_prettyurls/
├── ks_prettyurls.php          # Main module file
├── config.xml                  # XML configuration
├── LICENSE.txt                 # License
├── logo.png                    # Module logo (32x32)
├── index.php                   # Security file
│
├── classes/
│   ├── KsPrettyUrlsManager.php # URL management class
│   ├── KsTabManager.php        # KamikStudio menu class
│   └── 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                    # Link generation override
└── Dispatcher.php              # Routing override

5. Installation

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

# Or via FTP - upload the ks_prettyurls folder to /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. Configuration

Accessing the configuration

Menu: KamikStudio → KS Pretty URLs → Configure
Or: Modules → KS Pretty URLs → Configure

Entity types (enable/disable)

URL prefixes (optional)

Prefixes help avoid URL conflicts between different entity types.

Redirect settings

7. Usage

URL management panel

Menu: KamikStudio → KS Pretty URLs

Automatic generation

URLs are generated automatically when:

• You create a new category/product/CMS page
• You edit an existing entity and change its slug (link_rewrite)

Editing a URL manually

1. Go to the URL list
2. Click the edit icon next to the chosen entry
3. Change the "Pretty URL" field
4. Save

8. Database

Table: ps_ks_pretty_urls

Stores the pretty URL → entity mapping.

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`)
);

Table: ps_ks_pretty_urls_redirects

Stores redirects from the old URLs.

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. How it works

URL generation

Link generation (Frontend)

URL resolution (Request)

10. KamikStudio menu system

The module automatically integrates with the central KamikStudio menu in the admin panel.

How it works

1. First KS module installed → KsTabManager creates the main "KamikStudio" tab + the module tab
2. Another KS module installed → Adds only the new module's tab
3. Last KS module uninstalled → Removes the main tab and the override files

Menu structure

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

11. Troubleshooting

# Check the override files
ls -la override/classes/Link.php
ls -la override/classes/Dispatcher.php

# Delete the class cache
rm -f var/cache/prod/class_index.php
rm -f var/cache/dev/class_index.php

// Check whether the override is loaded (temporarily in index.php)
var_dump(get_parent_class('Link'));
// Should return: "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 'Done!';
"
rm -f var/cache/prod/class_index.php

12. FAQ

13. License

14. Changelog

15. Support