Category:API - Revision history

Drn@ecs.soton.ac.uk: Moved API content to template so it can be transcluded in two places.

2017-09-08T12:54:48Z

Moved API content to template so it can be transcluded in two places.

← Older revision		Revision as of 12:54, 8 September 2017
Line 1:		Line 1:
	{{API}}		{{API}}

	~~EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (~~API).		{{API Content}}

	~~Reasons you may need to write your own EPrints code:~~

	* customising the way the eprints summary pages are rendered
	* writing your own command-line script to control EPrints in some way
	* writing a new CGI script (dynamic web page)
	* writing a plugin

	~~== Key Sections ==~~
	* [[Core API]] provides a basic introduction to using the EPrints API.
	* [[StyleGuide]] gives guidance on how to code in a compatible style.
	* [[Modules]] discusses the framework for Plugins you write for the community.

	~~==Principal Modules==~~

	~~This is a list of the principal modules in the EPrints API. These modules are the primary means of connecting to and manipulating objects in the repository.~~


	~~===[[API:EPrints/Repository\|EPrints::Repository]]===~~

	An Repository is a eprints archive with it's own website configuration and data. One install of the eprints software can run serveral seperate repositories. Sharing code but with totally different configurations. Before EPrints 2.4 this was known as EPrints::Archive. This was changed to avoid confusion with the eprint status of "archive".

	~~===[[API:EPrints/Database\|EPrints::Database]]===~~

	~~The connection to the MySQL (or other database) back end. ''datasets'' are stored in the MySQL system, but you do not have to address it directly.~~

	~~===[[API:EPrints/DataSet\|EPrints::DataSet]]===~~

	~~A dataset is a collection of ''items'' of the same type. It can be searched.~~

	Some datasets all have the same "config id". The "config id" is used to get information about the dataset from the archive config - inbox, buffer, archive and deletion all have the same metadata fields and types.

	~~Core datasets are:~~

	{\|
	~~\| DATASET ID~~
	~~\| COMMENT~~
	\|-
	~~\| eprint~~
	~~\| EPrint records are the core of the system.~~
	\|-
	~~\| user~~
	~~\| Users registered with the system.~~
	\|-
	~~\| subject~~
	~~\| The subject tree.~~
	\|-
	~~\| document~~
	~~\| Documents belonging to EPrints. Every document is part of an EPrint record.~~
	\|-
	~~\| subscription~~
	~~\| Subscriptions made by users. Every subscription is a part of a Subscription record.~~
	\|-
	~~\| history~~
	~~\| Stores actions performed on records.~~
	\|}

	~~In addtion to these datasets are four virtual datasets: inbox, buffer, archive and deletion. These act just like "eprint" except that they are filtered to only contain records with those status.~~

	~~Note that prior to 2.4 the "eprint" dataset was virtual, rather than "inbox", "buffer" etc. The History dataset was introduced in 2.4.~~

	~~===[[API:EPrints/MetaField\|EPrints::MetaField]]===~~

	~~A single field in a dataset. Each dataset has a few "system" fields which eprints uses to manage the system and then any number of ''archive'' specific fields which you may configure.~~

	~~===[[API:EPrints/DataObj\|EPrints::DataObj]]===~~

	The "super class" of ''subjects'', ''users'', ''eprints'' and ''documents'' etc. In the very core of the system these are all treated identically and much of the configuration and methods of these classes of "thing" are identical. We use the term ''item'' to speak about the general case.

	; '''type''' or '''user-type''' or '''eprint-type''' : ''users'', ''eprints'' and ''documents'' all have a "type". This controls how they are "cited" and also for ''users'' and ''eprints'' it controls what ''fields'' may be edited, and which are required.

	~~====[[API:EPrints/DataObj/Document\|EPrints::DataObj::Document]]====~~

	A document is a single format of an ''eprint'', eg. HTML, PDF, PS etc. It can contain more than one file, for example HTML may contain more than one html page + image files. The actual files are stored in the filesystem. Pre 2.4 this was known as EPrints::Document.

	~~====[[API:EPrints/DataObj/EPrint\|EPrints::DataObj::EPrint]]====~~

	An eprint is a record in the system which has one or more ''documents'' and some ''metadata''. Usually, more than one ''document'' is to provide the same information in multiple formats, although this is not compulsory. Pre 2.4 this was known as EPrints::EPrint.

	~~====[[API:EPrints/DataObj/SavedSearch\|EPrints::DataObj::SavedSearch]]====~~

	~~Some software refers to this concept as "alerts".~~

	~~A stored search which is performed every day/week/month and any new results are the mailed to the user who owns the subscription.~~

	~~This diagram does not show "Subscription". Subscription is a subclass of DataObj (like EPrint, User etc.). A Subscription is associated with one User. A User is associated with 0..n Subscription's.~~

	~~====[[API:EPrints/DataObj/Subject\|EPrints::DataObj::Subject]]====~~

	A ''subject'' has an id and a list of who it's parents are. There is a build in ''subject'' with the id "ROOT" to act as the top level. A subject can have more than one parent to allow you to create a rich lattice, rather than just a tree, but loops are not allowed.

	~~====[[API:EPrints/DataObj/User\|EPrints::DataObj::User]]====~~

	~~A user registered with the system. (NOT necesarily the author of the ''eprints'' they deposit). Pre 2.4 this was known as EPrints::User~~

