This is the installation instruction for myLounge Redirection 1.2 .
Please read this text carefully to get a correct installation of the scripts.
1. INTRODUCTION
This software allows you to run a redirection service. Users may signup at your site to get a short and catchy domain name.
You as the webmaster may put advertisments on each redirected domain name.
Please keep the link back to our website included in the template file.
If you remove the link back to our website - to be honest: there's nothing we can do about that :-)
But we would be happy if you keep that link, so that other people also are able to download this software.
You may also present this link on any other web-accessible page of your website.
2. INSTALLATION
Installation is done quick and quite easy. All you need initially to start is a text editor to change a few varables in one file, and a ftp-program to load the scripts up on your server.
Now here are detailed installation instructions...
a. The list of files/directories that come along with this distribution ([...] is a directory)
.htaccess
index.php
[myred]
ad.php
admin.php
adrules.php
click.php
clients.php
delete.php
dyn.php
feedback.php
help.php
member.php
setup.php
signup.php
stats.php
terms.php
whois.php
[img]
bar.gif
[include]
functions.php
vars.php
[language]
deinc.php
eninc.php
[template]
template.html
style.css
The following 2 files MUST be placed in your webroot directory:
.htaccess
index.php
If you already have a file called "index.php" or "index.html" in your webroot, rename it (for example "index2.php" or better "home.php" or "home.html") and use this one.
You can still use the now called "index2.php"/"home.php"/"home.html" as your default startpage (this can be done in the admin panel, more on that in "d.").
The directory "myred" also must be placed in your webroot.
It must be accessible via your webbrowser by typing in "http://www.yourdomain.com/myred/".
It contains:
ad.php (if you require ads in redirected pages)
admin.php - your control panel
adrules.php (if you require ads in redirected pages)
click.php (if you require ads in redirected pages)
clients.php (if you require ads in redirected pages)
delete.php - OPTIONAL: gives your users the option to delete their subdomain names by themselves
dyn.php - OPTIONAL: allow your users to run a webserver from home even with a dynamic ip-address
feedback.php - OPTIONAL: a feedback form to contact you. Emails will be sent to the administrator email address
help.php
member.php - the user area
setup.php (only required for installation)
signup.php - here your users will signup for a new domain name
stats.php - OPTIONAL: shows stats of how many users are registered per domain name
terms.php
whois.php - OPTIONAL: a little whois script
b. Editing variables
Open the file "vars.php" (located in the directory "include") with your favourite text editor.
There are 3 to 4 variables you might have to change:
* $mysql_host is the name of the host the mysql-server is running on. In most cases it is 'localhost' and there is no need to change it. If you are unsure about that, please ask your webspace provider.
* $mysql_username is the username to access the mysql-server. If you are unsure about that, please ask your webspace provider.
* $mysql_passwd is the password to access the mysql-server. If you are unsure about that, please ask your webspace provider.
* $mysql_dbase is the name of the database where the tables will be installed. You can use an existing database (for example if you only have the right to access one database on the mysql-server), or fill in a totally new database name which will be created automatically during installation.
Things you may want to do:
* in "vars.php" edit the variable $dateformat to fit your needs. For example, "d. M. Y H:i" means you get the date in the format "20. Feb. 2002 20:19".
* open "template.html" and "style.css" in your favorite html- or texteditor and modify it to fit your website's design. A little bit HTML-knowledge is required to do so.
*********IMPORTANT*********: there are certain words like {TITLE}, {MENU} and {MAIN} written in "template.html".
These are tags which will be replaced by content while the scripts are running.
YOU HAVE TO KEEP {MAIN} IN IT IN ORDER TO RUN THE SCRIPTS. {TITLE} and {MENU} are not necessary, but recommended.
You may also use any other html- and css-file instead of the ones that come with this softwarepackege, but if you do so,
you have to rename them to "template.html" and the css-file to "style.css" and put them into the template-directory.
Again: don't forget to put the {MAIN} tag in "template.html" where you want to have the output of the scripts.
* open "terms.php" and fill in the terms and conditions for your redirection service.
* open "adrules.php" and fill in the terms and prices for your advertising clients.
Don't forget to save the files after you made the changes.
c. Upload the scripts
Upload the scripts to the root directory of your webserver. All scripts must be accessible like http://www.yourdomain.com/myred/script.php
It is important that you transfer the scripts in ASCII mode, and the image (bar.gif) in binary mode. Normally this should work automatically, depending on the ftp-program you use. Otherwise manually switch to ASCII or binary (ask you ftp-program's documentation about that).
Also leave the directory names and structure as it is.
d. run "setup.php"
Open your webbrowser and call the script "setup.php" like this: http://www.yourdomain.com/myred/setup.php
If you get mySQL-errors during the first and second step of setup: that's normal and you can ignore them (the scripts want to access the mySQL-tables which don't exist yet).
You'll see a welcome page and your mySQL-data. You also can decide on how to proceed: either create a complete new database, or use an existing one (description on screen).
All other steps are self-explaining.
During step 3 you may eventually choose the former renamed "index2.php"/"home.php"/"home.html" as "Default startpage".
After finalizing setup, don't forget to delete the "setup.php" from your webserver.
RENAMING IT IS NOT RECOMMENDED for security reasons.
3. CONFIGURATION AND RUNNING
After setup, open admin.php like this: http://www.yourdomain.com/myred/admin.php
You'll be prompted for your username and password.
After filling them in and pressing enter, you are in the main administration screen, and here you see different options to choose from.
What you should do first, is filling in the domain(s) you want to use for your redirection service (the domains your user can sign up to, at least one is required) and the categories to categorise the user's webpages (this is a function for future releases of myLounge Redirection).
Play around with all the options in the administration area, they should be self-explaining (you can also use the demo-installation on our website).
That's all. For questions, please write to [email protected] or use the messageboard at http://www.mylounge.com (if available).
Note that we try to, but that we are not obligated to support modified scripts.
We wish you best luck and success with your redirection service.
Thank you for using myLounge Redirection !
4. DISCLAIMER OF WARRANTY
THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.
myLounge is not liable for the content of any webpage redirected with myLounge Redirection.
The user (you) must assume the entire risk of using the program.