Plugin / Any Hostname

Description

Any Hostname alters all WordPress-generated URLs according to the servers current hostname, so that they will always correspond to the actual hostname as entered by the user, as opposed to always using the URL specified in the WordPress options. The plugin is ideal for making a site available across multiple domains or running local development servers.

Known Issues

This plugin will not be able to alter the contents of constants such as WP_CONTENT_URL and WP_PLUGIN_URL as these are (quite naturally) defined before any plugins are loaded. Plugin developers should instead rely on either one of the plugins_url(), content_url() or get_option() functions, which will always return the filtered hostname. An example of this is the WPtouch plugin, in which case you can override WPtouch’s compat_get_wp_content_url function, as described by this Gist: https://gist.github.com/1401269.

Any Hostname might also obscure the value of WordPress and Site URL settings on the Options » General settings page, due to the fact that these values are retrieved using the get_option() function. The values actually stored in WordPress’ database is in fact your site’s true URL. From 1.0b2 up the plugin will deactivate the host filters on this page, which might cause some page resources to load from the default URL (potentially being unreachable).

Any Hostname will not work on WordPress Network sites (WPMU) due to the fact that the pages in a network install stores its URLs explicitily in the database. Any ideas on how to circumvent this would be greatly appreciated.

Due to a bug in the WordPress Settings API (https://core.trac.wordpress.org/ticket/9296) the plugin settings are located on the Privacy page on WordPress versions below 3.5. From 3.5 and up the settings can be found on the Permalinks page.

Filters

Any Hostname has two filters, allowing you to programatically override the filtered hostname or the list of allowed hostnames. These are described below.

`any_hostname_host`

• Arguments: $host (required)
• Return value: $host (required)

Takes a host as argument, and returns a host that will be used when substituting the domain in URLs supplied by WordPress. This filter can be used to make the plugin use a specific host under certain circumstances.

`any_hostname_allowed_hosts`

• Arguments: $hosts (required)
• Return value: $hosts (required)

Takes an array of allowed hosts as argument, and returns an array of hosts to be used when checking if the user specified host should be allowed. Hosts should be treated as regular expression patterns.

Credits

• Slovak localization by Branco Radenovich of WebHostingGeeks.com
• Ukranian localization by Michael Yunat