335 lines
No EOL
7.1 KiB
PHP
335 lines
No EOL
7.1 KiB
PHP
<?php
|
|
// +-----------------------------------------------------------------------+
|
|
// | Piwigo - a PHP based photo gallery |
|
|
// +-----------------------------------------------------------------------+
|
|
// | Copyright(C) 2008-2014 Piwigo Team http://piwigo.org |
|
|
// +-----------------------------------------------------------------------+
|
|
// | 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 |
|
|
// | |
|
|
// | 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. |
|
|
// +-----------------------------------------------------------------------+
|
|
|
|
/**
|
|
* @package functions\menubar
|
|
*/
|
|
|
|
|
|
/**
|
|
* Manages a set of RegisteredBlock and DisplayBlock.
|
|
*/
|
|
class BlockManager
|
|
{
|
|
/** @var string */
|
|
protected $id;
|
|
/** @var RegisteredBlock[] */
|
|
protected $registered_blocks = array();
|
|
/** @var DisplayBlock[] */
|
|
protected $display_blocks = array();
|
|
|
|
/**
|
|
* @param string $id
|
|
*/
|
|
public function __construct($id)
|
|
{
|
|
$this->id = $id;
|
|
}
|
|
|
|
/**
|
|
* Triggers a notice that allows plugins of menu blocks to register the blocks.
|
|
*/
|
|
public function load_registered_blocks()
|
|
{
|
|
trigger_notify('blockmanager_register_blocks', array($this));
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_id()
|
|
{
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* @return RegisteredBlock[]
|
|
*/
|
|
public function get_registered_blocks()
|
|
{
|
|
return $this->registered_blocks;
|
|
}
|
|
|
|
/**
|
|
* Add a block with the menu. Usually called in 'blockmanager_register_blocks' event.
|
|
*
|
|
* @param RegisteredBlock $block
|
|
*/
|
|
public function register_block($block)
|
|
{
|
|
if (isset($this->registered_blocks[$block->get_id()]))
|
|
{
|
|
return false;
|
|
}
|
|
$this->registered_blocks[$block->get_id()] = $block;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Performs one time preparation of registered blocks for display.
|
|
* Triggers 'blockmanager_prepare_display' event where plugins can
|
|
* reposition or hide blocks
|
|
*/
|
|
public function prepare_display()
|
|
{
|
|
global $conf;
|
|
$conf_id = 'blk_'.$this->id;
|
|
$mb_conf = isset($conf[$conf_id]) ? $conf[$conf_id] : array();
|
|
if (!is_array($mb_conf))
|
|
{
|
|
$mb_conf = @unserialize($mb_conf);
|
|
}
|
|
|
|
$idx = 1;
|
|
foreach ($this->registered_blocks as $id => $block)
|
|
{
|
|
$pos = isset($mb_conf[$id]) ? $mb_conf[$id] : $idx*50;
|
|
if ($pos>0)
|
|
{
|
|
$this->display_blocks[$id] = new DisplayBlock($block);
|
|
$this->display_blocks[$id]->set_position($pos);
|
|
}
|
|
$idx++;
|
|
}
|
|
$this->sort_blocks();
|
|
trigger_notify('blockmanager_prepare_display', array($this));
|
|
$this->sort_blocks();
|
|
}
|
|
|
|
/**
|
|
* Returns true if the block is hidden.
|
|
*
|
|
* @param string $block_id
|
|
* @return bool
|
|
*/
|
|
public function is_hidden($block_id)
|
|
{
|
|
return !isset($this->display_blocks[$block_id]);
|
|
}
|
|
|
|
/**
|
|
* Remove a block from the displayed blocks.
|
|
*
|
|
* @param string $block_id
|
|
*/
|
|
public function hide_block($block_id)
|
|
{
|
|
unset($this->display_blocks[$block_id]);
|
|
}
|
|
|
|
/**
|
|
* Returns a visible block.
|
|
*
|
|
* @param string $block_id
|
|
* @return DisplayBlock|null
|
|
*/
|
|
public function get_block($block_id)
|
|
{
|
|
if (isset($this->display_blocks[$block_id]))
|
|
{
|
|
return $this->display_blocks[$block_id];
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Changes the position of a block.
|
|
*
|
|
* @param string $block_id
|
|
* @param int $position
|
|
*/
|
|
public function set_block_position($block_id, $position)
|
|
{
|
|
if (isset($this->display_blocks[$block_id]))
|
|
{
|
|
$this->display_blocks[$block_id]->set_position($position);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Sorts the blocks.
|
|
*/
|
|
protected function sort_blocks()
|
|
{
|
|
uasort($this->display_blocks, array('BlockManager', 'cmp_by_position'));
|
|
}
|
|
|
|
/**
|
|
* Callback for blocks sorting.
|
|
*/
|
|
static protected function cmp_by_position($a, $b)
|
|
{
|
|
return $a->get_position() - $b->get_position();
|
|
}
|
|
|
|
/**
|
|
* Parse the menu and assign the result in a template variable.
|
|
*
|
|
* @param string $var
|
|
* @param string $file
|
|
*/
|
|
public function apply($var, $file)
|
|
{
|
|
global $template;
|
|
|
|
$template->set_filename('menubar', $file);
|
|
trigger_notify('blockmanager_apply', array($this) );
|
|
|
|
foreach ($this->display_blocks as $id=>$block)
|
|
{
|
|
if (empty($block->raw_content) and empty($block->template))
|
|
{
|
|
$this->hide_block($id);
|
|
}
|
|
}
|
|
$this->sort_blocks();
|
|
$template->assign('blocks', $this->display_blocks);
|
|
$template->assign_var_from_handle($var, 'menubar');
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Represents a menu block registered in a BlockManager object.
|
|
*/
|
|
class RegisteredBlock
|
|
{
|
|
/** @var string */
|
|
protected $id;
|
|
/** @var string */
|
|
protected $name;
|
|
/** @var string */
|
|
protected $owner;
|
|
|
|
/**
|
|
* @param string $id
|
|
* @param string $name
|
|
* @param string $owner
|
|
*/
|
|
public function __construct($id, $name, $owner)
|
|
{
|
|
$this->id = $id;
|
|
$this->name = $name;
|
|
$this->owner = $owner;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_id()
|
|
{
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_name()
|
|
{
|
|
return $this->name;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_owner()
|
|
{
|
|
return $this->owner;
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Represents a menu block ready for display in the BlockManager object.
|
|
*/
|
|
class DisplayBlock
|
|
{
|
|
/** @var RegisteredBlock */
|
|
protected $_registeredBlock;
|
|
/** @var int */
|
|
protected $_position;
|
|
/** @var string */
|
|
protected $_title;
|
|
|
|
/** @var mixed */
|
|
public $data;
|
|
/** @var string */
|
|
public $template;
|
|
/** @var string */
|
|
public $raw_content;
|
|
|
|
/**
|
|
* @param RegisteredBlock $block
|
|
*/
|
|
public function __construct($block)
|
|
{
|
|
$this->_registeredBlock = $block;
|
|
}
|
|
|
|
/**
|
|
* @return RegisteredBlock
|
|
*/
|
|
public function get_block()
|
|
{
|
|
return $this->_registeredBlock;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function get_position()
|
|
{
|
|
return $this->_position;
|
|
}
|
|
|
|
/**
|
|
* @param int $position
|
|
*/
|
|
public function set_position($position)
|
|
{
|
|
$this->_position = $position;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_title()
|
|
{
|
|
if (isset($this->_title))
|
|
{
|
|
return $this->_title;
|
|
}
|
|
else
|
|
{
|
|
return $this->_registeredBlock->get_name();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param string
|
|
*/
|
|
public function set_title($title)
|
|
{
|
|
$this->_title = $title;
|
|
}
|
|
}
|
|
|
|
?>
|