# BEGIN BPS TAGGED BLOCK {{{ # # COPYRIGHT: # # This software is Copyright (c) 1996-2012 Best Practical Solutions, LLC # # # (Except where explicitly superseded by other copyright notices) # # # LICENSE: # # This work is made available to you under the terms of Version 2 of # the GNU General Public License. A copy of that license should have # been provided with this software, but in any event can be snarfed # from www.gnu.org. # # This work is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA # 02110-1301 or visit their web page on the internet at # http://www.gnu.org/licenses/old-licenses/gpl-2.0.html. # # # CONTRIBUTION SUBMISSION POLICY: # # (The following paragraph is not intended to limit the rights granted # to you to modify and distribute this software under the terms of # the GNU General Public License and is only of importance to you if # you choose to contribute your changes and enhancements to the # community by submitting them to Best Practical Solutions, LLC.) # # By intentionally submitting any modifications, corrections or # derivatives to this work, or any other work intended for use with # Request Tracker, to Best Practical Solutions, LLC, you confirm that # you are the copyright holder for those contributions and you grant # Best Practical Solutions, LLC a nonexclusive, worldwide, irrevocable, # royalty-free, perpetual, license to use, copy, create derivative # works based on those contributions, and sublicense and distribute # those contributions and any derivatives thereof. # # END BPS TAGGED BLOCK }}} package RT::CustomField; use strict; use warnings; use base 'RT::Record'; sub Table {'CustomFields'} use RT::CustomFieldValues; use RT::ObjectCustomFields; use RT::ObjectCustomFieldValues; our %FieldTypes = ( Select => { sort_order => 10, selection_type => 1, labels => [ 'Select multiple values', # loc 'Select one value', # loc 'Select up to [_1] values', # loc ], render_types => { multiple => [ # Default is the first one 'Select box', # loc 'List', # loc ], single => [ 'Select box', # loc 'Dropdown', # loc 'List', # loc ] }, }, Freeform => { sort_order => 20, selection_type => 0, labels => [ 'Enter multiple values', # loc 'Enter one value', # loc 'Enter up to [_1] values', # loc ] }, Text => { sort_order => 30, selection_type => 0, labels => [ 'Fill in multiple text areas', # loc 'Fill in one text area', # loc 'Fill in up to [_1] text areas', # loc ] }, Wikitext => { sort_order => 40, selection_type => 0, labels => [ 'Fill in multiple wikitext areas', # loc 'Fill in one wikitext area', # loc 'Fill in up to [_1] wikitext areas', # loc ] }, Image => { sort_order => 50, selection_type => 0, labels => [ 'Upload multiple images', # loc 'Upload one image', # loc 'Upload up to [_1] images', # loc ] }, Binary => { sort_order => 60, selection_type => 0, labels => [ 'Upload multiple files', # loc 'Upload one file', # loc 'Upload up to [_1] files', # loc ] }, Combobox => { sort_order => 70, selection_type => 1, labels => [ 'Combobox: Select or enter multiple values', # loc 'Combobox: Select or enter one value', # loc 'Combobox: Select or enter up to [_1] values', # loc ] }, Autocomplete => { sort_order => 80, selection_type => 1, labels => [ 'Enter multiple values with autocompletion', # loc 'Enter one value with autocompletion', # loc 'Enter up to [_1] values with autocompletion', # loc ] }, Date => { sort_order => 90, selection_type => 0, labels => [ 'Select multiple dates', # loc 'Select date', # loc 'Select up to [_1] dates', # loc ] }, DateTime => { sort_order => 100, selection_type => 0, labels => [ 'Select multiple datetimes', # loc 'Select datetime', # loc 'Select up to [_1] datetimes', # loc ] }, IPAddress => { sort_order => 110, selection_type => 0, labels => [ 'Enter multiple IP addresses', # loc 'Enter one IP address', # loc 'Enter up to [_1] IP addresses', # loc ] }, IPAddressRange => { sort_order => 120, selection_type => 0, labels => [ 'Enter multiple IP address ranges', # loc 'Enter one IP address range', # loc 'Enter up to [_1] IP address ranges', # loc ] }, ); our %FRIENDLY_OBJECT_TYPES = (); RT::CustomField->_ForObjectType( 'RT::Queue-RT::Ticket' => "Tickets", ); #loc RT::CustomField->_ForObjectType( 'RT::Queue-RT::Ticket-RT::Transaction' => "Ticket Transactions", ); #loc RT::CustomField->_ForObjectType( 'RT::User' => "Users", ); #loc RT::CustomField->_ForObjectType( 'RT::Queue' => "Queues", ); #loc RT::CustomField->_ForObjectType( 'RT::Group' => "Groups", ); #loc our $RIGHTS = { SeeCustomField => 'View custom fields', # loc_pair AdminCustomField => 'Create, modify and delete custom fields', # loc_pair AdminCustomFieldValues => 'Create, modify and delete custom fields values', # loc_pair ModifyCustomField => 'Add, modify and delete custom field values for objects' # loc_pair }; our $RIGHT_CATEGORIES = { SeeCustomField => 'General', AdminCustomField => 'Admin', AdminCustomFieldValues => 'Admin', ModifyCustomField => 'Staff', }; # Tell RT::ACE that this sort of object can get acls granted $RT::ACE::OBJECT_TYPES{'RT::CustomField'} = 1; __PACKAGE__->AddRights(%$RIGHTS); __PACKAGE__->AddRightCategories(%$RIGHT_CATEGORIES); =head2 AddRights C, C [, ...] Adds the given rights to the list of possible rights. This method should be called during server startup, not at runtime. =cut sub AddRights { my $self = shift; my %new = @_; $RIGHTS = { %$RIGHTS, %new }; %RT::ACE::LOWERCASERIGHTNAMES = ( %RT::ACE::LOWERCASERIGHTNAMES, map { lc($_) => $_ } keys %new); } sub AvailableRights { my $self = shift; return $RIGHTS; } =head2 RightCategories Returns a hashref where the keys are rights for this type of object and the values are the category (General, Staff, Admin) the right falls into. =cut sub RightCategories { return $RIGHT_CATEGORIES; } =head2 AddRightCategories C, C [, ...] Adds the given right and category pairs to the list of right categories. This method should be called during server startup, not at runtime. =cut sub AddRightCategories { my $self = shift if ref $_[0] or $_[0] eq __PACKAGE__; my %new = @_; $RIGHT_CATEGORIES = { %$RIGHT_CATEGORIES, %new }; } =head1 NAME RT::CustomField_Overlay - overlay for RT::CustomField =head1 DESCRIPTION =head1 'CORE' METHODS =head2 Create PARAMHASH Create takes a hash of values and creates a row in the database: varchar(200) 'Name'. varchar(200) 'Type'. int(11) 'MaxValues'. varchar(255) 'Pattern'. smallint(6) 'Repeated'. varchar(255) 'Description'. int(11) 'SortOrder'. varchar(255) 'LookupType'. smallint(6) 'Disabled'. C is generally the result of either CCustomFieldLookupType> or CCustomFieldLookupType>. =cut sub Create { my $self = shift; my %args = ( Name => '', Type => '', MaxValues => 0, Pattern => '', Description => '', Disabled => 0, LookupType => '', Repeated => 0, LinkValueTo => '', IncludeContentForValue => '', @_, ); unless ( $self->CurrentUser->HasRight(Object => $RT::System, Right => 'AdminCustomField') ) { return (0, $self->loc('Permission Denied')); } if ( $args{TypeComposite} ) { @args{'Type', 'MaxValues'} = split(/-/, $args{TypeComposite}, 2); } elsif ( $args{Type} =~ s/(?:(Single)|Multiple)$// ) { # old style Type string $args{'MaxValues'} = $1 ? 1 : 0; } $args{'MaxValues'} = int $args{'MaxValues'}; if ( !exists $args{'Queue'}) { # do nothing -- things below are strictly backward compat } elsif ( ! $args{'Queue'} ) { unless ( $self->CurrentUser->HasRight( Object => $RT::System, Right => 'AssignCustomFields') ) { return ( 0, $self->loc('Permission Denied') ); } $args{'LookupType'} = 'RT::Queue-RT::Ticket'; } else { my $queue = RT::Queue->new($self->CurrentUser); $queue->Load($args{'Queue'}); unless ($queue->Id) { return (0, $self->loc("Queue not found")); } unless ( $queue->CurrentUserHasRight('AssignCustomFields') ) { return ( 0, $self->loc('Permission Denied') ); } $args{'LookupType'} = 'RT::Queue-RT::Ticket'; $args{'Queue'} = $queue->Id; } my ($ok, $msg) = $self->_IsValidRegex( $args{'Pattern'} ); return (0, $self->loc("Invalid pattern: [_1]", $msg)) unless $ok; if ( $args{'MaxValues'} != 1 && $args{'Type'} =~ /(text|combobox)$/i ) { $RT::Logger->debug("Support for 'multiple' Texts or Comboboxes is not implemented"); $args{'MaxValues'} = 1; } if ( $args{'RenderType'} ||= undef ) { my $composite = join '-', @args{'Type', 'MaxValues'}; return (0, $self->loc("This custom field has no Render Types")) unless $self->HasRenderTypes( $composite ); if ( $args{'RenderType'} eq $self->DefaultRenderType( $composite ) ) { $args{'RenderType'} = undef; } else { return (0, $self->loc("Invalid Render Type") ) unless grep $_ eq $args{'RenderType'}, $self->RenderTypes( $composite ); } } $args{'ValuesClass'} = undef if ($args{'ValuesClass'} || '') eq 'RT::CustomFieldValues'; if ( $args{'ValuesClass'} ||= undef ) { return (0, $self->loc("This Custom Field can not have list of values")) unless $self->IsSelectionType( $args{'Type'} ); unless ( $self->ValidateValuesClass( $args{'ValuesClass'} ) ) { return (0, $self->loc("Invalid Custom Field values source")); } } (my $rv, $msg) = $self->SUPER::Create( Name => $args{'Name'}, Type => $args{'Type'}, RenderType => $args{'RenderType'}, MaxValues => $args{'MaxValues'}, Pattern => $args{'Pattern'}, BasedOn => $args{'BasedOn'}, ValuesClass => $args{'ValuesClass'}, Description => $args{'Description'}, Disabled => $args{'Disabled'}, LookupType => $args{'LookupType'}, Repeated => $args{'Repeated'}, ); if ($rv) { if ( exists $args{'LinkValueTo'}) { $self->SetLinkValueTo($args{'LinkValueTo'}); } if ( exists $args{'IncludeContentForValue'}) { $self->SetIncludeContentForValue($args{'IncludeContentForValue'}); } return ($rv, $msg) unless exists $args{'Queue'}; # Compat code -- create a new ObjectCustomField mapping my $OCF = RT::ObjectCustomField->new( $self->CurrentUser ); $OCF->Create( CustomField => $self->Id, ObjectId => $args{'Queue'}, ); } return ($rv, $msg); } =head2 Load ID/NAME Load a custom field. If the value handed in is an integer, load by custom field ID. Otherwise, Load by name. =cut sub Load { my $self = shift; my $id = shift || ''; if ( $id =~ /^\d+$/ ) { return $self->SUPER::Load( $id ); } else { return $self->LoadByName( Name => $id ); } } =head2 LoadByName (Queue => QUEUEID, Name => NAME) Loads the Custom field named NAME. Will load a Disabled Custom Field even if there is a non-disabled Custom Field with the same Name. If a Queue parameter is specified, only look for ticket custom fields tied to that Queue. If the Queue parameter is '0', look for global ticket custom fields. If no queue parameter is specified, look for any and all custom fields with this name. BUG/TODO, this won't let you specify that you only want user or group CFs. =cut # Compatibility for API change after 3.0 beta 1 *LoadNameAndQueue = \&LoadByName; # Change after 3.4 beta. *LoadByNameAndQueue = \&LoadByName; sub LoadByName { my $self = shift; my %args = ( Queue => undef, Name => undef, @_, ); unless ( defined $args{'Name'} && length $args{'Name'} ) { $RT::Logger->error("Couldn't load Custom Field without Name"); return wantarray ? (0, $self->loc("No name provided")) : 0; } # if we're looking for a queue by name, make it a number if ( defined $args{'Queue'} && ($args{'Queue'} =~ /\D/ || !$self->ContextObject) ) { my $QueueObj = RT::Queue->new( $self->CurrentUser ); $QueueObj->Load( $args{'Queue'} ); $args{'Queue'} = $QueueObj->Id; $self->SetContextObject( $QueueObj ) unless $self->ContextObject; } # XXX - really naive implementation. Slow. - not really. still just one query my $CFs = RT::CustomFields->new( $self->CurrentUser ); $CFs->SetContextObject( $self->ContextObject ); my $field = $args{'Name'} =~ /\D/? 'Name' : 'id'; $CFs->Limit( FIELD => $field, VALUE => $args{'Name'}, CASESENSITIVE => 0); # Don't limit to queue if queue is 0. Trying to do so breaks # RT::Group type CFs. if ( defined $args{'Queue'} ) { $CFs->LimitToQueue( $args{'Queue'} ); } # When loading by name, we _can_ load disabled fields, but prefer # non-disabled fields. $CFs->FindAllRows; $CFs->OrderByCols( { FIELD => "Disabled", ORDER => 'ASC' }, ); # We only want one entry. $CFs->RowsPerPage(1); # version before 3.8 just returns 0, so we need to test if wantarray to be # backward compatible. return wantarray ? (0, $self->loc("Not found")) : 0 unless my $first = $CFs->First; return $self->LoadById( $first->id ); } =head2 Custom field values =head3 Values FIELD Return a object (collection) of all acceptable values for this Custom Field. Class of the object can vary and depends on the return value of the C method. =cut *ValuesObj = \&Values; sub Values { my $self = shift; my $class = $self->ValuesClass; if ( $class ne 'RT::CustomFieldValues') { eval "require $class" or die "$@"; } my $cf_values = $class->new( $self->CurrentUser ); # if the user has no rights, return an empty object if ( $self->id && $self->CurrentUserHasRight( 'SeeCustomField') ) { $cf_values->LimitToCustomField( $self->Id ); } else { $cf_values->Limit( FIELD => 'id', VALUE => 0, SUBCLAUSE => 'acl' ); } return ($cf_values); } =head3 AddValue HASH Create a new value for this CustomField. Takes a paramhash containing the elements Name, Description and SortOrder =cut sub AddValue { my $self = shift; my %args = @_; unless ($self->CurrentUserHasRight('AdminCustomField') || $self->CurrentUserHasRight('AdminCustomFieldValues')) { return (0, $self->loc('Permission Denied')); } # allow zero value if ( !defined $args{'Name'} || $args{'Name'} eq '' ) { return (0, $self->loc("Can't add a custom field value without a name")); } my $newval = RT::CustomFieldValue->new( $self->CurrentUser ); return $newval->Create( %args, CustomField => $self->Id ); } =head3 DeleteValue ID Deletes a value from this custom field by id. Does not remove this value for any article which has had it selected =cut sub DeleteValue { my $self = shift; my $id = shift; unless ( $self->CurrentUserHasRight('AdminCustomField') || $self->CurrentUserHasRight('AdminCustomFieldValues') ) { return (0, $self->loc('Permission Denied')); } my $val_to_del = RT::CustomFieldValue->new( $self->CurrentUser ); $val_to_del->Load( $id ); unless ( $val_to_del->Id ) { return (0, $self->loc("Couldn't find that value")); } unless ( $val_to_del->CustomField == $self->Id ) { return (0, $self->loc("That is not a value for this custom field")); } my $retval = $val_to_del->Delete; unless ( $retval ) { return (0, $self->loc("Custom field value could not be deleted")); } return ($retval, $self->loc("Custom field value deleted")); } =head2 ValidateQueue Queue Make sure that the name specified is valid =cut sub ValidateName { my $self = shift; my $value = shift; return 0 unless length $value; return $self->SUPER::ValidateName($value); } =head2 ValidateQueue Queue Make sure that the queue specified is a valid queue name =cut sub ValidateQueue { my $self = shift; my $id = shift; return undef unless defined $id; # 0 means "Global" null would _not_ be ok. return 1 if $id eq '0'; my $q = RT::Queue->new( RT->SystemUser ); $q->Load( $id ); return undef unless $q->id; return 1; } =head2 Types Retuns an array of the types of CustomField that are supported =cut sub Types { return (sort {(($FieldTypes{$a}{sort_order}||999) <=> ($FieldTypes{$b}{sort_order}||999)) or ($a cmp $b)} keys %FieldTypes); } =head2 IsSelectionType Retuns a boolean value indicating whether the C method makes sense to this Custom Field. =cut sub IsSelectionType { my $self = shift; my $type = @_? shift : $self->Type; return undef unless $type; return $FieldTypes{$type}->{selection_type}; } =head2 IsExternalValues =cut sub IsExternalValues { my $self = shift; return 0 unless $self->IsSelectionType( @_ ); return $self->ValuesClass eq 'RT::CustomFieldValues'? 0 : 1; } sub ValuesClass { my $self = shift; return $self->_Value( ValuesClass => @_ ) || 'RT::CustomFieldValues'; } sub SetValuesClass { my $self = shift; my $class = shift || 'RT::CustomFieldValues'; if ( $class eq 'RT::CustomFieldValues' ) { return $self->_Set( Field => 'ValuesClass', Value => undef, @_ ); } return (0, $self->loc("This Custom Field can not have list of values")) unless $self->IsSelectionType; unless ( $self->ValidateValuesClass( $class ) ) { return (0, $self->loc("Invalid Custom Field values source")); } return $self->_Set( Field => 'ValuesClass', Value => $class, @_ ); } sub ValidateValuesClass { my $self = shift; my $class = shift; return 1 if !defined $class || $class eq 'RT::CustomFieldValues'; return 1 if grep $class eq $_, RT->Config->Get('CustomFieldValuesSources'); return undef; } =head2 FriendlyType [TYPE, MAX_VALUES] Returns a localized human-readable version of the custom field type. If a custom field type is specified as the parameter, the friendly type for that type will be returned =cut sub FriendlyType { my $self = shift; my $type = @_ ? shift : $self->Type; my $max = @_ ? shift : $self->MaxValues; $max = 0 unless $max; if (my $friendly_type = $FieldTypes{$type}->{labels}->[$max>2 ? 2 : $max]) { return ( $self->loc( $friendly_type, $max ) ); } else { return ( $self->loc( $type ) ); } } sub FriendlyTypeComposite { my $self = shift; my $composite = shift || $self->TypeComposite; return $self->FriendlyType(split(/-/, $composite, 2)); } =head2 ValidateType TYPE Takes a single string. returns true if that string is a value type of custom field =cut sub ValidateType { my $self = shift; my $type = shift; if ( $type =~ s/(?:Single|Multiple)$// ) { $RT::Logger->warning( "Prefix 'Single' and 'Multiple' to Type deprecated, use MaxValues instead at (". join(":",caller).")"); } if ( $FieldTypes{$type} ) { return 1; } else { return undef; } } sub SetType { my $self = shift; my $type = shift; if ($type =~ s/(?:(Single)|Multiple)$//) { $RT::Logger->warning("'Single' and 'Multiple' on SetType deprecated, use SetMaxValues instead at (". join(":",caller).")"); $self->SetMaxValues($1 ? 1 : 0); } $self->_Set(Field => 'Type', Value =>$type); } =head2 SetPattern STRING Takes a single string representing a regular expression. Performs basic validation on that regex, and sets the C field for the CF if it is valid. =cut sub SetPattern { my $self = shift; my $regex = shift; my ($ok, $msg) = $self->_IsValidRegex($regex); if ($ok) { return $self->_Set(Field => 'Pattern', Value => $regex); } else { return (0, $self->loc("Invalid pattern: [_1]", $msg)); } } =head2 _IsValidRegex(Str $regex) returns (Bool $success, Str $msg) Tests if the string contains an invalid regex. =cut sub _IsValidRegex { my $self = shift; my $regex = shift or return (1, 'valid'); local $^W; local $@; local $SIG{__DIE__} = sub { 1 }; local $SIG{__WARN__} = sub { 1 }; if (eval { qr/$regex/; 1 }) { return (1, 'valid'); } my $err = $@; $err =~ s{[,;].*}{}; # strip debug info from error chomp $err; return (0, $err); } =head2 SingleValue Returns true if this CustomField only accepts a single value. Returns false if it accepts multiple values =cut sub SingleValue { my $self = shift; if (($self->MaxValues||0) == 1) { return 1; } else { return undef; } } sub UnlimitedValues { my $self = shift; if (($self->MaxValues||0) == 0) { return 1; } else { return undef; } } =head2 CurrentUserHasRight RIGHT Helper function to call the custom field's queue's CurrentUserHasRight with the passed in args. =cut sub CurrentUserHasRight { my $self = shift; my $right = shift; return $self->CurrentUser->HasRight( Object => $self, Right => $right, ); } =head2 ACLEquivalenceObjects Returns list of objects via which users can get rights on this custom field. For custom fields these objects can be set using L. =cut sub ACLEquivalenceObjects { my $self = shift; my $ctx = $self->ContextObject or return; return ($ctx, $ctx->ACLEquivalenceObjects); } =head2 ContextObject and SetContextObject Set or get a context for this object. It can be ticket, queue or another object this CF applies to. Used for ACL control, for example SeeCustomField can be granted on queue level to allow people to see all fields applied to the queue. =cut sub SetContextObject { my $self = shift; return $self->{'context_object'} = shift; } sub ContextObject { my $self = shift; return $self->{'context_object'}; } sub ValidContextType { my $self = shift; my $class = shift; my %valid; $valid{$_}++ for split '-', $self->LookupType; delete $valid{'RT::Transaction'}; return $valid{$class}; } =head2 LoadContextObject Takes an Id for a Context Object and loads the right kind of RT::Object for this particular Custom Field (based on the LookupType) and returns it. This is a good way to ensure you don't try to use a Queue as a Context Object on a User Custom Field. =cut sub LoadContextObject { my $self = shift; my $type = shift; my $contextid = shift; unless ( $self->ValidContextType($type) ) { RT->Logger->debug("Invalid ContextType $type for Custom Field ".$self->Id); return; } my $context_object = $type->new( $self->CurrentUser ); my ($id, $msg) = $context_object->LoadById( $contextid ); unless ( $id ) { RT->Logger->debug("Invalid ContextObject id: $msg"); return; } return $context_object; } =head2 ValidateContextObject Ensure that a given ContextObject applies to this Custom Field. For custom fields that are assigned to Queues or to Classes, this checks that the Custom Field is actually applied to that objects. For Global Custom Fields, it returns true as long as the Object is of the right type, because you may be using your permissions on a given Queue of Class to see a Global CF. For CFs that are only applied Globally, you don't need a ContextObject. =cut sub ValidateContextObject { my $self = shift; my $object = shift; return 1 if $self->IsApplied(0); # global only custom fields don't have objects # that should be used as context objects. return if $self->ApplyGlobally; # Otherwise, make sure we weren't passed a user object that we're # supposed to treat as a queue. return unless $self->ValidContextType(ref $object); # Check that it is applied correctly my ($applied_to) = grep {ref($_) eq $self->RecordClassFromLookupType} ($object, $object->ACLEquivalenceObjects); return unless $applied_to; return $self->IsApplied($applied_to->id); } sub _Set { my $self = shift; unless ( $self->CurrentUserHasRight('AdminCustomField') ) { return ( 0, $self->loc('Permission Denied') ); } return $self->SUPER::_Set( @_ ); } =head2 _Value Takes the name of a table column. Returns its value as a string, if the user passes an ACL check =cut sub _Value { my $self = shift; return undef unless $self->id; # we need to do the rights check unless ( $self->CurrentUserHasRight('SeeCustomField') ) { $RT::Logger->debug( "Permission denied. User #". $self->CurrentUser->id ." has no SeeCustomField right on CF #". $self->id ); return (undef); } return $self->__Value( @_ ); } =head2 SetDisabled Takes a boolean. 1 will cause this custom field to no longer be avaialble for objects. 0 will re-enable this field. =cut =head2 SetTypeComposite Set this custom field's type and maximum values as a composite value =cut sub SetTypeComposite { my $self = shift; my $composite = shift; my $old = $self->TypeComposite; my ($type, $max_values) = split(/-/, $composite, 2); if ( $type ne $self->Type ) { my ($status, $msg) = $self->SetType( $type ); return ($status, $msg) unless $status; } if ( ($max_values || 0) != ($self->MaxValues || 0) ) { my ($status, $msg) = $self->SetMaxValues( $max_values ); return ($status, $msg) unless $status; } my $render = $self->RenderType; if ( $render and not grep { $_ eq $render } $self->RenderTypes ) { # We switched types and our render type is no longer valid, so unset it # and use the default $self->SetRenderType( undef ); } return 1, $self->loc( "Type changed from '[_1]' to '[_2]'", $self->FriendlyTypeComposite( $old ), $self->FriendlyTypeComposite( $composite ), ); } =head2 TypeComposite Returns a composite value composed of this object's type and maximum values =cut sub TypeComposite { my $self = shift; return join '-', ($self->Type || ''), ($self->MaxValues || 0); } =head2 TypeComposites Returns an array of all possible composite values for custom fields. =cut sub TypeComposites { my $self = shift; return grep !/(?:[Tt]ext|Combobox|Date|DateTime)-0/, map { ("$_-1", "$_-0") } $self->Types; } =head2 RenderType Returns the type of form widget to render for this custom field. Currently this only affects fields which return true for L. =cut sub RenderType { my $self = shift; return '' unless $self->HasRenderTypes; return $self->_Value( 'RenderType', @_ ) || $self->DefaultRenderType; } =head2 SetRenderType TYPE Sets this custom field's render type. =cut sub SetRenderType { my $self = shift; my $type = shift; return (0, $self->loc("This custom field has no Render Types")) unless $self->HasRenderTypes; if ( !$type || $type eq $self->DefaultRenderType ) { return $self->_Set( Field => 'RenderType', Value => undef, @_ ); } if ( not grep { $_ eq $type } $self->RenderTypes ) { return (0, $self->loc("Invalid Render Type for custom field of type [_1]", $self->FriendlyType)); } # XXX: Remove this restriction once we support lists and cascaded selects if ( $self->BasedOnObj->id and $type =~ /List/ ) { return (0, $self->loc("We can't currently render as a List when basing categories on another custom field. Please use another render type.")); } return $self->_Set( Field => 'RenderType', Value => $type, @_ ); } =head2 DefaultRenderType [TYPE COMPOSITE] Returns the default render type for this custom field's type or the TYPE COMPOSITE specified as an argument. =cut sub DefaultRenderType { my $self = shift; my $composite = @_ ? shift : $self->TypeComposite; my ($type, $max) = split /-/, $composite, 2; return unless $type and $self->HasRenderTypes($composite); return $FieldTypes{$type}->{render_types}->{ $max == 1 ? 'single' : 'multiple' }[0]; } =head2 HasRenderTypes [TYPE_COMPOSITE] Returns a boolean value indicating whether the L and L methods make sense for this custom field. Currently true only for type C