Pm705 at 15:47, 10 January 2016

2016-01-10T15:47:20Z

← Older revision		Revision as of 15:47, 10 January 2016
Line 1:		Line 1:
			{{API}}

	EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (API).		EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (API).

Dkane: /* Principal Modules */

2011-11-05T12:08:19Z

Principal Modules

← Older revision		Revision as of 12:08, 5 November 2011
Line 14:		Line 14:
	* [[Modules]] discusses the framework for Plugins you write for the community.		* [[Modules]] discusses the framework for Plugins you write for the community.

	==~~Principle~~ Modules==		==Principal Modules==

	This is a list of the ~~principle~~ modules in the EPrints API. These modules are the primary means of connecting to and manipulating objects in the repository.		This is a list of the principal modules in the EPrints API. These modules are the primary means of connecting to and manipulating objects in the repository.

DaveTarrant: /* EPrints::Database */

2010-11-30T17:25:41Z

EPrints::Database

← Older revision		Revision as of 17:25, 30 November 2010
Line 25:		Line 25:
	===[[API:EPrints/Database\|EPrints::Database]]===		===[[API:EPrints/Database\|EPrints::Database]]===

	The connection to the MySQL back end. ''datasets'' are stored in the MySQL system, but you do not have to address it directly.		The connection to the MySQL (or other database) back end. ''datasets'' are stored in the MySQL system, but you do not have to address it directly.

	===[[API:EPrints/DataSet\|EPrints::DataSet]]===		===[[API:EPrints/DataSet\|EPrints::DataSet]]===

Cjg at 12:04, 19 May 2010

2010-05-19T12:04:28Z

← Older revision		Revision as of 12:04, 19 May 2010
Line 1:		Line 1:
	~~{{manual}}~~

	EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (API).		EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (API).
Line 10:		Line 9:
	* writing a plugin		* writing a plugin

	[[Core API]] provides a basic introduction to using the EPrints API~~, and~~ [[StyleGuide]] gives guidance on how to code in a compatible style~~, and~~ [[Modules]] discusses the framework for Plugins you write for the community		== Key Sections ==
			* [[Core API]] provides a basic introduction to using the EPrints API.
			* [[StyleGuide]] gives guidance on how to code in a compatible style.
			* [[Modules]] discusses the framework for Plugins you write for the community.

	==Principle Modules==		==Principle Modules==

Pm705: /* Principle Modules */

2010-02-24T01:29:52Z

Principle Modules

