Adding a new user

Collecting information

For each user, you will need to collect some information:

• First name(s)
• Last name(s)
• Username
• Pronouns the person uses
• Password (this can always be changed)
• Bio
• Image in JPEG or PNG format (see below)
• Any professional or personal websites to add to the profile

Filling out the YAML file

Once you have all the information collected, you can start working in the file backend/setup/users.yml where you want to add the collected information above, in a format that follows this template:

- first_name: <First name>
  last_name: <Last name(s)>
  pronouns: <Which pronouns the person uses>
  username: usernamewithoutspacesorothercharacters
  password: <clear-text password here - which means this file should NOT be shared on the internet>
  bio: <insert bio here and make sure the text block follows YAML linting standard>
  img: backend/setup/profile-pictures/<firstname-lastname.jpg> <Also don't forget to add this file to the directory -- see below>
  groups:
      - Team <see the backend.settings.py file and the dictionary AUTO_GROUPS to find the available groups to add here>
  blurb:
      workshop: <slug to the workshop>
      text: <blurb for the workshop>
  links:
      - text: <whatever text you want to show for the link>
        url: <a valid full URL>
        cat: <project OR personal>

This section needs to be added to whichever category of user you wish to add:

• SUPER: Has full access to the site and all the database models
• STAFF: Has backend access to the admin interface, but not necessarily to all the database models.
• USER: Has no acccess to the admin interface but is a normal "learner" on the site.

See below for an example of how the YAML file needs to be structured.

Adding an image

Note: It is important to not forget to add the image file that you list in the users.yml file to the correct directory.

Full example of YAML file users.yml

by_groups:

    SUPER:
        - first_name: Test
        last_name: Superuser
        username: test
        password: test
        groups:
            - Team
        pronouns: "she"

    STAFF:
        - first_name: Test
        last_name: Staffuser
        username: test
        password: test
        groups:
            - Team
        pronouns: "he"

    USER:
        - first_name: Test
        last_name: User
        username: test
        password: test
        groups:
            - Learner
        pronouns: "they"