Location: PHPKode > projects > Top Music module > Top Music 3.0.7/README.txt
######################################################################
# Top Music 3.0 :: Readme
######################################################################
#
# Copyright (c) 2004-2005 by SergiDs.com
# All rights reserved.
# http://www.sergids.com
#
######################################################################

1.  Introduction & Requirements
2.  New Installations
3.  Updates from previous versions
4.  Notes

                           *  *  *  *  *

======================================================================
1.  Introduction & Requirements
======================================================================

------------
Introduction
------------

Top Music is an entertainment solution built exclusively for PHP-Nuke.
It allows you publish information about bands, albums and songs.
Features:
  :: A-Z list of Bands
  :: Bands information (Name, photo, genre, biography...)
  :: Bands' Discography
  :: Album information (Title, year, covers, band...)
  :: Album's Songs list
  :: Song information (Title, album, number, lyrics...)
  :: Listen song track
  :: Bands, Albums and Songs searching
  :: Ranking lists (most visited, most voted, etc)
  :: Charts
  :: Custom fields (image, link, text, textarea,  select, file)
  :: Voting system
  :: Uploads system
  :: Themes
  :: Automatic images optimization (powered by PHP gd library)
  :: Easy configuration screen
  :: Lots of blocks
  :: Multilanguage
  :: Easy installation
  :: Support forum and preview at http://www.sergids.com
  :: Mailing lists with latest news
  :: Sourceforge.net support (CVS, Files, etc)

--------------------
Minimum Requirements
--------------------

1.   PHP 4.2.1
2.	 PHP-Nuke 7.7

------------------------
Recommended Requirements
------------------------

1.   PHP 5.0 or greater.
2.	 PHP-Nuke 8.0

                           *  *  *  *  *

======================================================================
2.  New Installations
======================================================================

These are instructions for installing a fresh copy of Top Music. They
should be followed step-by-step for optimum results.

1.   Extract the archive and upload ALL files from directory 'html' 
     to your root PHP-Nuke directory keeping the same directory structure:
     
     [phpnuke_root]\
     [phpnuke_root]\admin\images\
     [phpnuke_root]\modules\topMusic\
     [phpnuke_root]\blocks\
     
     
2.   Login as administrator in your PHPNuke site.
     
3.   Go to http://[your_site_root]/modules/topMusic/install/topmusic_install.php. 
	 Follow the instructions presented to you.
	 
	 -OR-
	 
	 Use modules/topMusic/install/metadata.sql and data.sql (advanced users only).

4. Set write permissions to the following folders:

	modules/topMusic/photos
	modules/topMusic/photos/albums
	modules/topMusic/themes_c
	modules/topMusic/themes_c/sergids
	modules/topMusic/tracks

5.  Go to Top Music Administration / Settings section.
	Configure Top Music to adjust it to your needs.

6.  Enable Top Music module from PHP Nuke modules administration
	
6.  You can add your own themes in themes module directory and it will appear 
	automatically in Top Music settings section.
	See http://www.sergids.com/topmusic-advanced-faq.html for more details.

7.  You can translate Top Music module to your language. 
	See http://www.sergids.com/topmusic_translate.html for  more details.
	
8.  Enable Top Music module in PHPNuke modules administration.

                           *  *  *  *  *

======================================================================
3.  Updates from previous versions
======================================================================

These are instructions for updating an old copy of Top Music. They
should be followed step-by-step for optimum results.

1.   Extract the archive and upload ALL files from directory 'html' 
     to your root PHP-Nuke directory overwritting old ones.

2.	Delete [phpnuke_root]/admin/modules/topmusic folder and all its contents if exists.
	Delete [phpnuke_root]/admin/case/case.topmusic.php if exists.
	Delete [phpnuke_root]/admin/links/links.topmusic.php if exists.

3.  Login as administrator in your phpnuke site.

4.  Go to http://[your_site_root]/modules/topMusic/install/topmusic_update.php. 
	Follow the instructions presented to you.

	-OR-

	Execute sql/update_[previous_version]_3.sql into your database.

5. Set write permissions to the following folders:

	modules/topMusic/photos
	modules/topMusic/photos/albums
	modules/topMusic/themes_c
	modules/topMusic/themes_c/sergids
	modules/topMusic/tracks

6.   Go to Top Music Administration and enter into Settings section.
	 Configure Top Music to adjust it to your needs.

7.   You can add your own themes in themes module directory and they will appear 
	 automatically in settings section.
	 See http://www.sergids.com/topmusic-advanced-faq.html for more details.

                           *  *  *  *  *

======================================================================
4.  Notes
======================================================================

1.   Top Music is released under the GNU/GPL License. Please read 
     the included license with this software for use and distribution 
     limitations.

2.   Top Music may not be ported without written permission from the
     author(s).

3.   Top Music may not be mirrored without written permission from 
     the author(s).

                           *  *  *  *  *
Return current item: Top Music module