README AND INSTALL FILE ----------------------------------------------------------------------- for PageMod v1.4 These install directions assume that you have access to the SHELL prompt of your server, either via ssh or telnet. If you don't have that access, you'll have to unzip the files on your desktop and upload each directory by hand. The critical issue is that certain directories and files must be 'world writeable' so that the web server can write to them. For a list of those directories, consult the section below -- File And Directory Permissions. 1. Unzip the distribution file (pagemod.tar.gz) in your web server's *home* directory (not your web document root) (Your home directory is *above* your web document root.) by typing: gunzip pagemod.tar.gz pagemod.tar.gz contains two .tar files and one readme file: - pagemod_non_web.tar - pagemod_web.tar - readme.pagemod.install 2. Again, in your *home* directory, 'untar' the file 'pagemod_non_web.tar (the *non_web* file) by typing: tar xvpf pagemod_non_web.tar This will create the 'pagemod' directory where the primary script files will be installed. 3. Copy the file 'pagemod_web.tar' to your 'web document root', typically 'www' or 'html' (where your top index.html page is) by typing: cp pagemod_web.tar ./www (or ./your_web_document_root_name) then change to that directory by typing: cd ./www and then type: 'tar xvpf pagemod_web.tar' This will create a 'pm' directory where your generated pages and images will be stored. 4. Edit the file 'index.cgi' in the pm/standard directory and change the path names for the following variables (shown here with fake dirs): - $preferences_dir = '/your.home.directory/pagemod'; - $web_doc_root = '/your.home.directory/www'; (where the 'www' is the name of your web document root) (substitute the correct name) 5. Your login url will be http://yourdomain.com/pm/standard The default username is 'admin'. The default password is 'admin2000'. (Change them!) The password file is: pagemod/users/standard/.pagemod.cnf 6. Once you login at the standard url, you'll see the regular user menu *plus* the 'admin' menu, which you can use to create other users. NOTE! If you want to turn OFF the admin menu, (for example in a 'simple installation') then edit the pagemod_site.pl file and change the variable $show_admin_menu to 'no'. NOTE! The file pm/standard/index.cgi also has 3 variables that control menu display: - $show_modify_structure = 'no'; - $show_regenerate_pages = 'no'; - $show_select_templates = 'no'; If they're set to 'no' then the respective menus will only show in the admin menu. Otherwise, they'll display in the normal users menu if they're set to 'yes'. However, if they're set to 'no' and you also have $show_admin_menu set to 'no', then they won't show up at all. 7. Consult the documentation! 8. You're done. ----------------------------------------------------------------------- FILE AND DIRECTORY PERMISSIONS (for manual installs) Certain files and directories must be set to be 'world writeable', that is '777' (rwx-rwx-rwx) for directories and '666' (rw--rw--rw) for files or '755' (rwx-r-x-r-x) for some 'executable' files. This is so the web server can 'write' to the files and directories. DIRECTORIES Set to drwxrwxrwx (777) In Your Home Directory: - DIR (777): pagemod/users - DIR (777): pagemod/users/standard - DIR (777): pagemod/users/standard/backup - DIR (777): pagemod/users/standard/page_templates - DIR (777): pagemod/users/standard/sessions - DIR (777): pagemod/shared_templates/basic - DIR (777): pagemod/shared_templates/special In Your Web Document Root Directory: - DIR (777): pm - DIR (777): pm/standard/pages - DIR (777): pm/standard/pages/images FILES Set to -rwxr-xr-x (755) (Executable) In Your Home Directory: - FILE (755): pagemod/bin/libformat.so - FILE (755): pagemod/bin/nconvert In Your Web Document Root Directory: - FILE (755): pm/standard/index.cgi FILES Set to -rw-rw-rw- (666) In Your Home Directory: - FILE (666): pagemod/users/standard/pagemod.data.pl - FILE (666): pagemod/users/standard/page_template_dir.pl Note: ALL TEMPLATE FILES must be set to 666. (The files here are default installation files.) - FILE (666): pagemod/users/standard/page_templates/index.main.template.html - FILE (666): pagemod/users/standard/page_templates/index.popup_text.template.html - FILE (666): pagemod/users/standard/page_templates/news.whats_new.template.html - FILE (666): pagemod/shared_templates/basic/index.main.template.html - FILE (666): pagemod/shared_templates/basic/index.popup_text.template.html - FILE (666): pagemod/shared_templates/basic/news.whats_new.template.html - FILE (666): pagemod/shared_templates/special/index.main.template.html - FILE (666): pagemod/shared_templates/special/index.popup_text.template.html - FILE (666): pagemod/shared_templates/special/news.whats_new.template.html In Your Web Document Root Directory: Note: Strictly speaking, the PAGES files don't have to be set to 666, since they're generated by the web server. However, if YOU upload them, you have to set them to 666 so that the server can write to them. (The files here are default installation files.) - FILE (666): pm/standard/pages/index.html - FILE (666): pm/standard/pages/index.popup_text.html - FILE (666): pm/standard/pages/news.whats_new.html - FILE (666): pm/standard/pages/images/index.main.1.courting.jpg - FILE (666): pm/standard/pages/images/index.main.2.true_love.jpg - FILE (666): pm/standard/pages/images/tn_index.main.1.courting.jpg - FILE (666): pm/standard/pages/images/tn_index.main.2.true_love.jpg ----------------------------------------------------------------------- SETUP FILES Please look at the file 'pagemod/pagemod_site.pl' for setup variables and definitions. Each variable has notes next to it, explaining its purpose. Generally speaking, you don't have to edit anything. These are 'global' variables that will be used by all installed users within that pagemod tree. The mandatory 'setup file' is the 'index.cgi' file in the pm/standard directory. Variables in this file allow you to change the behavior of the program for each user in the pagemod tree. ----------------------------------------------------------------------- LOGGING IN The program requires a username and password, which is stored in the file called '.pagemod.cnf'. You may change the username and password by editing that file. NOTE: *MANY* FTP programs do NOT display filenames that begin with a dot (.) unless you request it. This is for security. You may have to set an option on your ftp program to display 'hidden' files. Once you log in, your password is encrypted and half of it is stored in the 'sessions' directory. The other half is encrypted and stored in a hidden field called a session id, in your web browsers screen. The encryption method is a handrolled XOR encryption. See the file http: //worldcommunity.com/opensource/futuresql/security.txt for details on this method. -----------------------------------------------------------------------