framework/sage
Template
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
6b988418cbb40c3388912fb2ab71691e4a4572fc
sage/doc/rewrites.md
Jacob Williams f4dae32bdc Add instructions to Nginx rewrite config 
Prevent problems when plugins include direct-access php files.
2013-03-06 12:19:39 -06:00

1.3 KiB
Raw Blame History

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

Include these in your Nginx config, before the PHP fastcgi block (location ~ \.php$).

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"
)