
 ***************************************************************************
 *  README.txt [English]                            script-name: phpECard  *
 *  ---------------------------------------------------------------------  *
 *  version                  : 2.0                                         *
 *  script suport page       : http://quick-xs.net/phpecard                *
 *  author email             : phpecard@quickxs.net                        *
 *                                                                         *
 ***************************************************************************
 *                                                                         *
 *  This is the installation-manual for phpECard 2.0. You should read      *
 *  all information in this document carefull before you use this script.  *
 *                                                                         *
 ***************************************************************************
  PLEASE REGISTER AT THE FORUM FOR SUPORT: http://www.quick-xs.net/phpecard


	!!  IF YOU ARE WILLING TO TRANSLATE THIS SCRIPT TO GERMAN  !!
	!!	  PLEASE CONTACT: phpecard@quick-xs.net		   !!



  TABLE OF CONTENTS
  =========================================================================
	1. Release notes
	2. Inslallation 
	3. First use
	4. Configuration information



  1. RELEASE NOTES
  =========================================================================
	'phpECard' is a script with wich you can set up your own personal
	e-card gallery. To do so you must follow the installation-guide
	and read the configuration-info to learn how to make your own 
	pictures compatible with 'phpECard'. 
	I hope you enjoy this script! Maybe you are able to modify this
	script with cool features? 
	Please post them at: http://quick-xs.net/phpecard 

	IMPORTANT: change settings in '../phpECard/config.php'!

	IN ORDER TO SUPORT THE SCRIPT USAGE AND GENERATE MORE USERS WHO
	CAN SHARE KNOWLEDGE. PLEASE DO NOT REMOVE LINKS TO THE SCRIPTS
	SOURCE FROM THE SCRIPT!!!



  2. INSTALLATION
  =========================================================================
      - You can only use this script on a host that suports php and have
	permision to read, write and execute files on the server.
	
      - You can extract all files from the 'phpECard_V2.zip' file to a
	random folder with WinZip. 
	After extracting you will see a folder named: 'phpECard' at the 
	specified location. Upload this complete folder to your webserver 
	on any location you please.

	IMPORTANT: Upload images in binary mode!

      - This is an overview of the directory 'phpECard', after uploading:
		phpECard/_gallery.php	
		phpECard/config.php
		phpECard/functions.php
		phpECard/index.php
		phpECard/lang_dutch.php
		phpECard/lang_english.php
		phpECard/template.php
		phpECard/images/001.jpg
		phpECard/images/002.jpg
		phpECard/images/003.jpg
		phpECard/images/004.jpg
		phpECard/images/005.jpg
		phpECard/images/006.jpg
		phpECard/images/paper.jpg
		phpECard/images/phpecard.php
		phpECard/images/thumb/001.jpg
		phpECard/images/thumb/002.jpg
		phpECard/images/thumb/003.jpg
		phpECard/images/thumb/004.jpg
		phpECard/images/thumb/005.jpg
		phpECard/images/thumb/006.jpg
		phpECard/userdata/preview_dutch.php
		phpECard/userdata/preview_english.php

      - MAKE SURE that your server allows file-writing in the directory; 
	'userdata'. You chould set the chmod of this dir to 777.

      - It is posible to rename the folder; 'phpECard' to whaterver name
	you like. This will NOT EFFECT the scripts functions! :o)

      - You can use the script directly on the location by calling up; 
	"../phpECard/index.php" in your browser. Or you can use the script
	by including it anywhere into a random php-document. In that case
	you must use the following command:

	    <!---   phpECard 2.0 include starts here   --->
		<?php
		$include_path = 'phpECard/'; // set the path
		include($include_path.'index.php');
		?>
	    <!---   phpECard 2.0 include starts here   --->

	The include_path-variable is used in parsing all functions so must
	be correct!

      - Before you start using the script you must edit some settings in
	'../phpECard/config.php'. Make sure these settings are correct!



  3. FIRST USE
  =========================================================================
      - Ofcourse you should test weither the script works well before you
	let your site's visitors to it. You might recieve some errors
	when the script has no rights to file-read or -write on your 
	server. In that case you should chech the weither the chmod is 777
	or contact you hosting-provider to ask them about the php-settings
	on the function; 'fwrite()'. 

      - If you want any kind of suport during your usage of phpECard:
	Please post it at the forum: http://quick-xs.net/phpecard 



  4. CONFIGURATION INFORMATION
  =========================================================================
      - To edit basic style-configuration, you must set the style-values
	in '../phpECard/config.php'. You can also choose to set the 
	location of your website's stylesheet.

      - To expand and personalyze your image-gallery you should resize
	the images you are going to use to the width of 365 pixels.
	The default width of the thumbnails is 150 pixels.
	
	Upload your sized pictures in binary mode to the folder 'images'
	and upload the thumbs to the folder 'thumbs'.
	
      - The output-body can be edited in '_gallery.php'.
	In fact you can use any name for the pics, as long as it comes back
	in the links to the compose-body are like so (set; 'default_name'):
		
	<a 
	href="'.makelink('image-name').'">
	<img src="'.$include_path.'images/thumb/image-name.jpg" border="1">
	</a>
	
	or
	
	<a href="'.makelink('image-name').'">image-name</a>

      - If you want any kind of suport during your usage of phpECard:
	Please post it at the forum: http://quick-xs.net/phpecard 
	
	
 
 ***************************************************************************
                                    END








