Simple foreign domain routing for Rails
Ruby
Switch branches/tags
Nothing to show
Pull request Compare This branch is 21 commits ahead of landlessness:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
rails
test
.gitignore
MIT-LICENSE
README
Rakefile
VERSION.yml
foreign-fqdn-routing.gemspec
init.rb

README

Foreign FQDN Routing + 
Request Routing Plugin for Ruby on Rails 
-----------------------------------------
= Foreign FQDN Request Routing

-------------------------------------------------------------------------------
Foreign FQDN Routing provides simple handling of foreign domains in Rails.
It borrows largely from SubdomainFu and some other snippets found around the web.

Request routing allows you to define routing conditions that test 
methods/properties of the request object such as subdomain, domain,
port.  You can test them either against a value or with a Regexp
(assuming the method returns a string)

Merging these two plugins allows them to work together and enhance the routing
capability of Rails.

Documentation from the original plugins follows...

-------------------------------------------------------------------------------
Foreign FQDN Routing
-------------------------------------------------------------------------------

Installation
============

Foreign FQDN Routing is available as a plugin or a gem. To install it as a 
plugin with Rails 2.1 or later):

script/plugin install git://github.com/autodata/foreign-fqdn-routing.git

To install as a gem:

gem install foreign-fqdn-routing

Examples
========

Foreign FQDN Routing extends Rails's routing mechanisms to provide a way to 
redirect non-native domains. 

Let's say my rails app domain is 'mydomain.com' and I am creating an app that
allows users to add a CNAME record to map their subdomain so that 
'foo.usersdomain.com' would actually point to 'mydomain.com/users/1234'.

The route at the top of config/routes.rb would look like:

map.connect '*path', :controller => 'users',
:action => 'index', :conditions => { :foreign_domain => true }

And in the users controller:

@user = User.find_by_foreign_domain(request.host.downcase) 
# this example would require a database field called foreign_domain

Configuration
=============

You will need to configure Foreign FQDN Routing based on your native hostnames. 

native_domains
--------

A hash of arrays for the native domain names for each relevant environment.

Create the file config/initializers/native_domains.rb and put something like:

ForeignFQDNRouting.init_native_domains = {
  :development => ['localhost'], 
  :staging => ['staging.example.com'],
  :production => ['example.com', 'example.org', 'example.net']
} # set all at once (also the defaults)


Or set the native domains on the fly with:

ForeignFQDNRouting.native_domains = 
  ['example.com', 'example.org', 'example.net'] # sets for current environment

Resources
=========

* GitHub Repository: http://github.com/autodata/foreign_fqdn_routing
* 2008 by Brian Mulloy (http://landlessness.net/), with contributions from Joe Scharf and William Melody. Released under the MIT license.


*******************************************************************************

-------------------------------------------------------------------------------
Request Routing Plugin for Ruby on Rails
-------------------------------------------------------------------------------
(c) Dan Webb 2006 (dan@vivabit.com)

Plugin that allows you to define routing conditions that test 
methods/properties of the request object such as subdomain, domain,
port.  You can test them either against a value or with a Regexp
(assuming the method returns a string)

*UPDATE* Now works with the new routing code as implemented in edge rails.  Note the
change in API: use :conditions instead of :requirements.

== Installation

    ruby script/plugin install http://svn.vivabit.net/external/rubylibs/request_routing/

== Usage

In routes.rb you can specify use the :requirements hash with request properties:

    map.connect '', :controller => 'main', :conditions => { :subdomain => 'www' }

    map.connect 'admin', :controller => 'admin', :conditions => { :remote_ip => /^127\.0\.0\.[0-9]$/ }

You can also, of course, use the conditions hash in map.with_options calls.

The allowed properties are:

		:subdomain  (only checks the first subdomain)
		:domain (only accurate for single tld domain names at the moment)
		:method (a symbol)
		:port (a number)
		:remote_ip 
		:content_type (content type of the post body)
		:accepts 
		:request_uri (the entire request uri)
		:protocol (either http:// or https://)

== Copyright

Copyright (c) 2009 Joe Scharf. See LICENSE for details.