Administrator

How do I manage Domain Settings?

Follow
Ryan Richins
  • Agilix team member
  • Updated:
    info_outline
    Created:

Manage domains, users, courses, styles & themes, and integrations.

Domain Settings allows you to customize your domain to best suit your district or organization. This article walks through the options in Edit Settings to give an overview of this powerful feature.

To access Domain Settings:

  1. Open the vertical menu in the toolbar of Domain Details.  
  2. Select Domain Settings.

The settings you can edit on this screen are arranged in alphabetized cards. This article provides an overview of those settings.

Activity templates

Activity Templates: If enabled, Buzz allows you to create activity templates that content authors can copy items from the syllabus of the indicated course and edit for their own needs.

Authentication

Authentication: Buzz supports the use of Single Sign-on (SSO) features to allow users to sign into one application (for example, a student information system) and be automatically logged into Buzz without needing to re-enter credentials.

Avatars

Avatars: If enabled, Buzz allows users to choose a profile picture from a list of pre-approved avatars. From this card, you can add, upload, and delete these avatar images.

Badges

Badges: Buzz allows course authors to set up badges that can be automatically awarded to students upon their completion of a specified activity or accomplishment, or awarded manually by a teacher or grader. From this screen, you can add, edit, and delete these Badges.

Blackout dates

Blackout dates: Use blackout dates to specify the dates you don't want included when calculating due dates for continuous enrollment courses in your domain.

Provide a Name and Start and End dates.

Clipboard tabs

Clipboard Tabs: Add tabs for third-party apps to seamlessly integrate for intervention or other personalized learning goals. For example, you may integrate with a messaging tool. To do so, provide:

  • A tab Title.
  • The third-party URL.

Course templates

Template Courses: If enabled, Buzz allows you to Add course templates that content authors can use as a structure when creating new courses.

Editor

Editor: These fields control elements of the Editor tool. From this screen, you can:

  • Hide Activities (activity types) in the Editor by listing them in the field; separate items with commas.
  • Required rights specify which rights you want a user to have in order to see the Editor tool.

G Suite service account

G Suite service account: G Suite integration enables:

  • Easy creation of Google Drive documents in the Student app when completing a dropbox activity.
  • PDF snapshots of Google Drive submissions.
  • Automatic permissions management.
  • Automatic copies of Google Drive documents when duplicating activities.

Landing content

Landing Content: Easily create domain-wide landing page content that appears on the user's Home and specify when and which roles see it.

Learning standards

Learning Standards: To help assess objective mastery, Buzz allows you to align course activities with Standards from various states and/or organizations (these are drawn from the Achievement Standards Network (ASN) catalogue). By default, Buzz makes the following standards available to all domains (contact your Agilix account manager to add standards to your domain):

  1. To make an organization's standards available in your courses, add its code to the Comma-separated list of standard sets.
  2. Check the boxes for the grade levels that you want included as well.

Library extensions

Library Extensions: Buzz allows you to make content from various online resources available in a Digital Library. These can include other courses within their district or organization as well as open sources like EdGate, OpenEd, and Kahn Academy.

Login redirects

Login Redirects: Add redirects to allow users to access Buzz data in a third-party app, by authenticating in Buzz first. To do so, provide:

  • The ID of the redirect entry.
  • The third-party URL.

LTI credentials

LTI Credentials: Buzz allows you to integrate with other learning tools (like Turnitin). From this screen, you can add and delete Learning Tools Interoperability (LTI) Credentials.

To add a new LTI Credential, you are asked to provide the Hostname URL, the Key, and the Secret.

Metadata for activities

Activity Metadata: Buzz allows you to add and remove the metadata sections associated with items (folders and activities) in the Editor tool for the teacher role. From this screen, you can add, edit, and delete metadata sections. To create a metadata section, you are asked to:

  • Provide a Name, which is not visible to the users and cannot include spaces or special characters (you can underscore or hyphenate between words).
  • Provide a Title, which is visible to students.
  • Choose Input Type from the options listed here. The content entered in these fields is used to create searchable metadata tags
  • Provide Placeholder text for the activity.
  • Use the Default field to define the default state or content that you want present in the field (this is not available for the Rich Text input type).
  • Indicate the Levels within the course folder structure at which you want this metadata displayed. Level one is the first level of folders under the course folder, level two impacts any folders or activities you add to those folders, and so forth. If you don't specify here, the field is shown at all levels.
  • Choose the Item Type for which the section should appear (folders, activities, or all).
  • Indicate whether you want to Allow setting per group.
  • Indicate whether you want to make the item Visible to students when they select the item in the Activities tool (only applicable to folders).
  • Indicate whether you want the metadata Editable in Clipboard in the Teacher app. Checking this box causes the metadata field to appear in the Clipboard when creating activities.

Metadata for courses

Course Metadata: Create metadata fields for teachers, course authors, etc to complete for courses.

Metadata for domains

Domain Metadata: Allows admins to create Domain Metadata fields where users can record and track additional information about a domain.

Metadata for questions

Question Metadata: Buzz allows you to create metadata fields for questions by providing a:

  • Name: The XML element name for the data.
  • Title: What you want shown in the UI.

