Difference between revisions of "Pagerange field"

From EPrints Documentation
Jump to: navigation, search
(Added description. Added ToC. Reorganised other sections)
Line 1: Line 1:
 
{{fieldtypes}}
 
{{fieldtypes}}
__NOTOC__
+
 
 +
== Description ==
 +
This field is stored as a single text string in the database but is presented as two text fields to fill in a <tt>from</tt> and a <tt>to</tt>.  The text between the two fields is set using the <code>lib/metafield:to</code> phrase. 
 +
 
 +
When the two fields are saved to the database a <tt>-</tt> is added between the <tt>from</tt> and a <tt>to</tt> fields so <tt>5</tt> and <tt>10</tt> becomes <tt>5-10</tt>.  This would then be rendered in a citation using <code>lib/metafield/pagerange:range</code>, by default <tt>pp. 5-10</tt>.  If only the <tt>from</tt> field is entered or is the same as the <tt>to</tt> field then the citation would be rendered using <code>lib/metafield/pagerange:from_page</code> or <code>lib/metafield/pagerange:same_page</code> respectively, by default: <tt>p. 5</tt>, if <tt>from</tt> field is <tt>5</tt>.
 +
 
 
== Inheritance ==
 
== Inheritance ==
 
 
* [[Metadata]]
 
* [[Metadata]]
 
** [[Int field]]
 
** [[Int field]]
 
*** [[Pagerange field]]
 
*** [[Pagerange field]]
 
== Description ==
 
  
 
== Properties ==
 
== Properties ==
 
 
No extra properties.
 
No extra properties.
  
 
== Required Phrases ==
 
== Required Phrases ==
 +
No additional phrases.
  
 
== Database ==
 
== Database ==
 +
Pagerange fields are stored in the database as
 +
fieldname VARCHAR(255)
  
Pagerange fields are stored in the database as
+
== API ===
 +
See [[API:EPrints/MetaField/Namedset|API page]].
  
  fieldname VARCHAR(255)
+
== Examples ==
 +
Most basic example.
 +
  {
 +
    name => 'pagerange',
 +
    type => 'pagerange',
 +
}

Revision as of 21:14, 8 April 2023

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


Metadata Fields: Arclanguage - Base64 - Bigint - Boolean - Compound - Counter - Dataobjref - Date - Decimal - Email - Fields - Float - Id - Idci - Image - Int - Itemref - Keywords - Langid - Longtext - Longtext_counter - Multilang - Multipart - Name - Namedset - Pagerange - Recaptcha - Relation - Search - Secret - Set - Storable - Subject - Subobject - Text - Time - Timestamp - Url - Uuid

Description

This field is stored as a single text string in the database but is presented as two text fields to fill in a from and a to. The text between the two fields is set using the lib/metafield:to phrase.

When the two fields are saved to the database a - is added between the from and a to fields so 5 and 10 becomes 5-10. This would then be rendered in a citation using lib/metafield/pagerange:range, by default pp. 5-10. If only the from field is entered or is the same as the to field then the citation would be rendered using lib/metafield/pagerange:from_page or lib/metafield/pagerange:same_page respectively, by default: p. 5, if from field is 5.

Inheritance

Properties

No extra properties.

Required Phrases

No additional phrases.

Database

Pagerange fields are stored in the database as

fieldname VARCHAR(255)

API =

See API page.

Examples

Most basic example.

{
    name => 'pagerange',
    type => 'pagerange',
}