Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions client/documentation/admin-dashboard/committee.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
## Committee Members

Profiles of the Committee Members of the club that are displayed on the about page.
URL: `/admin/game_dev/committee/add/`

Profiles of the Committee Members of the club that are displayed on the about page `/about`.

## Prerequisites

As a committee member is also a member of the club, you must construct a member first via `/admin/game_dev/member/add/`. Back on the committee page, you can find a specific member (e.g. the one you just created) by clicking the magnifying glass icon next to the `Id` input box.

## Fields

**Id:** Required and unique field for the club member that is on the committee. It is an integer field that corresponds to the raw integer id of a row in the Member table, as a Foreign Key if you know databases.

**Role:** Required and unique field for the specific role in the committee that this member has. It is something known as an Enum (Enumeration), which has a discrete number of custom choices. You can choose from 'President', 'Vice President', 'Secretary', 'Treasurer', 'Marketing', 'Events OCM', 'Projects OCM', and 'Fresher Rep'. Since they must be unique, you can only have 8 objects in the Committee table at a time for now. This can definitely be changed in the future when the committee grows.

## Other Notes

Before making a Committee object in the Committee table, you must make a Member object for the person that's on the committee and then link it through the id (just to clarify)
15 changes: 9 additions & 6 deletions client/documentation/admin-dashboard/games.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,20 @@
## Games

URL: `/admin/game_dev/game/`
Pages for games can be added and edited at the row 'Game' of the GAME_DEV section on the main admin page.

### Fields

**Name:** Required field for the game's name. A character field (includes letters, numbers and symbols) of maximum length 200 characters.

**Descripiton:** Required field for the game's description. A text field.
**Description:** Required field for the game's description. A text field.

**Completion:** Required field for the game's completion. A multichoice option field with four options including:
- "Work in progress (Unplayable)"
- "Playable - In Development"
- "Beta - Stable but not Final"
- "Completed"

- "Work in progress (Unplayable)"
- "Playable - In Development"
- "Beta - Stable but not Final"
- "Completed"

**Active:** Required field for if the game is continued to be being worked on. A boolean field.

Expand All @@ -28,4 +30,5 @@ Pages for games can be added and edited at the row 'Game' of the GAME_DEV sectio

**Itch Game Width:** This field is required if the playable field ID is non null. This value is gotten in a similar way to the Itch Game Embed, however for the developer it's the number after "width=" and in the page source is found after "data-width=".

**Itch Game Height:** This field is required if the playable field ID is non null. This value is gotten in a similar way to the Itch Game Embed, however for the developer it's the number after "height=" and in the page source is found after "data-height=".
**Itch Game Height:** This field is required if the playable field ID is non null. This value is gotten in a similar way to the Itch Game Embed, however for the developer it's the number after "height=" and in the page source is found after "data-height=".

1 change: 1 addition & 0 deletions client/documentation/admin-dashboard/members.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
## Member Profiles

URL: `/admin/game_dev/member/add/`
Profiles of club members can be added and edited at the row 'Member' of the GAME_DEV section on the main admin page.

### Fields
Expand Down
83 changes: 83 additions & 0 deletions client/documentation/admin-dashboard/showcase.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
## Game Showcase
URL: `/admin/game_dev/gameshowcase/add/`
The Game Showcase page is managed by administrators to highlight outstanding individual games. It serves as the featured section of the game library (see `/games`).

## Prerequisites

1. **Add a Game**

- Path: `/admin/game_dev/game/add/`
- Required fields: name, description, completion status, host URL, thumbnail, event, etc.

2. **Add Game Contributors**
- Path: `/admin/game_dev/gamecontributor/add/`
- Link club members to individual games. Each contributor must first be created in the `/admin/game_dev/member/` member panel.

## Add Game Showcase

1. Navigate to: `/admin/game_dev/gameshowcase/add/`
2. Use the search function to find the desired game, then click the game ID to populate the value.
3. Enter the committee's recommendation in the "Description" field.
4. Save your changes and review the showcase page to ensure the content is correct.

## Page Elements Maintenance

- **Game Title**

- Edit at: `/admin/game_dev/game/`

- **Recommendation (Committee Advice)**

- Edit at: `/admin/game_dev/gameshowcase/`, under the field "Description"
- This recommendation appears directly under the game title as advice from the committee.

- **Game Description**

- Edit at: `/admin/game_dev/game/`
- The description is shown below the cover image and contributor section, and matches the content on the individual game page.

- **Cover Image**
- Uses the thumbnail uploaded when adding the game.
- Edit at: `/admin/game_dev/game/`

## Art Showcase

The Art Showcase page is managed by administrators to highlight outstanding individual artworks. It serves as the featured section of the art library.

## Prerequisites

1. **Add an Art Object**

- Path: `/admin/game_dev/art/add/`
- Required fields: name, description, source_game, media, active

2. **Add Art Contributors**
- Path: `/admin/game_dev/artcontributor/add/`
- Link club members to individual artworks. Each contributor must first be created in the `/admin/game_dev/member/` member panel.

## Add Art Showcase

1. Navigate to: `/admin/game_dev/artshowcase/add/`
2. Use the search function to find the desired art object, then click the art ID to populate the value.
3. Enter the committee's recommendation in the "Description" field.
4. Save your changes and review the showcase page to ensure the content is correct.

## Page Elements Maintenance

- **Art Name**

- Edit at: `/admin/game_dev/art/`

- **Recommendation (Committee Advice)**

- Edit at: `/admin/game_dev/artshowcase/`, under the field "Description"
- This recommendation appears directly under the art name as advice from the committee.

- **Art Description**

- Edit at: `/admin/game_dev/art/`

- **Media**
- Uses the media uploaded when adding the art.
- Edit at: `/admin/game_dev/art/`

Loading