Dynamic Home Page Generator 
V3.0 for WC5!
Copyright(c) 1998, Amit Dembsky & Architech Design Group
All rights reserved

29 November 1997

DISCLAIMER:

THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" 
WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT 
NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH THE 
CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR DIRECT, INDIRECT,
 SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF, 
INABILITY TO USE OR BREACH OF ANY WARRANTY.

COPYRIGHT:

This program is copyrighted under US law and international treaty 
provisions.  You agree that your use of this program is subject to 
these laws, which prohibit unauthorized copying or duplication of 
this program software, documentation, and other materials.
This program may not be decompiled or reverse engineered for any 
reason.

1. What is it?

- Dynamic  HomePage Generator  is a wcCode version 5.0+ program that 
will create HTML homepages for your users. A user simply fills up an 
HTML form, and voila  - a professional HomePage is created for him on 
the fly.

- Dynamic HomePage Generator uses DHTML (Dynamic HTML) the 
state-of-the-art technology to create personal homepages to your users 
on the fly.
Novices and experts alike can set up their own homepage on your server 
within 2-5 minutes.

- Each HomePage has a "HIT" counter, backgrounds graphics or color and 
up to two additional images. The user can choose from a library of 
graphics file and Background colors, or optionally he/she can upload 
the files DIRECTLY to his/her homepage.

- A HTML page that lists all the HomePages sorted alphabetically is 
generated on the fly.

- An optional Log file that logs any creation of a new homepage.

- Up to 3 security profiles can be denied. 

- Optional Header and Footer HTML files to dress up the dynamically 
generated pages

- Easy to setup for Novice Sysops/Webmasters

2. Configuration File:

This program is totally configurable by the SYSOP through the 
HOMEPAGE.CFG file.  This is a simple text file that the SYSOP can 
edit to suit his system.  
Please open the cfg file in notepad or any other ASCI text editor and 
modify it - instruction can be found in that file

3. File in this Archive:
1. Html-Homepage2.wcx  the actual program
2. Homepage.cfg - configuration file
3. *.gif - optional graphics you can use for background selections 
(collected by me from the Internet)
4. *.htm - optional Header and Footer files for the Homepage.htm - 
the homepage list.
Using this example, you can create header and footer files for the 
DHPG itself.
 

4. Installation:

1. Copy all the *.wcx and *.cfg files to your wildcat directory 
(make sure that the long file names are intact in the unzipping 
process).
2. Edit homepage.cfg as required. Make sure to create the directory 
per line #2 - let's call it users dir, copy all the rest of the 
Archive to this directory.
3. Create a menu item for userupload.wcx anywhere in your menu tree -
 Make sure to enable the security profiles you want to have upload 
rights.
4. You can have Header and Footer Html files for both the DHPG 
(Dynamic Home Page Generator) and the page that lists the Users which 
created Homepages:
 A. hphead.htm and hpfoot.htm for the list page.
 B. hpchead.htm and hpcfoot.htm for the DHPG. 
 Put those optional files in the user dir.
 Think about those files as the 2 pieces of bread in a sandwich and 
the DHTML as the pastrami. That means that you don't put closing tags 
such as </BODY> and </HTML> in the bottom of a header file, or opening 
tags  <BODY> and <HTML> in a footer file.
 If you decide not to use a header file for the HPC, you can define a 
