# Web Admin



# CSV Import / Export

### General CSV Import / Export

<p class="callout danger">Ticking the "Replace Data" checkbox will **delete all existing records** before importing.</p>

<p class="callout info">Any spreadsheets being uploaded must be exported to CSV format; The process for this will differ depending on your spreadsheet editor.</p>

The first row of an imported CSV should contain the names of the fields being imported, each row after should contain the data for a single imported record e.g:

<table border="1" id="bkmrk-first-name-surname-e" style="border-collapse: collapse; width: 100%; height: 119.188px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**First Name**</td><td style="height: 29.7969px;">**Surname**</td><td style="height: 29.7969px;">**Email**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Alice</td><td style="height: 29.7969px;">Alison</td><td style="height: 29.7969px;">alice.alison@example.com</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Bob</td><td style="height: 29.7969px;">Bobson</td><td style="height: 29.7969px;">bob.bobson@example.com</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Charles</td><td style="height: 29.7969px;">Charleson</td><td style="height: 29.7969px;">charles.charleson@example.com</td></tr></tbody></table>

<p class="callout info">The importer will fail to import any column that has spaces before or after the field name in the first row.</p>

### Importing Students

An example file for Student CSV upload can be downloaded [here](https://office.littlemonkey.co.nz/nextcloud/s/S3CEfaCx3L6YmNK)

The Student CSV importer can be found at the top left of the [Student Admin](https://play.wordchain.co.nz/admin/students/).

The student importer takes in some extra fields to allow for the linking and/or creation of student groups on import. The required fields for importing Students are:

<table border="1" id="bkmrk-first-name-surname-e-0" style="border-collapse: collapse; width: 100%; height: 106.188px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**First Name**</td><td style="height: 29.7969px;">**Surname**</td><td style="height: 29.7969px;">**Email**</td><td style="height: 29.7969px;">**Username**</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">optional</td><td style="height: 46.5938px;">optional</td><td style="height: 46.5938px;">required unless "Username" is provided</td><td style="height: 46.5938px;">required unless "Email" is provided</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-</td><td style="height: 29.7969px;">-</td><td style="height: 29.7969px;">*Must be a valid email*  
</td><td style="height: 29.7969px;">-</td></tr></tbody></table>

<table border="1" id="bkmrk-password-account-typ" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Password**</td><td style="height: 29.7969px;">**Account Type**</td><td style="height: 29.7969px;">**School Name**</td><td style="height: 29.7969px;">**Student Group Name**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">required for new users, optional for existing users</td><td style="height: 29.7969px;">required</td><td style="height: 29.7969px;">required if linking/creating student group</td><td style="height: 29.7969px;">required if linking/creating student group</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">*Must be 8+ characters with 1 capital and 1 number.  
The password must be a new password if provided for existing users*   
</td><td style="height: 29.7969px;">*set to "Student"*</td><td style="height: 29.7969px;">*If provided, must be the exact name of an existing school*</td><td style="height: 29.7969px;">*If provided, must be the exact name of an existing student group owner by the connecting school*</td></tr></tbody></table>

# Orders and Licences

### Pending Orders

All purchases come through the web admin as Pending Orders records under the [Pending Orders](https://play.wordchain.co.nz/admin/school-admin/PendingOrder) tab of the [School](https://play.wordchain.co.nz/admin/school-admin/) admin.

- **Credit card payments** will appear with either a status of "Paid" or "Cancelled". They require no manual action.
- **Invoices** will appear as "Pending" and should be set to "Paid" manually when the invoice is paid. The licences are allocated when the Pending Order is created so even if it is not set to "Paid" the school will still have it's licences.