psLinks Installation Instructions
Included in the zip file is a setup.php.example file for your convenience, however, the auto installation portion of the script should configure the setup.php file for you automatically.
Quick and Easy Installation Instructions:
NOTE: If you are installing the script in your cgi-bin directory.. see the cgi-bin instructions below.
1. Unzip the file on your computer.
2. Upload the cgi-script
directory and its entire contents to a directory on your server. This should be
the same place where your index.htm file resides. You should end up with the
following directory structure:
3. Open up the psLinks.php file from your web browser. For example, open up your web browser and in the location field type: http://www.yourdomain.com/cgi-script/psLinks/psLinks.php .You should get the auto setup screen. Enter your mysql database info, change the username and password and hit save. The script should now be configured and you will get the login screen to enter your username and password. If you get an error message saying it can't save the setup.php file.. see PERMISSIONS section below.
4. Once configured, you can enter the management of psLinks at any time by going to the URL: http://www.yourdomain.com/cgi-script/psLinks/psLinks.php?command=login.
CGI-BIN installation instructions.
1. Unzip the file on your computer
2. On your server, create a directory in your
cgi-bin directory called psLinks. Upload all the files in the psLinks directory from the the zip file to this directory.
You should end up with:
3. On your server, create a directory outside
your cgi-bin directory called cgi-script. Inside that directory, create another
directory called psLinks. The cgi-script directory should be in the same
directory where your index.htm page resides. You should end up with:
Upload the files from the images directory in
the zip file to the cgi-script/psLinks/images directory.
4. Open up the psLinks.php file from your web browser. For example, open up your web browser and in the location field type: http://www.yourdomain.com/cgi-bin/psLinks/psLinks.php .You should get the auto setup screen. Enter your mysql database info, change the username and password and hit save. The script should now be configured and you will get the login screen to enter your username and password. If you get an error message saying it can't save the setup.php file.. see PERMISSIONS section below.
5. Once configured, you can enter the management of psLinks at any time by going to the URL: http://www.yourdomain.com/cgi-bin/psLinks/psLinks.php?command=login.
Installing psLinks as a module for csPublisher.
1. Inside the csPublisher directory there will
be a directory called 'mod' (if you don't have this directory, email us
for the latest version of csPublisher). You need to install psLinks in that
directory for csPublisher to pick it up as a module. When uploaded, it should be
located at http://www.yourdomain.com/[urltopublisherdir]/mod/psLinks/psLinks.php
where [urltopublisherdir] is the where you have csPublisher installed on your server. Example:
2. Once uploaded to that directory follow either the regular installation instructions or the cgi-bin instructions depending on whether or not csPublisher is installed in your cgi-bin directory.
3. To use the module, you log into csPublisher and you will see an additional row called 'Module Management' on the bottom of your file list. Clicking on the psLinks link will allow you to manage psLinks. Inside the editor in the misc functions dropdown, you will see 2 new options. Insert psLinks and manage psLinks.
To insert a psLinks category to a webpage with the editor, simple place your cursor where you would like the links to appear. Go to misc functions -> insert psLinks. Then select the category and click the place code button. That's it! Click 'save and exit' from the file menu to save the page.
You do not need to do anything to install the database tables. If the tables do not exist, they will automatically be created by the script. If you get any mysql errors such as access denied or unable to connect to database. Check the setup.php file and verify the $database, $host, $user, and $pass variables are correct.
If your webserver doesn't have write access to your files by default you will get an error message when you try to save the setup.php file. If you are on a windows based webserver, you will need to contact your hosting service to configure your directories so the webserver has write access to them. If you are on a unix based server, including FreeBSD or Linux, you will need to chmod the psLinks and images directories to 777. If you installed the script in your cgi-bin directory you will have 2 psLinks directories.. one inside your cgi-bin directory and one outside your cgi-bin directory.
Images Don't Appear
This is the classic case where the entire script has been installed, including the images, in the cgi-bin directory. On unix based servers, the cgi-bin directory is usually configured to disallow the viewing of normal files like html files or images. In most cases, it is required to split the directories up between cgi files and non-cgi files. If this is the case, install the script using the above cgi-bin installation instructions.
Can't locate setup.php or t_setup.htm
This usually happens when the current directory isn't in the server's search path. To fix the problem, open psLinks.php and edit the variable:
$basepath = './';
to be the full path to the directory where psLinks is installed. On windows servers, don't forget to convert the normal backslash \ to a forward slash / in the path. For example:
$basepath = 'd:/inetpub/wwwroot/cgi-script/psLinks';
Please refer to the instructions.htm page for detailed usage instructions. Also see cssreadme.htm for a description of the css styles/classes that can be used with psLinks.
For tech support or questions, please email firstname.lastname@example.org