Tagann Django le creat roghnach “suíomhanna”. Is crúca é chun rudaí agus feidhmiúlacht a cheangal le láithreáin ghréasáin áirithe, agus is áit shealbhaithe é d'ainmneacha fearainn agus ainmneacha “fhíorúla” do shuíomhanna faoi thiomáint Django.
\nÚsáid é má chumhachtaíonn do shuiteáil Django aonair níos mó ná suíomh amháin agus ní mór duit idirdhealú a dhéanamh idir na suíomhanna sin ar bhealach éigin.
\nTá creat na suíomhanna bunaithe go príomha ar an tsamhail seo:
\nMúnla chun tréithe ``fearainn ```agus ``ainm ``a stóráil de láithreán gréasáin.
\nAn t-ainm fearainn láncháilithe a bhaineann leis an suíomh Gréasáin. Mar shampla, www.example.com.
Ainm “fhíorúil” inléite don duine don láithreán gréasáin.
\nSonraíonn an socrú: Setting: SITE_ID ID bunachar sonraí an réad: ~django.contrib.sites.models.site a bhaineann leis an gcomhad socruithe áirithe sin. <django.http.HttpRequest.get_host>Má fhágtar an socrú, déanfaidh an fheidhm:func: ~django.contrib.sites.shortcuts.get_current_site iarracht an suíomh reatha a fháil trí chomparáid idir an:attr: ~django.contrib.sites.models.site.domain leis an ainm óstach ón modh:meth: `request.get_host () `.
\nIs fútsa atá an chaoi a n-úsáideann tú é seo, ach úsáideann Django é ar chúpla bealach go huathoibríoch trí chúpla coinbhinsiún.
\nCén fáth a n-úsáideann tú suíomhanna? Is fearr é a mhíniú trí shamplaí.
\nBhí na suíomhanna LJworld.com agus Lawrence.com á oibriú ag an eagraíocht nuachta céanna - nuachtán Lawrence Journal-World i Lawrence, Kansas. Dhírigh LJworld.com ar nuacht, agus dhírigh Lawrence.com ar siamsaíocht áitiúil. Ach uaireanta bhí eagarthóirí ag iarraidh alt a fhoilsiú ar* an bheirt suíomhanna.
\nBa é an bealach naif chun an fhadhb a réiteach ná a cheangal ar tháirgeoirí láithreáin an scéal céanna a fhoilsiú faoi dhó: uair amháin le haghaidh LJworld.com agus arís do Lawrence.com. Ach tá sé sin neamhéifeachtach do tháirgeoirí láithreáin, agus tá sé iomarcach cóipeanna iolracha den scéal céanna a stóráil sa bhunachar sonraí.
\nCuireann réiteach níos fearr deireadh leis an dúbailt ábhair: Úsáideann an dá shuíomh an bunachar sonraí alt céanna, agus tá baint ag alt le suíomh amháin nó níos mó. I dtéarmaíocht samhail Django, léirítear é sin ag a: class: ~Django.db.Models.ManyTomanyField sa tsamhail Article:
from django.contrib.sites.models import Site\nfrom django.db import models\n\n\nclass Article(models.Model):\n headline = models.CharField(max_length=200)\n # ...\n sites = models.ManyToManyField(Site)\nCuireann sé seo roinnt rudaí i gcrích go deas:
\nLigeann sé do tháirgeoirí an láithreáin gach ábhar a chur in eagar - ar an dá shuíomh - i gcomhéadan amháin (riarachán Django).
Ciallaíonn sé nach gá an scéal céanna a fhoilsiú faoi dhó sa bhunachar sonraí; níl ach taifead amháin aige sa bhunachar sonraí.
Ligeann sé d'fhorbróirí láithreáin an cód amharc Django céanna a úsáid don dá shuíomh. Seiceálann an cód amharc a thaispeánann scéal ar leith chun a chinntiú go bhfuil an scéal iarrtha ar an suíomh reatha. Breathnaíonn sé rud éigin mar seo:
\nfrom django.contrib.sites.shortcuts import get_current_site\n\n\ndef article_detail(request, article_id):\n try:\n a = Article.objects.get(id=article_id, sites__id=get_current_site(request).id)\n except Article.DoesNotExist:\n raise Http404("Article does not exist on this site")\n # ...\nAr an gcaoi chéanna, is féidir leat samhail a cheangal leis an tsamhail:class: ~django.contrib.sites.models.site i gcaidreamh go leor le duine, ag baint úsáid:class: ~django.db.models.foreignKey.
\nMar shampla, mura gceadaítear alt ach ar shuíomh amháin, úsáideann tú samhail mar seo:
\nfrom django.contrib.sites.models import Site\nfrom django.db import models\n\n\nclass Article(models.Model):\n headline = models.CharField(max_length=200)\n # ...\n site = models.ForeignKey(Site, on_delete=models.CASCADE)\nTá na buntáistí céanna aige seo mar a thuairiscítear sa chuid deireanach.
\nIs féidir leat creat na suíomhanna i do thuairimí Django a úsáid chun rudaí áirithe a dhéanamh bunaithe ar an suíomh ina bhfuil an radharc á ghlaoch. Mar shampla:
\nfrom django.conf import settings\n\n\ndef my_view(request):\n if settings.SITE_ID == 3:\n # Do something.\n pass\n else:\n # Do something else.\n pass\nIt's fragile to hardcode the site IDs like that, in case they change. The\ncleaner way of accomplishing the same thing is to check the current site's\ndomain:
\nfrom django.contrib.sites.shortcuts import get_current_site\n\n\ndef my_view(request):\n current_site = get_current_site(request)\n if current_site.domain == "foo.com":\n # Do something\n pass\n else:\n # Do something else.\n pass\nTá an buntáiste aige seo freisin a sheiceáil an bhfuil creat na suíomhanna suiteáilte, agus a: class: ~django.contrib.sites.requests.requestsite sampla a thabhairt ar ais mura bhfuil sé.
\nMura bhfuil rochtain agat ar an réad iarratais, is féidir leat an modh ``get_current () ``de bhainisteoir an tsamhail:class: ~django.contrib.sites.models.site a úsáid. Ba cheart duit a chinntiú ansin go bhfuil an socrú: setting: SITE_ID i do chomhad socruithe. Tá an sampla seo coibhéiseach leis an gceann roimhe seo:
\nfrom django.contrib.sites.models import Site\n\n\ndef my_function_without_request():\n current_site = Site.objects.get_current()\n if current_site.domain == "foo.com":\n # Do something\n pass\n else:\n # Do something else.\n pass\nTá feidhmiúlacht foláirimh ríomhphoist ag LJworld.com agus Lawrence.com araon, a ligeann do léitheoirí clárú chun fógraí a fháil nuair a tharlaíonn nuacht. Tá sé bunúsach go leor: Síníonn léitheoir suas ar fhoirm gréasáin agus faigheann sé ríomhphost láithreach ag rá, “Go raibh maith agat as do shíntiús.”
\nBheadh sé neamhéifeachtach agus iomarcach an cód próiseála sínithe seo a chur i bhfeidhm faoi dhó, mar sin úsáideann na suíomhanna an cód céanna taobh thiar de na radhairc. Ach caithfidh an fógra “go raibh maith agat as síniú” a bheith difriúil do gach suíomh. Trí rudaí:class: ~django.contrib.sites.models.site a úsáid, is féidir linn an fógra “go raibh maith agat” a thiomsú chun luachanna an láithreáin reatha a úsáid: attr: ~django.contrib.sites.models.site.name agus:attr: ~django.contrib.sites.models.site.domain.
\nSeo sampla den chuma atá ar an radharc láimhseála foirme:
\nfrom django.contrib.sites.shortcuts import get_current_site\nfrom django.core.mail import send_mail\n\n\ndef register_for_newsletter(request):\n # Check form values, etc., and subscribe the user.\n # ...\n\n current_site = get_current_site(request)\n send_mail(\n "Thanks for subscribing to %s alerts" % current_site.name,\n "Thanks for your subscription. We appreciate it.\\n\\n-The %s team."\n % (current_site.name,),\n "editor@%s" % current_site.domain,\n [user.email],\n )\n\n # ...\nAr Lawrence.com, tá an líne ábhair ag an ríomhphost seo “Go raibh maith agat as liostáil le foláirimh lawrence.com.” Ar LJworld.com, tá an t-ábhar ag an ríomhphost “Go raibh maith agat as liostáil le foláirimh LJworld.com.” Téann an rud céanna le comhlacht teachtaireachta an ríomhphoist.
\nTabhair faoi deara gur bealach níos solúbtha fós (ach níos troma) chun é seo a dhéanamh ná córas teimpléad Django a úsáid. Ag glacadh leis go bhfuil eolairí teimpléad éagsúla ag Lawrence.com agus LJworld.com (:setting: DIRS <TEMPLATES-DIRS>), d'fhéadfá feirm a dhéanamh amach chuig an gcóras teimpléid mar sin:
\nfrom django.core.mail import send_mail\nfrom django.template import loader\n\n\ndef register_for_newsletter(request):\n # Check form values, etc., and subscribe the user.\n # ...\n\n subject = loader.get_template("alerts/subject.txt").render({})\n message = loader.get_template("alerts/message.txt").render({})\n send_mail(subject, message, "editor@ljworld.com", [user.email])\n\n # ...\nSa chás seo, bheadh ort comhaid teimpléad:file: subject.txt agus:file: message.txt a chruthú d'eolairí teimpléad LJworld.com agus Lawrence.com araon. Tugann sé sin níos mó solúbthachta duit, ach tá sé níos casta freisin.
\nIs smaoineamh maith é leas a bhaint as na rudaí:class: ~django.contrib.sites.models.site a oiread agus is féidir, chun castacht agus iomarcaíocht neamhriachtanach a bhaint.
\nTá coinbhinsiún get_absolute_url () ``Django go deas chun URL d'earraí a fháil gan an t-ainm fearainn, ach i gcásanna áirithe b'fhéidir gur mhaith leat an URL iomlán a thaispeáint - le ``https: // agus an fearainn agus gach rud - do réad. Chun seo a dhéanamh, is féidir leat creat na láithreáin a úsáid. Sampla:
>>> from django.contrib.sites.models import Site\n>>> obj = MyModel.objects.get(id=3)\n>>> obj.get_absolute_url()\n'/mymodel/objects/3/'\n>>> Site.objects.get_current().domain\n'example.com'\n>>> "https://%s%s" % (Site.objects.get_current().domain, obj.get_absolute_url())\n'https://example.com/mymodel/objects/3/'\nChun creat na láithreáin a chumasú, lean na céimeanna seo:
\nCuir django.contrib.sites' le do shocrú: INSTALLED_APPS.
Sainmhínigh a: socrú: SITE_ID socrú:
\nSITE_ID = 1\ndjango.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.
\n`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.
\nMá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 () `:
\n# First call; current site fetched from database.\ncurrent_site = Site.objects.get_current()\n# ...\n\n# Second call; current site fetched from cache.\ncurrent_site = Site.objects.get_current()\n# ...\n\n# Force a database query for the third call.\nSite.objects.clear_cache()\ncurrent_site = Site.objects.get_current()\nCurrentsitemanagerLink to this heading#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.
\n\nÚsáid:Class: ~django.contrib.sites.managers.currentSiteManager tríd é a chur le do mhúnla go sainráite. Mar shampla:
\nfrom django.contrib.sites.models import Site\nfrom django.contrib.sites.managers import CurrentSiteManager\nfrom django.db import models\n\n\nclass Photo(models.Model):\n photo = models.FileField(upload_to="photos")\n photographer_name = models.CharField(max_length=100)\n pub_date = models.DateField()\n site = models.ForeignKey(Site, on_delete=models.CASCADE)\n objects = models.Manager()\n on_site = CurrentSiteManager()\nLeis 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:
\nPhoto.objects.filter(site=settings.SITE_ID)\nPhoto.on_site.all()\nHow did CurrentSiteManager\nknow which field of Photo was the\nSite? By default,\nCurrentSiteManager looks for\neither a ForeignKey called\nsite or a\nManyToManyField called\nsites to filter on. If you use a field named something other than\nsite or sites to identify which\nSite objects your object is\nrelated to, then you need to explicitly pass the custom field name as\na parameter to\nCurrentSiteManager on your\nmodel. The following model, which has a field called publish_on,\ndemonstrates this:
from django.contrib.sites.models import Site\nfrom django.contrib.sites.managers import CurrentSiteManager\nfrom django.db import models\n\n\nclass Photo(models.Model):\n photo = models.FileField(upload_to="photos")\n photographer_name = models.CharField(max_length=100)\n pub_date = models.DateField()\n publish_on = models.ForeignKey(Site, on_delete=models.CASCADE)\n objects = models.Manager()\n on_site = CurrentSiteManager("publish_on")\nMá 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.
\nMá úsáideann tú an patrún seo go minic:
\nfrom django.contrib.sites.models import Site\n\n\ndef my_view(request):\n site = Site.objects.get_current()\n ...\nChun 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.
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:
\nSa 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.
\nAicme 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í.
Socraíonn na tréithe `ainm ``agus `domain don luach de:meth: ~django.http.httpRequest.get_host.
A RequestSite object has a similar\ninterface to a normal Site object,\nexcept its __init__()\nmethod takes an HttpRequest object. It's able to deduce\nthe domain and name by looking at the request's domain. It has\nsave() and delete() methods to match the interface of\nSite, but the methods raise\nNotImplementedError.
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.
\nFeidhm 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í.
\n