<!-- TITLE: Category Url Builder - Magento 2 module documentation-->
<!-- SUBTITLE: Author: Mateusz Bereszczuk -->
# Category Url Builder Module
## Module overview
Create more friendly SEO URLs for your category pages, with Category Url Builder. Our module, lets you shorten categories URL with a custom name.
## Module compatibility
This module is compatibile with Magento Community versions: **2.2**, **2.3** and **2.4**.
## How it works
After installing the module, got to the **Catalog > Categories** in **AP**. Edit any existing category, that has at least one parent category or add new one meeting this requirement.
Now go to **Search Engine Optimization** and type your URL key, then mark the **Omit parent path** checkbox. After saving changes, from now on your category URL will be `homepage/url-key`, instead of `homepage/parent-category/url-key`.
## Demo
demo2.magecreation.com
## Installation
### Composer
1. Add repo to composer.json:
```text
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:aurora-modules/category-url-builder.git"
}
...
],
```
2. Add package to composer.json:
```text
"require": {
...
"aurora/category-url-builder": "*"
...
},
```
3. In Magento root folder run the following commands:
```text
composer update aurora/category-url-builderr
php bin/magento module:enable Aurora_CategoryUrlBuilder
php bin/magento setup:upgrade
```
### Manual
1. Unzip the archive.
2. Upload extension files on your server to:
```text
{Magento root}
└── app/
└── code
```
3. In Magento root folder run the following commands:
```text
php bin/magento module:enable Aurora_CategoryUrlBuilder
php bin/magento setup:upgrade
```
## Changelog
### v1.0.7
* Code refactoring for Magento 2.4.4
### v1.0.5
* Code refactoring
### v1.0.4
* Changing ReadMe
### v1.0.3
* Fixing GitLab pipeline
### v1.0.2
* Code refactoring
### v1.0.1
* Fixing bug with URL
### Thank you for your interest in our products!