
// --------------------------------------------------------------------------
//
// INDEXU(tm) v.3.0.4
// Copyright(C), Sentraweb, 2001, All Rights Reserved.
//
// INDEXU(tm) is protected by Indonesia and International copyright laws.
// Unauthorized use or distribution of INDEXU(tm) is strictly prohibited,
// violators will be prosecuted. To obtain a license for using INDEXU(tm), 
// please register at INDEXU home page at indexu.com
//
// Author: Dody Rachmat Wicaksono (dody@sentraweb.com) 
//
// 1-April-2002
//
// --------------------------------------------------------------------------



*** Please refer to INDEXU User Guide detail information ***


Table of Content
-----------------------------------------
I.    Introduction
II.   What's New in version 3
III.  Installation
IV.   Upgrading from version 3.0.x
V.    Upgrading from version 2.0
VI.   How to add new theme set
VII.  How to translate into other language
VIII. Changes from v.3.0.3
IX.   Changes from v.3.0.2


---------------
I. Introduction
---------------

INDEXU is an easy-to-use program that will help you manage
your portal website. INDEXU comes with plenty of features that
will make your work easier to maintain your portal, both back-end
such as creating category and validating a new submission, and
front-end user interaction, such as web design, search, and new
links.

INDEXU is built with high performance and scalable technology:
PHP and MySQL; does not matter how large your database, it is
10,000 rows or 100,000 rows, INDEXU surely capable to
manage it and even run very smoothly without dropping its
performance significantly.

INDEXU is also designed to be the portal solution that maintains
your portal automatically. Thus, this great advantage will give
you more time to concentrate on the other things, like promoting
your website.



---------------------------
II. What's New in version 3
---------------------------

 Membership management with user's preference
 News grabber from other news website
 Multiple theme set
 Registered user review
 IP blocking to protect from cheating rating
 Favorites folder, allow your visitor to add their favorite listing
  and share with others
 New listing style New Links, Hot Links, Top Rated Links, and Editor's Pick 
 Category permission, allow you to set permission each category
 Hidden category, you can make some categories invisible 
 Check category structure and view category's hierarchy
 Multiple editor for content management, you can assign users to be an editor
  to help you maintain your website
 Search log now record IP address and number of result  
 Better mailing list management, you can create message, keep old message,
  and manage subscribers
 New Image field type, allow webmaster to upload image



-----------------
III. Installation
-----------------

1. Unzip the distribution file in your local PC to
   a new directory. You can use your own preferable program
   like WinZip.

2. Upload all files to your server except files in recovery_tools folder. 
   You can use your preferable ftp client such as WS_FTP or CuteFTP.
   
   Note: 
   
         Folder structure:
         
         main                     : public program files
           |
           +--admin               : admin cp program files
           |
           +--admin_tpl           : admin cp template files
           |    |
           |    +--images
           |    |    |
           |    |    +--review
           |    |
           |    +--mail           : admin email template files
           |
           +--cp                  : user and editor cp program files
           |
           +--images
           |
           +--lib                 : library files
           |    |
           |    +--adodb
           |
           +--recovery_tools      : recovery tools (do not upload it if it's not necessary)
           |
           +--themes              : theme files (CHMOD to 777)
           |    |
           |    +--default
           |         |
           |         +--cp
           |         |
           |         +--images
           |         |    |
           |         |    +--rating
           |         |    |
           |         |    +--review
           |         |
           |         +--mail
           |
           +--upload_files        : upload files by users (CHMOD to 777)
           
          
        
         recovery_tools folder contain recovery tools that help you
         when you encounter database problem. 
         You may run them directly by pointing your browser to those files.
         
         Those tools are:
         - create_admin_user.php 
           Create admin user, in case you lost your admin password you may need 
           to run this file to create new admin password
         - restore_db.php
           Restore database from backup file. In case your database is corrupt or
           moving to other database, you may run this file. Make sure your new
           database are empty.
   
3. Do a CHMOD on the following files and folder

   - application.php                                   CHMOD 666
   - all files in themes folder and its sub folder     CHMOD 777
   - upload_files folder                               CHMOD 777

   If you are using CuteFTP, right click on application.php file in remote file. 
   Then click change attributes. If your server using Windows OS, simply skip this step.
   
   If you are using telnet:
   $ chmod 666 application.php
   $ chmod 777 -R themes         (do recursive to its sub folder)
   $ chmod 777 upload_files

4. Open you web browser then run install.php on your
   browser (eg.: http://www.yourdomain.com/install.php).
      
5. Go to the INDEXU administrator control panel
   (eg.: http://www.yourdomain.com/admin/). Enter administrator
   username and password:
   username : admin
   password : admin
   
7. Its all done. Now you can start creating categories and
   adding links. If you have seen and sure that everything goes
   well, dont forget to delete install.php. If you forget to
   delete it, its possible for someone else to try hacking into
   your administrator area. So, please dont forget to delete
   install.php to make sure that your system is secure.   

   
   
-------------------------------
V. Upgrading from version 3.0.x
-------------------------------

Upload these files:
/*.php      (except application.php)
/lib/link.class.php
/lib/category.class.php
/lib/pagination.class.php
/lib/users.class.php
/admin/cat_view_hierarchy.php

The following template files has been changed:
/themes/default/rows.html
/themes/default/*_rows.html
/themes/default/detail.html
/themes/default/images/rating/*.gif



------------------------------
V. Upgrading from version 2.0
------------------------------

We highly recomend you to make backup of your files and database
before upgrading. And also make sure there's no pending link in
admin cp. The pending links won't be converted. If it's not empty,
you should approve/reject them first.
  
Upload Indexu v 3.0.2 files, and chmod necessary files as shown above.
Then point your browser to install.php.
Fill the database information the same with that you're using in Indexu v 2.0
Indexu will creating new tables, altering tables, and drop tables.
Indexu also creating new administrator user:
username: admin
password: admin

Beware, this upgrade procedure will rewrite your existing template file.
Many v.2 template files do not compatible v.3. You need to rewrite the
template files.



---------------------------
VI. How to add new theme set
---------------------------

You can add new theme set simply by adding new folder in theme folder.
For example you have created theme called 'mytheme'.
You should make new folder /theme/mytheme   
   


----------------------------------------  
VII. How to translate into other language
----------------------------------------

Translating indexu into other language are easy. It does not require any
php knowledge, although it would useful if you have some html and php knowledge. 
Just translate the template files in theme folder. Those files
are generic HTML files with some indexu's variables inside. 

msg.php file contain message files that is used by indexu. It's a php script
file that only contain array variables. Please be careful when modifying
this file, specially with double quote characters (").



--------------------------  
VIII. Changes from v.3.0.3
--------------------------

Bugs fixed:
 
- Fix modify link: reviews and avg_reviews deleted
- Fix modify link: uploaded img disappear/deleted
- Fix search result: next page error
- Fix search result: trim white space character
- Do update number of links after import categories
- Fix delete link: delete all related records in other table (review, votes, etc)
- Fix delete link: update number of links
- Fix install process: admin user date information

Changed:
- New default theme set
- Display favorite listing in search result

New feature:
- Recomended listing, require user to logged in and have favorite listing

--------------------------  
IX. Changes from v.3.0.2
--------------------------

Bugs fixed:

- Fix image on rating system
- Fix search result generate links from hidden and member only category
- Fix upgrade procedure from v.2.0
- Fix update number of links in category after admin modify a link

Changed:
- Change pagination style

New feature:
- Email editors and administrator after webmaster upload image
- Email administrator after add and modify a link


