https://github.com/sulu/suluredirectbundle
Sulu bundle for managing redirects
https://github.com/sulu/suluredirectbundle
hacktoberfest php sulu sulu-bundle
Last synced: 9 months ago
JSON representation
Sulu bundle for managing redirects
- Host: GitHub
- URL: https://github.com/sulu/suluredirectbundle
- Owner: sulu
- License: mit
- Created: 2017-03-07T15:03:03.000Z (over 9 years ago)
- Default Branch: 2.1
- Last Pushed: 2024-07-24T15:04:18.000Z (almost 2 years ago)
- Last Synced: 2025-01-19T10:05:31.826Z (over 1 year ago)
- Topics: hacktoberfest, php, sulu, sulu-bundle
- Language: PHP
- Homepage:
- Size: 251 KB
- Stars: 18
- Watchers: 12
- Forks: 19
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
SuluRedirectBundle
The SuluRedirectBundle adds simple but powerful capabilities for managing redirects to Sulu’s administration interface
and allows content managers to manage redirects without any knowledge of web servers.
The SuluRedirectBundle is compatible with Sulu **starting from version 2.0**. Have a look at the `require` section in
the [composer.json](composer.json) to find an
**up-to-date list of the requirements** of the bundle.
## 🚀 Installation and Documentation
Execute the following [composer](https://getcomposer.org/) commands to add the bundle to the dependencies of your
project:
```bash
composer require sulu/redirect-bundle
```
Afterwards, visit the [bundle documentation](Resources/doc/README.md) to
find out **how to set up and configure the SuluRedirectBundle** to your specific needs.
## 💡 Features
### Importing redirects
One of the great features of this bundle is the ability to import redirects from a CSV file.
The most simplified file just contains two columns, `source` and `target`.
Of course, all the other options like `statusCode`, `sourceHost`, and `enabled` can also be set in the import file.
It’s also possible to override existing redirects with an import; you just have to set the same value for `source`.
### Enabling and disabling redirects
Sometimes it’s necessary to prepare redirects which are not ready yet, especially if you have a large number of redirects.
Of course there’s a solution for that — toggler in the toolbar to enable or disable redirects quickly.
This allows you to import a large number of disabled redirects and then check them in the administration interface,
before enabling them when needed.
### Different statuses
The SuluRedirectBundle comes with three different statuses to be used for redirects:
- **301** Moved permanently
- **302** Moved temporarily
- **410** Gone
Those status codes are explained in detail [here](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).
### Automatic `Gone` redirects
This bundle also adds the possibility to automatically create redirects with status `410 Gone`, if a page or a entity with a route has been removed. This is very useful, because now search engines know, that this page has been deleted.
### Route Priorities
Redirects created via this bundle will only be used if no other route matches the given URL. This ensures that accidentally created or imported redirects do not affect existing pages. If a redirect matches the URL of an existing page, the redirect will only be effective after the page was unpublished.
In combination with the [SuluAutomationBundle](https://github.com/sulu/SuluAutomationBundle), this behaviour makes it possible to precautionarily create a redirect for the URL of an existing page that will be unpublished at a specified time in the future by the SuluAutomationBundle.
## ❤️ Support and Contributions
The Sulu content management system is a **community-driven open source project** backed by various partner companies.
We are committed to a fully transparent development process and **highly appreciate any contributions**.
In case you have questions, we are happy to welcome you in our official [Slack channel](https://sulu.io/services-and-support).
If you found a bug or miss a specific feature, feel free to **file a new issue** with a respective title and description
on the the [sulu/SuluRedirectBundle](https://github.com/sulu/SuluRedirectBundle) repository.
## 📘 License
The Sulu content management system is released under the terms of the [MIT License](LICENSE).