egroupware/etemplate/inc/class.link_widget.inc.php

<?php
	/**************************************************************************\
	* phpGroupWare - eTemplate Extension - InfoLog LinkTo Widget               *
	* http://www.phpgroupware.org                                              *
	* Written by Ralf Becker <RalfBecker@outdoor-training.de>                  *
	* --------------------------------------------                             *
	*  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.                                              *
	\**************************************************************************/

	/* $Id$ */

	/*!
	@class link_widget
	@author ralfbecker
	@abstract link-to:   widget that enable you to make a link to an other entry of a link-aware app
	@abstract link-list: widget that shows the links to an entry and a Unlink Button for each entry
	@discussion This widget is independent of the UI as it only uses etemplate-widgets and has therefor no
	@discussion render-function.
	*/
	class link_widget
	{
		var $public_functions = array(
			'pre_process' => True,
			'post_process' => True
		);
		var $human_name = array(	// this are the names for the editor
			'link-to'   => 'LinkTo',
			'link-list' => 'LinkList'
		);

		function link_widget($ui)
		{
			$this->link = CreateObject('infolog.bolink');
		}

		function pre_process($name,&$value,&$cell,&$readonlys,&$extension_data,&$tmpl)
		{
			if (!is_array($value))
			{
				$value = array(
					'to_id' => $value,
					'to_app' => $GLOBALS['phpgw_info']['flags']['currentapp']
				);
			}
			//echo "<p>start: $cell[type]::pre_process: value ="; _debug_array($value);
			switch ($type = $cell['type'])
			{
			case 'link-to':
				if ($value['button'] == 'search' && count($ids = $this->link->query($value['app'],$value['query'])))
				{
					$extension_data['app'] = $value['app'];
               
					$value = $extension_data;
					$value['options-id'] = $ids;
					$value['remark'] = '';
					
					$tpl = new etemplate('etemplate.link_widget.create');
				}
				else
				{
					if (!$value['button'])
					{
						$extension_data = $value;
					}
					$value = array_merge($extension_data,$value);
					$value['options-app'] = $this->link->app_list();

					$tpl = new etemplate('etemplate.link_widget.search');
					$tpl->set_cell_attribute('msg','disabled',$value['button'] != 'search');
				}
				break;

			case 'link-list':
				$app = $value['to_app'];
				$id  = $value['to_id'];
				//echo "<p>link-list-widget.preprocess: value="; _debug_array($value);

				if (!isset($value['title']))
				{
					$value['title'] = $this->link->title($app,$id);
				}
				$extension_data = $value;

				$links = $this->link->get_links($app,$id);
				if (!count($links))
				{
					$cell = $tmpl->empty_cell();
					$value = '';
					return True;
				}
				$tpl = new etemplate('etemplate.link_widget.list');
				$tpl->data[0]['A'] = $tmpl->data[0]['A'];	// set width of first col like the tmpl. calling us
				for($row=$tpl->rows-1; list(,$link) = each($links); ++$row)
				{
					$value[$row] = $link;
					$value[$row]['title'] = $this->link->title($link['app'],$link['id']);
				}
				break;
			}
			$cell['size'] = $cell['name'];
			$cell['type'] = 'template';
			$cell['name'] = $tpl->name;
			$cell['obj'] = &$tpl;

			//echo "<p>end: $type::pre_process: value ="; _debug_array($value);
			return True;	// extra Label is ok
		}

		function post_process($name,&$value,&$extension_data,&$loop,&$tmpl,$value_in)
		{
			if ($value['search'])
			{
				$button = 'search';
			}
			elseif ($value['create'])
			{
				$button = 'create';
			}
			elseif ($value['new'])
			{
				$button = 'new';
			}
			elseif (is_array($value['unlink']))
			{
				$button = 'unlink';
				list($unlink) = @each($value['unlink']);
			}
			//echo "<p>start: link_widget::post_process: button='$button', unlink='$unlink', value ="; _debug_array($value);
			unset($value[$button]);

			$value = array_merge($extension_data,$value);

			switch ($button)
			{
				case 'create':
					if ($value['to_app'])						// make the link
					{
						$this->link->link($value['to_app'],$value['to_id'],$value['app'],$value['id'],$value['remark']);
						//echo "<p>link($value[to_app],$value[to_id],$value[app],$value[id],'$value[remark]')</p>\n";
					}
					// fall-trough
				case 'search':
				case 'new':
					$extension_data = $value;
					$loop = True;
					break;

				case 'unlink':
					$this->link->unlink($unlink,$value['to_app'],&$value['to_id']);
					//echo "<p>unlink(link-id=$unlink,$value[to_app],$value[to_id])</p>\n";
					$loop = True;
					break;
			}
			$value['button'] = $button;
			//echo "<p>end: link_widget::post_process: value ="; _debug_array($value);
			return True;
		}
	}