An creat “láithreáin”Link to this heading#

Úsáid samplachLink to this heading#

Cén fáth a n-úsáideann tú suíomhanna? Is fearr é a mhíniú trí shamplaí.

from django.contrib.sites.models import Site
from django.db import models


class Article(models.Model):
    headline = models.CharField(max_length=200)
    # ...
    sites = models.ManyToManyField(Site)

from django.contrib.sites.models import Site
from django.db import models


class Article(models.Model):
    headline = models.CharField(max_length=200)
    # ...
    site = models.ForeignKey(Site, on_delete=models.CASCADE)

from django.conf import settings


def my_view(request):
    if settings.SITE_ID == 3:
        # Do something.
        pass
    else:
        # Do something else.
        pass

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

from django.contrib.sites.models import Site


def my_function_without_request():
    current_site = Site.objects.get_current()
    if current_site.domain == "foo.com":
        # Do something
        pass
    else:
        # Do something else.
        pass

from django.contrib.sites.shortcuts import get_current_site
from django.core.mail import send_mail


def register_for_newsletter(request):
    # Check form values, etc., and subscribe the user.
    # ...

    current_site = get_current_site(request)
    send_mail(
        "Thanks for subscribing to %s alerts" % current_site.name,
        "Thanks for your subscription. We appreciate it.\n\n-The %s team."
        % (current_site.name,),
        "editor@%s" % current_site.domain,
        [user.email],
    )

    # ...

from django.core.mail import send_mail
from django.template import loader


def register_for_newsletter(request):
    # Check form values, etc., and subscribe the user.
    # ...

    subject = loader.get_template("alerts/subject.txt").render({})
    message = loader.get_template("alerts/message.txt").render({})
    send_mail(subject, message, "editor@ljworld.com", [user.email])

    # ...

>>> from django.contrib.sites.models import Site
>>> obj = MyModel.objects.get(id=3)
>>> obj.get_absolute_url()
'/mymodel/objects/3/'
>>> Site.objects.get_current().domain
'example.com'
>>> "https://%s%s" % (Site.objects.get_current().domain, obj.get_absolute_url())
'https://example.com/mymodel/objects/3/'

Creat na láithreáin a chumasúLink to this heading#

Chun creat na láithreáin a chumasú, lean na céimeanna seo:

1. Cuir django.contrib.sites' le do shocrú: INSTALLED_APPS.

2. Sainmhínigh a: socrú: SITE_ID socrú:

   Code

   SITE_ID = 1
   

3. Rith: DjaDmin: `imirce `.

django.contrib.sites cláraíonn a:data: ~django.db.models.signals.post_migrate láimhseálaí comhartha a chruthaíonn suíomh réamhshocraithe darb ainm example.com leis an bhfearann example.com. Cruthófar an suíomh seo freisin tar éis Django an bunachar sonraí tástála a chruthú. <data-migrations>Chun an t-ainm agus an fearainn ceart a shocrú do do thionscadal, is féidir leat a:ref: `imirce sonraí `a úsáid.

D'fhonn freastal ar shuíomhanna éagsúla i dtáirgeadh, chruthófá comhad socruithe ar leithligh le gach ``SITE_ID` (b'fhéidir allmhairiú ó chomhad socruithe coiteann chun socruithe roinnte a dhúbailt) agus ansin sonraigh an oiriúna:envvar: DJANGO_SETTINGS_MODULE do gach suíomh.

An réad reatha `Láithreach a chaitheamh a chaitheamhLink to this heading#

De réir mar a stóráiltear an suíomh reatha sa bhunachar sonraí, d'fhéadfadh ceist bunachar sonraí a bheith mar thoradh ar gach glao chuig `site.objects.get_current () `. Ach tá Django beagán níos cliste ná sin: ar an gcéad iarratas, cuirtear an suíomh reatha a chosc, agus filleann aon ghlao ina dhiaidh sin na sonraí taiscéadaithe in ionad an bunachar sonraí a bhualadh.

Más mian leat ceist bunachar sonraí a chur i bhfeidhm ar chúis ar bith, is féidir leat a rá le Django an taisce a ghlanadh ag baint úsáide as Site.Objects.clear_cache () `:

# First call; current site fetched from database.
current_site = Site.objects.get_current()
# ...

# Second call; current site fetched from cache.
current_site = Site.objects.get_current()
# ...

# Force a database query for the third call.
Site.objects.clear_cache()
current_site = Site.objects.get_current()

An CurrentsitemanagerLink to this heading#

class managers.CurrentSiteManagerLink to this definition#

Má tá ról lárnach ag: Class: ~django.contrib.sites.models.site i d'iarratas, smaoinigh ar an gcabhrach: class: ~django.contrib.sites.managers.currentsiteManager a úsáid i do mhúnla (í). Is samhail é: doc: bainisteor a scagann a cheisteanna go huathoibríoch chun </topics/db/managers> rudaí a bhaineann leis an reatha: class: ~django.contrib.sites.models.site a áireamh.

