QSL Gallery v0.3

Paolo Subiaco http://gw.ir3ip.ampr.org/iw3grx

1 Introduzione

What are QSL? They are postal cards used to confirm connections between amateur radio people (OMs). When two OMs made a long radio connection, they usually exchange a card within their personal and connection informations, and a pretty photo.

This software, written in PHP4, permit users to store their QSL in a web server and view other QSL sorted by country, so this software is usable in the internet<->packet radio gateways as a nice service for the hamradio users.

Actually, the software was only tested in Linux, but it probably works in other operating systems too.

The software is release with the GNU General Public License: this means that the software is ``OpenSource'' and you can modify it without asking us, with the promise to redistribuite the new software modified by your own providing all sources. Please refer to the license specification at the URL http://www.gnu.org/copyleft/gpl.html.

2 Requirements

You need at least a web server capable of parsing PHP pages: you can use the most used http server Apache http://www.apache.org.

Consider that the php script need to access to its directories with writing permission: if your web server run as UID=nobody and GID=nogroup, you must grant permissions to nobody or nogroup.

The package tree is indicated below, indicating with ``[*]'' the whole directories and files which must have writing permissions to the webserver UID or GID:

main directory (not accessable by web server) [*]
- qsl.inc (an include file for html/index.php)
- README.lyx (this documentation, in LYX format)
- countries.qsl (list of countries and prefix... each line must be exactly 72 chars long, including carriage return; the third field is the number of QSL for that country) [*]
- csv2qsl.tcl (permit to convert a database with field delimited by ``:`` into country.qsl format; it also create a directory for each country, as specified below)
- qsl.counter (this is the access counter file) [*]
- html (link to a directory reachable by the webserver, for example /var/www/html/qsl) [*]
  - index.php (the main php script)
  - qsl.css (stylesheet definition)
  - star.png (a simple star image)
  - directories... (for each country, a directory must be created in lowercase) [*]

3 Installation

Select a directory non accessable by the webserver, for example /home/iw3grx/qsl-0.3and uncompress the tarball:
cd /home/iw3grx/qsl-0.3
tar xvzf /home/iw3grx/qsl-0.3.tar.gz
Then, create a simbolic link between /home/iw3grx/qsl-0.3/html and a directory reachable by the webserver, for example /var/www/html/qsl:
ln -s /home/iw3grx/qsl-0.3/html /var/www/html/qsl
Finally, be sure that the create directories and file have the right permissions: they must all be readable by the http server, and the files/directories specified above with the ``[*]'' must be both readable and writable by the http server.
Now try to connect http://yourhost/qsl and enjoy the QSL Gallery.

4 Conclusions

For any informations, please refer to the website http://ir3ip.sourceforge.net, hosted by sourceforge.net, where you will found all documents about.

For any suggestion or bug report, please post a message in the appropriate forum at the URL http://sourceforge.net/forum/?group_id=31821.

If you are interested about developing this software with us, please compile the subscription form at the URL http://ir3ip.sourceforge.net; if will install the software, please tell us where this software is installed, compiling the registration form at the same URL, so your server will be added to the list where the software is installed.

About this document ...

QSL Gallery v0.3

This document was generated using the LaTeX2HTML translator Version 99.2beta8 (1.42)

The command line arguments were:
latex2html -no_subdir -split 0 -show_section_numbers /tmp/lyx_tmpdir3794EZP4Fj/lyx_tmpbuf37945xsckv/README.tex

The translation was initiated by Paolo Subiaco on 2001-07-22

Paolo Subiaco 2001-07-22