From a7c945ad53a8fd94ed3f0c92b7dec83a06e97bfb Mon Sep 17 00:00:00 2001
From: badaix <johannes.pohl@badaix.de>
Date: Tue, 27 Oct 2020 08:30:36 +0100
Subject: [PATCH] Add content to default web page

---
 server/control_session_http.cpp | 34 +++++++++++++++++++-
 server/etc/index.html           | 55 ++++++++++++++++++++++++++++++++-
 2 files changed, 87 insertions(+), 2 deletions(-)
diff --git a/server/control_session_http.cpp b/server/control_session_http.cpp
index 2b4da4da..77febfbc 100644
--- a/server/control_session_http.cpp
+++ b/server/control_session_http.cpp
@@ -30,6 +30,38 @@ static constexpr auto LOG_TAG = "ControlSessionHTTP";
 
 
 static constexpr const char* HTTP_SERVER_NAME = "Snapcast";
+static constexpr const char* UNCONFIGURED =
+    "<html><head><title>Snapcast Default Page</title></head>"
+    "<body>"
+    "  <h1>Snapcast Default Page</h1>"
+    "  <p>"
+    "    This is the default welcome page used to test the correct operation of the Snapcast built-in webserver."
+    "  </p>"
+    "  <p>"
+    "    This webserver is a websocket endpoint for control clients (ws://<i>host</i>:1780/jsonrpc) and streaming clients"
+    "    (ws://<i>host</i>:1780/stream), but it can also host simple web pages. To serve a web page, you must configure the"
+    "    document root in the snapserver configuration file <b>snapserver.conf</b>, usually located in"
+    "    <b>/etc/snapserver.conf</b>"
+    "  </p>"
+    "  <p>"
+    "    The Snapserver installation should include a copy of <a href=\"https://github.com/badaix/snapweb\">Snapweb</a>,"
+    "    located in <b>/usr/share/snapserver/snapweb/</b><br>"
+    "    To activate it, please configure the <b>doc_root</b> as follows, and restart Snapserver to activate the changes:"
+    "  </p>"
+    "  <pre>"
+    "# HTTP RPC #####################################\n"
+    "#\n"
+    "[http]\n"
+    "\n"
+    "...\n"
+    "\n"
+    "# serve a website from the doc_root location\n"
+    "doc_root = /usr/share/snapserver/snapweb/\n"
+    "\n"
+    "#\n"
+    "################################################</pre>"
+    "</body>"
+    "</html>";
 
 namespace
 {
@@ -161,7 +193,7 @@ void ControlSessionHttp::handle_request(http::request<Body, http::basic_fields<A
         res.set(http::field::server, HTTP_SERVER_NAME);
         res.set(http::field::content_type, "text/html");
         res.keep_alive(req.keep_alive());
-        res.body() = "<html><head><title>Snapcast Default Page</title></head><body>TODO: description how to configure the doc_root</body></html>";
+        res.body() = UNCONFIGURED;
         res.prepare_payload();
         return res;
     };
diff --git a/server/etc/index.html b/server/etc/index.html
index 98969c7f..15a2b267 100644
--- a/server/etc/index.html
+++ b/server/etc/index.html
@@ -2,10 +2,63 @@
 
 <head>
   <title>Snapcast Default Page</title>
+  <style>
+    body {
+      background: #ffffff;
+      color: rgb(0, 0, 0);
+      font-family: 'Arial', sans-serif;
+      margin: 20px;
+      font-size: 20px;
+    }
+
+    pre {
+      margin: 8px 0px 8px 0px;
+      padding: 20px;
+      border-width: 1px;
+      border-style: dotted;
+      border-color: #000000;
+      background-color: #F5F6F7;
+      font-style: italic;
+      display: inline-block;
+    }
+
+    h1 {
+      margin: 15px 0px 0px 50px;
+      font-size: 180%;
+      font-weight: bold;
+    }
+  </style>
 </head>
 
 <body>
-  TODO: description how to configure the doc_root
+  <h1>Snapcast Default Page</h1>
+  <p>
+    This is the default welcome page used to test the correct operation of the Snapcast built-in webserver.
+  </p>
+  <p>
+    This webserver is a websocket endpoint for control clients (ws://<i>host</i>:1780/jsonrpc) and streaming clients
+    (ws://<i>host</i>:1780/stream), but it can also host simple web pages. To serve a web page, you must configure the
+    document root in the snapserver configuration file <b>snapserver.conf</b>, usually located in
+    <b>/etc/snapserver.conf</b>
+  </p>
+  <p>
+    The Snapserver installation should include a copy of <a href="https://github.com/badaix/snapweb">Snapweb</a>,
+    located in
+    <b>/usr/share/snapserver/snapweb/</b><br>
+    To activate it, please configure the <b>doc_root</b> as follows, and restart Snapserver to activate the changes:
+  </p>
+  <pre>
+# HTTP RPC #####################################
+#
+[http]
+
+...
+
+# serve a website from the doc_root location
+doc_root = /usr/share/snapserver/snapweb/
+
+#
+################################################</pre>
 </body>
 
 </html>
\ No newline at end of file
