|
The news system is in two parts.
HTML part -
This needs to be uploaded by you to your web server
to the same location that you install the rest of your site.
All the html components are in the html directory of the archive.
CGI scripts
This needs to be uploaded by you to your web server
to the the cgi-bin part of the server.
All the componemts are in the cgi-bin directory of the archive.
This package contains an automated install and unpacking routine.
Copy the two files newsscript.data and news_setup.pl to your cgi-bin
directory and run news_setup.pl. I suggest that you make a subdirectory
news in the cgi-bin directory and install there
The news_setup will unpack the news1.2 files and create the database
and log files. Most of the settings for your system are guessed by the
install script. Most people will just need to adjust the location of the
image buttons, icons, newsimages and choose the language.
Images
Image buttons are supplied with the auth package and should have already been
installed with Auth 1.5.
Updating previous versions
If you are updating a previous version of the dlman package then you will not need
to convert your database file to work with this system.
Installing New Versions
If you are updating then you will need to start in a clean empty directory in the
cgi-bin for the news1.2 otherwise you will have problems.
Install to a clean directory then copy accross files you want.
***** Install the auth 1.5 package first *****
Auth 1.5 is also free and is available from http://www.jbayley.com
1. Copy the button images of your choice to a directory normally available to the apache server.
I prefer to make a subdirectory in the main site called /images and put them there.
2. Create the newsimages directory, it must be available to the apache server.
If you prefer a sample /newsimages/ directory is included.
3. Create a directory for the news scripts to go in. You can use the cgi-bin if you
wish, I always think it neater to use a separate subdirectory called news. Change the
permissions of the directory you created to writeable by the webserver.
e.g. chmod 775 news
Note the config file assumes that you install in a directory in the cgi-bin
directory along with the auth1.5 files
4. Copy the news_setup.pl and newsscript.data scripts to your chosen directory.
and change the permissions so that the news_setup.pl script is executable by the
webserver.
e.g. chmod 755 news_setup.pl
5. Run the news_setup.pl script from your browser. This will unpack the files and
prompt you for your system settings.
Check the settings for the path to /images/buttons.en/
Check the settings for the path to /newsimages/
The default settings are ok if you followed the prefered format. If you
are happy with the settings then press the send button. this will generate the
configuration file.
6. Run the newsedit.pl script by clicking on the News editor link.
7. Consider renaming or deleting the news_setup.pl script for security. If it is left
then it is possible for someone to reconfigure your system remotely.
Help.
If the news_setup.pl script returns the message :-
File attributes set on 0 files
Config file read failed
Then check the permissions of the directory the news_setup.pl script is in this
usually means the server could not write the file due to the server not having
write permission.
If you get an error 403 forbidden then check the permissions of the news_setup.pl
script the likely cause is that the server could not execute the file.
Notes
news_setup.pl can be used at any time to re-configure your system. it will not
overwrite databases if they exist. Configuration files that exist are
renamed to have a time and data suffix and a new config file is created.
|
