index c96a0eda623374891b472e6a4ca2da6bd371abfe..ef2d25275f8e804085b50f841091ce2c858cdee9 100644 (file)
...
|->tab object for dn n
+
+Other functions implemented:
+============================
+
+CLASS tab
+ - multiple_support_available() Check if there is at least one plugin with
+ enabled multiple edit support
+ - enable_multiple_support() Enable multiple edit, for this tab.
+
+CLASS plugin
+ - enable_multiple_support() Enable multiple support for this plugin.
+ - init_multiple_support() Init summy object, to preset some values.
+ - multiple_execute() Display dummy object ui.
+ - multiple_save_object() Get posted values in multiple edit mode.
+ - multiple_check() Check values specified in dummy object.
+ - get_multi_edit_values() Get values changed from dummy object.
+ - set_multi_edit_values() Set values collected with get_multi_edit_values.
+ to all objects currently edited.
+
+
+Process:
+========
+
+multi_plug::multi_plug()
+ |->o_tab = new tab() #Initialize ui handle
+ |
+ |->handles
+ | |->handles[] = new tab() #Initialize objects we want to edit at once
+ |
+ |->o_tab->enable_multiple_support() #Enable multiple support for ui handle
+ |->detect_multiple_used_attributes() #Update ui handle with some default values
+ |->handles[]
+ |->by_object->get_multi_init_values() #Get attributes from all handles
+ |->o_tab
+ |->by_object->init_multiple_support() #Assign values to ui handle
+ |
+ |->execute() #Display ui
+ | |->o_tab->execute()
+ |->by_object->multiple_execute()
+ |
+ |->check() #Check given values
+ |->o_tab->check()
+ |->by_object->multiple_check()
+ |
+ |->save_object() #Save posts
+ |->o_tab->save_object()
+ |->by_object->multiple_save_object()
+ |
+ |->save() #Save collected values
+ |->populate_values() #Populate values to all handles
+ |->o_tab->get_multi_edit_values() #Get values to populate
+ |->handles->set_multi_edit_values() #Set values
+ |->handles->save() #Save handles
+
+
+
+
Using this class:
=================
Simple Example:
public $config = NULL;
private $s_class= "";
public $current = "";
+ public $by_object = array();
+ public $by_name = array();
/*! \brief Creates a multi_plug object
@param object $config GOsa Configuration object
*/
$this->o_tab = new $class($config,$tab,"new",$acl_category);
$this->o_tab->set_acl_base($acl_base);
+ $this->by_object = &$this->o_tab->by_object;
+ $this->by_name = &$this->o_tab->by_name;
+ $this->current = &$this->o_tab->current;
/* Check if the specified tab object supports multiple edits
*/
*/
private function array_combine($base,$add)
{
+
foreach($add as $key => $attr) {
if(!is_numeric($key)){
+
+ if(!is_array($add[$key])){
+ $add[$key] = array('count' => 1,$add[$key]);
+ }
+
if(!isset($base[$key])){
$base[$key] = $add[$key];
- }elseif(is_array($add[$key])){
+ }else{
+
+ if(!isset($base[$key]['count'])){
+ $base[$key]['count'] = count($base[$key]);
+ }
+
+ if(!isset($add[$key]['count'])){
+ $add[$key]['count'] = count($add[$key]);
+ }
for($i=0;$i<$add[$key]['count'];$i++){
if(!in_array($add[$key][$i],$base[$key])){
$base[$key][] = $add[$key][$i];
}elseif(is_string($base[$key]) && $base[$key]!=$minus[$key]){
unset($base[$key]);
}elseif(is_array($base[$key])){
+ $tmp = array();
+ if(!isset($base[$key]['count'])){
+ $base[$key]['count'] = count($base[$key]);
+ }
for($i = 0 ; $i < $base[$key]['count'] ; $i ++){
- if(isset($base[$key][$i]) && !in_array($base[$key][$i],$minus[$key])){
- $base[$key]['count'] --;
- if($base[$key]['count'] == 0){
- unset($base[$key]);
- break;
- }else{
- unset($base[$key][$i]);
- }
+ if(isset($base[$key][$i]) && in_array($base[$key][$i],$minus[$key])){
+ $tmp[] = $base[$key][$i];
}
}
+ if(count($tmp)){
+ $tmp['count'] = count($tmp);
+ $base[$key] = $tmp;
+ }else{
+ unset($base[$key]);
+ }
}
}
return($base);
/*! \brief Detect values that are used in all edited objects.
- * @returns array All multiple used attributes
*/
private function detect_multiple_used_attributes()
{
- $attrs = array();
- $first = $this->o_tab->current;
- $all = array();
- foreach($this->a_handles as $handle){
- if(count($attrs) == 0){
- $attrs = $handle->by_object[$first]->attrs;
- }else{
- $attrs = $this->array_intersect($attrs,$handle->by_object[$first]->attrs);
+ foreach($this->o_tab->by_object as $name => $plug){
+
+ if(empty($name)) continue;
+
+ $attrs = array();
+ $all = array();
+ foreach($this->a_handles as $hid => $handle){
+ $h_attrs = $this->a_handles[$hid]->by_object[$name]->get_multi_init_values();
+ if(count($attrs) == 0){
+ $attrs = $h_attrs;
+ }else{
+ $attrs = $this->array_intersect($attrs,$h_attrs);
+ }
+ $all = $this->array_combine($all,$h_attrs);
}
- $all = $this->array_combine($all,$handle->by_object[$first]->attrs);
- }
- foreach($this->o_tab->by_object as $name => $obj){
$this->o_tab->by_object[$name]->init_multiple_support($attrs,$all);
}
}
*/
public function execute()
{
- return($this->o_tab->execute());
+ $str = $this->o_tab->execute();
+ return($str);
}