Úsáid:Class: ~django.contrib.sites.managers.currentSiteManager tríd é a chur le do mhúnla go sainráite. Mar shampla:

from django.contrib.sites.models import Site
from django.contrib.sites.managers import CurrentSiteManager
from django.db import models


class Photo(models.Model):
    photo = models.FileField(upload_to="photos")
    photographer_name = models.CharField(max_length=100)
    pub_date = models.DateField()
    site = models.ForeignKey(Site, on_delete=models.CASCADE)
    objects = models.Manager()
    on_site = CurrentSiteManager()

Leis an tsamhail seo, cuirfidh Photo.Objects.all () ``gach rud ``Photo` ar ais sa bhunachar sonraí, ach ní thabharfaidh Photo.on_site.all () ``ach na rudaí ``Photo a bhaineann leis an suíomh reatha ar ais, de réir an socruithe: SITE_ID.

Cuir bealach eile, tá an dá ráiteas seo coibhéiseach:

Photo.objects.filter(site=settings.SITE_ID)
Photo.on_site.all()

Cén chaoi a raibh a fhios ag :class: ~django.contrib.sites.managers.currentsiteManager cén réimse de Photo ``a bhí an:class: `~django.contrib.sites.models.site`? De réir réamhshocraithe, féachann :class: `~django.contrib.sites.managers.currentSiteManager` ceachtar a:class: `~django.db.models.foreignKey` ar a dtugtar ``site nó a:class: ~django.db.models.manyToManyField ar a dtugtar sites le scagadh air. Má úsáideann tú réimse darb ainm rud éigin seachas site nó sites chun a aithint cé na ruda:class: ~django.contrib.sites.models.site a bhfuil baint ag do réad leis, ansin ní mór duit ainm an réimse saincheaptha a rith mar pharaiméadar chuig:class: ~django.contrib.sites.managers.currentsiteManager ar do mhúnla. Léiríonn an tsamhail seo a leanas, a bhfuil réimse aige ar a dtugtar publish_on, seo:

from django.contrib.sites.models import Site
from django.contrib.sites.managers import CurrentSiteManager
from django.db import models


class Photo(models.Model):
    photo = models.FileField(upload_to="photos")
    photographer_name = models.CharField(max_length=100)
    pub_date = models.DateField()
    publish_on = models.ForeignKey(Site, on_delete=models.CASCADE)
    objects = models.Manager()
    on_site = CurrentSiteManager("publish_on")

Má dhéanann tú iarracht a úsáid:class: ~django.contrib.sites.managers.currentSiteManager agus ainm réimse nach bhfuil ann a chur ar aghaidh, ardóidh Django ValueError.

Mar fhocal scoir, tabhair faoi deara gur dócha go mbeidh tú ag iarraidh “Bainisteoir” gnáth (neamh-shonrach don láithreán) a choinneáil ar do mhúnla, fiú má úsáideann tú: class: ~django.contrib.sites.Managers.CurrentSiteManager. Mar a mhínítear in:doc: doiciméadú bainisteora”, má shain</topics/db/managers> mhíníonn tú bainisteoir de láimh, ansin ní chruthóidh Django an bainisteoir uathoibríoch ``objects = Models.manager () duit. Tabhair faoi deara freisin go n-úsáideann codanna áirithe de Django - eadhon, suíomh riaracháin Django agus tuairimí cineálacha - cibé bainisteoir a shainmhínítear chéad sa tsamhail, mar sin más mian leat go mbeadh rochtain ag do shuíomh riaracháin ar gach rud (ní amháin cinn suíomh-shonrach), cuir ``objects = Models.manager () i do mhúnla, sula sainmhíníonn tú: `~django.contrib.current.sites.managers.tSiteManager.

Láithreán MiddlewareLink to this heading#

Má úsáideann tú an patrún seo go minic:

from django.contrib.sites.models import Site


def my_view(request):
    site = Site.objects.get_current()
    ...

Chun athrá a sheachaint, cuir: class: django.contrib.sites.middleware.currentsiteMiddleware chuig:setting: MIDDLEWARE. Socraíonn an middleware an tréith suite ar gach réad iarratais, ionas gur féidir leat request.site a úsáid chun an suíomh reatha a fháil.

Conas a úsáideann Django creat na suíomhannaLink to this heading#

