Difference between revisions of "API:EPrints/Plugin"
| Line 24: | Line 24: | ||
This class provides the basic methods used by all EPrints Plugins. | This class provides the basic methods used by all EPrints Plugins. | ||
| − | + | <!-- Edit below this comment --> | |
| − | |||
| − | |||
| − | |||
| − | + | <!-- Pod2Wiki= --> | |
| − | + | <!-- Pod2Wiki=head_methods --> | |
| + | ==METHODS== | ||
| + | <!-- Pod2Wiki=head_new --> | ||
| + | ===new=== | ||
| − | + | <source lang="perl">$plugin = EPrints::Plugin->new( %params ); | |
| − | + | ||
| + | </source> | ||
| + | Create a new instance of a plugin. Defines the following parameters: | ||
| + | |||
| + | <!-- Edit below this comment --> | ||
| + | |||
| + | |||
| + | <!-- Pod2Wiki= --> | ||
| + | <!-- Pod2Wiki=head_repository --> | ||
| + | ===repository=== | ||
| + | |||
| + | <source lang="perl">repository | ||
| + | |||
| + | </source> | ||
| + | Required handle to the current repository object. | ||
| + | |||
| + | <!-- Edit below this comment --> | ||
| + | |||
| + | |||
| + | <!-- Pod2Wiki= --> | ||
| + | <!-- Pod2Wiki=head_name --> | ||
| + | ===name=== | ||
| + | |||
| + | <source lang="perl">name | ||
| + | |||
| + | </source> | ||
| + | Human-readable name of the plugin. | ||
| + | |||
| + | <!-- Edit below this comment --> | ||
| + | |||
| + | |||
| + | <!-- Pod2Wiki= --> | ||
| + | <!-- Pod2Wiki=head_alias --> | ||
| + | ===alias=== | ||
| + | |||
| + | <source lang="perl">alias | ||
| + | |||
| + | </source> | ||
| + | Array reference of plugin id's that this plugin is aliasing (replacing). | ||
<!-- Edit below this comment --> | <!-- Edit below this comment --> | ||
Revision as of 11:16, 2 April 2012
EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects
Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki
Contents
NAME
EPrints::Plugin - base class of all EPrints Plugins
SYNOPSIS
$plugin = $repo->plugin( "Export::XML" );
DESCRIPTION
This class provides the basic methods used by all EPrints Plugins.
METHODS
new
$plugin = EPrints::Plugin->new( %params );
Create a new instance of a plugin. Defines the following parameters:
repository
repository
Required handle to the current repository object.
name
name
Human-readable name of the plugin.
alias
alias
Array reference of plugin id's that this plugin is aliasing (replacing).
$mime_type = EPrints::Plugin->mime_type()
Returns the MIME type for this plugin.
Returns undef if there is no relevant MIME type for this plugin type.
$value = EPrints::Plugin->local_uri
Return a unique ID for this plugin as it relates to the current repository. This can be used to distinguish that XML import for different repositories may have minor differences.
This URL will not resolve to anything useful.
$value = EPrints::Plugin->global_uri
Return a unique ID for this plugin, but not just in this repository but for any repository. This can be used for fuzzier tools which do not care about the minor differences between EPrints repositories.
This URL will not resolve to anything useful.
$id = $plugin->get_id
Return the ID of this plugin.
$name = $plugin->get_name
Return the ID of this plugin.
$name = $plugin->get_type
Return the type of this plugin. eg. Export
$name = $plugin->get_subtype
Return the sub-type of this plugin. eg. BibTex
This is the ID with the type stripped from the front.
$msg = $plugin->error_message
Return the error message, if this plugin can't be used.
$boolean = $plugin->broken
Return the value of a parameter in the current plugin.
$name = $plugin->matches( $test, $param )
Return true if this plugin matches the test, false otherwise. If the test is not known then return false.
$value = $plugin->param( $paramid )
Return the parameter with the given id. This uses the hard wired parameter unless an override has been configured for this repository:
$c->{plugins}->{"Export::XML"}->{params}->{name} = "My EP3 XML";
$c->{plugins}->{"Export::Ids"}->{params}->{disable} = 1;
$phraseid = $plugin->html_phrase_id( $id )
Returns the fully-qualified phrase identifier for the $id phrase for this plugin.
$xhtml = $plugin->html_phrase( $id, %bits )
Return the phrase belonging to this plugin, with the given id.
Returns a DOM tree.
$utf8 = $plugin->phrase( $id, %bits )
Return the phrase belonging to this plugin, with the given id.
Returns a utf-8 encoded string.
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/.
