Administrasjon
==============


.. _nytt_nettsted:

Legge til nytt nettsted
-----------------------

Hvis Wagtail-installasjonen skal betjene flere nettsteder, må det for hvert nettsted som legges til
opprettes et Site-objekt, en Collection, en startside og en eller flere adgangsgrupper:

:Page: Gå til *Pages* og opprett en ny artikkel rett under *Root*-siden.
:Site: Gå til *Settings > Sites* og opprett en ny site.
       Angi nettstedets domene (f.eks ``tma4105.math.ntnu.no``),
       portnummer 443,
       og bruk startsiden opprettet i forrige steg.
       Alternativet *Is default site* skal ikke være avkrysset.
:Collection: Gå til *Settings > Collections* og opprett en egen Collection (f.eks ``TMA4105``).
:Group: Gå til *Settings > Groups* og opprett en egen gruppe (f.eks ``TMA4105``).

Rediger deretter gruppen slik at den har følgende privilegier:

:Object permissions: ADD/CHANGE/DELETE på Course, Book, Video, Exam og Predefined Text.
:Other permissions: Can access Wagtail admin.
:Page permissions: ADD/EDIT/PUBLISH på nettstedets startside.
:Document permissions: ADD/EDIT på nettstedets collection.
:Image permissions: ADD/EDIT på nettstedets collection.

Gå til *Snippets > Page types* og tilpass listen over sidetyper (eksempel, bevis, regneregel, +++).

Hvis nettstedet tilhører et emne, gå også til *Snippets > Courses* og legg til emnet der.



.. _ny_bruker:

Legge til nye brukere
---------------------

Alle med gyldig brukerkonto kan logge inn i Wagtail
(med *gyldig brukerkonto* menes enten NTNU-brukerkonto eller
en hvilken som helst norsk Feide-brukerkonto,
avhengig av hvilken autentiseringskilde som brukes).

Den lokale Django-brukerkontoen blir opprettet ved første gangs innlogging,
men uten noen spesielle privilegier.

Å tilordne redigeringstilgang i Wagtail kan derfor gjøres på to måter:

* Be brukeren om å logge inn én gang, slik at brukerkontoen blir opprettet.
  Tilordne deretter brukeren til de gruppene han/hun skal ha tilgang til.
* Opprett brukerkontoen manuelt, og legg til brukeren i de aktuelle gruppene,
  slik at alt er i orden allerede første gang brukeren logger inn i Wagtail.

Sistnevnte er vanligvis å anbefale, men verken Djangos eller Wagtails
administrasjonsgrensesnitt lar deg opprette en brukerkonto uten å sette passord.
Siden vi alltid ønsker å benytte ekstern autentisering
(og ikke ha lokale passord på Django-brukerkontoene),
er det inntil videre den første måten som må benyttes.

**Husk å legge til brukeren på epostlista vår for Wagtail-brukere.**

.. note::

    **TODO:**
    Skrive en
    `custom management command <https://docs.djangoproject.com/en/2.1/howto/custom-management-commands/>`_
    som lar oss opprette brukerkontoer uten passord ved å kalle
    `set_unusable_password() <https://docs.djangoproject.com/en/2.1/ref/contrib/auth/#django.contrib.auth.models.User.set_unusable_password>`_
    på brukerobjektet før det lagres.