Difference between revisions of "API:EPrints/DataObj/User"

From EPrints Documentation
Jump to: navigation, search
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<!-- Pod2Wiki=_preamble_  
 
<!-- Pod2Wiki=_preamble_  
 
This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
 
This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
  -->{{API}}{{Pod2Wiki}}{{API:Source|file=EPrints/DataObj/User.pm|package_name=EPrints::DataObj::User}}[[Category:API|User]]<div><!-- Edit below this comment -->
+
  -->{{API}}{{Pod2Wiki}}{{API:Source|file=perl_lib/EPrints/DataObj/User.pm|package_name=EPrints::DataObj::User}}[[Category:API|USER]][[Category:API:EPrints/DataObj|USER]][[Category:API:EPrints/DataObj/User|USER]]<div><!-- Edit below this comment -->
  
  
Line 8: Line 8:
 
'''EPrints::DataObj::User''' - Class representing a single user.
 
'''EPrints::DataObj::User''' - Class representing a single user.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
 
 
<!-- Pod2Wiki=head_description -->
 
<!-- Pod2Wiki=head_description -->
 
==DESCRIPTION==
 
==DESCRIPTION==
Line 21: Line 18:
 
EPrints::DataObj::User is a subclass of EPrints::DataObj with the following metadata fields (plus those defined in ArchiveMetadataFieldsConfig:
 
EPrints::DataObj::User is a subclass of EPrints::DataObj with the following metadata fields (plus those defined in ArchiveMetadataFieldsConfig:
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
 
 
<!-- Pod2Wiki=head_system_metadata -->
 
<!-- Pod2Wiki=head_system_metadata -->
 
==SYSTEM METADATA==
 
==SYSTEM METADATA==
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+
* userid (int)
<span style='display:none'>User Comments</span>
+
: The unique ID number of this user record. Unique within the current repository.
<!-- Edit below this comment -->
 
  
 +
* rev_number (int)
 +
: The revision number of this record. Each time it is changed the revision number is increased. This is not currently used for anything but it may be used for logging later.
  
<!-- Pod2Wiki= -->
+
* username (text)
</div>
+
: The username of this user. Used for logging into the system. Unique within this repository.
<!-- Pod2Wiki=item_userid -->
 
===userid (int)===
 
  
The unique ID number of this user record. Unique within the current repository.
+
* password (secret)
 +
: The crypted password for this user as generated by [[API:EPrints/Utils#crypt|EPrints::Utils/crypt]]. This may be ignored if for example LDAP authentication is being used.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+
* usertype (namedset)
<span style='display:none'>User Comments</span>
+
: The type of this user. The options are configured in metadata-phrases.xml.
<!-- Edit below this comment -->
 
 
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_rev_number -->
 
===rev_number (int)===
 
 
 
The revision number of this record. Each time it is changed the revision number is increased. This is not currently used for anything but it may be used for logging later.
 
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
  
 +
* newemail (email)
 +
: Used to store a new but as yet unconfirmed email address.
  
<!-- Pod2Wiki= -->
+
* newpassword (secret)
</div>
+
: Used to store a new but as yet unconfirmed password.
<!-- Pod2Wiki=item_username -->
 
===username (text)===
 
  
The username of this user. Used for logging into the system. Unique within this repository.
+
* pin (text)
 +
: A code required to confirm a new username or password. This code is emailed to the user to confirm they are who they say they are.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+
* pinsettime (int)
<span style='display:none'>User Comments</span>
+
: When the pin code was set, so we can make it time out.
<!-- Edit below this comment -->
 
  
 +
* joined (time)
 +
: The date and time that the user account was created. Before EPrints 2.4 this was a date field so users created before the upgrade will appear to have been  created at midnight.
  
<!-- Pod2Wiki= -->
+
* email (email)
</div>
+
: The email address of this user. Unique within the repository.
<!-- Pod2Wiki=item_password -->
 
===password (secret)===
 
  
The password of this user encoded with crypt. This may be ignored if the repository is using an alternate authentication system, eg. LDAP.
+
* lang (namedset)
 +
: The ID of the prefered language of this user. Only really used in multilingual repositories.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+
* editperms (search, multiple)
<span style='display:none'>User Comments</span>
+
: This field is used to filter what eprints a staff member can approve and  modify. If it's unset then they can modify any (given the correct privs. but if it is set then an eprint must match at least one of the searches to be within their scope.
<!-- Edit below this comment -->
 
  
 +
* frequency (set)
 +
: Only relevant to staff accounts. Is the frequency they want to be mailed  about eprints matching their scope that are in editorial review. never,  daily, weekly or monthly.
  
<!-- Pod2Wiki= -->
+
* mailempty (boolean)
</div>
+
: Only relevant to staff accounts. If set to true then emails are sent even if there are no items matching the scope.
<!-- Pod2Wiki=item_usertype -->
 
===usertype (namedset)===
 
  
The type of this user. The options are configured in metadata-phrases.xml.
+
* preference (compound)
 +
: User preferences which need to be persistent (simple key-value pairs).
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
 
<!-- Pod2Wiki=item_newemail -->
 
===newemail (email)===
 
 
Used to store a new but as yet unconfirmed email address.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_newpassword -->
 
===newpassword (secret)===
 
 
Used to store a new but as yet unconfirmed password.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_pin -->
 
===pin (text)===
 
 
A code required to confirm a new username or password. This code is emailed to the user to confirm they are who they say they are.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_pinsettime -->
 
===pinsettime (int)===
 
 
When the pin code was set, so we can make it time out.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_joined -->
 
===joined (time)===
 
 
The date and time that the user account was created. Before EPrints 2.4 this was a date field so users created before the upgrade will appear to have been  created at midnight.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_email -->
 
===email (email)===
 
 
The email address of this user. Unique within the repository.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_lang -->
 
===lang (namedset) ===
 
 
The ID of the prefered language of this user. Only really used in multilingual repositories.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_editperms -->
 
===editperms (search, multiple)===
 
 
This field is used to filter what eprints a staff member can approve and  modify. If it's unset then they can modify any (given the correct privs. but if it is set then an eprint must match at least one of the searches to be within their scope.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_frequency -->
 
===frequency (set)===
 
 
Only relevant to staff accounts. Is the frequency they want to be mailed  about eprints matching their scope that are in editorial review. never,  daily, weekly or monthly.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_mailempty -->
 
===mailempty (boolean)===
 
 
Only relevant to staff accounts. If set to true then emails are sent even if there are no items matching the scope.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_preference -->
 
===preference (compound)===
 
 
User preferences which need to be persistent (simple key-value pairs).
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
<!-- Edit below this comment -->
 
 
 
<!-- Pod2Wiki= -->
 
</div>
 
 
<!-- Pod2Wiki=head_methods -->
 
<!-- Pod2Wiki=head_methods -->
 
==METHODS==
 
==METHODS==
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+
<!-- Pod2Wiki=head_get_system_field_info -->
<span style='display:none'>User Comments</span>
+
===get_system_field_info===
<!-- Edit below this comment -->
 
 
 
  
<!-- Pod2Wiki= -->
+
<source lang="perl">$field_info = EPrints::DataObj::User->get_system_field_info
</div>
 
<!-- Pod2Wiki=item_get_system_field_info -->
 
===get_system_field_info===
 
  
$field_info = EPrints::DataObj::User-&gt;get_system_field_info
+
</source>
 
Return an array describing the system metadata of the this  dataset.
 
Return an array describing the system metadata of the this  dataset.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_new -->
<!-- Pod2Wiki=item_new -->
 
 
===new===
 
===new===
  
$user = EPrints::DataObj::User-&gt;new( $session, $userid )
+
<source lang="perl">$user = EPrints::DataObj::User->new( $session, $userid )
 +
 
 +
</source>
 
Load the user with the ID of $userid from the database and return it as an EPrints::DataObj::User object.
 
Load the user with the ID of $userid from the database and return it as an EPrints::DataObj::User object.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_new_from_data -->
<!-- Pod2Wiki=item_new_from_data -->
 
 
===new_from_data===
 
===new_from_data===
  
$user = EPrints::DataObj::User-&gt;new_from_data( $session, $data )
+
<source lang="perl">$user = EPrints::DataObj::User->new_from_data( $session, $data )
 +
 
 +
</source>
 
Construct a new EPrints::DataObj::User object based on the $data hash  reference of metadata.
 
Construct a new EPrints::DataObj::User object based on the $data hash  reference of metadata.
  
 
Used to create an object from the data retrieved from the database.
 
Used to create an object from the data retrieved from the database.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_get_dataset_id -->
<!-- Pod2Wiki=item_get_dataset_id -->
 
 
===get_dataset_id===
 
===get_dataset_id===
  
$dataset = EPrints::DataObj::User-&gt;get_dataset_id
+
<source lang="perl">$dataset = EPrints::DataObj::User->get_dataset_id
 +
 
 +
</source>
 
Returns the id of the [[API:EPrints/DataSet|EPrints::DataSet]] object to which this record belongs.
 
Returns the id of the [[API:EPrints/DataSet|EPrints::DataSet]] object to which this record belongs.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_get_defaults -->
<!-- Pod2Wiki=item_get_defaults -->
 
 
===get_defaults===
 
===get_defaults===
  
$defaults = EPrints::DataObj::User-&gt;get_defaults( $session, $data )
+
<source lang="perl">$defaults = EPrints::DataObj::User->get_defaults( $session, $data )
 +
 
 +
</source>
 
Return default values for this object based on the starting data.
 
Return default values for this object based on the starting data.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_user_with_email -->
<!-- Pod2Wiki=item_user_with_email -->
 
 
===user_with_email===
 
===user_with_email===
  
$user = EPrints::DataObj::User::user_with_email( $session, $email )
+
<source lang="perl">$user = EPrints::DataObj::User::user_with_email( $session, $email )
 +
 
 +
</source>
 
Return the EPrints::user with the specified $email, or undef if they are not found.
 
Return the EPrints::user with the specified $email, or undef if they are not found.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_user_with_username -->
<!-- Pod2Wiki=item_user_with_username -->
 
 
===user_with_username===
 
===user_with_username===
  
$user = EPrints::DataObj::User::user_with_username( $session, $username )
+
<source lang="perl">$user = EPrints::DataObj::User::user_with_username( $session, $username )
 +
 
 +
</source>
 
Return the EPrints::user with the specified $username, or undef if  they are not found.
 
Return the EPrints::user with the specified $username, or undef if  they are not found.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_validate -->
<!-- Pod2Wiki=item_validate -->
 
 
===validate===
 
===validate===
  
$problems = $thing-&gt;validate
+
<source lang="perl">$problems = $thing->validate
 +
 
 +
</source>
 
Validate the user - find out if all the required fields are filled out, and that what's been filled in is OK. Returns a reference to an array of problem descriptions.
 
Validate the user - find out if all the required fields are filled out, and that what's been filled in is OK. Returns a reference to an array of problem descriptions.
  
Line 341: Line 176:
 
The problems are XHTML DOM objects describing the problem.
 
The problems are XHTML DOM objects describing the problem.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_commit -->
<!-- Pod2Wiki=item_commit -->
 
 
===commit===
 
===commit===
  
$user-&gt;commit( [$force] )
+
<source lang="perl">$user->commit( [$force] )
 +
 
 +
</source>
 
Write this object to the database.
 
Write this object to the database.
  
 
If $force isn't true then it only actually modifies the database if one or more fields have been changed.
 
If $force isn't true then it only actually modifies the database if one or more fields have been changed.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_remove -->
<!-- Pod2Wiki=item_remove -->
 
 
===remove===
 
===remove===
  
$success = $user-&gt;remove
+
<source lang="perl">$success = $user->remove
 +
 
 +
</source>
 
Remove this user from the database. Also, remove their saved searches, but do not remove their eprints.
 
Remove this user from the database. Also, remove their saved searches, but do not remove their eprints.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_is_staff -->
<!-- Pod2Wiki=item_owned_eprints_list -->
+
===is_staff===
===owned_eprints_list===
 
  
$list = $user-&gt;owned_eprints_list( %opts )
+
<source lang="perl">$bool = $user->is_staff()
Returns a [[API:EPrints/List|EPrints::List]] of all the [[API:EPrints/DataObj/EPrint|EPrints::DataObj::EPrint]]s owned by this user.
 
  
%opts is passed to a [[API:EPrints/Search|EPrints::Search]] which is used to filter the results.  
+
</source>
 +
Returns true if the user's type is '''editor''' or '''admin'''.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_langauge -->
<!-- Pod2Wiki=item_editable_eprints_list -->
+
===langauge===
===editable_eprints_list===
 
  
$list = $user-&gt;editable_eprints_list( %opts )
+
<source lang="perl">$lang = $user->langauge()
Returns a [[API:EPrints/List|EPrints::List]] of [[API:EPrints/DataObj/EPrint|EPrints::DataObj::EPrint]]s that match this user's editorial search expressions. If the user has no editorial scope a list of all buffered eprints is returned.
 
  
%opts is passed to a [[API:EPrints/Search|EPrints::Search]] which is used to filter the results.  
+
</source>
 +
Get the preferred language of the user.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_owned_eprints_list -->
<!-- Pod2Wiki=item_get_eprints -->
+
===owned_eprints_list===
===get_eprints===
 
  
$list = $user-&gt;get_eprints( $dataset )
+
<source lang="perl">$list = $user->owned_eprints_list( %opts )
DEPRECATED
 
  
Return EPrints in the given EPrints::DataSet which have this user as their creator.
+
</source>
 +
Returns a [[API:EPrints/List|EPrints::List]] of all the [[API:EPrints/DataObj/EPrint|EPrints::DataObj::EPrint]]s owned by this user.
  
Since 2.4 this returns an EPrints::List object, not an array of eprints.
+
%opts is passed to a [[API:EPrints/Search|EPrints::Search]] which is used to filter the results.  
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_editable_eprints_list -->
<!-- Pod2Wiki=item_get_editable_eprints -->
+
===editable_eprints_list===
===get_editable_eprints===
 
  
$list = $user-&gt;get_editable_eprints
+
<source lang="perl">$list = $user->editable_eprints_list( %opts )
DEPRECATED
 
  
Return eprints currently in the editorial review buffer. If this user has editperms set then only return those records which match.
+
</source>
 +
Returns a [[API:EPrints/List|EPrints::List]] of [[API:EPrints/DataObj/EPrint|EPrints::DataObj::EPrint]]s that match this user's editorial search expressions. If the user has no editorial scope a list of all eprints that match the given %opts is returned.
  
Since 2.4 this returns an EPrints::List object, not an array of eprints.
+
%opts is passed to a [[API:EPrints/Search|EPrints::Search]] which is used to filter the results.  
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
+
<pre>  $list = $user-&gt;editable_eprints_list(
<span style='display:none'>User Comments</span>
+
      dataset =&gt; $repo-&gt;dataset( "buffer" ),
<!-- Edit below this comment -->
+
    );</pre>
  
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_get_owned_eprints -->
 
===get_owned_eprints===
 
 
$list = $user-&gt;get_owned_eprints( $dataset );
 
DEPRECATED
 
 
Return a list of the eprints which this user owns. This is by default the same as $user-&gt;get_eprints( $dataset) but may be over-ridden by get_users_owned_eprints.
 
 
Since 2.4 this returns an EPrints::List object, not an array of eprints.
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_has_owner -->
<!-- Pod2Wiki=item_has_owner -->
 
 
===has_owner===
 
===has_owner===
  
$boolean = $user-&gt;has_owner( $possible_owner )
+
<source lang="perl">$boolean = $user->has_owner( $possible_owner )
 +
 
 +
</source>
 
True if the users are the same record.
 
True if the users are the same record.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_mail -->
<!-- Pod2Wiki=item_mail -->
 
 
===mail===
 
===mail===
  
$ok = $user-&gt;mail( $subjectid, $message, [$replyto], [$email] )
+
<source lang="perl">$ok = $user->mail( $subjectid, $message, [$replyto], [$email] )
 +
 
 +
</source>
 
Send an email to this user.  
 
Send an email to this user.  
  
Line 486: Line 292:
 
Return true if the email was sent OK.
 
Return true if the email was sent OK.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_render -->
<!-- Pod2Wiki=item_render -->
 
 
===render===
 
===render===
  
( $page, $title ) = $user-&gt;render
+
<source lang="perl">( $page, $title ) = $user->render
 +
 
 +
</source>
 
Render this user into HTML using the "user_render" method in ArchiveRenderConfig.pm. Returns both the rendered information and the title as XHTML DOM.
 
Render this user into HTML using the "user_render" method in ArchiveRenderConfig.pm. Returns both the rendered information and the title as XHTML DOM.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_render_full -->
<!-- Pod2Wiki=item_render_full -->
 
 
===render_full===
 
===render_full===
  
( $page, $title ) = $user-&gt;render_full
+
<source lang="perl">( $page, $title ) = $user->render_full
 +
 
 +
</source>
 
The same as $user-&gt;render, but renders all fields, not just those  intended for public viewing. This is the admin view of the user.
 
The same as $user-&gt;render, but renders all fields, not just those  intended for public viewing. This is the admin view of the user.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_get_url -->
<!-- Pod2Wiki=item_get_url -->
 
 
===get_url===
 
===get_url===
  
$url = $user-&gt;get_url
+
<source lang="perl">$url = $user->get_url
 +
 
 +
</source>
 
Return the URL which will display information about this user.
 
Return the URL which will display information about this user.
  
 
If $staff is true then return the URL for an administrator to view and modify this record.
 
If $staff is true then return the URL for an administrator to view and modify this record.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_get_type -->
<!-- Pod2Wiki=item_get_type -->
 
 
===get_type===
 
===get_type===
  
$type = $user-&gt;get_type
+
<source lang="perl">$type = $user->get_type
 +
 
 +
</source>
 
Return the type of this user. Equivalent of  $user-&gt;get_value( "usertype" );
 
Return the type of this user. Equivalent of  $user-&gt;get_value( "usertype" );
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_get_saved_searches -->
<!-- Pod2Wiki=item_get_saved_searches -->
 
 
===get_saved_searches===
 
===get_saved_searches===
  
@saved_searches = $eprint-&gt;get_saved_searches
+
<source lang="perl">@saved_searches = $eprint->get_saved_searches
 +
 
 +
</source>
 
Return an array of all EPrint::DataObj::SavedSearch objects associated with this user.
 
Return an array of all EPrint::DataObj::SavedSearch objects associated with this user.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_preference -->
<!-- Pod2Wiki=item_preference -->
 
 
===preference===
 
===preference===
  
$value = $user-&gt;preference( $key )
+
<source lang="perl">$value = $user->preference( $key )
 +
 
 +
</source>
 
Retrieve the preference $key.
 
Retrieve the preference $key.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_set_preference -->
<!-- Pod2Wiki=item_set_preference -->
 
 
===set_preference===
 
===set_preference===
  
$user-&gt;set_preference( $key, $value )
+
<source lang="perl">$user->set_preference( $key, $value )
 +
 
 +
</source>
 
Set a preference $key for the user to $value.
 
Set a preference $key for the user to $value.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_send_out_editor_alert -->
<!-- Pod2Wiki=item_send_out_editor_alert -->
 
 
===send_out_editor_alert===
 
===send_out_editor_alert===
  
$user-&gt;send_out_editor_alert
+
<source lang="perl">$user->send_out_editor_alert
 +
 
 +
</source>
 
Called on users who are editors, when it's time to send their update on what items are in the editorial review buffer.
 
Called on users who are editors, when it's time to send their update on what items are in the editorial review buffer.
  
 
Sends the email if needed.
 
Sends the email if needed.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_process_editor_alerts -->
<!-- Pod2Wiki=item_process_editor_alerts -->
 
 
===process_editor_alerts===
 
===process_editor_alerts===
  
EPrints::DataObj::User::process_editor_alerts( $session, $frequency );
+
<source lang="perl">EPrints::DataObj::User::process_editor_alerts( $session, $frequency );
 +
 
 +
</source>
 
Static method.
 
Static method.
  
 
Called to send out all editor alerts of a given frequency (daily, weekly, monthly) for the current repository.
 
Called to send out all editor alerts of a given frequency (daily, weekly, monthly) for the current repository.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_allow -->
<!-- Pod2Wiki=item_allow -->
 
 
===allow===
 
===allow===
  
$result = $user-&gt;allow( $priv, [$item] )
+
<source lang="perl">$result = $user->allow( $priv )
 +
 
 +
</source>
 
Returns true if $user can perform this action/view this screen.
 
Returns true if $user can perform this action/view this screen.
  
A true result is 1..15 where the value indicates what about the user allowed the priv to be performed. This is used for filtering owner/ editor actions in eprint control screens.
+
To test whether a privilege is possible on an object use [[API:EPrints/DataObj#permit|EPrints::DataObj/permit]].
  
1 = anybody (not currently used) 2 = only if logged in  4 = only if owner of item 8 = only if editor of item
+
<!-- Edit below this comment -->
  
For non item related privs the result will normally be 2.
 
  
Nb. That create eprint is NOT a priv related to an eprint, as you  don't own it at that stage.
+
<!-- Pod2Wiki= -->
 +
<!-- Pod2Wiki=head_has_privilege -->
 +
===has_privilege===
 +
 
 +
<source lang="perl">$boolean = $user->has_privilege( $priv )
 +
 
 +
</source>
 +
Returns true if $priv is in the user's privileges table.
  
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<span style='display:none'>User Comments</span>
 
 
<!-- Edit below this comment -->
 
<!-- Edit below this comment -->
  
  
 
<!-- Pod2Wiki= -->
 
<!-- Pod2Wiki= -->
</div>
+
<!-- Pod2Wiki=head_copyright -->
<!-- Pod2Wiki=_postamble_ --><!-- Edit below this comment -->
+
==COPYRIGHT==
 +
Copyright 2000-2011 University of Southampton.
 +
 
 +
This file is part of EPrints http://www.eprints.org/.
 +
 
 +
EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
 +
 
 +
EPrints 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 Lesser General Public License for more details.
 +
 
 +
You should have received a copy of the GNU Lesser General Public License along with EPrints.  If not, see http://www.gnu.org/licenses/.
 +
 
 +
<!-- Edit below this comment -->
 +
 
 +
 
 +
<!-- Pod2Wiki= -->
 +
<!-- Pod2Wiki=_postamble_ -->
 +
<!-- Edit below this comment -->

Revision as of 09:57, 22 January 2013

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects


API: Core API

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::DataObj::User - Class representing a single user.


DESCRIPTION

This class represents a single eprint user record and the metadata associated with it.

EPrints::DataObj::User is a subclass of EPrints::DataObj with the following metadata fields (plus those defined in ArchiveMetadataFieldsConfig:


SYSTEM METADATA

  • userid (int)
The unique ID number of this user record. Unique within the current repository.
  • rev_number (int)
The revision number of this record. Each time it is changed the revision number is increased. This is not currently used for anything but it may be used for logging later.
  • username (text)
The username of this user. Used for logging into the system. Unique within this repository.
  • password (secret)
The crypted password for this user as generated by EPrints::Utils/crypt. This may be ignored if for example LDAP authentication is being used.
  • usertype (namedset)
The type of this user. The options are configured in metadata-phrases.xml.
  • newemail (email)
Used to store a new but as yet unconfirmed email address.
  • newpassword (secret)
Used to store a new but as yet unconfirmed password.
  • pin (text)
A code required to confirm a new username or password. This code is emailed to the user to confirm they are who they say they are.
  • pinsettime (int)
When the pin code was set, so we can make it time out.
  • joined (time)
The date and time that the user account was created. Before EPrints 2.4 this was a date field so users created before the upgrade will appear to have been created at midnight.
  • email (email)
The email address of this user. Unique within the repository.
  • lang (namedset)
The ID of the prefered language of this user. Only really used in multilingual repositories.
  • editperms (search, multiple)
This field is used to filter what eprints a staff member can approve and modify. If it's unset then they can modify any (given the correct privs. but if it is set then an eprint must match at least one of the searches to be within their scope.
  • frequency (set)
Only relevant to staff accounts. Is the frequency they want to be mailed about eprints matching their scope that are in editorial review. never, daily, weekly or monthly.
  • mailempty (boolean)
Only relevant to staff accounts. If set to true then emails are sent even if there are no items matching the scope.
  • preference (compound)
User preferences which need to be persistent (simple key-value pairs).


METHODS

get_system_field_info

$field_info = EPrints::DataObj::User->get_system_field_info

Return an array describing the system metadata of the this dataset.


new

$user = EPrints::DataObj::User->new( $session, $userid )

Load the user with the ID of $userid from the database and return it as an EPrints::DataObj::User object.


new_from_data

$user = EPrints::DataObj::User->new_from_data( $session, $data )

Construct a new EPrints::DataObj::User object based on the $data hash reference of metadata.

Used to create an object from the data retrieved from the database.


get_dataset_id

$dataset = EPrints::DataObj::User->get_dataset_id

Returns the id of the EPrints::DataSet object to which this record belongs.


get_defaults

$defaults = EPrints::DataObj::User->get_defaults( $session, $data )

Return default values for this object based on the starting data.


user_with_email

$user = EPrints::DataObj::User::user_with_email( $session, $email )

Return the EPrints::user with the specified $email, or undef if they are not found.


user_with_username

$user = EPrints::DataObj::User::user_with_username( $session, $username )

Return the EPrints::user with the specified $username, or undef if they are not found.


validate

$problems = $thing->validate

Validate the user - find out if all the required fields are filled out, and that what's been filled in is OK. Returns a reference to an array of problem descriptions.

If there are no probelms then the array is empty.

The problems are XHTML DOM objects describing the problem.


commit

$user->commit( [$force] )

Write this object to the database.

If $force isn't true then it only actually modifies the database if one or more fields have been changed.


remove

$success = $user->remove

Remove this user from the database. Also, remove their saved searches, but do not remove their eprints.


is_staff

$bool = $user->is_staff()

Returns true if the user's type is editor or admin.


langauge

$lang = $user->langauge()

Get the preferred language of the user.


owned_eprints_list

$list = $user->owned_eprints_list( %opts )

Returns a EPrints::List of all the EPrints::DataObj::EPrints owned by this user.

%opts is passed to a EPrints::Search which is used to filter the results.


editable_eprints_list

$list = $user->editable_eprints_list( %opts )

Returns a EPrints::List of EPrints::DataObj::EPrints that match this user's editorial search expressions. If the user has no editorial scope a list of all eprints that match the given %opts is returned.

%opts is passed to a EPrints::Search which is used to filter the results.

  $list = $user->editable_eprints_list(
      dataset => $repo->dataset( "buffer" ),
     );


has_owner

$boolean = $user->has_owner( $possible_owner )

True if the users are the same record.


mail

$ok = $user->mail( $subjectid, $message, [$replyto], [$email] )

Send an email to this user.

$subjectid is the ID of a phrase to use as the subject of this email.

$message is an XML DOM object describing the message in simple XHTML.

$replyto is the reply to address for this email, if different to the repository default.

$email is the email address to send this email to if different from this users configured email address.

Return true if the email was sent OK.


render

( $page, $title ) = $user->render

Render this user into HTML using the "user_render" method in ArchiveRenderConfig.pm. Returns both the rendered information and the title as XHTML DOM.


render_full

( $page, $title ) = $user->render_full

The same as $user->render, but renders all fields, not just those intended for public viewing. This is the admin view of the user.


get_url

$url = $user->get_url

Return the URL which will display information about this user.

If $staff is true then return the URL for an administrator to view and modify this record.


get_type

$type = $user->get_type

Return the type of this user. Equivalent of $user->get_value( "usertype" );


get_saved_searches

@saved_searches = $eprint->get_saved_searches

Return an array of all EPrint::DataObj::SavedSearch objects associated with this user.


preference

$value = $user->preference( $key )

Retrieve the preference $key.


set_preference

$user->set_preference( $key, $value )

Set a preference $key for the user to $value.


send_out_editor_alert

$user->send_out_editor_alert

Called on users who are editors, when it's time to send their update on what items are in the editorial review buffer.

Sends the email if needed.


process_editor_alerts

EPrints::DataObj::User::process_editor_alerts( $session, $frequency );

Static method.

Called to send out all editor alerts of a given frequency (daily, weekly, monthly) for the current repository.


allow

$result = $user->allow( $priv )

Returns true if $user can perform this action/view this screen.

To test whether a privilege is possible on an object use EPrints::DataObj/permit.


has_privilege

$boolean = $user->has_privilege( $priv )

Returns true if $priv is in the user's privileges table.


COPYRIGHT

Copyright 2000-2011 University of Southampton.

This file is part of EPrints http://www.eprints.org/.

EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

EPrints 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with EPrints. If not, see http://www.gnu.org/licenses/.