Fixed (file) comments.

edit/editHTMLPage.php

@@ -1,6 +1,12 @@
 <?PHP
 /**
- * This page offers the opportunity to edit static page elements: the side bar and the footer.
+ * This page offers the opportunity to edit static page elements:
+ * - the side bar,
+ * - the footer,
+ * - the banner,
+ * - the welcome message for the backend.
+ *
+ * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */
 
 /*

edit/index.php

@@ -1,7 +1,9 @@
 <?PHP
 /**
  * Start page of the backend.
- * Offers a dashboard.
+ * Offers the welcome message (if there is one),
+ * a description of the CMS and some basic data
+ * on the contents of the current page.
  *
  * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */

edit/page.php

@@ -1,6 +1,8 @@
 <?PHP
 /**
  * This page offers the opportunity to edit static pages.
+ *
+ * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */
 
 /*

edit/pages.php

@@ -1,7 +1,6 @@
 <?PHP
 /**
- * Start page of the backend.
- * Offers a dashboard.
+ * Overview page for all pages.
  *
  * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */

edit/password_protect.php

@@ -1,6 +1,6 @@
 <?PHP
 /**
- * Login script
+ * Login script.
  *
  * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */

edit/settings.php

@@ -1,7 +1,6 @@
 <?PHP
 /**
- * Start page of the backend.
- * Offers a dashboard.
+ * Settings page.
  *
  * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */
@@ -28,7 +27,11 @@ if (!$_SESSION['admin']) {
 // Check for vars.
 loadHttpToGlobals(["task", "startPage", "pageTitle", "logo", "url", "css", "hideInstitution", "mdVersion", "mdImgFolder", "cacheRefreshInterval", "limitToInstitutions", "maxFileSize", "sendHTTPHeaders", "CSPimageSources", "CSPobjectSources", "defaultLang"]);
 
-if (isset($task) and $task == "update") { // Adding new users.
+/**
+ * Part for editing settings.
+ */
+
+if (isset($task) and $task == "update") {
 
     if (isset($defaultLang) and !in_array("$defaultLang.php", scanDirConts(__DIR__ . "/translations"))) {
         $_SESSION["editHistory"] = ["changesAborted", $translations['languageUnavailable']];

edit/users.php

@@ -1,7 +1,6 @@
 <?PHP
 /**
- * Start page of the backend.
- * Offers a dashboard.
+ * This script lists all users and offers the option to add new ones.
  *
  * @author Joshua Ramon Enslin <joshua@jrenslin.de>
  */
@@ -32,7 +31,10 @@ if (!isset($users)) {
     $users = json_decode(file_get_contents(__DIR__ . "/../data/users.json"), true);
 }
 
-if (isset($task) and $task == "insert") { // Adding new users.
+/**
+ * Adding new users.
+ */
+if (isset($task) and $task == "insert") {
 
     $redirectURL = "./users.php?" . write_common_vars(["username", "realName", "email", "admin"]) . "#addUser";