DOCman 1.5.x README

Date added: 04 February 2012 Last revised: 04 February 2012 Hits:

DOCman v1.5.x README

Please read the upgrade instructions below when upgrading from an older version!

Always back up your system files and database before (un)installing anything!

To make sure the files have not been tampered with, download DOCman, Addons and Translations from the official location at http://www.joomladocman.com

Table of Contents

  • About DOCman
  • System Requirements
  • Installation in Joomla! 1.5.x
  • Installing translations
  • Upgrading from older versions of v1.5.x
  • Upgrading from older versions of v1.4.x
  • Upgrading from v1.3 RC1 or RC2
  • Migrating DOCman from a Joomla! 1.0.x site to a Joomla! 1.5 site
  • Official Addons
  • Useful Links

About DOCman

DOCman is an open source document management and download system for Joomla! v1.5. With this component you can manage documents across categories and make them available for download.

For more information about the key features of DOCman v1.5 please check out our overview at http://www.joomlatools.eu/products/docman.html

System Requirements

  1. Joomla 1.5.x (recommended 1.5.15 or later)
  2. PHP 5.2.x or higher
  3. Database: MySQL 4.1 or higher

Installation in Joomla! 1.5.x

  1. Check the system requirements. [Help -> System Info -> System Info]
  2. Check your writing permissions. [Help -> System Info -> Directory Permissions]
  3. Install DOCman using Joomla's installer. [Extensions -> Install/Uninstall]
  4. If you're new to DOCman, we highly recommend you click the 'Add sample data'-button.
  5. Review the configuration settings and save.

Installing translations

Unzip the translation file of your choice in the root of your Joomla installation.

Upgrading from older versions of 1.5.x

If you have any version of 1.5.x, you can always upgrade to the latest version without loosing your data.

  1. Backup your Joomla installation and database
  2. Install upgrade_docman_v1.5.x_to_v1.5.x.tar.gz, just like you would install any other extension

You will receive the upgrade package by mail.

Upgrading from older versions of v1.4.x

If you have any version of 1.4.x, you can always upgrade to the latest version without loosing your data, EXCEPT the config settings and the theme.

  1. Make a backup copy of /administrator/components/com_docman/docman.config.php to a different location
    OR
    Make screenshots of the configuration pages, or note down the settings
  2. [Optional] If you have custom themes, make sure you backup these separately They're in /components/com_docman/themes
  3. Uninstall DOCman. Your files, documents, categories, licenses, logs and groups will be preserved.
  4. Uninstall the DOCman search plugin, DOClink and the official modules.
  5. Install the latest version of DOCman
  6. Restore docman.config.php or use the settings from the screenshots
  7. Review the configuration settings and save. Make sure that 'Path for storing files' (in the config) is correct.

Upgrading from v1.3 RC1 or RC2

You cannot upgrade directly from 1.3.x to 1.5. Instead you need to first upgrade to 1.4, then upgrade to 1.5.
Follow the instructions in the 1.4.x readme file on how to perform the upgrade from 1.3.x to 1.4.x

Migrating DOCman from a Joomla! 1.0.x site to a Joomla! 1.5 site

Download the file docman_migrator_plugins_[version].zip. Inside, there is a README file with instructions.

Useful Links