49👍
Django was created from a set of scripts developed at a newspaper to publish content on multiple domains; using one single content base.
This is where the “sites” module comes in. Its purpose is to mark content to be displayed for different domains.
In previous versions of django, the startproject
script automatically added the django.contrib.sites
application to INSTALLED_APPS
, and when you did syncdb
, a default site with the URL example.com
was added to your database, and since this was the first site, its ID was 1
and that’s where the setting comes from.
Keep in mind that starting from 1.6, this framework is not enabled by default. So if you need it, you must enable it
The SITE_ID
setting sets the default site for your project. So, if you don’t specify a site, this is the one it will use.
So to configure your application for different domains:
- Enable the sites framework
- Change the default site from
example.com
to whatever your default domain is. You can do this from the django shell, or from the admin. - Add your other sites for which you want to publish content to the sites application. Again, you can do this from the django shell just like any other application or from the admin.
- Add a foreign key to the Site model in your object
site = models.ForeignKey(Site)
- Add the site manager
on_site = CurrentSiteManager()
Now, when you want to filter content for the default site, or a particular site:
foo = MyObj.on_site.all() # Filters site to whatever is `SITE_ID`
foo = MyObj.objects.all() # Get all objects, irrespective of what site
# they belong to
The documentation has a full set of examples.
22👍
Things would be much easier to understand if Django’s default SiteAdmin included the id field in the list_display
fields.
To do this, you can redefine SiteAdmin (anywhere in your app, but I’d recommend your admin.py or maybe your urls.py) like this:
from django.contrib import admin
from django.contrib.sites.models import Site
admin.site.unregister(Site)
class SiteAdmin(admin.ModelAdmin):
fields = ('id', 'name', 'domain')
readonly_fields = ('id',)
list_display = ('id', 'name', 'domain')
list_display_links = ('name',)
search_fields = ('name', 'domain')
admin.site.register(Site, SiteAdmin)
After including this code snippet, the ID for each “Site” will be shown in the first column of the admin list and inside the form as a read only field. These ‘id’ fields are what you need to use as SITE_ID:
The concept is that each different site runs in a different application server instance, launched using a different yourdomain_settings.py that then includes a base_settings.py with the rest of the common configuration.
Each of these yourdomain_settings.py will define its own SITE_ID and all other different settings.py parameters that they need to look and be different from each other (static resources, templates, etc.) then you’ll define a DJANGO_SETTINGS_MODULE environment variable pointing to that specific yourdomain_settings.py file when launching the application server instance for that domain.
A further note: get_current_site(request)
does need request
to be available for it to work. If your code doesn’t have one, you can use Site.objects.get_current()
that however will need a SITE_ID properly defined in the running application server’s settings.
- [Django]-Django: show the count of related objects in admin list_display
- [Django]-How to implement FirebaseDB with a Django Web Application
- [Django]-How to get the username of the logged-in user in Django?
7👍
This is a late answer but for anyone else having SITE_ID issues and Site problems.
Inside the database, django has a django_site table with(id, domain, name). This is where django stores the SITE_IDs. Mine was actually 5 in the database but i had it set to SITE_ID=1 in the settings.
Knowing that, i can now go back to the database and clear it to get back to zero or use the actual id in the database.
- [Django]-How to assign items inside a Model object with Django?
- [Django]-Write only, read only fields in django rest framework
- [Django]-Storing an Integer Array in a Django Database
5👍
This is covered in the documentation for the Sites framework:
In order to serve different sites in production, you’d create a
separate settings file with each SITE_ID (perhaps importing from a
common settings file to avoid duplicating shared settings) and then
specify the appropriate DJANGO_SETTINGS_MODULE for each site.
But if you didn’t want to do it that way, you can not set SITE_ID
at all and just look up the current site based on the domain name in your views using get_current_site
:
from django.contrib.sites.shortcuts import get_current_site
def my_view(request):
current_site = get_current_site(request)
if current_site.domain == 'foo.com':
# Do something
pass
else:
# Do something else.
pass
- [Django]-Django ImportError: cannot import name 'render_to_response' from 'django.shortcuts'
- [Django]-Django stops working with RuntimeError: populate() isn't reentrant
- [Django]-Add custom form fields that are not part of the model (Django)
1👍
This link explains it:
You’ll want to create separate settings files for each domain you’re adding; each one will need its own MEDIA_URL and other settings. You’ll also want to do two things to make sure everything works out properly for administering the different sites:
Create a new Site object in your admin for each domain, and put the id of that Site into its settings file as SITE_ID so Django knows which site in the database corresponds to this settings file.
In the settings file for your original site (the one with id 1), add the other sites’ settings files to the ADMIN_FOR setting, to let Django know that this one instance of the admin application will handle all of the sites.
Also, if you wanna figure out how to modify models and set the views You may take a look at this link:
https://django.cowhite.com/blog/managing-multiple-websites-with-a-common-database-in-django-the-sites-framework/
- [Django]-How can I change the default Django date template format?
- [Django]-Django South – table already exists
- [Django]-How do I remove Label text in Django generated form?
0👍
"Sites" was initially intended for multiple servers sharing a DB, but was extended with feature #15089 around version 1.4 to support basic multitenancy.
Nowadays you can simply not define SITE_ID
if you always use methods that take a request
.
- [Django]-How do I deploy Django on AWS?
- [Django]-Using Pylint with Django
- [Django]-Django template comparing string