Files
sage/doc/rewrites.md
Ben Word fea92a61aa Rewrites organization
- Create lib/rewrites.php and move everything from lib/htaccess.php
except the H5BP htaccess functionality into it

- In the config, change add_theme_support('rewrite-urls') to
add_theme_support('rewrites')

- Remove the Apache/LightSpeed HTTPD check for rewrites

- Update docs with better Nginx rewrite rules
2013-02-04 19:56:42 -06:00

1.2 KiB

Roots Theme homepage | Documentation table of contents

Rewrites

Rewrites are handled by lib/rewrites.php. Rewrites currently do not happen for child themes or network installs.

Rewrite:

  1. /wp-content/themes/themename/assets/css/ to /assets/css/
  2. /wp-content/themes/themename/assets/js/ to /assets/js/
  3. /wp-content/themes/themename/assets/img/ to /assets/img/
  4. /wp-content/plugins/ -> /plugins/

If HTML5 Boilerplate's .htaccess support is enabled in lib/config.php, then the generate_rewrite_rules() filter is used to automatically add the contents of lib/h5bp-htaccess to your .htaccess file.

Alternative server configurations

Nginx

location ~ ^/assets/(img|js|css)/(.*)$ {
  try_files $uri $uri/ /wp-content/themes/roots/assets/$1/$2;
}
location ~ ^/plugins/(.*)$ {
  try_files $uri $uri/ /wp-content/plugins/$1;
}

Lighttpd

url.rewrite-once = (
  "^/css/(.*)$" => "/wp-content/themes/roots/css/$1",
  "^/js/(.*)$" => "/wp-content/themes/roots/js/$1",
  "^/img/(.*)$" => "/wp-content/themes/roots/img/$1",
  "^/plugins/(.*)$" => "/wp-content/plugins/$1"
)