diff --git a/client/documentation/admin-dashboard/committee.md b/client/documentation/admin-dashboard/committee.md index 5127371..0dc6243 100644 --- a/client/documentation/admin-dashboard/committee.md +++ b/client/documentation/admin-dashboard/committee.md @@ -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) diff --git a/client/documentation/admin-dashboard/games.md b/client/documentation/admin-dashboard/games.md index 73caf79..a5ace97 100644 --- a/client/documentation/admin-dashboard/games.md +++ b/client/documentation/admin-dashboard/games.md @@ -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. @@ -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=". \ No newline at end of file +**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=". + diff --git a/client/documentation/admin-dashboard/members.md b/client/documentation/admin-dashboard/members.md index f8fde6a..4984ba9 100644 --- a/client/documentation/admin-dashboard/members.md +++ b/client/documentation/admin-dashboard/members.md @@ -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 diff --git a/client/documentation/admin-dashboard/showcase.md b/client/documentation/admin-dashboard/showcase.md new file mode 100644 index 0000000..796bad3 --- /dev/null +++ b/client/documentation/admin-dashboard/showcase.md @@ -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/` +