File Coverage

blib/lib/CMS/Drupal/Modules/MembershipEntity/Membership.pm

Criterion	Covered	Total	%
statement	18	21	85.7
branch	0	2	0.0
condition			n/a
subroutine	6	7	85.7
pod			n/a
total	24	30	80.0

package CMS::Drupal::Modules::MembershipEntity::Membership;
$CMS::Drupal::Modules::MembershipEntity::Membership::VERSION = '0.092';
# ABSTRACT: Perl interface to a Drupal MembershipEntity membership

use strict;
use warnings;
use 5.010;

use Moo;
use Types::Standard qw/ :all /;
use Data::Dumper;

has mid       => ( is => 'ro', isa => Int, required => 1 );
has created   => ( is => 'ro', isa => Int, required => 1 );
has changed   => ( is => 'ro', isa => Int, required => 1 );
has uid       => ( is => 'ro', isa => Int, required => 1 );
has status    => ( is => 'ro', isa => Enum[ qw/0 1 2 3/ ], required => 1 );
has member_id => ( is => 'ro', isa => Str, required => 1 );
has type      => ( is => 'ro', isa => Str, required => 1 );
has terms     => ( is => 'ro', isa => HashRef, required => 1 );

sub is_active {
  my $self = shift;
  $self->{'_is_active'} = $self->{'status'} eq '1' ? 1 : 0;
  return $self->{'_is_active'};
}

sub has_renewal {
  my $self = shift;
  $self->{'_has_renewal'} = 0;
  foreach my $term ( values $self->{'terms'} ) {
    $self->{'_has_renewal'}++ if ($term->is_future and $term->is_active);
  }
  return $self->{'_has_renewal'};
}


1; ## return true to end package MembershipEntity::Membership

=pod

=head1 NAME

CMS::Drupal::Modules::MembershipEntity::Membership

=head1 VERSION

version 0.092

=head1 SYNOPSIS

 use CMS::Drupal::Modules::MembershipEntity::Membership;

 $mem = CMS::Drupal::Modules::MembershipEntity::Membership->new(
          'mid'       => '1234',
          'created'   => '1234565432',
          'changed'   => '1234567890',
          'uid'       => '5678',
          'status'    => '1',
          'member_id' => 'my_scheme_0123',
          'type'      => 'my_type',
          'terms'     => \%terms
        );

=head1 USAGE

Note: This module does not currently create or edit Memberships.

This module is not designed to be called directly, although it can be. This module is called by L, which has a method to retrieve all Memberships and create an object for each of them. Error checking is handled in the latter module, so if you use this module directly you will have to do your own error checking, for example, to make sure that the Membership actually has at least one Term associated with it. (Yes, I know it should be impossible not to, but it happens. This is Drupal we are dealing with.)

=head2 PARAMETERS

B Consult the Drupal MembershipEntity documentation for more details.

B The B for the Membership. Must be an integer.

B The date-and-time the Membership was created. Must be a Unix timestamp.

B The date-and-time the Membership was last changed. Must be a Unix timestamp.

B The Drupal user ID for the owner of the Membership. Must be an integer.

B The status of the Membership. Must be an integer from 0 to 3.

B The unique Member ID that Drupal assigns to the Membership. This is separate from the B and the B and can be configured by the Drupal sysadmin to take almost any string-y format.

B The Membership type.

B A hashref containing a L object for each term belonging to the Membership, keyed by the B (term ID).

=head2 METHODS

=over 4

=item is_active

Returns true if the Membership is active, as defined bythe value of the 'status' field in the database record.

=item has_renewal

Returns true if the Membership has a renewal Term that has not yet started. This is defined by the value of $term->is_future and $term->is_active both being true for at least one of the Membership's Terms.

=back

=head1 SEE ALSO

L

L

L

=cut