Prerequisites Before you can install the taggingmanager, there are four prerequisite components you must install. When you install these, remember to read the associated documentation. If your website is hosted for you, contact the server administrators or hosting company to ensure these are installed. 1. An Apache web server, available at the official download page. 2. A recent version of PHP, the programming language in which the taggingmanager is written. This is available from the official download page. * Some Linux servers may also require the equivalent MySQL package and PHP session management package; see the documentation for the operating system. 3. A MySQL database server, which will be used to store all the links and metadata. This is available from the official download page. 4. Taggingmanager itself, which is available from the official download page. Development versions are available from the Sourceforge.net project page. Uploading to the server Download and uncompress Download the taggingmanager to your local computer and uncompress the files, so that you can see the files and folders. This is usually done with software such as Winrar, WinZip or 7-Zip on Windows. Upload Upload the files to a public directory (usually public_html/tm) using an FTP client such as Flashfxp, FileZilla. If you are using a Unix server and have access to the httpd.conf, make a Symbolic link. Installation Create a MySQL database The MySQL database server stores the text and data of your tagginmanager. * If you know the root password for your database, create a database and an account to access it. * If you don't know the root password for your MySQL server, for example if you don't have the password because you are using a shared host, you need to create a MySQL database and a user before installing the taggingmanager. You can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. See the corresponding documentation. Alternatively, contact your host provider to have them create an account for you. Adjust the config file. * Adjust the config.php in your root folder: important to set thecorrect database data and installation path. Create users go to the directory admin, create/edit users we have 1 default user->admin:admin (you can delete this) for security reasons create .htaccess to protect the admin directory Uninstallation Removing the taggingmanager entirely can be accomplished in two steps: removing the directory where it was installed, and dropping the database from MySQL. For example, if you installed the taggingmanager to /var/www/tm, you might do rm -r /var/www/tm Then, using the mysql utility to interactively connect to MySQL as a user with adequate permissions, you would issue the following command at the mysql> prompt: DROP DATABASE taggingmanager; (If you needed to retain some tables, you could also drop just some of the tables individually. ) Howto protect adminfolder (v1.0 or lower only) You can protect a specific directory with the .htaccess file by doing the following: 1. Create a new file called .htpasswd 2. The .htpasswd file uses the following format for storing username and passwords: username:password There must be no spaces on the line before username, either side of the colon or after the password text. If you want several people to have access to the protected space, with each having a different login, you can add as many username/password lines as you wish making sure each one is on a separate line. username can be any text or name but should not contain any spaces. password should not be entered as plain text because this file could be viewed. Use the following link to get an encrypted version of your password: http://www.euronet.nl/~arnow/htpasswd , then use the encrypted version as the password for the username. To simplify the process, a tool now exists that can create your .htpasswd file entries for you which you can then cut/paste into your own .htpasswd file: http://users.plus.net/htpasswd/ 3. Now you need to add this to the .htaccess file. Note: the example given is for the www server, it is different for the CGI server which is explained later: AuthUserFile /share/isp/plusnet/www/uu/username/htdocs/directory/.htpasswd AuthGroupFile /dev/null AuthName EnterPassword AuthType Basic require valid-user The first line is the full server path to your .htpasswd file and will be different for each webspace (note: the path should be entered on the same line as AuthUserFile). To get your correct path for AuthUserFile just replace uu with the first 2 chars of your username, username with your username and directory with the name of the folder/directory you want to password protect. The .htaccess and .htpasswd files should then be put in directory. Note: if you put the .htaccess and .htpasswd files in the root of your site (htdocs on www server), it will password protect the entire site and ask for a username/password each time someone visits so it is not recommended to protect that one. Just place it in the sub directory you want to protect. You can replace the EnterPassword text of AuthName with whatever you like, this is what is displayed in the login box when you acces the protected area. If you wish the message to have spaces in it, enter it within quote marks, such as "Enter The Password". The above example shows the path to use for your www webspace. To find the path to use for your CGI server webspace do the following: * use telnet (or similar app) to connect to your cgi server shell e.g. telnet plus.net * Enter your cgi username & password to the login and password prompts * At the shell prompt ($) enter pwd followed by the return key. This will show your current working directory which is the root of your cgi webspace. * Use that information + the name of the directory/folder you want to protect as the path for the AuthUserFile line. E.g.: /files/homeX/username/secret/.htpasswd where X could be 1, 2 or 3. Once you have created your .htaccess and .htpasswd files and copied them to the directory/folder you want to protect you should test the folder protection via a browser. Enter the URL to the protected webspace (e.g. for www webspace if you put the files into a directory called protected, it may be something like http://www.username.plus.com/protected ). You should then be presented with a login screen where you must enter your username and password. If it works, entering a valid username/password will give you access to the folder, invalid username/password should not allow access to the folder. If the above fails, check you have created the .htaccess and .htpasswd files correctly and that you have copied them to the correct place. If you used FTP to copy the files to your webspace (www or cgi) make sure you transfered them as text and they have gone into the correct folder. Or ftp them as htaccess.txt and htpasswd.txt and rename them to .htaccess and .htpasswd.