Comments

website/queries/groupAdmin.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Gets the current settings for a group.
+ * @param int $groupID
+ * @return mixed
+ */
 function getGroupSettings(int $groupID) {
     $stmt = prepareQuery("
     SELECT
@@ -15,6 +20,12 @@ function getGroupSettings(int $groupID) {
     return $stmt->fetch();
 }
 
+/**
+ * Updates the settings for a group.
+ * @param int $groupID
+ * @throws AngryAlert
+ * @throws HappyAlert
+ */
 function updateGroupSettings(int $groupID)
 {
     if (!checkGroupAdmin($groupID, $_SESSION["userID"])) {
@@ -40,6 +51,12 @@ function updateGroupSettings(int $groupID)
     }
 }
 
+/**
+ * Checks if an user is an admin for a page.
+ * @param int $groupID
+ * @param int $userID
+ * @return bool
+ */
 function checkGroupAdmin(int $groupID, int $userID) : bool {
     $stmt = prepareQuery("
     SELECT
@@ -60,18 +77,39 @@ function checkGroupAdmin(int $groupID, int $userID) : bool {
     return ($role == "admin");
 }
 
+/**
+ * Returns all normal members for a group.
+ * @param int $groupID
+ * @return array|bool
+ */
 function getAllGroupUsers(int $groupID) {
     return getAllGroupMembers($groupID, 'member');
 }
 
+/**
+ * Returns all admin for a group.
+ * @param int $groupID
+ * @return array|bool
+ */
 function getAllGroupAdmins(int $groupID) {
     return getAllGroupMembers($groupID, 'admin');
 }
 
+/**
+ * Returns all Moderators for a group.
+ * @param int $groupID
+ * @return array|bool
+ */
 function getAllGroupMods(int $groupID) {
     return getAllGroupMembers($groupID, 'mod');
 }
 
+/**
+ * Returns all members for a group specified by a string.
+ * @param int $groupID
+ * @param string $role
+ * @return array|bool
+ */
 function getAllGroupMembers(int $groupID, string $role) {
     $stmt = prepareQuery("
         SELECT
@@ -97,6 +135,14 @@ function getAllGroupMembers(int $groupID, string $role) {
     return $stmt->fetchAll();
 }
 
+/**
+ * Upgrades or downgrades a groupmember to a different role.
+ * @param int $groupID
+ * @param int $userID
+ * @param string $role
+ * @throws AngryAlert
+ * @throws HappyAlert
+ */
 function upgradeUser(int $groupID, int $userID, string $role) {
     if (!checkGroupAdmin($groupID, $_SESSION["userID"])) {
         throw new AngryAlert("Geen toestemming om te wijzigen");
@@ -121,6 +167,11 @@ function upgradeUser(int $groupID, int $userID, string $role) {
     }
 }
 
+/**
+ * Removes a group form the database.
+ * @throws AngryAlert
+ * @throws HappyAlert
+ */
 function deleteGroup() {
     if (!checkGroupAdmin($_POST["groupID"], $_SESSION["userID"])) {
         throw new AngryAlert("Geen toestemming om de groep te verwijderen!");