Zina Installation

Installation Methods (0.12.x [2] | 0.11.x [2] | 0.10.x):

Stand Alone [2]
Postnuke [2]
Phpnuke [2]
Embedded into website [2]
Embedded into website - Single Band/Album [2]

Requirements [2]

Make sure PHP4 already works in the base directory of your MP3s.

Put Zina files in base directory of your MP3s.

If you want to use all features make sure _zina directory exists and is writable by webserver user (easiest and most insecure way is to make it world writable).
If not, set $z_cache = false; in zina.ini.php settings file.

Example zina.ini.php file (Absolutlely NO whitespace or returns outside of <?php ?>, mmm-kay?):
<?php#put settings you've changed in here, so when upgrading, your preferences are kept $z_mp3_dir = "mp3s";?>

Look over options in "DEFAULT SETTINGS" section of zina script. Make sure to change admin password if $z_login = true; Add changes to zina.ini.php file.

Point your webrowser to the base directory of your MP3s.

Requirements [2]
Unzip zina into modules directory

Make sure zina directory is named 'zina' and not 'zina-x.x.x'

If you want to use all features make sure the _zina directory exists and is writable by webserver user (easiest and most insecure way is to make it world writable).
If not, set $z_cache = false; in "DEFAULT SETTINGS" section of zina script or your zina.ini.php settings file.

Create a file in zina module directory called "zina.ini.php" (if you haven't already)

Put the following lines in that file:
<?php$z_postnuke = true; $z_width = "100%"; # give access only to logged in users $z_pn_users = false; $z_root_dir = "modules/zina"; $z_img_dir = "$z_root_dir/_images/"; $z_dir = "$z_root_dir/_zina"; $z_mp3_dir = "modules/zina";?>

Do whatever Postnuke requires you to do to add it as a module

Look over other options in "DEFAULT SETTINGS" section of zina script. Add changes to zina.ini.php file.

NOTE: When you are logged in as an administrator in Postnuke, you are an administrator in Zina. Go to the normal zina page and you will see more options. There are no settings under the Administration section of postnuke.

Postnuke [2] except $z_phpnuke = true; instead of $z_postnuke = true;

stand-alone mode [2].
For this example, I assume Zina is installed in a directory called zina

I also assume, you use CSS for look and feel.

I assume this directory is in the root directory of your website. e.g.
/ /zina/ /index.html <-- this is your website or something

Make the following changes/additions to your /zina/zina.ini.php file.
<?php $z_mp3_dir = "zina"; # if you've changed this variable, prefix 'zina/' # i.e. think path relative to website root directory! $z_root_dir = "zina"; $z_img_dir = "$z_root_dir/_images/"; $z_dir = "$z_root_dir/_zina"; $z_embed = true; #You can mess with these later... $z_width = "100%"; # width of zina, can also be in pixels #Change the stuff between the double quotes only! (Unless you know php, of course).$z_page_hdr_title = 'echo "$z_table<tr><td class=z_title><b>" . htmlentities($title) . "</b></td></tr></table>";';?>

/zina.php <-- create this file and put the following in it:
<?php ob_start(); ?> <html><body><? include("zina/index.php"); ?></body></html>

ok, now make sure everything works by pointing your browser at yourdomain.com/zina.php. it'll look pretty ugly! But you can now put these two lines into an existing website (or put an existing website aroung these two lines) and through the magic of CSS, it'll look pretty!

Oh, you should go back to the zina.ini.php file and uncomment and change the $z_width and $z_page_hdr_title to match your website.

See here for demos [2].

Embedded mode [2].
Add the following lines to your zina.ini.php file: $z_playlists = false; $z_dir_list = false; $z_random = false; $z_search = false; $z_nav = false;

Now use links (per embedded example) ala zina.php?p=dir where dir is path to appropriate directory (and %20 represents a space in a directory name, %2C for commas, etc.) (for ease, use right click "copy link location" in your browser in embedded example and replace '+' with '%20').

See here for demos [2].

Zina Installation - 0.10.x