Adding a custom domain

1. Create a domain mapping object in the Django admin (/admin/custom_domains/domainmapping/add/).

   • Your domain should be the Custom domain
   • The ~ path to your project page should be the Root path

2. Add the domain to Heroku (e.g. heroku domiains:add customdomain.com)

3. Set up a CNAME record for your domain pointing to openplans.org

   (if you have embedded Shareabouts.js)

4. Add a CORS mapping for the domain to the dataset on the Shareabouts API server.

   (if you have embedded Django Shareabouts)

5. Ensure that your embedded shareabouts map is using the same domain as the custom domain. E.g., if your custom domain is rainbowcity.org or masterplan.rainbowcity.org or something, use a domain like map.rainbowcity.org for your embedded Shareabouts map.

   Why?: By default, IE's permissions are such that cookies cannot be stored when you load a page in an iframe, unless that page is on the same domain. We rely on cookies for authentication in Shareabouts. Until that's no longer the case, this is a necessary fix.