A way of allowing subdomains to be served by the same project, and associating objects with particular subdomains.
Project description
A simple way of allowing subdomains to be served by the same project, and associating objects with particular subdomains.
Installation
By default, it will work if you use 127.0.0.1.nip.io (a domain that points to localhost) on port 80. To use a different base domain/port, set the BASE_HOST and/or BASE_PORT variables.
Add instances to your INSTALLED_APPS and migrate to get the Instance database table.
Add Instance objects, with the label being the subdomain you wish to use. Optionally, associate users with these instances.
Add instances.middleware.MultiInstanceMiddleware to your middleware; it must come after AuthenticationMiddleware. Now if you go to <subdomain>.<BASE_HOST>, request.instance will be set to the matching Instance object. If there’s a subdomain given but no match, it will redirect to BASE_HOST.
Requests to a subdomain will use your ROOT_URLCONF file; requests to the BASE_HOST will use ROOT_URLCONF_HOST or instances.urls by default (which just has one page that lists all instances)..
Instance edit form
In your ROOT_URLCONF, use a line like the following to have a page for editing the title and description of an instance:
url(r’^instance/edit$’, InstanceUpdate.as_view(), name=’instance-edit’)
Associating models
To have a model’s objects be associated with an instance, mix in InstanceMixin, and if you have a custom manager make it a subclass of InstanceManager. This adds an instance field, and provides a for_instance manager method to return all the objects in the given instance.
Mix in InstanceViewMixin to any display class-based view to restrict the default queryset to the request’s instance. Add InstanceFormMixin to any create/update view to store the current instance upon save, and allow editing only by those users associated with the instance. Remember to exclude instance from any model form, as it won’t be seen.
Running tests
pip install .
python runtests.py
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-subdomain-instances-3.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 88c50d37745c9f1ebd561a3892d9bd6c4e2e27fe6a702d36409205025337a59c |
|
MD5 | c7de821188a2bad2d4f6ccac8cc0965f |
|
BLAKE2b-256 | 3e7443025b03224fbb6beac948f6adcbbc8b1953eea03fe6dfa04af5f6fdc1c7 |
Hashes for django_subdomain_instances-3.0.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | beb3df026cdf0d9a636688d6f193301f6f079d0f5a7dcf7359bdb18f41f86dd2 |
|
MD5 | 82ba880552f0d127aefb2e43571437eb |
|
BLAKE2b-256 | 1f537a5ee6ca33890b25ba3ef9b0920b4894f0bbc1ae2bd05932f7f7dde9d6e5 |