psPopper 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:
cgi-script
cgi-script/psPopper
cgi-script/csPopper/data
cgi-script/csPopper/images

3. Open up the psPopper.php file from your web browser. For example, open up your webbrowser and in the location field type: http://www.yourdomain.com/cgi-script/psPopper/psPopper.php .You should get the auto setup screen. Enter a 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, to enter csPopper, open psPopper.php from your webbrowser. For example, http://www.yourdomain.com/cgi-script/psPopper/psPopper.php. You should get a login screen to enter the username and password you configured during setup.

CGI-BIN installation instructions.

1. Unzip the file on your computer

2. On your server, create a directory in your cgi-bin directory called psPopper. Upload all the files in the psPopper directory from the the zip file to this directory. Also, upload the data directory. You should end up with:
cgi-bin/psPopper
cgi-bin/psPopper/data

3. On your server, create a directory outside your cgi-bin directory called cgi-script. Inside that directory, create another directory called psPopper. The cgi-script directory should be in the same directory where your index.htm page resides. You should end up with:
cgi-script/psPopper
cgi-script/psPopper/images

Upload the files from the images directory in the zip file to the cgi-script/psPopper/images directory.

4. Open up the psPopper.php file from your web browser. For example, open up your webbrowser and in the location field type: http://www.yourdomain.com/cgi-bin/psPopper/psPopper.php . You should get the auto setup screen. Enter a 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.

PERMISSIONS

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 psPopper and data directories to 777. If you installed the script in your cgi-bin directory you will have 2 psPopper directories.. one inside your cgi-bin directory and one outside your cgi-bin directory.. only the one inside your cgi-bin directory needs to be chmodded to 777.

In addition, any files and/or directories you want to manage with psPopper you will also need to chmod to 777 (directories) or 666(files) so the webserver will have write access to them.

Troubleshooting

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 them. 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 psPopper.php and edit the variable:
$basepath = './';
to be the full path to the directory where psPopper 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/csPublisher';

Please refer to the instructions.htm file for detailed instructions.

For tech support or questions, please email contact@cgiscript.net