###########################################
# EMPOWER 2001 - Technical Manual vs 1.4: #
###########################################


** SUPPORT IS AVAILABLE FOR $85 USD PER HOUR FOR THIS PROGRAM!


** EMPOWER 2001 will NOT work with PHP version 3, only PHP version 4.x, 
** EMPOWER 2001 has not been tested on Windows machines--no begging, please! 



****************************************************************

Program Contents:
=================
1.  demo.html
2.  index.php 
3.  README.txt (this file)
4.  /images/ [directory]
5.   - spacer.gif [images directory]
6.  /includes/ [directory]
7.	  - config.inc.php [includes directory]
8.   - shared.lib.php [includes directory]
9.  /templates/ [directory]
10.  - login.temp.php [templates directory]
11.  - main.tem.php [templates directory]

****************************************************************

Overview:

** Usage of this program accepts that you have read and agree to the 
license (bottom of this page) that comes with this program. Usage of this 
program also assumes you have limited experience with PHP and that 
you have PHP installed on your server. If this is not correct, please
contact your system administrator for proper installation or further 
help. This program allows you to EMPOWER your clients, by allowing 
them to make text changes to their own web pages - without changing 
the design or HTML you've worked so hard to create.

The procedure is simple:

1. Open the "includes/config.inc.php" file with your favorite text editor 
	(Notepad, Textpad, Pro-HTML, Coffee Cup, etc.).

2. Make adjustments to the following settings as needed:

3. Set ROOT for EMPOWER 2001 to access. This is the path-to-base directory
	where EMPOWER 2001 is located.

4. Set PATH for EMPOWER 2001 to access. This is the path-to-base directory
	where EMPOWER 2001 will operate. NOTE: If you put EMPOWER 2001 in your
	"root" directory, the ROOT and PATH settings will be the same.

5. Set PREVIEW for EMPOWER 2001 to view via http. This is the url to access
	the ROOT setting for where EMPOWER 2001 is located.

6. Set URL for EMPOWER 2001. This is the location to where EMPOWER 2001 is
	located via http. NOTE: If you put EMPOWER 2001 in your "root" directory,
	the PREVIEW and URL settings will be the same.

7. Set DIR_IGNORE, directories to ignore: Create a list of each directory
	you would like EMPOWER 2001 to ignore and put each one in quotes and 
   separate them with a comma ("directory1", "directory2", "directory3")
 
8. Set AUTH, USER, PASS for basic authentication. If you are using more 
	secure authentication, such as htaccess, or you don't need password 
	protection, set AUTH to 0. Define the USER and PASS here, if you 
	wish control of access of this program.

9. Set META for EMPOWER 2001. To allow meta tag(s) editing set to 1,
	to disable change to 0; default is 1. 

10 Set TITLE for EMPOWER 2001. To allow page title editing set to 1,
	to disable change to 0; default is 1. 

11 Set CONVERT for EMPOWER 2001. To convert line breaks ("\n") to
	line breaks ("<br>") set to 1, to disable change to 0; default is 1. 

12 Set HTML for EMPOWER 2001. To allow HTML tags, set to 1, to disable
	change to 0; default is 1.

13 Set EMAIL for EMPOWER 2001. For error reporting, set to your email
	address to report errors.

14 Set REPORT for EMPOWER 2001. To turn off EMPOWER 2001 errors from
	appearing in your email inbox set to 0; default is 1;

15 Save .php file in any directory of the client's web site.

16 Change file permissions to chmod 644.
   (If you are using an FTP program, you may right click on a file and 
   choose option "chmod (UNIX)".) Then check the read, write and 
   execute boxes as follows:    
   owner   group   other
     x       x       x
     x       .       . 
     .       .       .

Now open each client web page in question (again using your Text 
Editor), and insert the following comments before and after each 
segment of the page which you wish to EMPOWER for your client:

		BEFORE:	<!-- EMPOWER -->

		text, including HTML code HERE ... 

		AFTER:  <!-- END_EMPOWER -->

(Note: To save time, you may want to program the keystrokes for 
these two comments into your text editor; they are the only code
you need for this procedure.)

