################################################################################### # HTAdmin - the .htaccess tool Version 2.0 alpha # # Copyright 2004 Jon Thompson jon@serpentskiss.com # # Created 04 February 2004 Last modified 04 February 2004 # # # ################################################################################### # COPYRIGHT NOTICE # # Copyright 2004 Jon Thompson All Rights Reserved # # # # This program may be used and modified free of charge by anyone as long as this # # copyright notice and the comments above remain intact. By using this code you # # agree to indemnify Jon Thompson from any liability that may arise from its use # # # # Selling of this code without prior written consent is forbidden - it's my work, # # so don't try to make money from me! # # # # Please obtain permission before redistributing this software over the Internet # # or in any other medium. In all cases copyright and header must remain intact. # ################################################################################### ################################################################################### # [1]: There are no user-configurable settings in this script. Any changes made # # to the script can therefore not be supported. # # # # [2]: This script is *untested* except while under development, and is therefore # # considered to be in an alpha release status. Use at your own risk. I # # accept no responsibilty for the use of this script. # # # # [3]: Comments and suggestions can be sent to the email address above. # # # # [4]: PLEASE READ THIS TEXT FILE CAREFULLY! # # # ################################################################################### ----------------------------------------------------------------------------------- CONTENTS OF THIS ZIP FILE ----------------------------------------------------------------------------------- [] htadmin.pl - the script itself [] HTAdmin_readme.txt - this text file ----------------------------------------------------------------------------------- UPLOADING INSTRUCTIONS ----------------------------------------------------------------------------------- [] Use your FTP program to upload the htadmin.pl script to the directory you wish to customise. SET THE FTP TRANSFER MODE TO ASCII!!! [] CHMOD the uploaded script to 755 (rwxr-xr-x). CHMOD can usually be found in your FTP program by right-clicking on the file once it has been uploaded. [] In your web browser, go to the folder your have just uploaded the script to, and add "htadmin.pl" to the end of the url eg: http://www.mydomainname.com/folder/htadmin.pl [] Enter the administrator password. If this is the first time the script has been run on your webspace, then the default password is "password" (no quotes!) Everything else is fairly self-explanatory once you are in the program itself. Below is a quick guide to each screen: ----------------------------------------------------------------------------------- ADMINISTRATOR OPTIONS ----------------------------------------------------------------------------------- There are 2 options on this screen: [] change the administrator password (recommended after installation!) [] reset the folder to a non-protected state. This will only be available if there is a .htaccess file in the folder. ----------------------------------------------------------------------------------- CUSTOM ERROR PAGES ----------------------------------------------------------------------------------- This allows you to specify custom error pages for the 4 most commonly-seen errors on websites. [] 401: Unauthorised Displayed when someone has tried to access a password-protected area and has failed 3 times. [] 403: Forbidden The server recognised the request, but is refusing access to the requested URL. [] 404: Page not found The file or page requested could not be found. [] 500: Internal server error Covers a multitude of sins, thanks to Microsoft's "friendly" error message settings, and is no use for diagnostics. Usually indicates a script was executed that contains errors. ----------------------------------------------------------------------------------- PASSWORD PROTECTION ----------------------------------------------------------------------------------- The main part of the script. This section allows you to give a number of users access to the folder that the script has been uploaded to. [] Add a user Add a new user to the list of users allowed to access the folder. Usernames MUST be: - at least 2 characters long - made up of ONLY alphanumeric characters A to Z, a to z and 0 to 9. [] Modify a user Change the password for an existing user [] Delete a user Remove a username from the list of users allowed to access the folder Please note that the last two options are only available if there is an existing user list. ----------------------------------------------------------------------------------- LOGOUT ----------------------------------------------------------------------------------- Logs the administrator out of the script, kills the cookies that were set and returns you back to the login screen. ################################################################################### # Copyright 2004 Jon Thompson All Rights Reserved # ###################################################################################