> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleverschool.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Website Utilities

> Getting Started

> [!NOTE]
>
> Initial module enablement and manager assignment must be performed by an `Administrator`.

## Quick Start

**1. Enable the Website Utilities module**

Navigate to **Administration** > **Modules** and locate **Website Utilities**. Toggle the module to **Enabled**.

**2. Assign a Website Manager**

In **Administration** > **Staff**, assign the `Website Manager` role to one or more staff members responsible for public school communications, office management, or IT systems.

> [!TIP]
>
> Until at least one `Website Manager` is assigned, system administrators will receive automated reminder notifications prompting them to delegate module leadership.

**3. Open the Website Utilities Module**

Reload your browser and select **Website** from the main navigation sidebar (or navigate to `/website/contacts` or `/website/words`).

**4. Configure Central School Office Email**

On the **Website Contacts** page (`/website/contacts`), click the **Manage** / configuration icon at the top right:

* **School Admin Email**: Enter the official central school office inbox (e.g. `office@cleverschool.test`).
* **School Admin Title**: Enter your school's formal title (e.g. `St Clevers School Office`).
* Click **Save** to confirm. This address will automatically receive copies (`CC`) of all contact form submissions and serve as the default `Reply-To` address.

**5. Add Initial Staff Contacts**

Click **Add a new contact** to register key staff members, phase leaders, or departmental inboxes (e.g. *Admissions*, *Pastoral Leads*, *SENDCo*). Assign appropriate department groups and verify their status badge.

**6. Schedule Initial Word of the Week Entries**

Navigate to **Website Words** (`/website/words`) and click **Add a new word** to input vocabulary for the upcoming school week, including meaning, example sentence, and foreign language translations.

***

## Further Setup (Manager Guide)

> [!NOTE]
>
> Ongoing directory management, vocabulary scheduling, and website integration feeds are administered by a `Website Manager`.

### 1. Organising Departmental Groups & Contact Ordering

To provide a clean, intuitive selection list for parents on your public contact form:

* **Group Categorisation**: When creating or editing contacts, assign clear, recognisable group names (e.g. *Senior Leadership*, *Pastoral & Heads of Year*, *Subject Leads*, *Administrative Team*).
* **Drag-and-Drop Reordering**: Use the handle icon on the left of any contact row to drag contacts into your preferred hierarchy within each group.
* **Direct Email Permissions**: Keep the **Send direct** toggle enabled for staff members who should receive individual email notifications when contacted.

### 2. Auditing Staff Account Status Badges

The contacts table automatically matches email addresses against school user accounts:

* User (Green): The contact is verified and linked to an active staff member in Cleverschool.
* Not a user (Red): The email address is external or not associated with any Cleverschool account. Confirm there are no typos in the email address.
* Archived user (Orange): The staff member's account has been archived. Update or delete the contact to prevent orphaned communications.

### 3. Advance Vocabulary Scheduling Strategy

Ensure your school website maintains a continuous stream of engaging literacy content:

* **Termly / Annual Planning**: Schedule 10 to 40 words in advance at the start of each term or academic year.
* **Automatic Sequential Dates**: Each new word automatically pre-populates with the date of the next consecutive week (`+7 days`).
* **Stock Health Monitoring**: Keep an eye on the vocabulary counter at the top of the words dashboard:
  * **Green Badge**: Healthy stock (> 9 future words scheduled).
  * **Orange Badge**: Moderate stock (4–9 future words scheduled).
  * **Red Badge**: Low stock (0–3 future words scheduled; automated email reminder triggered).

### 4. Delegating Operational Roles

Distribute workload across your school's administrative and curriculum teams:

* **`Website Owner`**: Assign to department leads or modern foreign languages (MFL) coordinators to input curriculum-aligned vocabulary terms and update departmental contact entries.
* **`Website Viewer`**: Assign read-only access to governors, auditors, or communication assistants who need visibility over web directory entries.

***

## Website Developer Handoff

Provide your school's web development agency or internal IT specialist with the following live integration endpoints:

| Feature | Endpoint URL | Purpose |
| :- | :- | :- |
| **Interactive Contact Form** | `https://[your-school].cleverschool.systems/contact` | Direct link or iframe embed for public parent inquiries with Turnstile protection. |
| **Staff Contacts JSON** | `https://[your-school].cleverschool.systems/website/contacts/list` | JSON feed of active staff contacts and department groups. |
| **School Office Email JSON** | `https://[your-school].cleverschool.systems/website/contacts/email` | JSON feed of central school office email settings. |
| **Current Word of the Week** | `https://[your-school].cleverschool.systems/website/words/current` | JSON feed of the active week's vocabulary word, definition, and translations. |
| **Word Archive JSON** | `https://[your-school].cleverschool.systems/website/words/previous` | JSON feed of all past vocabulary words for revision archives. |
| **School Logo Image** | `https://[your-school].cleverschool.systems/logo` | Permanent authenticated image feed of your school crest/logo. |

***

## Next Steps & Practical Guides

> [card] [Tutorials & Workflows](./tutorials)
>
> Walkthroughs for bulk Excel imports, Turnstile bot protection, and website embedding.

> [card] [System Overview](https://docs.cleverschool.systems/website/overview.md)
>
> Review core capabilities and architecture details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.