=================================================================
MediaLibrary Free , version 4.6 Free , for Joomla 3.x and PHP5-7
=================================================================


CONTENTS
========

01. Introduction
02. System Requirements
03. License
04. Installation
05. Upgrade Instructions from free and Pro version
06. Upgrade Instructions from versions before
07. Getting started
08. Support
09. Addons
10. Languages
11. Other components/plugins
12. Customisation
13. Keeping up-to-date



01. INTRODUCTION
----------------

The MediaLibrary Free component for Joomla allows you to manage and maintain 
a media library or media collection with ease on a Joomla-based website. 
It supports Books, Music, Movies and Games.

Media details (title, authors, covers, release information) can be pulled in 
easily from Amazon using the ISBN (International Standard Book Number) or ASIN 
(Amazon Standard Identification Number). 
Because MediaLibrary incorporates Lend-Return management and user contributed 
Media Review options, it is excellent for media library management. 
It can be used to set up and manage community libraries, libraries for 
organisations, school and university libraries, private media collection 
management, etc. 

Since MediaLibrary also supports media sales directly through Amazon (with sales 
commission) as well as emedia downloads, websites can also use the component to 
promote and sell their own or other people's publications.
The integration with VirtueMart allow for direct selling as well.  

The Free version of MediaLibrary has a lot of added functionality compared to 
the Free version. For full details on the different options visit 
http://www.ordasoft.com.

Maintainers: Andrey Kvasnevskiy
Homepage   : http://www.ordasoft.com



02. SYSTEM REQUIREMENTS
-----------------------

MediaLibrary Free is a Joomla component. It needs a functioning Joomla 3.x 
installation. MediaLibrary Free needs PHP 5 with SOAP, CURL, XSL and GD 
extensions to function properly. It integrates with VirtueMart as well.
Please make sure you have VirtueMart installed before you install MediaLibrary 
Free (with the needed IE fixes applied)! 

PLEASE CHECK BEFORE INSTALLING MediaLibrary:
In order for MediaLibrary Amazon Web Services to work, you need to compile PHP5 
with support for the SOAP extension!
In order for csv export to work, you need to compile PHP5 with support for the 
XSL extension!
In order for Book Cover downloads to work, you need to compile PHP5 with support 
for the CURL extension!
In order for CAPTCHA images (Guest User anti-spam for reviews and suggestions) 
to work, you need to compile PHP5 with the GD extension!
VirtueMart needs to be installed

CHECK YOUR PHP INSTALLATION FOR PROPER EXTENSIONS:
First please make sure PHP5 has the above extensions enabled!
- If you run your own web server, please recompile PHP with support for XSL, 
  SOAP, CURL and GD.
- If your website is with a hosting provider, check with them for the inclusion 
  of these PHP extensions.
MediaLibrary needs these PHP extensions to install and function correctly!

INSTALLER CHECK FOR PHP EXTENSIONS:
The MediaLibrary installer will check for the availability of these PHP extensions 
and issue a warning if they are missing. If you get such a warning, just uninstall 
MediaLibrary, fix the PHP extensions first, and then reinstall MediaLibrary.

PLEASE NOTE:
Even though we can do checks for the proper PHP extensions inside the MediaLibrary 
installer package, we have no way to roll back the installation once started, not 
even when a check fails. So installation will continue, even if a PHP extension is 
not present. This is unfortunately a limitation of the Joomla installer!



03. LICENSE
-----------

MediaLibrary Free is released as a commercial component.
Check the included LICENSE.txt file for license details.
There will also be a Free version available (with less functionality), released 
under the GNU/GPL.



04. INSTALLATION
----------------

MediaLibrary Free is installed easily with the standard Joomla component installer. 
For additional information on how to set up and configure MediaLibrary Free to 
suit your needs, please consult the [MediaLibrary Manuals] section on the website.
VirtueMart needs to be installed BEFORE you install MediaLibrary Pro Shop.
Also apply the needed IE fixes for VirtueMart beforehand (see the VirtueMart 
website).


05. UPGRADE INSTRUCTIONS FROM FREE AND PRO VERSION
----------------------------------------------------------

To keep your MediaLibrary data when upgrading from a previous version 
(deinstall-reinstall), please follow the instructions below. 
This will restore all existing media data (including descriptions and 
reviews) to your new MediaLibrary Free installation.

Full save so files and folders:

{yours site}/administrator/components/com_medialibrary
{yours site}/components/com_medialibrary

Please do full media export.

Then go to [medialibrary] [Settings Backend] and set [Update] to “YES”

The uninstall basic component and install Free version.

Please recover folders:
{yours site}/components/com_medialibrary/emedia
{yours site}/components/com_medialibrary/covers

Also you will need upgrade all plugins and modules

And all will work.

At first please check Upgrade process at test site



06. Upgrade Instructions from versions before
---------------------------------------------

Full save so files and folders:

{yours site}/administrator/components/com_medialibrary
{yours site}/components/com_medialibrary

Please do full media export.

After that please remove
{yours site}/administrator/components/com_medialibrary
{yours site}/components/com_medialibrary

Please do install MediaLibrary version.

Please recover folders:
{yours site}/components/com_medialibrary/emedia
{yours site}/components/com_medialibrary/covers

Also you will need upgrade all plugins and modules
And all will work.

At first please check Upgrade process at test site



07. GETTING STARTED
-------------------

The [MediaLibrary Free Manuals] section on the website has many articles 
with instructions on MediaLibrary setup and use.



08. SUPPORT
-----------

The OrdaSoft.com site has a [Support Forums] section for support to the 
MediaLibrary component, modules and plugins. There is a special forum section 
dedicated to registered MediaLibrary Free users.



09. ADDONS (MODULES, PLUGINS)
-----------------------------

Modules and plugins (mambots) are constantly being developed for use with 
MediaLibrary. You can download them from the download sections on the website.



10. LANGUAGES
-------------

MediaLibrary Free comes with English  files included.
The OrdaSoft.com website will offer additional German, French, Spanish, Dutch 
and Italian languages soon for download. 
The MediaLibrary interface will automatically pick up the frontend or backend 
language set in your Joomla configuration. Frontend language switches with 
JoomFish will also result in the automatic language change in MediaLibrary.

You can add non-included languages to MediaLibrary by creating your own 
translations. 
Copy english.php from the directory /components/com_medialibrary/language/, 
rename it to your language and then create the translation. Next add the 
language selectors to the code and upload the translation to your medialibrary.
You can find full instructions on creating translations and adding languages 
on the website.
Remember that Joomla 3.x and high needs files saved as UTF-8, so do NOT use Notepad or
Wordpad (they are not UTF-8 capable)!



11. OTHER COMPONENTS/PLUGINS
----------------------------

Add-ons for interaction with other components are also available developed 
(SEF, Sitemap). Community Builder and full JoomFish integration will be 
developed later.



12. CUSTOMISATION
-----------------

If you need a new specific feature added to MediaLibrary Free for your own 
installation, you can order a custom development. 
Just contact sales@ordasoft.com describing the details of your requirements. 
We will then investigate your request and send you a price quote for this 
development. When you pay for a customisation for MediaLibrary, you will receive 
the next version of MediaLibrary Free with your feature included.



13. KEEPING UP-TO-DATE
----------------------

Please check http://www.ordasoft.com for news, details and contact 
information regarding MediaLibrary. In time there will also be a MediaLibrary 
Newsletter to which you can subscribe (news, developments, etc.).
