From e3fd0a269b8ab29c2af2fb84a2714d92ee50681d Mon Sep 17 00:00:00 2001
From: Tobias Diekershoff <tobias.diekershoff@gmx.net>
Date: Mon, 4 Jan 2016 09:55:30 +0100
Subject: [PATCH] some doc strings, sort platforms for federation stats page

---
 mod/admin.php | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/mod/admin.php b/mod/admin.php
index 616e8fcd4a..34e9b5c03b 100644
--- a/mod/admin.php
+++ b/mod/admin.php
@@ -238,7 +238,7 @@ function admin_content(&$a) {
  *
  * The returned string contains the HTML code of the subpage for display.
  *
- * @brief subpage with some stats about "the federstion" network
+ * @brief subpage with some stats about "the federation" network
  * @param App $a
  * @return string
  */
@@ -249,7 +249,9 @@ function admin_page_federation(&$a) {
     // We are looking for the following platforms in the DB, "Red" should find
     // all variants of that platform ID string as the q() function is stripping
     // off one % two of them are needed in the query
-    $platforms = array('Diaspora', 'Friendica', '%%red%%', 'Hubzilla', 'GNU Social', 'StatusNet');
+    // Add more platforms if you like, when one returns 0 known nodes it is not
+    // displayed on the stats page.
+    $platforms = array('Friendica', 'Diaspora', '%%red%%', 'Hubzilla', 'GNU Social', 'StatusNet');
     $counts = array();
     foreach ($platforms as $p) {
 	// get a total count for the platform, the name and version of the
@@ -333,6 +335,7 @@ function admin_page_federation(&$a) {
 	'$counts' => $counts,
 	'$version' => FRIENDICA_VERSION,
 	'$legendtext' => t('Currently this node is aware of nodes from the following platforms:'),
+	'$baseurl' => $a->get_baseurl(),
     ));
 }
 /**
@@ -743,6 +746,9 @@ function admin_page_site_post(&$a){
 
 /**
  * @brief generate Admin Site subpage
+ *
+ * This function generates the main configuration page of the admin panel.
+ *
  * @param  App $a
  * @return string
  */
@@ -955,6 +961,13 @@ function admin_page_site(&$a) {
 
 /**
  * @brief generates admin panel subpage for DB syncronization
+ *
+ * This page checks if the database of friendica is in sync with the specs.
+ * Should this not be the case, it attemps to sync the structure and notifies
+ * the admin if the automatic process was failing.
+ *
+ * The returned string holds the HTML code of the page.
+ *
  * @param App $a
  * @return string
  **/
@@ -1133,6 +1146,13 @@ function admin_page_users_post(&$a){
 
 /**
  * @brief admin panel subpage for User management
+ *
+ * This function generates the admin panel page for user management of the
+ * node. It offers functionality to add/block/delete users and offers some
+ * statistics about the userbase.
+ *
+ * The returned string holds the HTML code of the page.
+ *
  * @param App $a
  * @return string
  */