NAME

CatalystX::Resource::TraitFor::Controller::Resource::Sortable - makes your resource sortable

VERSION

version 0.03

SYNOPSIS

# TestApp.pm
'Controller::Resource::Artist' => {
    resultset_key => 'artists',
    resource_key => 'artist',
    form_class => 'TestApp::Form::Resource::Artist',
    model => 'DB::Resource::Artist',
    redirect_mode => 'list',
    traits => ['Sortable'],
    actions => {
        base => {
            PathPart => 'artists',
        },
    },
},

# TestApp/Schema/Result/Resource/Artist.pm
__PACKAGE__->load_components(qw/ Ordered Core /);
__PACKAGE__->table('artist');
__PACKAGE__->add_columns(
    ...,
    'position',
    {
        data_type => 'integer',
        is_numeric => 1,
        is_nullable => 0,
    },
);

__PACKAGE__->resultset_attributes({ order_by => 'position' });
__PACKAGE__->position_column('position');

DESCRIPTION

adds these paths to your Controller which call move_previous/move_next on your resource item as provided by DBIx::Class::Ordered

Make sure the schema for your sortable resource has a 'position' column.

/resource/*/move_previous
/resource/*/move_next

For nested resources you need to set a grouping_column Example: Artist has_many Albums has_many Songs

# TestApp/Schema/Result/Resource/Song.pm
__PACKAGE__->grouping_column('album_id');

After a move operation you will always be redirected to the referer If no referer header is foudn you'll be redirected to '/'

ACTIONS

move_next

will switch the resource with the next one

move_previous

will switch the resource with the previous one

move_to

move resource to denoted position

AUTHOR

David Schmidt <davewood@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by David Schmidt.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.