Cé nach bhfuil sé ag teastáil go n-úsáideann tú creat na suíomhanna, spreagtar go láidir é, toisc go mbaineann Django leas as i gcúpla áit. Fiú mura bhfuil do shuiteáil Django ag cumhachtú ach suíomh amháin, ba cheart duit an dá soicind a thógáil chun réad an láithreáin a chruthú le do fearainn agus ainm `, agus díriú ar a ID i do shuíomh: SITE_ID.

Seo mar a úsáideann Django creat na suíomhanna:

• Sa chreat: mod: atreoruithe <django.contrib.redirects>, tá baint ag gach réad atreoraithe le suíomh áirithe. Nuair a chuardaíonn Django atreorú, cuireann sé an suíomh reatha san áireamh.

• Sa chreat: mod: flatpages <django.contrib.flatpages>, tá baint ag gach leathanach cothrom le suíomh áirithe. Nuair a chruthaítear leathanach cothrom, sonraíonn tú ai:class: ~django.contrib.sites.models.site, agus seiceálann seiceál:class: ~django.contrib.flatpages.middleware.flatpageFallBackmiddleware an suíomh reatha chun leathanaigh réidh a aisghabháil le taispeáint.

• Sa chreat sindiciúcháin: mod:<django.contrib.syndication>, tá rochtain go huathoibríoch ag na teimpléid le haghaidh title agus description ar athróg {{site}}, arb é an:class: ~django.contrib.sites.models.site réad a léiríonn an láithreán reatha. Chomh maith leis sin, úsáidfidh an crúca chun URLanna míreanna a sholáthar an réad ``fearainn ``ón réad reatha:class: ~django.contrib.sites.models.site mura sonraíonn tú fearann láncháilithe.

• Sa chreat:mod: fíordheimhniúcháin <django.contrib.auth>, :class: django.contrib.auth.views.loginView téann an t-ainm reatha:class: ~django.contrib.sites.models.site chuig an teimpléad mar {{site_name}}.

• Úsáideann an dearcadh aicearra (django.contrib.contenttypes.views.shortcut) réad reatha: class: ~django.contrib.sites.models.site agus URL réada á ríomh.

• Sa chreat riaracháin, úsáideann an nasc “amharc ar an láithreán” an reatha:class: ~django.contrib.sites.models.site chun an fearainn don láithreán a atreoróidh sé chuig a oibriú amach.

Iarrata rudaíLink to this heading#

Baineann roinnt: doc: feidhmchláir django.contrib </ref/contrib/index> leas as creat na láithreáin ach déantar iad a ailtiriú ar bhealach nach gá uir* creat na suíomhanna atá le suiteáil i do bhunachar sonraí. (Níl daoine áirithe ag iarraidh, nó níl* in* an tábla bunachar sonraí breise a éilíonn creat na láithreáin a shuiteáil.) Maidir leis na cásanna sin, soláthraíonn an creat aicme a:class: django.contrib.sites.requests.requestsite, ar féidir é a úsáid mar fhilleadh nuair nach bhfuil creat na suíomhanna tacaíochta le bunachar sonraí ar fáil.

class requests.RequestSiteLink to this definition#

Aicme a roinneann an príomh-chomhéadan de:class: ~django.contrib.sites.models.site (ie, tá tréithe domain agus ``ainm ``aige) ach a fhaigheann a chuid sonraí ó réad django:class: ~django.http.httpRequest seachas ó bhunachar sonraí.

__init__(request)Link to this definition#

Socraíonn na tréithe `ainm ``agus `domain don luach de:meth: ~django.http.httpRequest.get_host.

A: Class: ~django.contrib.sites.requests.requestSite tá comhéadan cosúil le réad gnáth:class: ~django.contrib.sites.models.site, seachas a: meth: ~django.contrib.sites.requests.requestSite. Tógann an modh __init__ () `réad: aicme: `~django.http.httpRequest. Tá sé in ann an fearainn agus ainm ``a bhaint amach trí fhéachaint ar fhearann an iarratais. Tá modhanna ``save () ``agus ``delete () aige chun comhéadan de:class: ~django.contrib.sites.models.site a mheaitseáil, ach ardaíonn na modhanna: exc: NotImplementeDerror.

Aicearra get_current_siteLink to this heading#

Faoi dheireadh, chun cód titim athchleachtach a sheachaint, soláthraíonn an creat feidhm a:func: django.contrib.sites.shortcuts.get_current_site.

shortcuts.get_current_site(request)Link to this definition#

Feidhm a sheiceálann an bhfuil django.contrib.sites suiteáilte agus a thugann an rud reatha: class: ~django.contrib.sites.models.site nó a:class: ~django.contrib.sites.requestsite réad reatha bunaithe ar an iarratas. Breathnaíonn sé suas ar an suíomh reatha bunaithe ar:meth: request.get_host () <django.http.HttpRequest.get_host>`mura sainmhínítear an socrú:setting: `SITE_ID.

Féadfaidh fearann agus calafort araon a chur ar ais ag: meth: request.get_host () <django.http.HttpRequest.get_host>`nuair a bhíonn calafort sonraithe go sainráite ag an gceannteideal Óstach, m.sh. ``example.com:80`. I gcásanna den sórt sin, má theipeann ar an cuardach toisc nach n-oireann an t-óstach taifead sa bhunachar sonraí, déantar an calafort a dhíriú agus déantar an cuardach a athbhreithniú leis an gcuid fearainn amháin. Ní bhaineann sé seo le:class: ~django.contrib.sites.requests.requestsite a úsáidfidh an t-óstach neamh-mhodhnaithe i gcónaí.