Test a few pages to make sure everything is working correctly and 
that's all there is to it ... Your pages are now EMPOWERED, and 
ready to deliver to the client!


**
If you feel this program has been useful or to make suggestions,
please send an email to: empower2001@digisoft77.com.
**


#################################
# End User Instructions vs 1.1: #
#################################

Summary:

This program allows you to access your web pages, to make text-edits
or other simple changes, without having to go back to your web 
designer each time. The pages of your site are designed to allow 
access only to these less complicated areas. 

You may change the text that will appear in the text boxes as you 
wish, and then save each page when you are finished. [Don't worry; 
you can't "break" anything; the page-programming code and format
will NOT be disturbed.]


Step-by-Step:

 
1. Go to the Empower 2001 page on your web site.

2. Log-In with the designated username and password.

3. Click the arrow on the right hand drop-down menu at the top of
   the page. You should see a list of the files in the root directory
   of your web site. 

4. If the file you wish to edit is shown, click on that file to
   highlight it. Proceed to Step 6. 

5. If the file is NOT listed, click the arrow on the left hand 
   drop-down menu, and highlight the sub-directory which contains the
   file you want to edit. Click [open dir] to open that subdirectory. 
   If the sub-directory is within another sub-directory, repeat step
   this step. Then return to the right hand menu and highlight 
   your file. 

6. Click [open file] to the right of the menu to open the file for
   editing. 

7. You should now see a series of text boxes, containing the 
   text-copy from your web page. You may now make changes as you wish.

8. When you are finished editing the page, click on the 
   [Save Changes!] button at the bottom of the page. 

9. If you're happy with how the page now looks... you're done! If not,
   RELOAD THE PAGE and edit some more.

10 Repeat Steps 3 through 10 for any other pages you wish to edit.


###########
# LICENSE #
###########

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation. This program is distributed in the 
hope that it will be useful, but WITHOUT ANY WARRANTY; without even 
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
PURPOSE.  For more details, see the GNU General Public License.
<http://www.opensource.org/gpl-license.html>

If you are a web designer/developer you MAY distribute
this program to your clients at will. However, you may NOT sell the
source code to anyone! This is a value-added program 
that you can give to your clients. You will also not hold us,
digiSoft 77, liable for any damages or alterations that may arise 
from giving your clients access to edit their own web site(s) or from
using this program. Instructions are provided in this file and 
everything is well documented.

  Requirements: 
    UNIX/LINUX server
    PHP4 (NOT PHP3)
    A web browser

  Installation:
    Please see the Technical Manual & End User Instructions at the 
    top of this page.
    
  Documentation:
    Documentation for installation and the end user's manual
    are available at the top of this file.
    
#######
# FAQ #
#######

Q: Is EMPOWER 2001 available for Win 32?
A: NOPE!

Q: Does EMPOWER 2001 work with PHP3?
A: NO! Upgrade to PHP4 or have your network administrator upgrade
   to PHP4 (http://www.php.net)

Q: I get a "permissions denied" message, what's wrong?
A: Be sure your file permissions are set to allow read and 
   write capabilities (chmod 644?) 
   See #13 of the technical manual [above]
   
Q: No text is showing up in the text boxes, what's wrong?
A: Be sure to place the empower tags in the pages you want your 
   client to edit. This will tell the program what is editable and 
   what is not. You may place as many of these tags on any one page.
   MAKE SURE YOU PUT THE TAGS ON SEPERATE, NEW LINES:
   
   <!-- EMPOWER -->
   your editable text or HTML here...
   <!-- END_EMPOWER --> 

Q: The text boxes aren't pulling the text out correctly, 
	what's wrong? 
A: Make sure that you do NOT have other comments mixed in with the 
	EMPOWER tags, also double check the spelling of the tags and 
	make sure you have an even number of opening and closing tags! 

Q: None of the drop down menu's are reading the files and directories.
A: Make sure the ROOT variable path is correct in the config.inc.php file.
   Also, EMPOWER 2001 will only display files in the drop down menu
   that have the correct <!-- EMPOWER --> "tags". They must also have
   an even number of tags, this is to minimize errors when re-creating
   files.


##################################################################