Location: PHPKode > projects > @1 File Store > INSTALLATION.txt
Script name: @1 File Store PRO
This version: v3.2
Last Updated: 15 May 2007
Website: www.upoint.info/cgi

==============================================================================
UPGRADE FROM PRO VERSION v2.0 to v3.2:
==============================================================================
1) Delete all files in the folder "templates_c".
2) Configure "config.php" in v3.0.
3) Re-upload all files/folders in the same structure as the ZIP file.
   For example, "main.php" should be located at www.yourdomain.com/filestore/main.php.

   *note1:
   a) If you have made a lot of customization to version 2.0, you might want to
      backup a copy of all existing files for easy reference.
   b) Do not delete the existing files in the "data" folder as they are your
      current data.
   c) Upload via shell/SSH not recommended for upgrade.

4) Update the existing MySQL tables using the "upgrade_only.sql" file. You can do
   this by pasting the content of dump.sql into:

     phpMyAdmin >> [select your database] >> SQL >> Run Queries

   This will create an extra table:
    - fstore_settings

7) Backup and delete the files "autoapprove_install.php", "upgrade_only.sql" and
   "dump.sql" for security.

8) Point your browser to the "filestore" folder.
   Default master admin login is admin/admin.

9) Immediately after successful login, click on the link at the bottom-right of
   the page to see license validity. If the license is not valid, please contact
   UPOINT at the Helpdesk immediately.

==============================================================================
FRESH INSTALLATION for v3.2:
==============================================================================
1) Configure config.php in v3.2.
2) Create a main folder "filestore" in the ROOT directory (www.yourdomain/filestore).
3) Upload all files/folders in the same structure as the ZIP file. For example, the
   location of "main.php" should be www.yourdomain.com/filestore/main.php.

   You can either:
   - unzip the ZIP file in your local drive and upload all files manually using FTP.

   ... or

   - upload the zip file using FTP and unzip using shell/SSH. This method is
     strongly recommended as it is fast and more reliable. To use this method:
       a) Upload filestore.zip to the "filestore" directory.
          - www.yourdomain.com/filestore/filestore.zip
       b) Unzip using the command "unzip filestore.zip".

4) a) Chmod the folders "data", "template_c" and "temporary" to 777.
   b) Chmod the folder "control" and all its sub-folders to 777.
      - Chmod all files under the "control" folder's sub-folders to 666.
   !!! If you get an error page when clicking the left menu (such as Users),
       please omit step b) and leave the "control" folder, its subfolders
       and all files to the default chmod value, which should be 755 for folders
       and 644 for files.

5) Create MySQL tables using the "dump.sql" file. You can do this by
   pasting the content of dump.sql into:

     phpMyAdmin >> [select your database] >> SQL >> Run Queries

   This will create 7 tables:
    - fstore_access_list
    - fstore_file_list
    - fstore_folders
    - fstore_logger
    - fstore_settings
    - fstore_user_groups
    - fstore_users

6) Point your browser to the "autoapprove_install.php". The script will create a
   new group called "Public" for auto-approval feature. Skip this step if you turned
   OFF the auto-approve feature under config.php.

7) Backup and delete the files "autoapprove_install.php", "upgrade_only.sql" and
   "dump.sql" for security reasons.

8) Point your browser to the "filestore" folder.
   Default master admin login is "admin/admin".

9) Immediately after successful login, click on the link at the bottom-right of
   the page to see your license validity. If the license is not valid, please
   contact UPOINT at the Helpdesk.

10) Go to "Users" (left panel) and edit your "admin" profile. Then you may start
    creating Groups and Directories (Folders).

==============================================================================
HOW TO TRANSLATE THE SCRIPT INTO ANOTHER LANGUAGE
==============================================================================
* The translation in the language files might not be 100% correct. If you have
  found some errors, you can easily edit them using a text editor. If there is
  a need, you may even create a new language file.

1) Open language/en.php with a text editor.

2) Translate the words/phrases.

3) Save the new language file as xx.php.

4) Under config.php, replace "en" below with "xx":

   "SITE_LANG" => "en"

