FlatPress Wiki

PrettyURL plugin turns standard URLs into SEO friendly URLs.

For this to work as expected for entries, the server configuration must be adjusted. If the .htaccess file does not yet exist in the main FlatPress directory, the plugin helps you to create a suitable file.

Open the main panel Plugins in the administration area. Then open the subpanel PrettyURLs. In the editor window you can see the recommended content for the .htaccess file.

				
AddType application/x-httpd-php .php .htm .html
Options -Indexes

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /flatpress-instance/

RewriteRule ^\.htaccess$ - [F]

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /flatpress-instance/index.php [L]
</IfModule>

You only need to save this file.

Done.

If this does not work, have a look at the Troubleshooting.

To make files with the extension .php (e.G. contact.php, search.php) also friendly accessible, paste the following code into the editor instead of the above code:

Options -Indexes
Options +MultiViews
Options +FollowSymLinks
AddType application/x-httpd-php .php .htm .html

<IfModule mod_rewrite.c>
  RewriteEngine On
  
# Protects the .htacces file from external access, status code 403 "Forbidden" is output
  RewriteRule ^\.htaccess$ - [F]

  RewriteBase /flatpress-instance/

# Removing .php Extension and adding a trailing slash at the end
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^([^/]+)/$ $1.php
  RewriteRule ^([^/]+)/([^/]+)/$ /$1/$2.php
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_URI} !(\.[a-zA-Z0-9]{1,5}|/)$
  RewriteRule (.*)$ /$1/ [R=301,L]

# Remove the fp-content directory
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-l
  RewriteRule ^images/(.*) /flatpress-instance/fp-content/images/$1 [L]
  RewriteRule ^attachs/(.*) /flatpress-instance/fp-content/attachs/$1 [L]

# Redirect all other requests to index.php
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^.*$ /flatpress-instance/index.php [L,QSA]
  
# Forwarding from http to https without consideration of the subdomain (www.)
  RewriteCond %{SERVER_PORT} !^443$
  RewriteRule (.*) https://%{HTTP_HOST}/$1 [R=301,L]
</IfModule>

In order for the PrettyURLs plugin to write or modify the .htaccess file, it is necessary that the directory and file permissions for the .htaccess file are set (chmod 0776).

Please note that on apache+windows prettyurls will not work, because there is NO mod_rewrite support!

When using the Nginx server software, a few settings must be added manually with administrative access to the nginx.conf file. These can be found by default in the directories /usr/local/nginx/conf or /etc/nginx or /usr/local/etc/nginx.

First activate one of the two modes in the PrettyURLs configuration:

(*) HTTP Get - Example: /?u=/2011/01/01/hello-world/

or

(*) Pretty - Example: /2011/01/01/hello-world/

Then add the following code to the nginx.conf file:

# see https://stackoverflow.com/questions/72521825/convert-htaccess-to-nginx-directives
location /flatpress-instance {
  if (!-e $request_filename) {
    rewrite ^/(.+)$ /flatpress-instance/index.php?u=$1 last;
    break;
  }
} 

⚠️ It has not yet been confirmed that this works 100% on a live system.