Editing How to make a Screen perform Actions


 Works in EPrints 3.2+

Please read the page on [[How_to_make_a_Screen_for_the_Admin_Section]] as this extends that information.

===What's happening===

The process has three parts:
# Some ''action'' buttons
# Some ''action'' routines
## A ''allow'' routine
## An ''action'' routine
# Where to go after the ''action'' completes

===Making the buttons===
The action buttons are the functionality that make the work... well, flow.

You need to define the "screen" (perl package) that contains the actions, and what the actions are.

The <code>$s->render_action_buttons</code> function takes a hash, which describes the set of buttons to display:
<pre>
    my %buttons = (
		    cancel   => $self->phrase( "action:cancel:title" ),
                    update   => $self->phrase( "action:update:title" ),
                    _order   => [ "update", "cancel" ],
                    _class   => "ep_form_button_bar"
	          );
    $f->appendChild( $s->render_action_buttons( %buttons ) );
</pre>
* <code>cancel   => $self->phrase( "action:cancel:title" )</code> describe one action button: the internal name for the action and the text to be used for that button. You may have any number of buttons.
*<code>_order</code> is a reference to a list defining the order for the buttons. With nothing defined, the order will be random.
*<code>_class</code> defines the css class to give to the div that contains the buttons.

The above code would produce the following (x)html:
<pre>
<div class="ep_form_button_bar">
 <input type="submit" class="ep_form_action_button"
        onclick="return EPJS_button_pushed( '_action_update' )"
        name="_action_update" value="Update">
 <input type="submit" class="ep_form_action_button"
        onclick="return EPJS_button_pushed( '_action_cancel' )"
        name="_action_cancel" value="Cancel">
 </div>
</pre>