Zina Installation - 2.0 Series

Installation Methods

2.0 | 1.0 [1]

Installation: Stand Alone

Make sure your system meets the requirements [2].
Unzip zina files into a directory accessible by your webserver.
Make sure Zina's "cache" directory is writable by the webserver user.
Point your webrowser to the Zina script.
Log in.
Go to "Settings" (this initializes the cache directories) and change your password.
Make sure demo site works.
If all is good, play around with the other settings and have fun.
Note: cron.php needs to be run regularly (via cron?) or caches need to be regenerated manually.

Installation: Modules

Your CMS should already be installed and functioning properly.
Make sure your system meets the requirements [2].
Download [3] the appropriate file for your CMS.
Install per your CMS's instructions.
Make sure Zina's "cache" directory is writable by the webserver user.
While logged in administrator, go to Zina's settings to initialize cache directories (see notes)
Make sure demo site works.
Go back to settings page, change music directory and have fun.

Notes

Administrative interface is either accessible via the CMS's normal place or via a "Settings Icon" in the upper right hand corner on Zina's pages when logged in.

Access permissions are controlled by your CMS.

If you want to use clean urls, make sure they are enabled and work in your CMS.

If there is a cron.php file in Zina's root directory, it needs to be run regularly (via cron?) or caches need to be regenerated manually. If it is not there, make sure your CMS's cron is functioning.

Joomla Specific

If using SEF urls, you must modify Joomla's .htaccess and remove/comment out the following line (or add appropriate extension, e.g. mp3, .m3u,.jpg, .xspf,.xml, .rss, etc):
RewriteCond %{REQUEST_URI} (/|\.php|\.html|\.htm|\.feed|\.pdf|\.raw|/[^.]*)$ [NC]

Currently, last.fm & twitter.com support are not available.

Wordpress Specific

WP 2.7.x: DO NOT USE THE AUTO UPDATE FEATURE!

There cannot be a trailing slash at the end of your permalink structure if you want to use clean urls.

Installation: Embedded into website

Get Zina working in stand-alone mode [4] first.
Then you have a few options
Option 1:

Modify a theme to look like your site. See: Themes in Documentation [5].

Option 2: You could incorporate Zina into your site via PHP. A basic example:

<?php require_once("PATH/index.php"); ?>
<html>
<?php echo $zina['head_css'].$zina['head_js']; ?>
</head>
<body>
<?php echo ztheme('page_complete', $zina); ?>
</body>
</html>
Then in PATH/index.php you'll need to comment out the line: #echo ztheme('page_complete', $zina);
In Zina's Settings, change the theme to "zinaEmbed" and then modify it (or copy it first and modify that one) to further match your site.

Installation: IIS

Hopefully, as of 2.0a6, IIS should just work. Let me know!

Upgrading

Your database can be upgraded within Zina.
Your zina.ini.php might not work correctly.
cron.php needs to be setup to run regularly (or you have to manually regenerate caches).