background graphics in the cfg file (line #4)
5. Create a link <A HREF="/code/html-homepage2"> Create your 
Home Page </A>  
6. Put all the predefined graphic files in the \user dir - 
use gif files only and make sure to define the # of background files 
in the cfg file - default is 6 files (please use light backgrounds)
7. Few files and directories will be created 
(once the first user creates a Homepage):
A. A user directory off the users dir, with the name of username. 
If username has 2 words, it will be firstname.lastname 
(In my system I am using Aliases)
B. A *.ctr file for each user in the /data dir - 
this is a counter file for page hits.
C. Homepage.htm in the users dir (line #2 in the cfg file)- 
this one lists the users homepages. 
(hphead and hpfoot, if exists,  will be appended to it)
D. hpusers.srt - a sorted list of all the users that created a 
homepage. (in the users dir)
E. A log file - optional if you defined it in the cfg file - 
by default it's enabled and named homepage.log

5. Frequently Asked Questions: 

Q: After running DHPG for a while I decided to add the Header/footer 
files. Although I did it, I can not see any change in the Homepage.htm.
A: No changes will be generated until another user creates his/hers 
homepage. 
The program will generate a change ONLY when there is a change in the 
Homepages status.

Q: One of my users asked me to remove his Homepage, how do I do that?
A: Delete his directory (wc5:\http\public\users\username). Open 
wc5:\http\public\users\hpusers.srt in notepad and delete the line that 
holds this user name. The hpusers.srt is the sorted lists of the 
homepages, and it is used in the homepage.htm.

Q: One of my users asked me to replace his graphics with new ones, 
how do I do that?
A: Actually, the only thing he needs to do is upload the new graphics 
using the same name as the old ones 
(this will overwrite the existing graphics)


6. How to contact me:  

Current E-Mail address is amitd@ix.netcom.com
You can get the latest versions at:
http://pw2.netcom.com/~amitd


7. Registration:

DYNAMIC HOMEPAGE GENERATOR shareware's version is limited to 5 users - 
Only 5 users will be able to create a HomePage using this app.
The registered version does not have this limitation.
Please read the included Register.doc file for information on 
registering.

8. What's new ?:

Version 3.0
Read the readme.1st

Version 2.7
PLEASE READ CAREFULLY
IMPORTANT for current users.
================================

1. Many changes were introduce to the structure of Homepage.cfg in 
version 2.7.
Please read the instructions in the attached homepage.cfg carefully 
and change per your system configuration.

2. The sorted list of homepages was improved:
A. It is shown in a table form.
You HAVE to modify hphead.htm to show the table correctly 
(and per your liking)
Add the table tag after the last line, for example add:
<table border=0 bgcolor=pink>
B. You can have a bullet instead of the sorting numbers by having a 
file called home.gif in the "Users" directory. 
(I included a sample in the archive)
 
3. Many of you asked to have your system as the default link instead 
of a link to my site.
Please read the homepage.cfg file and modify lines 14,15.
***
Remember - If you do any change in the config file or one of the app 
files and you can not see any change - RE Submit your own home page 
(No changes required) and the app will do the required changes.
Since it is DHTML it will not change anything unless someone submitted
a page, only at that time changes will be made.

1. Added option for user to add header and title to the home page.
2. The title will be used also as a description of the homepage in the 
sorted list of homepages.
3. Better formatting to the java script Dialog Box
4. If a file called "home.gif" exists in the /public/users directory, 
it will serve as a bullet insted of the number before the homepage name
 and title (in the sorted homepages list)
5. You can have you system as the default favorite link instead of the 
current Iconet.net


Version 2.5
1. Only one wcx is required - (html-homepage2.wcx)
You can delete the html-homepage-post2.wcx
2. Will work with Html-Upload and Without it - Will show the menu 
options only if it finds Html-userupload in the wc5 directory.
3. Added a link to HTML tutorial.
4. Added a Footer text option
5. Added the Meta tag - users can enter up to ten keywords or phrases 
that you would like the Internet search engines to relate to.
6. Will show the users their HomePage path once submitted.
7. Homepage BGcolor defaults to White.
8. Added version number to the "About" MsgBox.

Version 2.2x
1. Fix - The footer option is working now.
2. Fix - Email yes/No is working now.
3. Fix - Email and Hit Counter options are saved now between sessions.
4. Fix - Marital Staus option is saved now from between sessions.
5. hpfoot.htm - edited to point to /code/html-homepage2 
(was /code/html-homepage)
6. New - Full Name and Middle Initial are supported now
7. Fixed some minor cosmetic issues. 


Version 2.0
A.Information is saved now to a database that means that when you 
edit your homepage, all the info from previous session is there.
B.Added selection for Text, Links and Visited Links colors
C.Added selection for Hit Counter Yes/No
D.Enhanced look and feel.
E.Fixed some typos 