---

functions.php

Go to the documentation of this file.

<?php
/* $Id: functions.php,v 1.5 2003/10/03 15:27:31 mikko Exp $ */
/*
 * ImaComm - a web based photo album software
 * Copyright (C) 2003, Mikko Kokkonen
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or (at
 * your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 */

// Global -> add these variables always everywhere!
$add = array("album", "image");

$_functions_prefix = realpath(dirname(__FILE__));
// {{{ theme(string $theme)
function theme( $theme )
{
        $themedir = "themes";
        // Do we have $theme?
        if (file_exists("$themedir/$theme/cfgindex.php"))
        {
                // Using sessions...
                session_register("theme");
                $_SESSION['theme'] = "$themedir/$theme/";
                return true;
        }
        else
        {
                // Find 1st theme and use it...
                $dir = dir($themedir);
                while (false !== ($entry = $dir->read()))
                {
                        if (file_exists($dir.path."/".$entry."/cfgindex.php"))
                        {
                                session_register("theme");
                                $_SESSION['theme'] = $dir.path."/".$entry."/";
                                return true;
                        }
                }
                // We don't have any themes installed!
                $msg = "<h1 style=\"color: #f00;\">Sorry :-(</h1>";
                $msg .= "<p>You haven't installed any themes. Before you can configure ImaComm, you need to install at least one theme.</p>";
                $msg .= "<p>If you just extract ImaComm from package then you did have a mispackged version. Please download a ImaComm always from its homepage, <a href=\"http://imacomm.sourceforge.net\">http://imacomm.sourceforge.net</a>.<br />If you did downloaded this package from there, please send a bug report <a href=\"FIXME: LINK HERE\">FIXME: LINK HERE</a></p>";
                $msg .= "<p><font size=\"-1\">Technical information: You tried to load theme $theme</font></p>";
                die($msg);
        }
        return false;
}
// }}}

// {{{ string getAlbum()
function getAlbum()
{
        $album_path = explode("/", $_REQUEST['album']);
        $album = array_pop($album_path);
        if ($album == "")
        {
                $album = "-root-";
        }

        return $album;
}
// }}}

// {{{ string onPage()
function onPage()
{
        return basename($_SERVER['PHP_SELF'], ".php");
}
// }}}

// {{{ showPage()
function showPage()
{
        global $document;

        // Load theme...
        $theme = $_SESSION['theme'];
        if (!isset($theme))
        {
                print deverror("Session variable <b>theme</b> must be set before calling showPage()! Call theme(\"theme\") first!", true);
        }
        // Try to resolve our page...
        $page = basename($_SERVER['PHP_SELF'], ".php");
        $dirs = explode("/", dirname($_SERVER['PHP_SELF']));
        $dir = array_pop($dirs);
        if ($dir == "setup")
        {
                $tpl = "cfg$page.php";
        }
        else
        {
                $tpl = "$page.php";
        }

        // Load template...
        if (!file_exists("$theme/$tpl"))
        {
                print deverror("Theme $theme is not installed correctly. File $tpl is missing from theme folder!", true);
        }
        require_once "$theme/$tpl"; // Simplae and nice, isn't it?
}
// }}}

// {{{ deverror($msg, $serious = false)
function deverror($msg, $serious = false)
{
        $msg = "<b>[Developer error]</b>: (".__FILE__.":".__LINE__.") $msg<br />If you are not a developer, you just found a bug. Please report it with SourceForge Bugzilla! FIXME: Add address!";
        if ($serious)
        {
                die($msg);
        }
        else
        {
                return "$msg<br />";
        }
}
// }}}

// {{{ string genLink($title = null, $vars = null, $href = null)
function genLink($title = null, $vars = null, $href = null)
{
        global $add;
        $vars = explode(":", $vars);
        $href = ($href == null) ? $_SERVER['PHP_SELF'] : $href;
        
        $reqvar = $_REQUEST;
        // Split vars from values...
        foreach ($vars as $var)
        {
                if (strstr($var, '=') !== false)
                {
                        list ($var, $value) = explode("=", $var);
                        $reqvar[$var] = $value;
                }
                $variables[] = $var;
        }
        $vars = array_merge($add, $variables);
        $vars = array_unique($vars);
        
        $buf = "<a href=\"$href?";
        foreach ($vars as $var)
        {
                $buf .= "$var=".$reqvar[$var]."&";
        }
        $buf .= "\">$title</a>\n";

        return $buf;
}
// }}}

// {{{ string formBegin($href = null, $method = "post")
function formBegin($href = null, $method = "post")
{
        global $add;
        $href = ($href == null) ? $_SERVER['PHP_SELF'] : $href;

        $buf = "<form method=\"$method\" action=\"$href\">";
        foreach ($add as $var)
        {
                $buf .= "<input type=\"hidden\" name=\"$var\" value=\"".$_REQUEST[$var]."\" />\n";
        }

        return $buf;
}
// }}}

// {{{ string formEnd()
function formEnd()
{
        $buf = "</form>";

        return $buf;
}
// }}}

// {{{ string popupLink($title, $href)
function popupLink($title, $href)
{
        $buf = "<a href=\"$href\">$title</a>";

        return $buf;
}
// }}}

// {{{ mixed parseValue($value, $type)
function parseValue($value, $type)
{
        global $_functions_prefix;
        // Accept boolean values
        $boolval = array(
                        "true"  => true,
                        "yes"   => true,
                        "1"     => true,
                        "false" => false,
                        "no"    => false,
                        "0"     => false);

        if ($type == "boolean")
        {
                return $boolval[$value];
        }
        if ($type == "string")
        {
                return $value;
        }
        if ($type == "integer")
        {
                settype($value, "integer");
                return $value;
        }
        if ($type == "theme")
        {
                if (is_dir("$_functions_prefix/themes/$value"))
                {
                        return "$value";
                }
        }
        // FIXME: More types?
}
// }}}

// {{{ string dprint($var)
function dprint($var)
{
        $buf = "<pre>";
        ob_start();
        print_r($var);
        $buf .= ob_get_contents();
        ob_end_clean();
        $buf .= "</pre>";

        return $buf;
}
// }}}
?>

---