Skip to content
This repository has been archived by the owner on Mar 5, 2020. It is now read-only.

Club Approval Flow

Atul Varma edited this page Jul 14, 2015 · 6 revisions

This page documents how Club approval flow works for staff.

It is accurate as of release 0.0.9 made on June 3, 2015. If that seems like a long time ago, this document may be woefully out of date.

Club Submission

When a user adds their club to the site, they are presented with the following confirmation dialog:

Their club is then visible only to them, under a My Clubs section of the Clubs page.

At this point an email is sent out to Teach staff informing them of the submission. It will look something like this:

Subject: Please review: new club has been submitted

sillyperson would like to add their Club to the map.

Name: hello testing
Location: Detroit, Michigan, United States
Website: 
Description: hello testing
Email: [email protected]

This club is currently in a pending state and you can approve or deny it
for inclusion in the public map at:

https://teach-api-production.herokuapp.com/admin/clubs/club/120/

You may also want to email them at [email protected] to say hello!

At this point, someone from the teach staff should manually contact the submitter via email.

Clicking on the link in the email will take the staff member to the Django administration site for the Teach site. Before following this link, please log into teach.mozilla.org (the login is shared between the admin site and the teach site).

Note than an email is also sent out to the user who submitted the club.

Accessing the Administration Site

When you're logged in to teach.mozilla.org, there should be a "Site Administration" link in the nav below your username:

2015-05-18_17-57-24

If you don't see this, then it's because we haven't marked your account as having staff privileges. Please contact Atul or Hannah to have this done.

Clicking on the Site Administration link will eventually present you with a standard browser-issued pop up dialog that looks something like this:

The username and password for this prompt is not your Webmaker username and password--it's a shared set of credentials that is required to log in to the administrative part of the site, as a layer of additional protection. If you don't already know these credentials, please contact Atul or Hannah.

Once you have access to the administration site, you can click on "Clubs" to be taken to a list view, where you can view all clubs and their current statuses, sorting them by any column:

2015-05-29_7-42-56


Aside: The Difference Between "Status" and "Is active"

You may notice in the screenshot above that there is one column called "Status" and another called "Is active". This is actually a bug; for now all you need to know is that if "Is active" is false, the club is effectively deleted: it won't show up in any user's "My Clubs" list, and it definitely won't show up to the general public.


Clicking on the name of a club will take you to its detail page, where you will be able to view and change any of the metadata about the club. You will also be able to change the club's approval status using the following widget:

2015-05-29_7-53-25

Note that changing the status does not send a transactional email to the club owner--you'll have to do that manually.

Also note that if a user edits a Club that had been in the "Denied" state, it will switch to "Pending" automatically, though no transactional email will be sent.