How to manage redirects in Grav CMS?

@virginie 

Managing redirects in Grav CMS involves a few steps, typically handled via configuration files or plugins. Here’s how you can set up and manage redirects in Grav:

1. Using .htaccess (Apache):

If you're running Grav on an Apache server, you can manage redirects by editing the .htaccess file located in the root directory of your Grav installation.

1. Open the .htaccess file.
2. Add Redirect Rules: You can add simple redirect rules, for example: Redirect 301 /old-page /new-page This rule will redirect a request from /old-page to /new-page using a 301 (permanent) redirect.

2. Using web.config (IIS):

For those using Microsoft IIS, you'll manage redirects in the web.config file, again located in the root directory.

1. Open the web.config file.
2. Add Redirect Rules: Use the URL Rewrite Module syntax:

3. Using Nginx Configuration:

If you’re using Nginx, you’ll edit the server configuration files typically located in /etc/nginx/sites-available/.

1. Edit the Nginx configuration file for your site.
2. Add Redirects: location = /old-page { return 301 /new-page; }

4. Using Grav's user/config/site.yaml:

Grav allows simple redirects via its configuration files without server configuration changes.

1. Open the user/config/site.yaml file.
2. Add Redirects: redirects: /old-page: /new-page This is a simple method but is only applicable to simple one-to-one URL mappings.

5. Using Plugins:

Grav also has plugins that simplify the management of redirects:

• Admin Panel Redirects: If you have the Admin Plugin, you can manage redirects through the GUI by navigating to the "Configuration" area.
• Redirects Plugin: This plugin allows you to manage complex redirect rules directly from the Grav admin interface or via configuration files.

6. Testing Redirects:

Always test your redirects via a browser or command-line tools like curl to ensure they’re functioning as expected. For example:

1

curl -I http://example.com/old-page

Make sure the headers indicate the type of redirect you’ve intended (e.g., 301, 302).

These methods allow you to manage redirects efficiently in Grav CMS, whether through server-level configurations or through Grav's built-in capabilities and plugins. Make sure to back up your configurations before making changes.