1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
=head1 NAME
Reaction::Manual::ActionPrototypes - 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|Reaction::UI::ViewPort::Collection::Grid::Member>
=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
|
