 |
|
Please read the following installation instructions carefully:
|
• A server running PHP v4.3 or higher. Some of the syntax will NOT work on earlier versions.
• Javascript enabled browser.
• A MySQL database to hold the script tables.
• GD2 Library support for auto thumbnail creation. To find out how to check if you have this installed, see the F.A.Q page.
• .htaccess support. This is only required if you wish to use the mod_rewrite option.
|
1 => Create a database to hold the script tables. If you are unsure of this procedure contact your web hosting company.
2 => Open up the 'inc/db_connection.inc.php' file in a text editor and edit it to point to the database you just created. DO NOT comment out the prefix function. If you don`t need to change it leave it as it is.
3 => Again in your text editor, open up the 'admin/inc/password.inc.php' file and choose a username and password for your admin area.
4 => Upload all the files/folders into a directory on your web server. Example: /ecards/
5 => Chmod the following folders to 777 to make them world writeable. (If your server accepts 755, then you should choose this as its known to be more secure):
/images/ecards/
/images/ecards/fullsize/
/images/ecards/thumbs/
/images/emoticons/
/images/icons/
/images/uploads/
/log/
/music/
/templates/
/templates/email/
/admin/backup/ |
6 => Access the '/install/index.php' file in your browser and follow the set up instructions to complete installation. Once setup is complete, delete the install dir.
7 => If the setup was successful log in to your admin area and select 'Options/Settings' from the top menu. Update the settings to your own preferences.
| http://www.yoursite.com/ecards/admin/index.php?cmd=login |
8 => Update all the e-mail templates to include your own web URL and information. Update any other templates that you want to change the appearance of.
9 => Thats it, all done. For script usage see below.
SECURITY NOTE: For extra security you should rename your 'admin' folder to something unique!!
|
If the auto install has aborted, this is no problem, follow these instructions:
1 => Access your database using your MySQL admin program. PHPMYADMIN?. Click on the database you created for this script and delete any tables that have been created by this script. If you only have 1 database, be careful not to delete any other important tables.
2 => IMPORTANT!: The .sql file in the script has the prefix of 'mgr_' before the table names. If you have specified a different prefix in the connection file then you need to change the prefix for the table names in the 'docs/schematic/tables.sql' file BEFORE you run it.
3 => When you are ready browse for and run the 'docs/schematic/tables.sql' file to set up the script tables.
4 => Log in to your admin area and select 'Options/Settings' from the top menu. Update the settings to your own preferences.
| http://www.yoursite.com/ecards/admin/index.php?cmd=login |
5 => Update all the e-mail templates to include your own web URL and information. Update any other templates that you want to change the appearance of.
6 => Thats it, all done. For script usage see below.
|
1 => To begin, you need to create some top level categories. Do this by selectings E-Cards/Categories from the top menu.
2 => If you want to, you can add sub categories to the top level categories. These are optional. For example, you may have a category called 'Transport' and sub categories named 'Cars', 'Trains' & 'Aeroplanes' etc. Add sub categories by selecting E-Cards/Sub Categories from the top menu.
3 => Once you have some categories in place, you need to add some images to the system. Images can be batch added to save time. If you have the auto thumbnail creation function checked and the GD Library installed, the thumbnails will be created for you. If you don`t or are unsure of this,
it is advised that you create and upload the thumbnails manually.
4 => To batch add images, first you must upload your images into the '/images/ecards/' directory. When the system batch adds the images, it renames the files and moves them into the '/images/ecards/fullsize/' & '/images/ecards/thumbs/' directories respectively.
5 => A report will be seen once you have added your images. Any problems will be shown on screen.
6 => Once you have batch added some images, you can view these in your e-card system. Assuming your system is in a directory called 'ecards', use the following URL:
| http://www.yoursite.com/ecards/index.php |
8 => Once you have some images created, set up a test account to check that all features are functioning correctly. Or, if you have the guest option enabled, run a test without sign up.
9 => Manage your members in your admin area.
| http://www.yoursite.com/ecards/admin/index.php?cmd=login |
10 => Enjoy
SECURITY NOTE: For extra security you should rename your 'admin' folder to something unique!!
|
You can edit the templates manually in a text editor and re-upload, or in your admin area.
It is important that the data between <?php ?> tags remains in place or else the template may fail.
Advanced users will know which variables are not so important.
The e-mail templates are similar but contain program variables between braces. ie: {NAME}
Again, be careful when editing not to remove these variables.
PHP & HTML paths are shown in the e-mail templates. Delete depending on your MOD_REWRITE preference.
|
If you have a Paypal business/premier account you can use their IPN (Instant Payment Notification) system to process payments and charge members for sending e-cards. CURL MUST be installed on your server for this to work. The first thing you need to do is activate the IPN system if you haven`t already done so.
1 => If you are using the IPN system with another script, the IPN system will already be active. This script will not affect any other scripts using the system or your E-Bay account.
2 => Log in to your Paypal business account at http://www.paypal.com.
3 => Select 'Profile' from the top menu and then click 'Instant Payment Notification Preferences'. Then click the 'Edit' button.
4 => Before you enable the IPN system click the 'read the instructions' link on the Paypal website to make sure your server supports the IPN system.
5 => Check the box to enable the IPN system and in the URL box enter the following URL:
| http://www.yoursite.com/greetings/index.php?cmd=notify |
6 => Make sure the URL is correct. The IPN needs a default URL to send the data to. If you already have a URL in place, don`t worry, leave it as it is, it should still work ok as the URL of this script is sent to the Paypal website. Then click 'Save'.
7 => The IPN system is now enabled.
8 => If you want to log error responses from the Paypal website, activate logging in your admin area. The log entries will be visible in the 'log/paypal_errors.txt' text file. It is recommended you do activate logging to analyze any problems that may appear. |
The really great thing about the IPN system is you can test it out to make sure it works without the worry of actually processing any payment. For this unique option you need to have a Sandbox account. This is free to web developers and can be found here:
There are support forums for you to get help with the IPN system if you are experiencing problems. Once you have a Sandbox account set up you can enable this to test the script out.
To enable the IPN system in the script go to your admin area and select 'Options/Paypal IPN' from the drop down menu.
|
Hopefully this installation guide has helped you get the script up and running. Check out the F.A.Q page for some solutions to common problems.
If you require any help at all, please post on the support forums. Thank you.
|
|
|