← Older revision		Revision as of 01:29, 24 February 2010
Line 16:		Line 16:
	This is a list of the principle modules in the EPrints API. These modules are the primary means of connecting to and manipulating objects in the repository.		This is a list of the principle modules in the EPrints API. These modules are the primary means of connecting to and manipulating objects in the repository.

	~~===[[API:EPrints/Session\|EPrints::Session]]===~~

	~~A session is created every time a cgi script or a bin script is executed, and terminated afterwards.~~

	===[[API:EPrints/Repository\|EPrints::Repository]]===		===[[API:EPrints/Repository\|EPrints::Repository]]===

	An ~~archive~~ is a eprints archive with it's own website configuration and data. One install of the eprints software can run serveral seperate ~~archives~~. Sharing code but with totally different configurations. Before EPrints 2.4 this was known as EPrints::Archive. This was changed to avoid confusion with the eprint status of "archive".		An Repository is a eprints archive with it's own website configuration and data. One install of the eprints software can run serveral seperate repositories. Sharing code but with totally different configurations. Before EPrints 2.4 this was known as EPrints::Archive. This was changed to avoid confusion with the eprint status of "archive".

	===[[API:EPrints/Database\|EPrints::Database]]===		===[[API:EPrints/Database\|EPrints::Database]]===

Tdb01r at 12:15, 12 August 2009

2009-08-12T12:15:42Z

@@ Line 1: / Line 1: @@
 EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (API).
@@ Line 8: / Line 10: @@
 * writing a plugin
-Before you start looking at the API you may want to look at [[Documentation|EPrints Manual]], which has pointers to how-tos, tutorials etc.
+[[Core API]] provides a basic introduction to using the EPrints API, and [[StyleGuide]] gives guidance on how to code in a compatible style, and [[Modules]] discusses the framework for Plugins you write for the community
-[[Core API]] provides a basic introduction to using the EPrints API, and [[StyleGuide]] gives guidance on how to code in a compatible style, and [[Modules]] discusses the framework for Plugins you write for the community
+==Principle Modules==

Kiz at 09:28, 12 August 2009

2009-08-12T09:28:44Z

← Older revision		Revision as of 09:28, 12 August 2009
Line 10:		Line 10:
	Before you start looking at the API you may want to look at [[Documentation\|EPrints Manual]], which has pointers to how-tos, tutorials etc.		Before you start looking at the API you may want to look at [[Documentation\|EPrints Manual]], which has pointers to how-tos, tutorials etc.

	[[Core API]] provides a basic introduction to using the EPrints API, and [[StyleGuide]] gives guidance on how to code in a compatible style.		[[Core API]] provides a basic introduction to using the EPrints API, and [[StyleGuide]] gives guidance on how to code in a compatible style, and [[Modules]] discusses the framework for Plugins you write for the community

Kiz at 09:21, 12 August 2009

2009-08-12T09:21:43Z

← Older revision		Revision as of 09:21, 12 August 2009
Line 10:		Line 10:
	Before you start looking at the API you may want to look at [[Documentation\|EPrints Manual]], which has pointers to how-tos, tutorials etc.		Before you start looking at the API you may want to look at [[Documentation\|EPrints Manual]], which has pointers to how-tos, tutorials etc.

	[[Core API]] provides a basic introduction to using the EPrints API.		[[Core API]] provides a basic introduction to using the EPrints API, and [[StyleGuide]] gives guidance on how to code in a compatible style.

Tdb01r at 19:37, 11 August 2009

2009-08-11T19:37:43Z

← Older revision		Revision as of 19:37, 11 August 2009
Line 1:		Line 1:
	~~This category provides access~~ to the EPrints Application Programming Interface (API) ~~documentation~~.		EPrints is written in the [http://www.perl.org/ Perl language]. Sometimes you may need to write your own Perl code using the EPrints Application Programming Interface (API).

	~~For introductory material~~ look at [[Documentation]].		Reasons you may need to write your own EPrints code:

			* customising the way the eprints summary pages are rendered
			* writing your own command-line script to control EPrints in some way
			* writing a new CGI script (dynamic web page)
			* writing a plugin

			Before you start looking at the API you may want to look at [[Documentation\|EPrints Manual]], which has pointers to how-tos, tutorials etc.

	[[Core API]] provides a basic introduction to using the EPrints API.		[[Core API]] provides a basic introduction to using the EPrints API.