--- /dev/null
+=head1 Changes to the Action Prototype Mechanism
+
+=head1 DESCRIPTION
+
+After Reaction 0.001001 the API used to create links for different actions in
+the L<ViewPort::Collection::Grid|Reaction::UI::ViewPort::Collection::Grid>
+changed significantly. The aim of the changes was to create a simpler API that
+was more concise, flexible, and didn't tie unneccessary controller logic in the
+ViewPort layer.
+
+=head1 Major Changes
+
+=head2 Controller Layer
+
+=head3 L<Reaction::UI::Controller::Collection>
+
+=over 4
+
+=item The default display class for the C<list> action is now
+L<Grid|Reaction::UI::ViewPort::Collection::Grid>.
+
+=item Addition of the C<default_member_actions> and C<default_collection_actions>
+
+=item Addition of the C<_build_member_action_prototype> and
+C<_build_collection_action_prototype> methods. These are used by
+C<_build_action_viewport_args> to create prototypes for collection and member
+actions.
+
+=back
+
+=head3 L<Reaction::UI::Controller::Collection::CRUD>
+
+By default, enable C<create>, C<update>, C<delete>, C<delete_all>, actions.
+
+=head2 ViewPort Layer
+
+=head3 L<Reaction::UI::ViewPort::Collection::Grid>
+
+=over 4
+
+=item Add the C<member_action_count> attribute. It allows the controller to
+know how many actions to expect to lay out the UI properly.
+
+=item Default to member-class
+L<Grid::Member::WithActions|Reaction::UI::ViewPort::Collection::Grid::Member::WithActions>
+
+=back
+
+=head2 L<Reaction::UI::ViewPort::Role::Actions>
+
+Completely revamped the action-prototypes, added ordering support and moved to
+using the new C<ViewPort::URI|Reaction::UI::ViewPort::URI>.
+
+Most notably C<action_prototypes> is now a HASH ref.
+
+=head1 Migration
+
+In most cases, you shouldn't need to change much for migration, but if you had
+custom actions in your controllers that were linked to by the CRUD system, or
+you had excluded certain classes, you'll need to create some minor updates.
+
+=head2 A custom collection action in your controller.
+
+ #old code
+ sub custom_action { ... }
+ sub _build_action_viewport_map {
+ my $map = shift->next::method(@_);
+ $map->{custom_action} = 'Reaction::UI::ViewPort::Action';
+ return $map;
+ }
+ sub _build_action_viewport_args {
+ my $args = shift->next::method(@_);
+ my $custom_proto = {
+ label => 'Create',
+ action => sub { [ '', 'create', $_[1]->req->captures ] }
+ };
+ my $protos = $args->{list}->{action_prototypes};
+ push(@$protos, $custom_proto);
+ return $args;
+ }
+
+ #new code:
+ sub custom_action { ... }
+ sub _build_action_viewport_map {
+ my $map = shift->next::method(@_);
+ $map->{custom_action} = 'Reaction::UI::ViewPort::Action';
+ return $map;
+ }
+ sub _build_default_collection_actions {
+ [ @{shift->next::method(@_)}, 'custom_action'];
+ }
+
+=head2 A custom member action in your controller.
+
+ #old code
+ sub custom_action { ... }
+ sub _build_action_viewport_map {
+ my $map = shift->next::method(@_);
+ $map->{custom_action} = 'Reaction::UI::ViewPort::Action';
+ return $map;
+ }
+ sub _build_action_viewport_args {
+ my $args = shift->next::method(@_);
+ my $custom_proto = {
+ label => 'Create',
+ action => sub { [ '', 'create', $_[1]->req->captures ] }
+ };
+ my $protos = $args->{list}->{Member}->{action_prototypes};
+ push(@$protos, $custom_proto);
+ return $args;
+ }
+
+ #new code:
+ sub custom_action { ... }
+ sub _build_action_viewport_map {
+ my $map = shift->next::method(@_);
+ $map->{custom_action} = 'Reaction::UI::ViewPort::Action';
+ return $map;
+ }
+ sub _build_default_member_actions {
+ [ @{shift->next::method(@_)}, 'custom_action'];
+ }
+
+
+=head2 Disabling a default collection action
+
+ #old code
+ sub delete_all {}
+ sub _build_action_viewport_args {
+ my $args = shift->next::method(@_);
+ #remove the delete all action
+ my $protos = $args->{list}->{action_prototypes};
+ @$protos = grep { $_->{label} !~ /Delete all/i } @$protos;
+ return $args;
+ }
+
+ #new code
+ sub delete_all {}
+ sub _build_default_collection_actions {
+ [ grep {$_ ne 'delete_all'} @{ shift->next::method(@_) } ];
+ }
+
+ #or ...
+ sub delete_all {}
+ sub _build_action_viewport_args {
+ my $args = shift->next::method(@_);
+ my $protos = $args->{list}->{action_prototypes};
+ delete $protos->{delete_all};
+ return $args;
+ }
+
+
+=head2 Changing the label of a collection action
+
+ #old code
+ sub _build_action_viewport_args {
+ my $args = shift->next::method(@_);
+ my $protos = $args->{list}->{action_prototypes};
+ $proto = grep { $_->{label} eq 'Delete all' } @$protos;
+ $proto->{label} = 'New Label';
+ return $args;
+ }
+
+ #new code
+ sub delete_all {}
+ sub _build_action_viewport_args {
+ my $args = shift->next::method(@_);
+ my $protos = $args->{list}->{action_prototypes};
+ $proto->{delete_all}->{label} = 'New Label';
+ return $args;
+ }
+
+ #or ...
+ __PACKAGE__->config(action => { list => { ViewPort => {
+ action_prototypes => { delete_all => {label => 'New Label'} }
+ },
+ );
+
+=cut
projects / catagits/Reaction.git / commitdiff