Move English documentation to folder en_US

1 files changed, 173 insertions, 0 deletions

diff --git a/doc/en_US/nice-urls.markdown b/doc/en_US/nice-urls.markdown
new file mode 100644
index 00000000..a054e85d
--- /dev/null
+++ b/doc/en_US/nice-urls.markdown
@@ -0,0 +1,173 @@
+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$is_args$args;
+
+    # 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_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+    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);
+```
+
+Another example with Kanboard in a subfolder:
+
+```
+server {
+    listen 443 ssl default_server;
+    listen [::]:443 ssl default_server;
+
+    root /var/www/html;
+    index index.php index.html index.htm;
+    server_name _;
+
+    location / {
+        try_files $uri $uri/ =404;
+    }
+
+    location ^~ /kanboard {
+
+        location /kanboard {
+            try_files $uri $uri/ /kanboard/index.php$is_args$args;
+        }
+
+        location ~ ^/kanboard/(?:kanboard|config.php|config.default.php) {
+            deny all;
+        }
+
+        location ~* /kanboard/data {
+            deny all;
+        }
+
+        location ~ \.php(?:$|/) {
+            fastcgi_split_path_info ^(.+\.php)(/.+)$;
+            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+            fastcgi_param PATH_INFO $fastcgi_path_info;
+            fastcgi_param HTTPS on; # Use only if HTTPS is configured
+            include fastcgi_params;
+            fastcgi_pass unix:/var/run/php5-fpm.sock;
+        }
+
+        location ~ /kanboard/\.ht {
+            deny all;
+        }
+    }
+}
+```
+
+Adapt the example above according to your own configuration.
+
+IIS configuration example
+-------------------------
+
+1. Download and install the Rewrite module for IIS: [Download link](http://www.iis.net/learn/extensions/url-rewrite-module/using-the-url-rewrite-module)
+2. Create a web.config in you installation folder:
+
+```xml
+<?xml version="1.0"?>
+<configuration>
+    <system.webServer>
+        <defaultDocument>
+            <files>
+                <clear />
+                <add value="index.php" />
+            </files>
+        </defaultDocument>
+        <rewrite>
+            <rules>
+                <rule name="Kanboard URL Rewrite" stopProcessing="true">
+                    <match url="^(.*)$" ignoreCase="false" />
+                    <conditions logicalGrouping="MatchAll">
+                        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
+                    </conditions>
+                    <action type="Rewrite" url="index.php" appendQueryString="true" />
+                </rule>
+            </rules>
+        </rewrite>
+    </system.webServer>
+</configuration>
+```
+
+In your Kanboard `config.php`:
+
+```php
+define('ENABLE_URL_REWRITE', true);
+```
+
+Adapt the example above according to your own configuration.
+