NAME

Krang::CGI::Media - web interface to manage media

SYNOPSIS

  use Krang::ClassLoader 'CGI::Media';
  my $app = pkg('CGI::Media')->new();
  $app->run();

DESCRIPTION

Krang::CGI::Media provides a web-based system through which users can add, modify, delete, check out, or publish media.

INTERFACE

Following are descriptions of all the run-modes provided by Krang::CGI::Media.

The default run-mode (start_mode) for Krang::CGI::Media is 'add'.

Run-Modes

• find

  The find mode allows the user to run simple and advanced searches on live media objects, which will be listed on paging view 'Find Media'.

  From this paging view the user may choose to view, edit or retire an object, or select a set of objects to be checked out to the workspace, published or deleted (depending on the user's permission set).

• list_retired

  The list_retired mode allows the user to run simple and advanced searches on retired media objects, which will be listed on paging view 'Retired Media'.

  From this paging view the user may choose to view or unretire an object, or select a set of objects to be deleted (depending on the user's permission set).

• advanced_find

  This method is deprecated, but left in here for backwards compatibility.

  The find mode allows the user to run an ``advanced search'' on media objects, which will be listed on a paging view.

  From this paging view the user may choose to edit or view an object, or select a set of objects to be deleted.

• list_active

  List all active media. Provide links to view each media object. If the user has 'checkin all' admin abilities then checkboxes are provided to allow the media to be checked-in.

• add_media

  The ``add_media'' run-mode displays the form through which new Media objects may be added to Krang.

• checkin_add

  Save the new media object, then check it in. Redirect to My Workspace afterwards, even tho the media object will not be there.

• save_stay_add

  Saves the new object and redirects to edit screen (Triggered by 'create' button.)

• checkout_and_edit

  Checks out the media object identified by media_id and sends the user to edit.

• edit

  The ``edit'' mode displays the form through which users may edit existing Media objects.

• save_edit

  Validate and save the form content to the media object. Redirect the user to their Workspace.

• checkin_edit

  Validate and save the form content to the media object. Checkin media object. Redirect the user to their Workspace.

• save_stay_edit

  Validate and save the form content to the media object. Return the user to the edit screen.

• delete

  Trashes the media object specified by CGI form parameter 'media_id'. Redirect user to Workspace.

• delete_selected

  Trashes the media objects which have been selected (checked) from the find mode list view. This mode expects selected media objects to be specified in the CGI param krang_pager_rows_checked.

• retire_selected

  Retires the media objects which have been selected (checked) from the find mode list view. This mode expects selected media objects to be specified in the CGI param krang_pager_rows_checked.

• save_and_edit_schedule

  This mode saves the current data to the session and passes control to edit schedule for media.

• save_and_associate_media

  The purpose of this mode is to hand the user off to the associate contribs screen. This mode writes changes back to the media object without calling save(). When done, it performs an HTTP redirect to:

    contributor.pl?rm=associate_media

• save_and_publish

  This mode writes changes back to the media object, calls save() and then redirects to publisher.pl to publish the media object.

This mode writes changes back to the media object, calls save() and then redirects to publisher.pl to preview the media object.

• save_and_view_log

  The purpose of this mode is to hand the user off to the log viewing screen. This mode writes changes back to the media object without calling save(). When done, it performs an HTTP redirect to history.pl.

• view_log

  The purpose of this mode is to hand the user off to the log viewing screen but preserving where we came from.

• view

  Display the specified media object in a view form.

• view_version

  Display the specified version of the media object in a view form.

• revert_version

  Send the user to an edit screen, replacing the object with the specified version of itself.

• checkin_selected

  Checkin all the media which were checked on the list_active screen.

• checkout_selected

  Checkout all the media which were checked on the list_active screen.

• save_and_jump

  This mode saves the current data to the session and jumps to editing an element within the media.

• save_and_bulk_edit

  This mode saves the current element data to the session and goes to the bulk edit mode.

• save_and_change_bulk_edit_sep

  Saves and changes the bulk edit separator, returning to edit.

• save_and_leave_bulk_edit

  This mode saves the current element data to the session and goes to the edit mode.

• save_and_go_up

  This mode saves the current element data to the session and jumps to edit the parent of this element.

• retire

  Move media to the retire and return to the Find Media screen.

• unretire

  Move media from retire back to live. If a DuplicateURL conflict occurs, leave the media retired and alert the user.