https://github.com/b13/masi
Extend TYPO3's URL Handling
https://github.com/b13/masi
Last synced: over 1 year ago
JSON representation
Extend TYPO3's URL Handling
- Host: GitHub
- URL: https://github.com/b13/masi
- Owner: b13
- License: gpl-2.0
- Created: 2019-05-09T16:45:21.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-11-29T06:39:13.000Z (over 1 year ago)
- Last Synced: 2025-03-29T05:09:23.229Z (over 1 year ago)
- Language: PHP
- Size: 72.3 KB
- Stars: 24
- Watchers: 13
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# masi - Extend TYPO3's URL Handling
Masi is the missing piece for the people who want to customize _everything_ when generating URLs in TYPO3 v10+.
## Features
1. TYPO3 v10 skips pages of type "SysFolder" and "Spacers" by default when generating the URL of subpages. _masi_ includes them by default!
2. _masi_ also ships with a new checkbox for pages, to exclude a certain page slug when generating subpages. This way, you can exclude only certain SysFolders.
There is a CLI command to migrate the options from RealURL to the _masi_ database field.
3. _masi_ evaluates PageTSconfig where you can override your values.
TCEMAIN.pages.slug.generatorOptions {
fields = company, city
fieldSeparator = -
}
4. _masi_ allows you to set a hard prefix (!) for a specific page tree via PageTS:
TCEMAIN.pages.slug.generatorOptions {
prefix = /wishlist/
}
Any prefix is added BEFORE the parent page prefix, but you can also disable the option "prefixParentPageSlug"
TCEMAIN.pages.slug.generatorOptions {
prefixParentPageSlug = 0
}
Of course, all the values within the "slug" field can be changed by the editor, but it's here for convenience.
## Installation
Use it via `composer req b13/masi` or install the Extension `masi` from the TYPO3 Extension Repository.
_masi_ requires TYPO3 v10.4.0 or later.
If you want to migrate from RealURL, execute this one-time command as long as the database field `pages.tx_realurl_exclude` exists, and transfers the data to `pages.exclude_slug_for_subpages`:
`vendor/bin/typo3 database:migrate:masi`
There is also an upgrade wizard for the Installer to execute the same functionality via the Upgrade Tool of TYPO3's Installer.
## License
As TYPO3 Core, _masi_ is licensed under GPL2 or later. See the LICENSE file for more details.
## Background, Authors & Further Maintenance
This extension was created as a show-case on what you can do with one magic hook for TYPO3 v10 and customize
so many things.
TYPO3 community often requests functionality, which can be put in small and efficient extensions, and _masi_ does
exactly that, without having to burden everything into TYPO3 Core.
_masi_ was initially created by Benni Mack in 2019, for [b13, Stuttgart](https://b13.com), with the nice support from
Martin Kutschker.
[Find more TYPO3 extensions we have developed](https://b13.com/useful-typo3-extensions-from-b13-to-you) that help us deliver value in client projects. As part of the way we work, we focus on testing and best practices to ensure long-term performance, reliability, and results in all our code.