If you have come up with a new language file, we should be much grateful if you
could submit it to us so that we can include it in the ZIP file to benefit all
users.

==============================================================================
HIDDEN FEATURES: Direct access without entering username/password.
==============================================================================
1) You may create public logins so that visitors do not have to sign up to
access the archive. Simply create accounts with username "guest_XXXXX". Ie., give
the username the "guest_" prefix and "XXXXX" can be anything. By doing so, the
visitors will get an "Access Denied" message if they try to edit the Profile. You
may create multiple guest logins with different access permission.

The link should be in this format:
http://yourdomain.com/filestore/main.php?id=1&login=guest_public&password=123

The URL above assumed that you have created a user profile with username
"guest_public" and password "123". Also, you must have granted this user the
permission to access folder with id "1". You can find out the id of a folder by
hovering the mouse cursor over the folder and observe the URL in the status bar.

==============================================================================
TIPS:
==============================================================================
1) If there are many records, the script lists them in multiple pages.
  The current settings are:

    Uploaded files - 20 per page
    Users - 50 per page
    Access logs - 300 per page

  To change the figures, search and edit in the *.php and *.tpl files:
    $pager->setpagesize(20);

==============================================================================
UPLOAD FAILURE:
==============================================================================
Q1: The file upload failed although the filesize of the file I tried to upload is
   smaller than the maximum limit set in the script.
Q2: I got the "time-out", "server reset" and "upload failed" message when I tried
   to upload larger files (5 ~ 6Mb).

A: Please see the FAQ at http://upoint.info/cgi/helpcenter . This a very common
   question.

==============================================================================
CHANGE LOG v2.0 to v3.2:
==============================================================================
Please see new features added and bug fixes at http://upoint.info/cgi/demo/fs/v3.htm .

==============================================================================
SMARTY TEMPLATE ENGINE:
==============================================================================
This script uses Smarty's template engine. You do not need to specially
install it to your server. Simply upload the "smarty" folder as in Step 3.
To learn more about Smarty, please visit http://smarty.php.net/ .

==============================================================================
F.A.Q:
==============================================================================
Q: Can UPOINT do the installation for me?
A: Yes! We charge merely $10 for the installation. Payment can be made at
   https://upoint.info/payment.htm . Once payment is made, please create a
   Helpdesk ticket at www.upoint.info/contact.htm and tell us your domain name,
   FTP address and FTP username/password. Typically, installation takes 1~2 days.

Q: How can I purchase more licenses?
A: From version 3 onwards, each license issued is based on the domain name
   of the website. For single-purchase users, you may request for additional
   domain licenses at only $10 per license. Payment can be made at
   https://upoint.info/payment.htm . Once payment is made, please create a
   Helpdesk ticket at www.upoint.info/contact.htm and tell us your domain name.

Q: I have changed the domain name of my website, can I get a new license for free?
A: We need to regenerate the license for your new domain name and the fee is $10.

Q: Would I be getting free upgrades?
A: This is the upgrade policy from version 3.0 onwards:
   
   - Minor upgrade
      > FREE (example: upgrade from 3.x to 3.z)
   - Major upgrade which does not require a license regeneration
      > FREE (example: upgrade from 3.x to 4.z)
   - Major upgrade which requires a license regeneration
      > $10 (example: upgrade from 3.x to 4.z)
      > Free if purchased within 6 months.

Q: Where can I find the FAQ for this script?
A: Our FAQ page is located at http://upoint.info/cgi/helpcenter/

Q: Can I pay you to customize this script for me?
A: @1 File Store PRO is a sophisticated script. We cannot customiz this script
   for you at a cost-effective price and time frame.

Q: Do you do custom programming?
A: Yes! If you need a custom script, please contact us at our Helpdesk.

==============================================================================
PROBLEMS?
==============================================================================
Please DO NOT contact us by email, use the secured Helpdesk below instead.

The Management,
UPDI Network Enterprise
www.upoint.info
Contact us for help: http://upoint.info/contact.htm

Return current item: @1 File Store