Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Muhammadbugaje/NAMETS_Website/llms.txt

Use this file to discover all available pages before exploring further.

The NAMETS platform exposes a singleton-style Site Settings record in the Django admin that acts as a central control panel for user-facing feature flags. Rather than deploying code changes every time applications open or close for a new session, administrators simply update a single database row. The SiteSettings model lives in the core app and is accessible at /admin/ under the Administration section in the sidebar.
Only one SiteSettings record should exist at any time. If the record is deleted, default values apply and all application portals will be closed until a new record is created.

Accessing Site Settings

1

Log in to the admin panel

Navigate to https://your-site.onrender.com/admin/ and sign in with a superuser account. Only superusers have permission to view and edit Site Settings.
2

Open Site Settings

In the left sidebar, scroll to the Administration group and click Site Settings. You will see the single settings record.
3

Edit and save

Toggle the relevant fields on or off and click Save. Changes take effect immediately — no server restart is required.

Field Reference

All fields belong to the core.SiteSettings model. Boolean fields gate user-facing pages; text fields supply the intro copy shown at the top of each form.
tutor_applications_open
boolean
default:"False"
When True, the tutor application form on the public site becomes accessible and accepts new submissions. When False, the form is hidden or replaced with a “closed” message. Maps to the help text: “Allow tutor applications?”
membership_applications_open
boolean
default:"False"
Controls whether the NAMETS membership application form is open to new submissions. Toggle this at the start of each academic session when recruiting new members.
islamiyya_registration_open
boolean
default:"False"
Opens or closes the Islamiyya class registration portal. Students can only register when this flag is True.
An optional WhatsApp group invite URL sent to students after their Islamiyya registration is verified. Leave blank if no WhatsApp group is in use for the current session.
Example: https://chat.whatsapp.com/AbCdEfGhIjKlMnOpQrStUv
tutor_evaluations_open
boolean
default:"False"
When True, the tutor evaluation form is visible to students so they can rate their tutors. Close this after the evaluation window ends to prevent late submissions. Maps to the help text: “Allow students to submit tutor evaluations?”
tutor_intro_text
string
A short paragraph displayed at the top of the tutor application page to motivate prospective applicants. Edit this each session to keep the messaging current.
membership_intro_text
string
Introductory text shown at the top of the membership application form. Customize this per session or recruitment drive.
evaluation_intro_text
string
default:"Help us improve by evaluating your tutor."
A brief prompt displayed above the tutor evaluation submission form to encourage students to participate in feedback.

How Feature Flags Work

The platform checks these boolean flags before rendering application or registration forms. The general flow is:
1

User visits an application page

For example, a student navigates to the Islamiyya registration page.
2

View reads SiteSettings

The Django view fetches the SiteSettings singleton and inspects the relevant boolean field (e.g. islamiyya_registration_open).
3

Open or closed response

If the flag is True, the form is rendered with the corresponding intro text. If False, the user sees a notice that the portal is currently closed.

Quick Reference Table

FieldTypeDefaultControls
tutor_applications_openBooleanFalseTutor application form visibility
membership_applications_openBooleanFalseMembership application form visibility
islamiyya_registration_openBooleanFalseIslamiyya registration form visibility
islamiyya_whatsapp_linkURLnullWhatsApp invite link sent post-verification
tutor_evaluations_openBooleanFalseTutor evaluation form visibility
tutor_intro_textTextSee aboveIntro copy on tutor application page
membership_intro_textTextSee aboveIntro copy on membership application page
evaluation_intro_textTextSee aboveIntro copy on tutor evaluation page
Develop a session calendar that maps each boolean flag to a specific date range (e.g. “membership applications open: Week 1–3 of semester”). You can then schedule admin updates in advance rather than relying on ad-hoc toggles.

Build docs developers (and LLMs) love