SL/Controller/RequirementSpecTextBlock.pm

   1 package SL::Controller::RequirementSpecTextBlock;
   2
   3 use strict;
   4
   5 use parent qw(SL::Controller::Base);
   6
   7 use Carp;
   8 use Params::Validate ();
   9 use Time::HiRes ();
  10
  11 use SL::ClientJS;
  12 use SL::Clipboard;
  13 use SL::Controller::Helper::RequirementSpec;
  14 use SL::DB::RequirementSpec;
  15 use SL::DB::RequirementSpecPicture;
  16 use SL::DB::RequirementSpecPredefinedText;
  17 use SL::DB::RequirementSpecTextBlock;
  18 use SL::Helper::Flash;
  19 use SL::Locale::String;
  20
  21 use Rose::Object::MakeMethods::Generic
  22 (
  23   scalar                  => [ qw(text_block picture) ],
  24   'scalar --get_set_init' => [ qw(predefined_texts js) ],
  25 );
  26
  27 __PACKAGE__->run_before('load_requirement_spec_text_block', only => [qw(ajax_edit ajax_update ajax_delete ajax_flag dragged_and_dropped ajax_copy ajax_add_picture)]);
  28
  29 #
  30 # actions
  31 #
  32
  33 sub action_ajax_list {
  34   my ($self) = @_;
  35
  36   my $result        = { };
  37   my $current_where = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type});
  38   my $new_where;
  39
  40   if ($::form->{clicked_type} =~ m/^text-blocks-(front|back)/) {
  41     $new_where = $1 eq 'front' ? 0 : 1;
  42
  43   } else {
  44     $new_where = $self->output_position_from_id($::form->{clicked_id});
  45   }
  46
  47   # $::lxdebug->message(0, "cur $current_where new $new_where");
  48
  49   $self->show_list(output_position => $new_where, id => $::form->{clicked_id}, set_type => 1) if ($new_where != ($current_where // -1));
  50
  51   $self->render($self->js);
  52 }
  53
  54 sub action_ajax_add {
  55   my ($self) = @_;
  56
  57   my $current_where = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type}) // -1;
  58   my $new_where     = $self->output_position_from_id($::form->{id})                                                  // $::form->{output_position};
  59
  60   $self->show_list(output_position => $new_where) if $new_where != $current_where;
  61
  62   $self->add_new_text_block_form(output_position => $new_where, insert_after_id => $::form->{id}, requirement_spec_id => $::form->{requirement_spec_id});
  63
  64   $self->invalidate_version->render($self);
  65 }
  66
  67 sub action_ajax_edit {
  68   my ($self) = @_;
  69
  70   my $current_where = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type}) // -1;
  71
  72   if ($self->text_block->output_position != $current_where) {
  73     $self->show_list(output_position => $self->text_block->output_position, id => $self->text_block->id, requirement_spec_id => $self->text_block->requirement_spec_id);
  74   }
  75
  76   my $html = $self->render('requirement_spec_text_block/_form', { output => 0 });
  77
  78   $self->js
  79      ->hide('#text-block-' . $self->text_block->id)
  80      ->remove('#edit_text_block_' . $self->text_block->id . '_form')
  81      ->insertAfter($html, '#text-block-' . $self->text_block->id)
  82      ->jstree->select_node('#tree', '#tb-' . $self->text_block->id)
  83      ->focus('#edit_text_block_' . $self->text_block->id . '_title')
  84      ->render($self);
  85 }
  86
  87 sub action_ajax_create {
  88   my ($self, %params) = @_;
  89
  90   my $attributes   = $::form->{ $::form->{form_prefix} } || die "Missing attributes";
  91   my $insert_after = delete $attributes->{insert_after};
  92
  93   my @errors = $self->text_block(SL::DB::RequirementSpecTextBlock->new(%{ $attributes }))->validate;
  94   return SL::ClientJS->new->error(@errors)->render($self) if @errors;
  95
  96   $self->text_block->save;
  97   $self->text_block->add_to_list(position => 'after', reference => $insert_after) if $insert_after;
  98
  99   my $html = $self->render('requirement_spec_text_block/_text_block', { output => 0 }, text_block => $self->text_block);
 100   my $node = $self->presenter->requirement_spec_text_block_jstree_data($self->text_block);
 101
 102   $self->invalidate_version
 103     ->hide('#text-block-list-empty')
 104     ->replaceWith('#' . $::form->{form_prefix} . '_form', $html)
 105     ->jstree->create_node('#tree', $insert_after ? ('#tb-' . $insert_after, 'after') : ('#tb-' . ($attributes->{output_position} == 0 ? 'front' : 'back'), 'last'), $node)
 106     ->jstree->select_node('#tree', '#tb-' . $self->text_block->id);
 107   $self->add_new_text_block_form(output_position => $self->text_block->output_position, insert_after_id => $self->text_block->id, requirement_spec_id => $self->text_block->requirement_spec_id)
 108     ->render($self);
 109 }
 110
 111 sub action_ajax_update {
 112   my ($self, %params) = @_;
 113
 114   my $prefix     = $::form->{form_prefix} || 'text_block';
 115   my $attributes = $::form->{$prefix}     || {};
 116
 117   foreach (qw(requirement_spec_id output_position position)) {
 118     delete $attributes->{$_} if !defined $attributes->{$_};
 119   }
 120
 121   my @errors = $self->text_block->assign_attributes(%{ $attributes })->validate;
 122   return SL::ClientJS->new->error(@errors)->render($self) if @errors;
 123
 124   $self->text_block->save;
 125
 126   my $html = $self->render('requirement_spec_text_block/_text_block', { output => 0 }, text_block => $self->text_block);
 127
 128   $self->invalidate_version
 129     ->remove('#' . $prefix . '_form')
 130     ->replaceWith('#text-block-' . $self->text_block->id, $html)
 131     ->jstree->rename_node('#tree', '#tb-' . $self->text_block->id, $self->text_block->title)
 132     ->render($self);
 133 }
 134
 135 sub action_ajax_delete {
 136   my ($self) = @_;
 137
 138   my $current_where = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type}) // -1;
 139   if ($self->text_block->output_position == $current_where) {
 140     $self->js
 141        ->remove('#edit_text_block_' . $self->text_block->id . '_form')
 142        ->remove('#text-block-' . $self->text_block->id);
 143
 144     $self->js->show('#text-block-list-empty') if 1 == scalar @{ $self->text_block->get_full_list };
 145   }
 146
 147   $self->text_block->delete;
 148
 149   $self->invalidate_version
 150      ->jstree->delete_node('#tree', '#tb-' . $self->text_block->id)
 151      ->render($self);
 152 }
 153
 154 sub action_ajax_flag {
 155   my ($self) = @_;
 156
 157   $self->text_block->update_attributes(is_flagged => !$self->text_block->is_flagged);
 158
 159   my $current_where = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type});
 160
 161   SL::ClientJS->new
 162    ->action_if($current_where == $self->text_block->output_position, 'toggleClass', '#text-block-' . $self->text_block->id, 'flagged')
 163    ->toggleClass('#tb-' . $self->text_block->id, 'flagged')
 164    ->render($self);
 165 }
 166
 167 sub action_dragged_and_dropped {
 168   my ($self)       = @_;
 169
 170   my $position           = $::form->{position} =~ m/^ (?: before | after | last ) $/x ? $::form->{position}                                                      : die "Unknown 'position' parameter";
 171   my $dropped_text_block = $position           =~ m/^ (?: before | after ) $/x        ? SL::DB::RequirementSpecTextBlock->new(id => $::form->{dropped_id})->load : undef;
 172
 173   my $dropped_type       = $position ne 'last' ? undef : $::form->{dropped_type} =~ m/^ text-blocks- (?:front|back) $/x ? $::form->{dropped_type} : die "Unknown 'dropped_type' parameter";
 174   my $old_where          = $self->text_block->output_position;
 175
 176   $self->text_block->db->do_transaction(sub {
 177     1;
 178     $self->text_block->remove_from_list;
 179     $self->text_block->output_position($position =~ m/before|after/ ? $dropped_text_block->output_position : $::form->{dropped_type} eq 'text-blocks-front' ? 0 : 1);
 180     $self->text_block->add_to_list(position => $position, reference => $dropped_text_block ? $dropped_text_block->id : undef);
 181   });
 182
 183   # $::lxdebug->dump(0, "form", $::form);
 184
 185   $self->invalidate_version
 186     ->jstree->open_node('#tree', '#tb-' . (!$self->text_block->output_position ? 'front' : 'back'));
 187
 188   return $self->js->render($self) if $::form->{current_content_type} !~ m/^text-block/;
 189
 190   my $current_where = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type}) // -1;
 191   my $new_where     = $self->text_block->output_position;
 192   my $id            = $self->text_block->id;
 193
 194   # $::lxdebug->message(0, "old $old_where current $current_where new $new_where current_CID " . $::form->{current_content_id} . ' selfid ' . $self->text_block->id);
 195   if (($old_where != $new_where) && ($::form->{current_content_id} == $self->text_block->id)) {
 196     # The currently selected text block is dragged to the opposite
 197     # text block location. Re-render the whole content column.
 198     $self->show_list(output_position => $new_where, id => $id);
 199
 200   } else {
 201     if ($old_where == $current_where) {
 202       $self->js->remove('#text-block-' . $self->text_block->id);
 203
 204       if (0 == scalar(@{ SL::DB::Manager::RequirementSpecTextBlock->get_all(where => [ requirement_spec_id => $self->text_block->requirement_spec_id, output_position => $current_where ]) })) {
 205         $self->js->show('#text-block-list-empty');
 206       }
 207     }
 208
 209     if ($new_where == $current_where) {
 210       $self->js->hide('#text-block-list-empty');
 211
 212       my $html             = "" . $self->render('requirement_spec_text_block/_text_block', { output => 0 }, text_block => $self->text_block);
 213       $html                =~ s/^\s+//;
 214       my $prior_text_block = $self->text_block->get_previous_in_list;
 215
 216       if ($prior_text_block) {
 217         $self->js->insertAfter($html, '#text-block-' . $prior_text_block->id);
 218       } else {
 219         $self->js->prependTo($html, '#text-block-list');
 220       }
 221     }
 222   }
 223
 224   $self->js->render($self);
 225 }
 226
 227 sub action_ajax_copy {
 228   my ($self, %params) = @_;
 229
 230   SL::Clipboard->new->copy($self->text_block);
 231   SL::ClientJS->new->render($self);
 232 }
 233
 234 sub action_ajax_paste {
 235   my ($self, %params) = @_;
 236
 237   my $copied = SL::Clipboard->new->get_entry(qr/^RequirementSpecTextBlock$/);
 238   if (!$copied) {
 239     return SL::ClientJS->new
 240       ->error(t8("The clipboard does not contain anything that can be pasted here."))
 241       ->render($self);
 242   }
 243
 244   my $current_output_position = $self->output_position_from_id($::form->{current_content_id}, $::form->{current_content_type});
 245   my $new_output_position     = $::form->{id} ? $self->output_position_from_id($::form->{id}) : $::form->{output_position};
 246   my $front_back              = 0 == $new_output_position ? 'front' : 'back';
 247
 248   $self->text_block($copied->to_object);
 249   $self->text_block->update_attributes(requirement_spec_id => $::form->{requirement_spec_id}, output_position => $new_output_position);
 250   $self->text_block->add_to_list(position => 'after', reference => $::form->{id}) if $::form->{id};
 251
 252   if ($current_output_position == $new_output_position) {
 253     my $html = $self->render('requirement_spec_text_block/_text_block', { output => 0 }, text_block => $self->text_block);
 254     $self->js->action($::form->{id} ? 'insertAfter' : 'appendTo', $html, '#text-block-' . ($::form->{id} || 'list'));
 255   }
 256
 257   my $node = $self->presenter->requirement_spec_text_block_jstree_data($self->text_block);
 258   $self->invalidate_version
 259     ->jstree->create_node('#tree', $::form->{id} ? ('#tb-' . $::form->{id}, 'after') : ("#tb-${front_back}", 'last'), $node)
 260     ->render($self);
 261 }
 262
 263 #
 264 # actions for pictures
 265 #
 266
 267 sub action_ajax_add_picture {
 268   my ($self) = @_;
 269
 270   $self->picture(SL::DB::RequirementSpecPicture->new);
 271   $self->render('requirement_spec_text_block/_picture_form', { layout => 0 });
 272 }
 273
 274 sub action_ajax_edit_picture {
 275   my ($self) = @_;
 276
 277   $self->picture(SL::DB::RequirementSpecPicture->new(id => $::form->{picture_id})->load);
 278   $self->text_block($self->picture->text_block);
 279   $self->render('requirement_spec_text_block/_picture_form', { layout => 0 });
 280 }
 281
 282 sub action_ajax_create_picture {
 283   my ($self, %params)              = @_;
 284
 285   my $attributes                   = $::form->{ $::form->{form_prefix} } || die "Missing attributes";
 286   $attributes->{picture_file_name} = ((($::form->{ATTACHMENTS} || {})->{ $::form->{form_prefix} } || {})->{picture_content} || {})->{filename};
 287   my @errors                       = $self->picture(SL::DB::RequirementSpecPicture->new(%{ $attributes }))->validate;
 288
 289   return $self->js->error(@errors)->render($self) if @errors;
 290
 291   $self->picture->save;
 292
 293   $self->text_block($self->picture->text_block);
 294   my $html = $self->render('requirement_spec_text_block/_text_block_picture', { output => 0 }, picture => $self->picture);
 295
 296   $self->invalidate_version
 297     ->dialog->close('#jqueryui_popup_dialog')
 298     ->append('#text-block-' . $self->text_block->id . '-pictures', $html)
 299     ->show('#text-block-' . $self->text_block->id . '-pictures')
 300     ->render($self);
 301 }
 302
 303 sub action_ajax_update_picture {
 304   my ($self)     = @_;
 305
 306   my $attributes = $::form->{ $::form->{form_prefix} } || die "Missing attributes";
 307   $self->picture(SL::DB::RequirementSpecPicture->new(id => $::form->{id})->load);
 308
 309   if (!$attributes->{picture_content}) {
 310     delete $attributes->{picture_content};
 311   } else {
 312     $attributes->{picture_file_name} = ((($::form->{ATTACHMENTS} || {})->{ $::form->{form_prefix} } || {})->{picture_content} || {})->{filename};
 313   }
 314
 315   $self->picture->assign_attributes(%{ $attributes });
 316   my @errors = $self->picture->validate;
 317
 318   return $self->js->error(@errors)->render($self) if @errors;
 319
 320   $self->picture->save;
 321
 322   $self->text_block($self->picture->text_block);
 323   my $html = $self->render('requirement_spec_text_block/_text_block_picture', { output => 0 }, picture => $self->picture);
 324
 325   $self->invalidate_version
 326     ->dialog->close('#jqueryui_popup_dialog')
 327     ->replaceWith('#text-block-picture-' . $self->picture->id, $html)
 328     ->show('#text-block-' . $self->text_block->id . '-pictures')
 329     ->render($self);
 330 }
 331
 332 sub action_ajax_delete_picture {
 333   my ($self) = @_;
 334
 335   $self->picture(SL::DB::RequirementSpecPicture->new(id => $::form->{id})->load);
 336   $self->picture->delete;
 337   $self->text_block(SL::DB::RequirementSpecTextBlock->new(id => $self->picture->text_block_id)->load);
 338
 339   $self->invalidate_version
 340     ->remove('#text-block-picture-' . $self->picture->id)
 341     ->action_if(!@{ $self->text_block->pictures }, 'hide', '#text-block-' . $self->text_block->id . '-pictures')
 342     ->render($self);
 343 }
 344
 345 sub action_ajax_download_picture {
 346   my ($self) = @_;
 347
 348   $self->picture(SL::DB::RequirementSpecPicture->new(id => $::form->{id})->load);
 349   $self->send_file(\$self->picture->{picture_content}, type => $self->picture->picture_content_type, name => $self->picture->picture_file_name);
 350 }
 351
 352 #
 353 # filters
 354 #
 355
 356 sub load_requirement_spec_text_block {
 357   my ($self) = @_;
 358   $self->text_block(SL::DB::RequirementSpecTextBlock->new(id => $::form->{id})->load || die "No such requirement spec text block");
 359 }
 360
 361 #
 362 # helpers
 363 #
 364
 365 sub output_position_from_id {
 366   my ($self, $id, $type, %params) = @_;
 367
 368   if ($type) {
 369     return $1 eq 'front' ? 0 : 1 if $type =~ m/-(front|back)$/;
 370     return undef                 if $type !~ m/text-block/;
 371   }
 372
 373   my $text_block = $id ? SL::DB::Manager::RequirementSpecTextBlock->find_by(id => $id) : undef;
 374
 375   return $text_block ? $text_block->output_position : undef;
 376 }
 377
 378 sub init_predefined_texts {
 379   return SL::DB::Manager::RequirementSpecPredefinedText->get_all_sorted;
 380 }
 381
 382 sub init_js {
 383   my ($self) = @_;
 384   $self->js(SL::ClientJS->new);
 385 }
 386
 387 sub invalidate_version {
 388   my ($self) = @_;
 389
 390   my $html   = $self->render('requirement_spec/_version', { output => 0 },
 391                              requirement_spec => SL::DB::RequirementSpec->new(id => $::form->{requirement_spec_id} || $self->text_block->requirement_spec_id)->load);
 392   return $self->js->html('#requirement_spec_version', $html);
 393 }
 394
 395 sub add_new_text_block_form {
 396   my ($self, %params) = @_;
 397
 398   croak "Missing parameter output_position"     unless defined($params{output_position}) && ($params{output_position} ne '');
 399   croak "Missing parameter requirement_spec_id" unless $params{requirement_spec_id};
 400
 401   $self->text_block(SL::DB::RequirementSpecTextBlock->new(
 402     requirement_spec_id => $params{requirement_spec_id},
 403     output_position     => $params{output_position},
 404   ));
 405
 406   my $id_base = join('_', 'new_text_block', Time::HiRes::gettimeofday(), int rand 1000000000000);
 407   my $html    = $self->render('requirement_spec_text_block/_form', { output => 0 }, id_base => $id_base, insert_after => $params{insert_after_id});
 408
 409   $self->js
 410      ->action($params{insert_after_id} ? 'insertAfter' : 'appendTo', $html, '#text-block-' . ($params{insert_after_id} || 'list'))
 411      ->focus('#' . $id_base . '_title');
 412 }
 413
 414 sub show_list {
 415   my $self   = shift;
 416   my %params = Params::Validate::validate(@_, { output_position => 1, id => 0, requirement_spec_id => 0, set_type => 0, });
 417
 418   $params{requirement_spec_id} ||= $::form->{requirement_spec_id};
 419   croak "Unknown requirement_spec_id" if !$params{requirement_spec_id};
 420
 421   my $text_blocks = SL::DB::Manager::RequirementSpecTextBlock->get_all_sorted(where => [ output_position => $params{output_position}, requirement_spec_id => $params{requirement_spec_id} ]);
 422   my $html        = $self->render('requirement_spec_text_block/ajax_list', { output => 0 }, TEXT_BLOCKS => $text_blocks, output_position => $params{output_position});
 423
 424   $self->js->html('#column-content', $html);
 425
 426   $self->js->val('#current_content_type', 'text-blocks-' . (0 == $params{output_position} ? 'front' : 'back')) if $params{id} || $params{set_type};
 427   $self->js->val('#current_content_id',   $params{id})                                                         if $params{id};
 428
 429   return $self->set_function_blocks_tab_menu_class(class => 'text-block-context-menu');
 430 }
 431
 432 1;