WISE Administrator Resources

Hiroki Terashima edited this page Jun 7, 2018 · 3 revisions


This page contains resources for WISE administrators such as first time getting started and user management.

If you'd like to contribute to the open source effort or ask questions to developers about programming or about this page, email us on the wise-dev mailing list (http://groups.google.com/group/wise-dev) or come chat with us on Gitter (https://gitter.im/WISE-Community/WISE)

First time getting started

Log in as admin and change the password

  1. Log in as admin. username/password is admin/pass. You should see the admin homepage.
  2. Change password to something else. Under "User Management", click on "list all teachers". Find the admin user, and click on "Change Password" next to it. This should bring up the window to let you change the password.
  3. Remember your new password.

Add a project to the WISE library

  1. Log in as admin. You should see the admin homepage.
  2. Click on "Import A Project" link under the "Project Management" section. You will use this page to add the project to your WISE instance.
  • Option 1: Use the "Select a WISE Project to Import" drop-down select menu to choose from available sample projects.
  • Option 2: Download a project from http://wise5.org and use it to upload in the "Manually Import WISE Project" section. For "Project Zip File", click "browse..." and select the zip file you downloaded.
  1. Hit "Import", and note the success message, along with the new project id and links to preview and manage it. This confirms that the project has been added to your WISE instance and is now available for teachers to preview. If you do not see the success message, you might have to set your file permissions. See here: https://github.com/WISE-Community/WISE/wiki/How-to-Setup-WISE-on-a-Server#Troubleshooting.
  2. To confirm that the project has been added to the library, go back to the admin portal. Click on "Manage All Projects" link under the "Project Management" section. The new project should be listed here.
  3. To make the project available to the general public, you'll need to add tags to the project. In the "Existing Tags" column for the new project, add a "library" tag. In the "Create A New Tag" input box, type "library" and click on the create button. This will make this project accessible in the Project Library page for other non-admin users. If you would also like project to show up in the main home, add an additional "public" tag.
  4. Click on the "Preview" link under "Other Actions" column. This will start the VLE and load the project.
  5. Alternatively, go back to the main home page (not the admin home page) and click on "Preview a Project" button. The new project should be listed there because you added the "library" tag above. Click on the "Preview Project" link to preview the project. This method is suitable for people who do not have admin privileges.

Configure Portal Settings

  1. Log in as admin. You should see the admin homepage.
  2. Click on "Configure WISE Settings" link under the "WISE management" section.
  3. Enable "Is Login Allowed" to allow students and teachers to log in to your WISE instance.
  4. Enable "Send WISE statistics to WISE5.org" to help WISE researchers gather statistical data of your WISE instance usage.

Teacher Information Sheet

Go to http://your_wise_instance_url/pages/gettingstarted.html. This page is also linked from the new teacher account confirmation email, the main homepage, and the WISE footer. This page helps teachers get started using WISE and will introduce how to create teacher/student accounts and set up runs.

Adding/Modifying Runcode Prefixes

Runcodes are created when a new classroom run is set up and is used to add students to the run. Runcode follows the format [runcodePrefix][threeDigitNumber]. For example, Lion354, Mouse917, etc. Default runcode prefixes are specified for each locale in wise.properties with they key "runcode_prefixes_en". You can define your runcodes here for each locale.

Changing default locale

Default locale is specified in wise.properties under the key "defaultLocale". The default setting is


You can change this to any locale listed in "supportedLocales" (e.g. en, ar, zh_TW, zh_CN, nl, fr, de, el, he, it, ja, ko, pt, es, th, tr, etc).

And then restart the server to make the change take effect.