Metadata for users

User Metadata: Allows admins to create User Metadata fields where users can track additional information about a user.

Miscellaneous

The Miscellaneous card includes:

  • Default course navigation: Choose your domain's default Activities tool layout from two options:
    • Full View shows the course tree structure in the sidebar when a user opens a folder.

    • Simplified shows only the contents of the folder the user is in. 

  • Idle Timeout: Enter, in minutes, the amount of time Buzz can remain idle before logging a user out. Providing a timeout value prevents users from staying logged in indefinitely and having that time recorded and reported as activity. If you leave this field blank, users are not logged out due to inactivity.
  • Prohibited Files: List any file types that you want to prohibit users from uploading to Buzz. Separate items with commas.
  • Hide audio and video uploading controls: Check this box to disable audio/video uploads.

Rubrics

Rubrics: Create rubrics for course authors to use with the Rubric editor.

School years and grading periods

School Years and Grading Periods: Set up domain-level Grading Periods for courses in your domain to use. To do so, you must define a school year, create Grading Periods within that school year, and then select the current year and Grading Period for the domain.

Scoring objectives

Scoring Objectives: Buzz allows you to add Scoring Objectives to use in Multi-Outcome Scoring courses.  

SpeechStream

Enable SpeechStream with this card (learn more about SpeechStream).

Student options

Student Options: Here, you can:

Text Editor (Formerly XML Editor)

You can open the Text Editor from the toolbar.

This screen allows you to edit Application settings, Domain customizations, and XLI settings.

You will be required to use these screens to complete some tasks in Buzz, but for the most part these screens are for advanced users who prefer this editor to the Buzz UI.

Comments (10)

Sort by
Kevin Healy

When customizing my domain under "Settings --> Domain Options --> Menu Entries-Standard, it will not allow me to edit any settings for any admin level menu items. I have full permissions to the domain, but every time I click to edit Competencies, for example, it disappears and an objectives option creates itself under the Menu Entries-Custom. Any thoughts or advice?

Brad Marshall
  • Agilix team member

Hey Kevin, this is a bug. Those options shouldn't jump down to Custom. However, even though it is under Custom, you can still edit them. "objectives" is the ID for the tool that you call Competencies. 

Matthew Marichiba

The Menu Entries - custom section above doesn't mention the URL substitution variables. The only place I've seen those is in old BrainHoney docs. I needed that info just now, so figured I'd paste it here.

url - URL to display in a top level iframe when a user clicks the menu entry. This URL can contain dynamic replacement variables by surrounding them with double curly braces: {{VAR}}. These are the supported replacement variables:

  • TOKEN - The xLi authentication token for the currently logged in user. When using this variable, url must be a secure URL that starts with https.
  • USERID - The ID for the currently logged in user.
  • USERDOMAINID - The domain ID for the currently logged in user.
  • USERSPACE - The userspace for the customization domain, or the domain userspace visible in the top level URL.
  • ENROLLMENTID - The ID of the currently selected enrollment.
  • COURSEID - The ID of the course associated with the currently selected enrollment.
  • QUERY-<param> - The value of the top page's query parameter with the case-sensitive name of <param>. The application only replaces this variable if external is not set to true.
Keoni Messer

In the new UI, what does the Domain Option "Hide Activities" do? I had assumed it would change visibility of the existing activities of certain types, but it doesn't do that according to what I've seen.

Scott Taylor

Hello Keoni,

The "Hide Activities" option removes the specified activities from the new item creation options. It will not affect items of that type that are already created, but will remove that type from being available when creating new items in a course.

Keoni Messer

Thank you! That makes sense. I think my mind went to activity visibility because I was hoping that's how it functioned. :)

Chad Kafka (FPS)

I am working in the OLD UI still. I manage our Domain Level and I want to upload some common rubrics so those authoring courses can just 'pick' them to use rather than having to recreate them.  I see that the Rubric files have to be XML.  Is there a template somewhere to follow for what this looks like or a suggestion on what application to create the rubric in?  I have tried taking data and saving as XML and when I do import the XML file, there is no data present.  Looking for a good guide to follow...


Thanks,

Scott Taylor

Hello Chad,

Due to the nature of how the XML format can change we haven't put out a guide, but would recommend creating the rubric using the editor there (accessed via the pencil icon when adding the rubric template). The upload option is there for if someone were to share a rubric created in Buzz that they downloaded.

Shaun Creighton

I added a rubric to a domain by creating it using the editor (using the pencil icon as described above). When I am editing a course within that domain and try to add the rubric to an assignment, it doesn't show up on the list. If it matters, my user account is in a different domain ... does the rubric need to be added to the domain that contains the user accounts of course editors, or the domain where the course resides (or both)?

Scott Taylor

Hello Shaun,

To access the templates defined on a domain the user must log into that domain's userspace (meaning the URL in the address bar needs to be the domain where the template is defined). So let's say the users are in a domain called Users and the template is defined in a domain called Template, to access the template you'll have to log into template.agilixbuzz .com rather than users.agilixbuzz .com.

Please sign in to leave a comment.