egroupware_official/phpgwapi/inc/class.applications.inc.php

282 lines
7.9 KiB
PHP
Executable File

<?php
/**************************************************************************\
* phpGroupWare API - Applications manager functions *
* This file written by Mark Peters <skeeter@phpgroupware.org> *
* Copyright (C) 2001 Mark Peters *
* -------------------------------------------------------------------------*
* This library is part of the phpGroupWare API *
* http://www.phpgroupware.org/api *
* ------------------------------------------------------------------------ *
* This library is free software; you can redistribute it and/or modify it *
* under the terms of the GNU Lesser General Public License as published by *
* the Free Software Foundation; either version 2.1 of the License, *
* or any later version. *
* This library 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 Lesser General Public License for more details. *
* You should have received a copy of the GNU Lesser General Public License *
* along with this library; if not, write to the Free Software Foundation, *
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA *
\**************************************************************************/
/* $Id$ */
/*!
@class applicatons
@abstract functions for managing and installing apps
@discussion Author: skeeter
*/
class applications
{
var $account_id;
var $data = Array();
var $db;
/**************************************************************************\
* Standard constructor for setting $this->account_id *
\**************************************************************************/
/*!
@function applications
@abstract standard constructor for setting $this->account_id
@param $account_id account id
*/
function applications($account_id = '')
{
global $phpgw, $phpgw_info;
$this->db = $phpgw->db;
$this->account_id = get_account_id($account_id);
}
/**************************************************************************\
* These are the standard $this->account_id specific functions *
\**************************************************************************/
/*!
@function read_repository
@abstract read from repository
@discussion private should only be called from withing this class
*/
function read_repository()
{
global $phpgw, $phpgw_info;
if (!isset($phpgw_info['apps']) ||
gettype($phpgw_info['apps']) != 'array')
{
$this->read_installed_apps();
}
$this->data = Array();
if($this->account_id == False) { return False; }
$apps = $phpgw->acl->get_user_applications($this->account_id);
reset($phpgw_info['apps']);
while ($app = each($phpgw_info['apps']))
{
// $check = $phpgw->acl->check('run',1,$app[0]);
$check = (isset($apps[$app[0]])?$apps[$app[0]]:False);
if ($check)
{
$this->data[$app[0]] = array(
'title' => $phpgw_info['apps'][$app[0]]['title'],
'name' => $app[0],
'enabled' => True,
'status' => $phpgw_info['apps'][$app[0]]['status']
);
}
}
reset($this->data);
return $this->data;
}
/*!
@function read()
@abstract read from the repository
@discussion pubic function that is used to determine what apps a user has rights to
*/
function read()
{
if (count($this->data) == 0){ $this->read_repository(); }
reset($this->data);
return $this->data;
}
/*!
@function add
@abstract add an app to a user profile
@discussion
@param $apps array containing apps to add for a user
*/
function add($apps)
{
global $phpgw_info;
if(gettype($apps) == 'array')
{
while($app = each($apps))
{
$this->data[$app[1]] = array(
'title' => $phpgw_info['apps'][$app[1]]['title'],
'name' => $app[1],
'enabled' => True,
'status' => $phpgw_info['apps'][$app[1]]['status']
);
}
}
elseif(gettype($apps))
{
$this->data[$apps] = array(
'title' => $phpgw_info['apps'][$apps]['title'],
'name' => $apps,
'enabled' => True,
'status' => $phpgw_info['apps'][$apps]['status']
);
}
reset($this->data);
return $this->data;
}
/*!
@function delete
@abstract delete an app from a user profile
@discussion
@param $appname appname to remove
*/
function delete($appname)
{
if($this->data[$appname])
{
unset($this->data[$appname]);
}
reset($this->data);
return $this->data;
}
/*!
@function update_data
@abstract update the array(?)
@discussion
@param $data update the repository array(?)
*/
function update_data($data)
{
reset($data);
$this->data = Array();
$this->data = $data;
reset($this->data);
return $this->data;
}
/*!
@function save_repository()
@abstract save the repository
@discussion
*/
function save_repository()
{
global $phpgw;
$num_rows = $phpgw->acl->delete_repository("%%", 'run', $this->account_id);
reset($this->data);
while($app = each($this->data))
{
if(!$this->is_system_enabled($app[0])) { continue; }
$phpgw->acl->add_repository($app[0],'run',$this->account_id,1);
}
reset($this->data);
return $this->data;
}
/**************************************************************************\
* These are the non-standard $this->account_id specific functions *
\**************************************************************************/
function app_perms()
{
global $phpgw, $phpgw_info;
if (count($this->data) == 0)
{
$this->read_repository();
}
@reset($this->data);
while (list ($key) = each ($this->data))
{
$app[] = $this->data[$key]['name'];
}
return $app;
}
function read_account_specific()
{
global $phpgw, $phpgw_info;
if (gettype($phpgw_info['apps']) != 'array')
{
$this->read_installed_apps();
}
$app_list = $phpgw->acl->get_app_list_for_id('run',1,$this->account_id);
if(!$app_list)
{
reset($this->data);
return $this->data;
}
@reset($app_list);
while ($app = each($app_list))
{
if ($this->is_system_enabled($app[1]))
{
$this->data[$app[1]] = array(
'title' => $phpgw_info['apps'][$app[1]]['title'],
'name' => $app[1],
'enabled' => True,
'status' => $phpgw_info['apps'][$app[1]]['status']
);
}
}
reset($this->data);
return $this->data;
}
/**************************************************************************\
* These are the generic functions. Not specific to $this->account_id *
\**************************************************************************/
/*!
@function read_installed_apps()
@abstract populate array with a list of installed apps
*/
function read_installed_apps()
{
global $phpgw_info;
$this->db->query("select * from phpgw_applications where app_enabled != '0' order by app_order asc",__LINE__,__FILE__);
if($this->db->num_rows())
{
while ($this->db->next_record())
{
$name = $this->db->f('app_name');
$title = $this->db->f('app_title');
$status = $this->db->f('app_enabled');
$phpgw_info['apps'][$name] = array(
'title' => $title,
'name' => $name,
'enabled' => True,
'status' => $status
);
}
}
}
/*!
@function is_system_enabled
@abstract check if an app is enabled
@param $appname name of the app to check for
*/
function is_system_enabled($appname)
{
global $phpgw_info;
if(gettype($phpgw_info['apps']) != 'array')
{
$this->read_installed_apps();
}
if ($phpgw_info['apps'][$appname]['enabled'])
{
return True;
}
else
{
return False;
}
}
}
?>