Interested in applying some eye-candy
to the images of albums and performers/artists ? It's rather easy. Really! Read more
How does user registration and login options work ?
What it is:
It's possible to enable self registration of new users as well as enabling email of lost passwords plus controlling if 'anonymous' users (users without login and password) can access your AmpJuke box.
It's also possible to show/hide the "Keep me signed in" option on the login-page.
Finally, there's an option to automatically delete users that have not logged in for X days (X is a value you specify):
The "User registration and login options" are controlled on the "Configuration" page (located in "Admin's options" menu on the "Welcome" page).
How it works:
When self registration of new users is enabled, anyone with an email address can register in AmpJuke.
A free-format text link (f.ex. "Click here to register") can be displayed on the login-page. When a new user clicks on the link, the registration process is started.
The user enters a desired username, email adress and a password. It's possible to control the minimum and maximum lenght of usernames and passwords.
The new user must also verify the he/she is human by answering a simple "quiz" question displayd on the registration page.
When all checks in relation to length of username+password as well as a correct answer to the "quiz" question is OK, a confirmation message is sent by mail to the new users email address.
Once the link in the email message is clicked, the user is activated and is able to login and start streaming music.
If a user forgets his/her password, it's possible to display a simple text link on the login-page (F.ex. "Lost password ? Click here!"). When someone clicks on the link, AmpJuke asks for an email address and - if found - an email is sent to the user.
The email message contains a "reset" link. When clicked, AmpJuke assigns a new password to the user, and sends the new password in another email message to the user.
If the user suddenly remembers the "lost" password, and he/she avoids clicking on the "reset" link in the email, the password for the user is left unchanged.
A couple of other options exists in relation to handling anonymous users (users without a username and password). We'll take a closer look at them below.
Note: You might want to enable blocking of IP-adresses as an extra 'feature'. More about blocking of IP-adresses here: http://www.ampjuke.org/?id=faq58.
How it's configured:
Configuration of self registration of users, login options and handling of anonymous users is done by logging in as a user with administrator access, then clicking on "Configuration..." on the "Welcome" page, and finally expanding the section "User registration and login options" on the site configuration page.
The section is divided into four subsections as follows:
Enable self-registration of users: If activated (checked), it's possible for new users to register themselves on your AmpJuke box as described above. If left blank (unchecked) the next four parameters will not have any effect.
Use this email address as sender: Some (many?) administrators prefers a "blind" email address - f.ex. "NoReply@somedomain.com" - when sending mails automatically during a registration process.
By entering an email address - f.ex. "firstname.lastname@example.org" - the sender will be (you guessed it) "email@example.com" on all mails in relation to self-registration. Beware that many email servers checks domain vs. IP-adresse (as well as a lot of other things) in order to determine if an email is considered to be spam or not, so my advice is to use a valid email-domain.
And - just to be 100% clear - AmpJuke uses the standard PHP-funftion mail(), which will work if mail has been configured correctly on your AmpJuke server. I am _not_ able to support configuration of mail on all the AmpJuke boxes out there. Period.
Display this text (f.ex. "Click here to register"):Will display a free format text link on the login-page that - if clicked - will take new users to the registration page as described above.
Username length: Consist of two parameters - the minimum and maximum number of characters allowed in a username within AmpJuke.
Password length: Same a username length above. This one is just dealing with min/max length of passwords.
In section 2, you can configure if it's possible to have AmpJuke send an email with a "reset" link as well as new, auto-generated passwords (as explained above in "How it works"):
Enable sending emails with lost/forgotten password: If activated (checked), it's possible to request a "reset" link sent by email.
And - just to repeat myself again - AmpJuke uses the standard PHP-funftion mail(), which will work if mail has been configured correctly on your AmpJuke server. I am _not_ able to support configuration of mail on all the AmpJuke boxes out there. Period.
Display this text (f.ex. "Forgot your password ? Click here"): Will display a free format text link on the login-page that - if clicked - will ask for an email address to send the "reset" link to (as explained above in "How it works").
Section 3 determines if inactive users should be deleted automatically, and the duration (in days) a user is considered to be 'inactive' before being deleted.
Setting a value different than 0 for Automatically delete users that have not logged in after will delete any user that haven't logged in for that number of days.
If you set the value to 0 the effect will be that no automatic deletion will happen, no matter how long it's been since the user logged in last.
Section 4 only consists of one parameter:
Hide "Keep me signed in" option on login page: If activated (checked) the checkbox "Keep me signed in for two weeks" will not be visible on the login-page.
Section 5 deals with 'anonymous' users (users without a username and password):
Allow anonymous users: If activated (checked) anyone will be able to access your AmpJuke box regardless if they have a username+password or not. If activated, there will be an option "Login as anonymous" on the login-page which allows users to get access to AmpJuke without username+password.
Also allow anonymous users to stream music:This parameter will only have effect if "Allow anonymous users" (see above) is activated. If checked (activated), users without a username+password will - besides being able to browse your music collection - also be able to stream music using AmpJuke.