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

From EPrints Documentation
Jump to: navigation, search
 
Line 23: Line 23:
 
  $c->{citation_caching}->{enabled} = 1;
 
  $c->{citation_caching}->{enabled} = 1;
 
    
 
    
<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_instance_variables -->
 
==INSTANCE VARIABLES==
 
See &lt;EPrints::DataObj#INSTANCE_VARIABLES&gt;.
 
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<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>
 
<span style='display:none'>User Comments</span>
Line 114: Line 103:
  
 
The moment at which this citation cache was generated.
 
The moment at which this citation cache was generated.
 +
 +
<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_references_and_related_objects -->
 +
==REFERENCES AND RELATED OBJECTS==
 +
None.
 +
 +
<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_instance_variables -->
 +
==INSTANCE VARIABLES==
 +
See &lt;EPrints::DataObj|EPrints::DataObj#INSTANCE_VARIABLES&gt;.
  
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>

Latest revision as of 16:37, 10 January 2022

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::CitationCache - A cached citation for a data object.

User Comments


DESCRIPTION

This class describes a single item in the citationcache dataset. A citationcache object describes a formatted citation for a single item in another dataset.

To enable citation caching edit the archive's cfg/cfg.d/citationcaches.pl and change the appropriate line to:

$c->{citation_caching}->{enabled} = 1;
 

User Comments


CORE METADATA FIELDS

User Comments


citationcacheid (int)

The unique numerical ID of this citation cache event.

User Comments


datasetid (text)

The name of the dataset to which the item that has a citation cache belongs. eprint is used for eprints, rather than the inbox, buffer, etc.

User Comments


objectid (int)

The numerical ID of the object in the dataset.

User Comments


style (text)

The style of citation for a particular item. Each data object may have many different citation styles and defined appropriate data object's sub-directory of the citations configuration directory.

User Comments


citation_text (text)

The actually text generated for the citation cache by render_citation.

User Comments


timestamp (time)

The moment at which this citation cache was generated.

User Comments


REFERENCES AND RELATED OBJECTS

None.

User Comments


INSTANCE VARIABLES

See <EPrints::DataObj|EPrints::DataObj#INSTANCE_VARIABLES>.

User Comments


METHODS

User Comments


Constructor Methods

User Comments


create

EPrints::DataObj::CitationCache::create( $session, $data );

Create a new citationcache object from supplied $data. Unlike other create methods this one does not return the new object as it's never needed, and would increase the load on modifying items.

Also, this does not queue the fields for indexing.

User Comments


Class Methods

User Comments


get_system_field_info

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

Return the metadata field configuration for this object.

User Comments


get_dataset_id

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

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

User Comments


get_defaults

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

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

User Comments


Object Methods

User Comments


commit

$citationcache->commit 

Commit the formatted text generated for a citationcache

User Comments


render

$xhtml = $citationcache->render

A citation cache cannot have a rendering of itself.

User Comments


get_dataobj

$dataobj = $citationcache->get_dataobj

Returns the object to which this citation cache relates.

User Comments


SEE ALSO

EPrints::DataObj and EPrints::DataSet.

User Comments


COPYRIGHT

© Copyright 2022 University of Southampton.

EPrints 3.4 is supplied by EPrints Services.

http://www.eprints.org/eprints-3.4/

LICENSE

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

EPrints 3.4 and this file are released under the terms of the GNU Lesser General Public License version 3 as published by the Free Software Foundation unless otherwise stated.

EPrints 3.4 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 3.4. If not, see http://www.gnu.org/licenses/.

User Comments