mirror of
https://github.com/YunoHost-Apps/kanboard_ynh.git
synced 2024-09-03 19:36:17 +02:00
87 lines
2.2 KiB
Markdown
87 lines
2.2 KiB
Markdown
URL rewriting
|
|
=============
|
|
|
|
Kanboard is able to work indifferently with url rewriting enabled or not.
|
|
|
|
- Example of URL rewritten: `/board/123`
|
|
- Otherwise: `?controller=board&action=show&project_id=123`
|
|
|
|
If you use Kanboard with Apache and with the mode rewrite enabled, nice urls will be used automatically.
|
|
In case you get a "404 Not Found", you might need to set at least the following overrides for your DocumentRoot to get the .htaccess files working:
|
|
|
|
```sh
|
|
<Directory /var/www/kanboard/>
|
|
AllowOverride FileInfo Options=All,MultiViews AuthConfig
|
|
</Directory>
|
|
```
|
|
|
|
URL Shortcuts
|
|
-------------
|
|
|
|
- Go to the task #123: **/t/123**
|
|
- Go to the board of the project #2: **/b/2**
|
|
- Go to the project calendar #5: **/c/5**
|
|
- Go to the list view of the project #8: **/l/8**
|
|
- Go to the project settings for the project id #42: **/p/42**
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
By default, Kanboard will check if the Apache mode rewrite is enabled.
|
|
|
|
To avoid the automatic detection of url rewriting from the web server, you can enable this feature in your config file:
|
|
|
|
```php
|
|
define('ENABLE_URL_REWRITE', true);
|
|
```
|
|
|
|
When this constant is at `true`:
|
|
|
|
- URLs generated from command line tools will be also converted
|
|
- If you use another web server than Apache, by example Nginx or Microsoft IIS, you have to configure yourself the url rewriting
|
|
|
|
Note: Kanboard always fallback to old school urls when it's not configured, this configuration is optional.
|
|
|
|
Nginx configuration example
|
|
---------------------------
|
|
|
|
In the section `server` of your Nginx config file you can use this example:
|
|
|
|
```bash
|
|
index index.php;
|
|
|
|
location / {
|
|
try_files $uri $uri/ /index.php;
|
|
|
|
# If Kanboard is under a subfolder
|
|
# try_files $uri $uri/ /kanboard/index.php;
|
|
}
|
|
|
|
location ~ \.php$ {
|
|
try_files $uri =404;
|
|
fastcgi_split_path_info ^(.+\.php)(/.+)$;
|
|
fastcgi_pass unix:/var/run/php5-fpm.sock;
|
|
fastcgi_index index.php;
|
|
include fastcgi_params;
|
|
}
|
|
|
|
# Deny access to the directory data
|
|
location ~* /data {
|
|
deny all;
|
|
return 404;
|
|
}
|
|
|
|
# Deny access to .htaccess
|
|
location ~ /\.ht {
|
|
deny all;
|
|
return 404;
|
|
}
|
|
```
|
|
|
|
In your Kanboard `config.php`:
|
|
|
|
```php
|
|
define('ENABLE_URL_REWRITE', true);
|
|
```
|
|
|
|
Adapt the example above according to your own configuration.
|