rt 4.2.14 (#13852)

[freeside.git] / rt / lib / RT / CachedGroupMembers.pm

diff --git a/rt/lib/RT/CachedGroupMembers.pm b/rt/lib/RT/CachedGroupMembers.pm
index c75a654..f3d0bf0 100644 (file)
--- a/rt/lib/RT/CachedGroupMembers.pm
+++ b/rt/lib/RT/CachedGroupMembers.pm
@@ -2,7 +2,7 @@
 #
 # COPYRIGHT:
 #
-# This software is Copyright (c) 1996-2011 Best Practical Solutions, LLC
+# This software is Copyright (c) 1996-2017 Best Practical Solutions, LLC
 #                                          <sales@bestpractical.com>
 #
 # (Except where explicitly superseded by other copyright notices)
@@ -46,78 +46,135 @@
 #
 # END BPS TAGGED BLOCK }}}
 
-# Autogenerated by DBIx::SearchBuilder factory (by <jesse@bestpractical.com>)
-# WARNING: THIS FILE IS AUTOGENERATED. ALL CHANGES TO THIS FILE WILL BE LOST.  
-# 
-# !! DO NOT EDIT THIS FILE !!
-#
-
-use strict;
-
-
 =head1 NAME
 
-  RT::CachedGroupMembers -- Class Description
- 
+  RT::CachedGroupMembers - a collection of RT::GroupMember objects
+
 =head1 SYNOPSIS
 
-  use RT::CachedGroupMembers
+  use RT::CachedGroupMembers;
 
 =head1 DESCRIPTION
 
 
 =head1 METHODS
 
+
+
 =cut
 
+
 package RT::CachedGroupMembers;
 
-use RT::SearchBuilder;
+use strict;
+use warnings;
+
+use base 'RT::SearchBuilder';
+
 use RT::CachedGroupMember;
 
-use vars qw( @ISA );
-@ISA= qw(RT::SearchBuilder);
+sub Table { 'CachedGroupMembers'}
+
+# {{{ LimitToUsers
 
+=head2 LimitToUsers
 
-sub _Init {
+Limits this search object to users who are members of this group
+This is really useful when you want to have your UI separate out
+groups from users for display purposes
+
+=cut
+
+sub LimitToUsers {
     my $self = shift;
-    $self->{'table'} = 'CachedGroupMembers';
-    $self->{'primary_key'} = 'id';
 
+    my $principals = $self->Join(
+        ALIAS1 => 'main', FIELD1 => 'MemberId',
+        TABLE2 => 'Principals', FIELD2 =>'id'
+    );
 
-    return ( $self->SUPER::_Init(@_) );
+    $self->Limit(       ALIAS => $principals,
+                         FIELD => 'PrincipalType',
+                         VALUE => 'User',
+                         ENTRYAGGREGATOR => 'OR',
+                         );
 }
 
 
-=head2 NewItem
 
-Returns an empty new RT::CachedGroupMember item
+
+=head2 LimitToGroups
+
+Limits this search object to Groups who are members of this group
+This is really useful when you want to have your UI separate out
+groups from users for display purposes
 
 =cut
 
-sub NewItem {
+sub LimitToGroups {
     my $self = shift;
-    return(RT::CachedGroupMember->new($self->CurrentUser));
+
+    my $principals = $self->Join(
+        ALIAS1 => 'main', FIELD1 => 'MemberId',
+        TABLE2 => 'Principals', FIELD2 =>'id'
+    );
+
+
+    $self->Limit(       ALIAS => $principals,
+                         FIELD => 'PrincipalType',
+                         VALUE => 'Group',
+                         ENTRYAGGREGATOR => 'OR',
+                         );
 }
-RT::Base->_ImportOverlays();
 
-=head1 SEE ALSO
 
-This class allows "overlay" methods to be placed
-into the following files _Overlay is for a System overlay by the original author,
-_Vendor is for 3rd-party vendor add-ons, while _Local is for site-local customizations.  
 
-These overlay files can contain new subs or subs to replace existing subs in this module.
+=head2 LimitToMembersOfGroup PRINCIPAL_ID
+
+Takes a Principal Id as its only argument. 
+Limits the current search principals which are _directly_ members
+of the group which has PRINCIPAL_ID as its principal id.
+
+=cut
+
+sub LimitToMembersOfGroup {
+    my $self = shift;
+    my $group = shift;
+
+    return ($self->Limit( 
+                         VALUE => $group,
+                         FIELD => 'GroupId',
+                         ENTRYAGGREGATOR => 'OR',
+                         ));
 
-Each of these files should begin with the line 
+}
 
-   no warnings qw(redefine);
 
-so that perl does not kick and scream when you redefine a subroutine or variable in your overlay.
+=head2 LimitToGroupsWithMember PRINCIPAL_ID
 
-RT::CachedGroupMembers_Overlay, RT::CachedGroupMembers_Vendor, RT::CachedGroupMembers_Local
+Takes a Principal Id as its only argument. 
+Limits the current search to groups which contain PRINCIPAL_ID as a member  or submember.
+This function gets used by GroupMember->Create to populate subgroups
 
 =cut
 
+sub LimitToGroupsWithMember {
+    my $self = shift;
+    my $member = shift;
+
+    
+
+    return ($self->Limit( 
+                         VALUE => $member || '0',
+                         FIELD => 'MemberId',
+                         ENTRYAGGREGATOR => 'OR',
+                         QUOTEVALUE => 0
+                         ));
+
+}
+# }}}
+
+
+RT::Base->_ImportOverlays();
 
 1;