Installing sendcard a a PHP-Nuke module
PLEASE NOTE: This is still experimental.

Congratulations!  You have made a very good choice of e-card script for your website :-)

~~~~~~~~~~~~~~~~
~ Installation ~
~~~~~~~~~~~~~~~~

Extract the contents of the archive to some directory.

When you extracted the archive you will have seen a directory called "options"
Under here there is a folder called PHP-Nuke with some files that you must use
to replace the default ones in the sendcard folder.

These files are:
index.php - replaces index.php in the sendcard directory
admin/modules/sendcard.php - place this in PHP-Nuke's admin directory - it's supposed
to give you direct access to sendcard's administration area (but doesn't seem to be 
working).
templates/card.tpl
templates/form.tpl - both replace the default templates.  The difference
                     with this form.tpl is that the paths have 
                     modules/sendcard/ prepended.

Once you have done all the above you are ready to start installing sendcard.

Upload the folder sendcard/ and all subfolders/files to the modules 
directory.  So you will end up with the admin folder at
http://yourdomain/modules/sendcard/admin

This is an important link to remember, as I cannot find how to get this
link to appear in PHP-Nuke's administration area.

If you are on a Unix/Linux/FreeBSD server chmod the files sendcard.php, 
sendcard_setup.php, admin/config.php, admin/plugins/<all files> and
include/lang/<all files> to 666 (that is, rw-rw-rw) so that the web server 
can write to them.  To do this, you must either use your FTP program
and do each file manually, or if you have ssh access to your server
you can use the script chmod.php to do it for you.  Run it via the
command line:
% php -q ./chmod.php


Go to http://yourdomain/modules/sendcard/admin/index.php and log in using the
password:
  password

Click on the link for the installation wizard.

1) Check that the paths on the
administration configuration page are correct.  My settings look like the
following:
Directory you installed sendcard in:
	modules/sendcard/
Full path to directory you installed sendcard in:
	http://yourdomain/modules/sendcard/
Full system path:
	/system/path/to/public_html/modules/sendcard/

Change your password!

2) Change the default settings.  Most of this is self-explanatory.  However,
there is one option that you *must* change to get sendcard working with
PHP-Nuke.
Change the web address of the sendcard directory from:
  http://yourdomain/sendcard/
to
  http://yourdomain/ (assuming PHP-Nuke is installed in the root of your site)

Change the paths to the templates/music/images (under advanced options) by 
prepending "modules/sendcard/" to each of the paths.

Once you have made the above changes and set the other options on that page 
you can create the tables in your database.  However, before you send
yourself a congratulatory e-card you also need to bring up the "Translation"
page.

On the "Translation" page, change all the references to "index.php" to 
"modules.php?name=sendcard"

Now we need to activate the module.  Log into the administration area of 
PHP-Nuke and go to the modules section.  Click on the "Activate" link next to
sendcard.  You may also like to change the name used in the menu's link to
something other than "sendcard".  To do this, click on the "Edit link" and
enter your own title.

Everything is now done!  Send yourself a test card and let your visitors enjoy using sendcard.

If you get stuck, don't forget the support forum at 
http://www.sendcard.org/forum/.  Please search the forum before posting
your question - I get fed up answering the same questions again and 
again.

Full documentation on customizing sendcard can be found at 
http://www.sendcard.org/documentation/