bnomei/kirby3-redirects

Setup HTTP Status Code Redirects from within the Kirby Panel

Installs: 200

Dependents: 0

Suggesters: 0

Stars: 6

Watchers: 1

Forks: 0

Open Issues: 0

Type:kirby-plugin

1.4.2 2019-08-19 09:24 UTC

README

GitHub release License Kirby Version Kirby 3 Pluginkit Build Status Coverage Status Gitter

Setup HTTP Status Code Redirects from within the Kirby Panel.

Kirby 3 Redirects can handle Request-URIs like projects?id=123, project/cool.html and send Response-URIs like https://exter.nal. This makes it the ideal choice when porting a non Kirby project.

Similar Plugin

  • kirby-retour but it can only handle Kirby Routes. It is the better choice when updating a Kirby 2 project or creating a brand new Kirby 3 project.

Commerical Usage

This plugin is free but if you use it in a commercial project please consider to

Installation

  • unzip master.zip as folder site/plugins/kirby3-redirects or
  • git submodule add https://github.com/bnomei/kirby3-redirects.git site/plugins/kirby3-redirects or
  • composer require bnomei/kirby3-redirects

Setup

Add the plugin-redirects section to your site.yml and add redirects in the panel.

site.yml

sections:
  # ...other sections
  redirects:
    extends: plugin-redirects3xx

If you need all http codes you can use extends: plugin-redirects instead which calls the api to retrieve them (once for each redirect). This is not advised if you have a lot of redirects.

Since v1.1.0 the plugin will register itself with a route:before-hook and take care of the redirecting automatically. Many thanks to Sebastian Aschenbach for suggesting this solution.

Settings

All settings require bnomei.redirects. as prefix.

code

  • default: 301

querystring

  • default: true do keep querystring in request URI
  • example: https://kirby3-plugins.bnomei.com/projects?id=12 => projects?id=12

map

  • default: A closure to get the structure from site.txt. Define you own if you want the section to be in a different blueprint or skip the blueprint and just use code.

Disclaimer

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.

License

MIT

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.

Credits

This plugins is similar yet way less powerful than K2 version of