You need to configure a number of things to make this work:
-1. The web interface depends on a 'guest' user existing. You can create this
+1. If you want online registration to work then you set mail_sender in
+ /etc/disorder/config to the email address that communications from the web
+ interface will appear to be sent. If this is not a valid, deliberable email
+ address then the results are not likely to reliable.
+
+ mail_sender webmaster@example.com
+
+ By default the web interface sends mail by connecting to the SMTP port of
+ 127.0.0.1. You can override this with the smtp_server directive, for
+ exampler:
+
+ smtp_server mail.example.com
+
+2. The web interface depends on a 'guest' user existing. You can create this
with the following command:
disorder setup-guest
disorder -- setup-guest --no-online-registration
-2a. If you want to have a 'jukebox' virtual host, modify the DNS accordingly
+3a. If you want to have a 'jukebox' virtual host, modify the DNS accordingly
and use a fragment such as this one:
<VirtualHost HOSTNAME>
echo label url.static /static/ >> /etc/disorder/options.user
echo label links.css /static/disorder.css >> /etc/disorder/options.user
-2b. If you don't want a virtual host then you must still make sure that
+3b. If you don't want a virtual host then you must still make sure that
DisOrder can find its icons and stylesheet. For example in your web server
configuration:
echo label url.static /disorder/ >> /etc/disorder/options.user
echo label links.css /disorder/disorder.css >> /etc/disorder/options.user
-3. Install disorder.cgi in an appropriate location. Remember to make it
- executable. For example assuming a virtual host as above (2a):
+4. Install disorder.cgi in an appropriate location. Remember to make it
+ executable. For example assuming a virtual host as above (3a):
install -m 755 clients/disorder.cgi ~jukebox/public_html/index.cgi
- or not (2b):
+ or not (3b):
install -m 755 clients/disorder.cgi /usr/lib/cgi-bin/disorder
-4. Try it out. You should be able to perform read-only operations straight
+5. Try it out. You should be able to perform read-only operations straight
away, and after visiting the 'Login' page to authenticate, perform other
operations like adding a track to the queue.
-5. If you run into problems, always look at the appropriate error log; the
+6. If you run into problems, always look at the appropriate error log; the
message you see in your web browser will usually not be sufficient to
diagnose the problem all by itself.
-6. If you have a huge number of top level directories, then you might find
+7. If you have a huge number of top level directories, then you might find
that the 'Choose' page is unreasonably large. If so add the following line
to /etc/disorder/options.user:
label sidebar.choosewhich choosealpha
\fISERVICE\fR.
.SS "Web Interface Configuration"
.TP
+.B mail_sender \fIADDRESS\fR
+The email address that appears in the From: field of any mail messages sent by
+the web interface. This must be set if you have online registration enabled.
+.TP
.B refresh \fISECONDS\fR
Specifies the maximum refresh period in seconds. Default 15.
.TP
Defines the maximum number of characters to include in a \fBshort\fR name
part. Default 30.
.TP
+.B smtp_server \fIHOSTNAME\fR
+The hostname (or address) of the SMTP server to use for sending mail. The
+default is 127.0.0.1.
+.TP
.B templates \fIPATH\fR ...
Specifies the directory containing templates used by the web
interface. If a template appears in more than one template directory