Open Journal Systems
3.3.0
|
Data Fields | |
$pluginCategory | |
$pluginPath | |
$request | |
Protected Member Functions | |
_registerTemplateResource ($inCore=false) | |
Abstract class for plugins.
For best performance, a plug-in should not be instantiated if it is disabled or the current page/operation does not require the plug-in's functionality.
Newer plug-ins support enable/disable and request filter settings that enable the PKP library plug-in framework to lazy-load plug-ins only when their functionality is actually being required for a request.
For backwards compatibility we need to assume that older plug-ins do not support lazy-load because their register() method and hooks may have side-effects required on all requests. We have no way of knowing on which pages these side effects are important so we need to load legacy plug-ins on all pages.
In these cases the register() function will be called on every request when the category the plug-in belongs to is being loaded. This was the default behavior before plug-in lazy load was introduced.
Plug-ins that want to enable lazy-load have to include a 'lazy-load' setting in their version.xml:
<lazy-load>1</lazy-load>
Definition at line 51 of file Plugin.inc.php.
Plugin::__construct | ( | ) |
Plugin::_overridePluginTemplates | ( | $hookName, | |
$args | |||
) |
Call this method when an enabled plugin is registered in order to override template files. Any plugin which calls this method can override template files by adding their own templates to: <overridingPlugin>/templates/plugins/<category>/<originalPlugin>/templates/<path>.tpl
$hookName | string TemplateResource::getFilename |
$args | array [ @option string File path to preferred template. Leave as-is to not override template. @option string Template file requested ] |
Definition at line 398 of file Plugin.inc.php.
|
protected |
Register this plugin's templates as a template resource
$inCore | boolean True iff this is a core resource. |
Definition at line 376 of file Plugin.inc.php.
References PKPTemplateManager\getManager(), getTemplatePath(), and getTemplateResource().
Referenced by BrowseBySectionPlugin\register(), TexturePlugin\register(), register(), and UsageStatsPlugin\register().
Plugin::addLocaleData | ( | $locale = null | ) |
Load locale data for this plugin.
$locale | string |
Definition at line 454 of file Plugin.inc.php.
References AppLocale\getLocale(), getLocaleFilename(), and AppLocale\registerLocaleFile().
Referenced by SubscriptionSSOPlugin\register(), ArticleReportPlugin\register(), ResolverPlugin\register(), SubscriptionReportPlugin\register(), LDAPAuthPlugin\register(), PubMedExportPlugin\register(), ReviewReportPlugin\register(), ViewReportPlugin\register(), PKPUserImportExportPlugin\register(), NativeImportExportPlugin\register(), OAIMetadataFormatPlugin\register(), QuickSubmitPlugin\register(), PKPUsageStatsReportPlugin\register(), PKPPubIdPlugin\register(), LazyLoadPlugin\register(), CounterReportPlugin\register(), MetadataPlugin\register(), SwordImportExportPlugin\register(), PKPAcronPlugin\register(), ManualPaymentPlugin\register(), PaypalPaymentPlugin\register(), and PubObjectsExportPlugin\register().
Plugin::getActions | ( | $request, | |
$actionArgs | |||
) |
Get a list of link actions for plugin management.
request | PKPRequest |
$actionArgs | array The list of action args to be included in request URLs. |
Reimplemented in SwordPlugin, UsageStatsPlugin, MarkupPlugin, WebFeedPlugin, PLNPlugin, AnnouncementFeedPlugin, GoogleAnalyticsPlugin, OrcidProfilePlugin, CitationStyleLanguagePlugin, StaticPagesPlugin, ReportPlugin, SubscriptionSSOPlugin, CustomBlockManagerPlugin, PKPAcronPlugin, PKPPubIdPlugin, and ImportExportPlugin.
Definition at line 844 of file Plugin.inc.php.
Plugin::getCanDisable | ( | ) |
Determine whether the plugin can be disabled.
Reimplemented in LazyLoadPlugin, TinyMCEPlugin, OAIMetadataFormatPlugin_JATS, and GatewayPlugin.
Definition at line 860 of file Plugin.inc.php.
Plugin::getCanEnable | ( | ) |
Determine whether the plugin can be enabled.
Reimplemented in LazyLoadPlugin, OAIMetadataFormatPlugin_JATS, and GatewayPlugin.
Definition at line 852 of file Plugin.inc.php.
Plugin::getCategory | ( | ) |
Get the name of the category this plugin is registered to.
Definition at line 322 of file Plugin.inc.php.
References $pluginCategory.
Referenced by CustomBlockManagerPlugin\getActions(), OrcidProfilePlugin\smartyPluginUrl(), and smartyPluginUrl().
Plugin::getContextSpecificPluginSettingsFile | ( | ) |
Get the filename of the settings data for this plugin to install when a new application context (e.g. journal, conference or press) is installed.
Subclasses using default settings should override this.
Reimplemented in DefaultThemePlugin, PLNPlugin, MarkupPlugin, WebFeedPlugin, PdfJsViewerPlugin, GoogleScholarPlugin, LensGalleyPlugin, DublinCoreMetaPlugin, TinyMCEPlugin, HtmlArticleGalleyPlugin, DevelopedByBlockPlugin, ResolverPlugin, LanguageToggleBlockPlugin, SubscriptionBlockPlugin, and InformationBlockPlugin.
Definition at line 268 of file Plugin.inc.php.
Referenced by register().
Plugin::getCurrentVersion | ( | ) |
Get the current version of this plugin
Definition at line 810 of file Plugin.inc.php.
References $pluginPath, DAORegistry\getDAO(), and getPluginPath().
|
abstract |
Get a description of this plugin.
Reimplemented in OrcidProfilePlugin, DefaultThemePlugin, SwordPlugin, UsageStatsPlugin, GoogleScholarPlugin, DublinCoreMetaPlugin, PLNPlugin, SubscriptionSSOPlugin, HealthSciencesThemePlugin, ImmersionThemePlugin, MarkupGatewayPlugin, TinyMCEPlugin, MarkupBatchGatewayPlugin, BootstrapThreeThemePlugin, CustomBlockPlugin, CriticalTimesThemePlugin, HypothesisPlugin, MarkupPlugin, PKPAcronPlugin, SwordImportExportPlugin, PKPUsageEventPlugin, CounterReportPlugin, PLNGatewayPlugin, LDAPAuthPlugin, WebFeedBlockPlugin, WebFeedGatewayPlugin, UsageStatsOptoutBlockPlugin, URNPubIdPlugin, AnnouncementFeedBlockPlugin, AnnouncementFeedGatewayPlugin, DOIPubIdPlugin, CrossRefExportPlugin, PdfJsViewerPlugin, QuickSubmitPlugin, DRIVERPlugin, LensGalleyPlugin, BrowseBySectionPlugin, PKPUserImportExportPlugin, NativeImportExportPlugin, ReviewReportPlugin, ResolverPlugin, HtmlArticleGalleyPlugin, DevelopedByBlockPlugin, RecommendByAuthorPlugin, RecommendBySimilarityPlugin, DataciteExportPlugin, PubMedExportPlugin, SubscriptionReportPlugin, LanguageToggleBlockPlugin, AnnouncementFeedPlugin, PKPUsageStatsReportPlugin, ArticleReportPlugin, PKPDc11MetadataPlugin, DOAJExportPlugin, CitationStyleLanguagePlugin, MedraExportPlugin, GoogleAnalyticsPlugin, ViewReportPlugin, SubscriptionBlockPlugin, OAIMetadataFormatPlugin_JATS, InformationBlockPlugin, PaypalPaymentPlugin, ManualPaymentPlugin, OAIMetadataFormatPlugin_MARC, OAIMetadataFormatPlugin_RFC1807, TexturePlugin, OAIMetadataFormatPlugin_MARC21, PKPOAIMetadataFormatPlugin_DC, MakeSubmissionBlockPlugin, WebFeedPlugin, CustomBlockManagerPlugin, DefaultTranslationPlugin, BrowseBlockPlugin, and StaticPagesPlugin.
Plugin::getDirName | ( | ) |
Get the directory name of the plugin
Definition at line 338 of file Plugin.inc.php.
|
abstract |
Get the display name for this plugin.
Reimplemented in OrcidProfilePlugin, DefaultThemePlugin, SwordPlugin, UsageStatsPlugin, GoogleScholarPlugin, DublinCoreMetaPlugin, PLNPlugin, SubscriptionSSOPlugin, HealthSciencesThemePlugin, ImmersionThemePlugin, MarkupGatewayPlugin, TinyMCEPlugin, MarkupBatchGatewayPlugin, BootstrapThreeThemePlugin, CustomBlockPlugin, CriticalTimesThemePlugin, HypothesisPlugin, MarkupPlugin, PKPAcronPlugin, SwordImportExportPlugin, PKPUsageEventPlugin, CounterReportPlugin, PLNGatewayPlugin, LDAPAuthPlugin, WebFeedBlockPlugin, WebFeedGatewayPlugin, UsageStatsOptoutBlockPlugin, URNPubIdPlugin, AnnouncementFeedBlockPlugin, AnnouncementFeedGatewayPlugin, DOIPubIdPlugin, DRIVERPlugin, CrossRefExportPlugin, PdfJsViewerPlugin, QuickSubmitPlugin, ResolverPlugin, LensGalleyPlugin, BrowseBySectionPlugin, ReviewReportPlugin, PKPUserImportExportPlugin, HtmlArticleGalleyPlugin, NativeImportExportPlugin, DevelopedByBlockPlugin, RecommendByAuthorPlugin, RecommendBySimilarityPlugin, DataciteExportPlugin, PubMedExportPlugin, SubscriptionReportPlugin, LanguageToggleBlockPlugin, PKPUsageStatsReportPlugin, ArticleReportPlugin, AnnouncementFeedPlugin, ViewReportPlugin, PKPDc11MetadataPlugin, DOAJExportPlugin, CitationStyleLanguagePlugin, MedraExportPlugin, GoogleAnalyticsPlugin, SubscriptionBlockPlugin, OAIMetadataFormatPlugin_JATS, InformationBlockPlugin, PaypalPaymentPlugin, OAIMetadataFormatPlugin_MARC, OAIMetadataFormatPlugin_RFC1807, ManualPaymentPlugin, OAIMetadataFormatPlugin_MARC21, PKPOAIMetadataFormatPlugin_DC, TexturePlugin, MakeSubmissionBlockPlugin, CustomBlockManagerPlugin, DefaultTranslationPlugin, WebFeedPlugin, BrowseBlockPlugin, and StaticPagesPlugin.
Referenced by ThemePlugin\addOption().
Plugin::getEnabled | ( | ) |
Determine whether the plugin is enabled.
Reimplemented in MarkupGatewayPlugin, PLNGatewayPlugin, AnnouncementFeedGatewayPlugin, OAIMetadataFormatPlugin_JATS, and GatewayPlugin.
Definition at line 868 of file Plugin.inc.php.
Referenced by AnnouncementFeedPlugin\callbackAddLinks(), UsageStatsPlugin\callbackParseCronTab(), GoogleAnalyticsPlugin\getActions(), PKPPubIdPlugin\getActions(), PKPAcronPlugin\getActions(), CustomBlockManagerPlugin\getActions(), SubscriptionSSOPlugin\getActions(), AnnouncementFeedPlugin\getActions(), PLNPlugin\getActions(), WebFeedPlugin\getActions(), ReportPlugin\getActions(), StaticPagesPlugin\getActions(), MarkupPlugin\getActions(), UsageStatsPlugin\getActions(), SwordPlugin\getActions(), OrcidProfilePlugin\getActions(), PLNPlugin\getManagementVerbs(), BrowseBySectionPlugin\loadPageHandler(), SubscriptionSSOPlugin\register(), PdfJsViewerPlugin\register(), HtmlArticleGalleyPlugin\register(), LensGalleyPlugin\register(), TinyMCEPlugin\register(), AnnouncementFeedPlugin\register(), DublinCoreMetaPlugin\register(), GoogleAnalyticsPlugin\register(), GoogleScholarPlugin\register(), BrowseBySectionPlugin\register(), DOIPubIdPlugin\register(), URNPubIdPlugin\register(), OAIMetadataFormatPlugin\register(), PKPPubIdPlugin\register(), SwordPlugin\register(), RecommendByAuthorPlugin\register(), DRIVERPlugin\register(), RecommendBySimilarityPlugin\register(), DefaultTranslationPlugin\register(), CustomBlockManagerPlugin\register(), WebFeedPlugin\register(), TexturePlugin\register(), OrcidProfilePlugin\register(), StaticPagesPlugin\register(), CitationStyleLanguagePlugin\register(), PLNPlugin\register(), MarkupPlugin\register(), UsageStatsPlugin\register(), and OrcidProfilePlugin\setupCallbackHandler().
Plugin::getHideManagement | ( | ) |
Determine whether or not this plugin should be hidden from the management interface. Useful in the case of derivative plugins, i.e. when a generic plugin registers a feed plugin.
Reimplemented in MarkupGatewayPlugin, CustomBlockPlugin, WebFeedBlockPlugin, PLNGatewayPlugin, AnnouncementFeedGatewayPlugin, UsageStatsOptoutBlockPlugin, WebFeedGatewayPlugin, and AnnouncementFeedBlockPlugin.
Definition at line 203 of file Plugin.inc.php.
Plugin::getInstallControlledVocabFiles | ( | ) |
Get the filename of the controlled vocabulary for this plugin to install when the system is installed. Null if none included.
Reimplemented in MetadataPlugin.
Definition at line 255 of file Plugin.inc.php.
Referenced by installControlledVocabs(), and register().
Plugin::getInstallDataFile | ( | ) |
Get the filename of the install data for this plugin. Subclasses using SQL tables should override this.
Reimplemented in PLNPlugin.
Definition at line 235 of file Plugin.inc.php.
Referenced by installData(), installEmailTemplateData(), and register().
Plugin::getInstallEmailTemplateDataFile | ( | ) |
Get the filename of the email template data for this plugin. Subclasses using email templates should override this.
Definition at line 290 of file Plugin.inc.php.
Referenced by installEmailTemplateData(), installLocale(), and register().
Plugin::getInstallEmailTemplatesFile | ( | ) |
Get the filename of the email templates for this plugin. Subclasses using email templates should override this.
Reimplemented in OrcidProfilePlugin, SwordPlugin, PaypalPaymentPlugin, and ManualPaymentPlugin.
Definition at line 278 of file Plugin.inc.php.
Referenced by installEmailTemplates(), installLocale(), and register().
Plugin::getInstallFilterConfigFiles | ( | ) |
Get the filename(s) of the filter configuration data for this plugin. Subclasses using filters can override this.
The default implementation establishes "well known" locations for the filter configuration. If you keep your files in these locations then there's no need to override this method.
Definition at line 304 of file Plugin.inc.php.
References getPluginPath().
Referenced by installFilters().
Plugin::getInstallMigration | ( | ) |
Get the installation migration for this plugin.
Reimplemented in UsageStatsPlugin.
Definition at line 225 of file Plugin.inc.php.
Referenced by register(), and updateSchema().
Plugin::getInstallSchemaFile | ( | ) |
Get the filename of the ADODB schema for this plugin. Subclasses using SQL tables should override this.
Reimplemented in SwordPlugin, MarkupPlugin, StaticPagesPlugin, and PLNPlugin.
Definition at line 217 of file Plugin.inc.php.
Referenced by register(), and updateSchema().
Plugin::getInstallSitePluginSettingsFile | ( | ) |
Get the filename of the settings data for this plugin to install when the system is installed (i.e. site-level plugin settings). Subclasses using default settings should override this.
Reimplemented in DefaultThemePlugin, UsageStatsPlugin, PKPAcronPlugin, PKPUsageEventPlugin, TinyMCEPlugin, DevelopedByBlockPlugin, and LanguageToggleBlockPlugin.
Definition at line 246 of file Plugin.inc.php.
Referenced by installSiteSettings(), and register().
Plugin::getLocaleFilename | ( | $locale | ) |
Get the filename for the locale data for this plugin.
$locale | string |
Reimplemented in CounterReportPlugin.
Definition at line 531 of file Plugin.inc.php.
References getPluginPath().
Referenced by addLocaleData().
|
abstract |
Protected methods (may be overridden by custom plugins) Get the name of this plugin. The name must be unique within its category, and should be suitable for part of a filename (ie short, no spaces, and no dependencies on cases being unique).
Reimplemented in MarkupGatewayPlugin, MarkupBatchGatewayPlugin, MarkupPlugin, PKPAcronPlugin, SwordImportExportPlugin, CustomBlockPlugin, CounterReportPlugin, PLNGatewayPlugin, PKPUsageEventPlugin, LDAPAuthPlugin, WebFeedGatewayPlugin, UsageStatsOptoutBlockPlugin, ResolverPlugin, AnnouncementFeedBlockPlugin, CrossRefExportPlugin, LazyLoadPlugin, QuickSubmitPlugin, WebFeedBlockPlugin, ReviewReportPlugin, AnnouncementFeedGatewayPlugin, PKPUserImportExportPlugin, DataciteExportPlugin, NativeImportExportPlugin, ViewReportPlugin, PKPUsageStatsReportPlugin, PubMedExportPlugin, ArticleReportPlugin, SubscriptionReportPlugin, PKPDc11MetadataPlugin, DOAJExportPlugin, MedraExportPlugin, OAIMetadataFormatPlugin_MARC, OAIMetadataFormatPlugin_RFC1807, OAIMetadataFormatPlugin_MARC21, OAIMetadataFormatPlugin_JATS, PKPOAIMetadataFormatPlugin_DC, PaypalPaymentPlugin, and ManualPaymentPlugin.
Referenced by PubObjectsExportPlugin\executeExportAction(), ImportExportPlugin\getActions(), ReportPlugin\getActions(), getSetting(), installSiteSettings(), ImportExportPlugin\pluginUrl(), smartyPluginUrl(), and updateSetting().
Plugin::getPluginPath | ( | ) |
Get the path this plugin's files are located in.
Reimplemented in MarkupGatewayPlugin, MarkupBatchGatewayPlugin, PLNGatewayPlugin, UsageStatsOptoutBlockPlugin, WebFeedBlockPlugin, WebFeedGatewayPlugin, AnnouncementFeedBlockPlugin, AnnouncementFeedGatewayPlugin, SwordImportExportPlugin, and CustomBlockPlugin.
Definition at line 330 of file Plugin.inc.php.
References $pluginPath.
Referenced by ImmersionThemePlugin\addSiteWideData(), MarkupPlugin\callbackLoadBatchHandler(), TexturePlugin\callbackLoadHandler(), UsageStatsPlugin\callbackLoadHandler(), MarkupPlugin\callbackLoadMarkupHandler(), PLNPlugin\callbackParseCronTab(), UsageStatsPlugin\callbackParseCronTab(), SwordPlugin\callbackSwordLoadHandler(), CounterReportPlugin\getClassPath(), InformationBlockPlugin\getContextSpecificPluginSettingsFile(), SubscriptionBlockPlugin\getContextSpecificPluginSettingsFile(), LanguageToggleBlockPlugin\getContextSpecificPluginSettingsFile(), ResolverPlugin\getContextSpecificPluginSettingsFile(), DevelopedByBlockPlugin\getContextSpecificPluginSettingsFile(), HtmlArticleGalleyPlugin\getContextSpecificPluginSettingsFile(), TinyMCEPlugin\getContextSpecificPluginSettingsFile(), DublinCoreMetaPlugin\getContextSpecificPluginSettingsFile(), LensGalleyPlugin\getContextSpecificPluginSettingsFile(), GoogleScholarPlugin\getContextSpecificPluginSettingsFile(), PdfJsViewerPlugin\getContextSpecificPluginSettingsFile(), WebFeedPlugin\getContextSpecificPluginSettingsFile(), MarkupPlugin\getContextSpecificPluginSettingsFile(), PLNPlugin\getContextSpecificPluginSettingsFile(), DefaultThemePlugin\getContextSpecificPluginSettingsFile(), MarkupPlugin\getCssUrl(), getCurrentVersion(), OrcidProfilePlugin\getHandlerPath(), PLNPlugin\getHandlerPath(), OrcidProfilePlugin\getIcon(), MetadataPlugin\getInstallControlledVocabFiles(), PLNPlugin\getInstallDataFile(), ManualPaymentPlugin\getInstallEmailTemplatesFile(), PaypalPaymentPlugin\getInstallEmailTemplatesFile(), SwordPlugin\getInstallEmailTemplatesFile(), OrcidProfilePlugin\getInstallEmailTemplatesFile(), getInstallFilterConfigFiles(), PLNPlugin\getInstallSchemaFile(), StaticPagesPlugin\getInstallSchemaFile(), MarkupPlugin\getInstallSchemaFile(), SwordPlugin\getInstallSchemaFile(), LanguageToggleBlockPlugin\getInstallSitePluginSettingsFile(), DevelopedByBlockPlugin\getInstallSitePluginSettingsFile(), TinyMCEPlugin\getInstallSitePluginSettingsFile(), PKPUsageEventPlugin\getInstallSitePluginSettingsFile(), PKPAcronPlugin\getInstallSitePluginSettingsFile(), UsageStatsPlugin\getInstallSitePluginSettingsFile(), DefaultThemePlugin\getInstallSitePluginSettingsFile(), StaticPagesPlugin\getJavaScriptURL(), MarkupPlugin\getJsUrl(), SwordPlugin\getJsUrl(), LensGalleyPlugin\getLensPath(), CounterReportPlugin\getLocaleFilename(), getLocaleFilename(), TexturePlugin\getPluginUrl(), OrcidProfilePlugin\getStyleSheet(), getTemplatePath(), getTemplateResource(), import(), installEmailTemplates(), installLocale(), ThemePlugin\isActive(), UsageStatsPlugin\loadJavascript(), HealthSciencesThemePlugin\loadTemplateData(), URNPubIdPlugin\loadUrnFieldComponent(), AnnouncementFeedPlugin\register(), PKPUserImportExportPlugin\register(), CustomBlockManagerPlugin\register(), WebFeedPlugin\register(), and UsageStatsPlugin\register().
& Plugin::getRequest | ( | ) |
Get the current request object
Definition at line 828 of file Plugin.inc.php.
References $request, and Registry\get().
Referenced by MarkupGatewayPlugin\_process(), ImmersionThemePlugin\addIssueTemplateData(), URNPubIdPlugin\addPublicationFormFields(), ImmersionThemePlugin\addSiteWideData(), ImmersionThemePlugin\addToIssueForm(), MarkupPlugin\callbackLoadMarkupHandler(), MarkupPlugin\callbackUserProfile(), MarkupGatewayPlugin\fetch(), MarkupPlugin\fetchGateway(), HealthSciencesThemePlugin\hasEmbeddedCSS(), ImmersionThemePlugin\hasEmbeddedCSS(), ImmersionThemePlugin\homepageAnnouncements(), URNPubIdPlugin\loadUrnFieldComponent(), ImmersionThemePlugin\readIssueFormFields(), MarkupPlugin\register(), TexturePlugin\templateFetchCallback(), and MarkupPlugin\templateFetchCallback().
Plugin::getSeq | ( | ) |
Return a number indicating the sequence in which this plugin should be registered compared to others of its category. Higher = later.
Reimplemented in MarkupBatchGatewayPlugin, and DefaultTranslationPlugin.
Definition at line 173 of file Plugin.inc.php.
Plugin::getSetting | ( | $contextId, | |
$name | |||
) |
Retrieve a plugin setting within the given context
$contextId | int Context ID |
$name | string Setting name |
Reimplemented in PLNPlugin, and OrcidProfilePlugin.
Definition at line 473 of file Plugin.inc.php.
References DAORegistry\getDAO(), getName(), and Config\getVar().
Referenced by UsageStatsPlugin\_getPluginSetting(), PKPAcronPlugin\_getTasksToRun(), URNPubIdPlugin\addPublicationFormFields(), DOIPubIdPlugin\addPublicationFormFields(), URNPubIdPlugin\addPublishFormNotice(), DOIPubIdPlugin\addPublishFormNotice(), ManualPaymentPlugin\addSettings(), PaypalPaymentPlugin\addSettings(), AnnouncementFeedPlugin\callbackAddLinks(), WebFeedPlugin\callbackAddLinks(), MarkupPlugin\callbackUserProfile(), URNPubIdPlugin\constructPubId(), MedraExportPlugin\depositXML(), DOAJExportPlugin\depositXML(), DataciteExportPlugin\depositXML(), CrossRefExportPlugin\depositXML(), PubObjectsExportPlugin\display(), UsageStatsPlugin\displayReaderArticleGraph(), UsageStatsPlugin\displayReaderMonographGraph(), UsageStatsPlugin\displayReaderPreprintGraph(), CustomBlockPlugin\getContents(), BlockPlugin\getEnabled(), GatewayPlugin\getEnabled(), LazyLoadPlugin\getEnabled(), OAIMetadataFormatPlugin_JATS\getEnabled(), CitationStyleLanguagePlugin\getEnabledCitationDownloads(), CitationStyleLanguagePlugin\getEnabledCitationStyles(), DOAJExportPlugin\getExportActions(), PubObjectsExportPlugin\getExportActions(), MarkupPlugin\getOTSLoginParametersForJournal(), CitationStyleLanguagePlugin\getPrimaryStyleName(), PubIdPlugin\getPubId(), URNPubIdPlugin\getResolvingURL(), CrossRefExportPlugin\getStatusMessage(), PKPUsageEventPlugin\getUniqueSiteId(), PaypalPaymentPlugin\handle(), ManualPaymentPlugin\isConfigured(), PaypalPaymentPlugin\isConfigured(), DOIPubIdPlugin\isObjectTypeEnabled(), URNPubIdPlugin\isObjectTypeEnabled(), SubscriptionSSOPlugin\loadHandlerCallback(), PubIdPlugin\manage(), SwordPlugin\performAutomaticDeposits(), CustomBlockManagerPlugin\register(), UsageStatsPlugin\register(), GoogleAnalyticsPlugin\registerScript(), SubscriptionSSOPlugin\subscribedUserCallback(), MarkupPlugin\templateFetchCallback(), DOIPubIdPlugin\validatePublicationDoi(), URNPubIdPlugin\validatePublicationUrn(), and PKPPubIdPlugin\verifyData().
Plugin::getTemplatePath | ( | $inCore = false | ) |
Return the canonical template path of this plug-in
$inCore | Return the core template path if true. |
Reimplemented in PLNGatewayPlugin, WebFeedBlockPlugin, and CustomBlockPlugin.
Definition at line 366 of file Plugin.inc.php.
References getPluginPath().
Referenced by _registerTemplateResource().
Plugin::getTemplateResource | ( | $template = null , |
|
$inCore = false |
|||
) |
Return the Resource Name for templates in this plugin, or if specified, the full resource locator for a specific template.
$template | Template path/filename, if desired |
$inCore | boolean True if a "core" template should be used. |
Definition at line 349 of file Plugin.inc.php.
References $pluginPath, and getPluginPath().
Referenced by SwordSettingsForm\__construct(), AuthorDepositForm\__construct(), SwordDepositPointForm\__construct(), QuickSubmitPlugin\_cancelSubmit(), _registerTemplateResource(), QuickSubmitPlugin\_saveSubmit(), BrowseBySectionPlugin\addSectionFormFields(), LensGalleyPlugin\articleCallback(), HtmlArticleGalleyPlugin\articleViewCallback(), OrcidProfilePlugin\authorFormFilter(), SwordPlugin\callbackSettingsTab(), StaticPagesPlugin\callbackShowWebsiteSettingsTabs(), RecommendByAuthorPlugin\callbackTemplateArticlePageFooter(), RecommendBySimilarityPlugin\callbackTemplateArticlePageFooter(), DOIPubIdExportPlugin\display(), DOAJExportPlugin\display(), PubMedExportPlugin\display(), PKPUserImportExportPlugin\display(), NativeImportExportPlugin\display(), SwordImportExportPlugin\display(), CounterReportPlugin\display(), CitationStyleLanguagePlugin\getCitationDownloads(), BlockPlugin\getContents(), UsageStatsOptoutBlockPlugin\getContents(), ManualPaymentPlugin\getPaymentForm(), DOIPubIdPlugin\getPubIdAssignFile(), URNPubIdPlugin\getPubIdAssignFile(), DOIPubIdPlugin\getPubIdMetadataFile(), URNPubIdPlugin\getPubIdMetadataFile(), AuthPlugin\getSettingsTemplate(), UsageStatsPlugin\getTemplate(), OrcidProfilePlugin\handleUserPublicProfileDisplay(), LensGalleyPlugin\issueCallback(), PdfJsViewerPlugin\issueCallback(), OrcidProfilePlugin\registrationFilter(), and PdfJsViewerPlugin\submissionCallback().
Plugin::import | ( | $class | ) |
Load a PHP file from this plugin's installation directory.
$class | string |
Definition at line 515 of file Plugin.inc.php.
References getPluginPath().
Plugin::installContextSpecificSettings | ( | $hookName, | |
$args | |||
) |
Callback used to install settings on new context (e.g. journal, conference or press) creation.
$hookName | string |
$args | array |
Definition at line 627 of file Plugin.inc.php.
References DAORegistry\getDAO().
Plugin::installControlledVocabs | ( | $hookName, | |
$args | |||
) |
Callback used to install controlled vocabularies on system install.
$hookName | string |
$args | array |
Definition at line 611 of file Plugin.inc.php.
References DAORegistry\getDAO(), and getInstallControlledVocabFiles().
Plugin::installData | ( | $hookName, | |
$args | |||
) |
Callback used to install data files.
$hookName | string |
$args | array |
Definition at line 558 of file Plugin.inc.php.
References getInstallDataFile(), and AppLocale\requireComponents().
Plugin::installEmailTemplateData | ( | $hookName, | |
$args | |||
) |
Callback used to install email template data.
$hookName | string |
$args | array |
Definition at line 679 of file Plugin.inc.php.
References DAORegistry\getDAO(), getInstallDataFile(), and getInstallEmailTemplateDataFile().
Plugin::installEmailTemplates | ( | $hookName, | |
$args | |||
) |
Callback used to install email templates.
$hookName | string |
$args | array |
Definition at line 641 of file Plugin.inc.php.
References DAORegistry\getDAO(), getInstallEmailTemplatesFile(), getPluginPath(), and AppLocale\registerLocaleFile().
Plugin::installFilters | ( | $hookName, | |
$args | |||
) |
Callback used to install filters.
$hookName | string |
$args | array |
Definition at line 727 of file Plugin.inc.php.
References getInstallFilterConfigFiles().
Plugin::installLocale | ( | $hookName, | |
$args | |||
) |
Callback used to install email template data on locale install.
$hookName | string |
$args | array |
Definition at line 705 of file Plugin.inc.php.
References DAORegistry\getDAO(), getInstallEmailTemplateDataFile(), getInstallEmailTemplatesFile(), getPluginPath(), and AppLocale\registerLocaleFile().
Plugin::installSiteSettings | ( | $hookName, | |
$args | |||
) |
Callback used to install settings on system install.
$hookName | string |
$args | array |
Definition at line 588 of file Plugin.inc.php.
References $application, PKPApplication\get(), DAORegistry\getDAO(), getInstallSitePluginSettingsFile(), and getName().
Plugin::isSitePlugin | ( | ) |
Site-wide plugins should override this function to return true.
Reimplemented in AuthPlugin, UsageStatsPlugin, CustomBlockManagerPlugin, PKPUsageEventPlugin, UsageStatsOptoutBlockPlugin, and PKPAcronPlugin.
Definition at line 182 of file Plugin.inc.php.
Referenced by LazyLoadPlugin\getEnabled(), and LazyLoadPlugin\setEnabled().
Plugin::manage | ( | $args, | |
$request | |||
) |
Perform a management function.
$args | array |
$request | PKPRequest |
Reimplemented in OrcidProfilePlugin, CitationStyleLanguagePlugin, PLNPlugin, MarkupPlugin, UsageStatsPlugin, WebFeedPlugin, AnnouncementFeedPlugin, CustomBlockManagerPlugin, SubscriptionSSOPlugin, PKPAcronPlugin, PKPPubIdPlugin, PubObjectsExportPlugin, GoogleAnalyticsPlugin, and PubIdPlugin.
Definition at line 192 of file Plugin.inc.php.
Plugin::register | ( | $category, | |
$path, | |||
$mainContextId = null |
|||
) |
Load and initialize the plug-in and register plugin hooks.
For backwards compatibility this method will be called whenever the plug-in's category is being loaded. If, however, registerOn() returns an array then this method will only be called when the plug-in is enabled and an entry in the result set of registerOn() matches the current request operation. An empty array matches all request operations.
$category | String Name of category plugin was registered to |
$path | String The path the plugin was found in |
$mainContextId | integer To identify if the plugin is enabled we need a context. This context is usually taken from the request but sometimes there is no context in the request (e.g. when executing CLI commands). Then the main context can be given as an explicit ID. |
Reimplemented in UsageStatsPlugin, MarkupPlugin, ThemePlugin, PLNPlugin, PubObjectsExportPlugin, CitationStyleLanguagePlugin, StaticPagesPlugin, OrcidProfilePlugin, PaypalPaymentPlugin, ManualPaymentPlugin, PKPAcronPlugin, TexturePlugin, WebFeedPlugin, CustomBlockManagerPlugin, DefaultTranslationPlugin, SwordImportExportPlugin, PKPUsageEventPlugin, MetadataPlugin, DRIVERPlugin, RecommendByAuthorPlugin, RecommendBySimilarityPlugin, CounterReportPlugin, LazyLoadPlugin, SwordPlugin, PKPPubIdPlugin, OAIMetadataFormatPlugin, PKPUsageStatsReportPlugin, QuickSubmitPlugin, URNPubIdPlugin, PKPUserImportExportPlugin, BrowseBySectionPlugin, NativeImportExportPlugin, UserImportExportPlugin, DOIPubIdPlugin, ReviewReportPlugin, ViewReportPlugin, LDAPAuthPlugin, ResolverPlugin, AnnouncementFeedPlugin, DublinCoreMetaPlugin, GoogleAnalyticsPlugin, GoogleScholarPlugin, HtmlArticleGalleyPlugin, LensGalleyPlugin, TinyMCEPlugin, PubMedExportPlugin, ArticleReportPlugin, SubscriptionReportPlugin, HypothesisPlugin, PdfJsViewerPlugin, and SubscriptionSSOPlugin.
Definition at line 99 of file Plugin.inc.php.
References _registerTemplateResource(), getContextSpecificPluginSettingsFile(), getInstallControlledVocabFiles(), getInstallDataFile(), getInstallEmailTemplateDataFile(), getInstallEmailTemplatesFile(), getInstallMigration(), getInstallSchemaFile(), getInstallSitePluginSettingsFile(), and HookRegistry\register().
Plugin::smartyPluginUrl | ( | $params, | |
$smarty | |||
) |
Extend the {url ...} smarty to support plugins.
$params | array |
$smarty | Smarty |
Reimplemented in OrcidProfilePlugin, and QuickSubmitPlugin.
Definition at line 793 of file Plugin.inc.php.
References getCategory(), and getName().
Plugin::updateSchema | ( | $hookName, | |
$args | |||
) |
Called during the install process to install the plugin schema, if applicable.
$hookName | string |
$args | array |
Definition at line 761 of file Plugin.inc.php.
References getInstallMigration(), and getInstallSchemaFile().
Plugin::updateSetting | ( | $contextId, | |
$name, | |||
$value, | |||
$type = null |
|||
) |
Update a plugin setting within the given context.
$contextId | int Context ID |
$name | string The name of the setting |
$value | mixed Setting value |
$type | string optional |
Definition at line 495 of file Plugin.inc.php.
References DAORegistry\getDAO(), and getName().
Referenced by PKPAcronPlugin\_parseCrontab(), PKPUsageEventPlugin\buildUsageEvent(), PLNPlugin\getServiceDocument(), PLNPlugin\getSetting(), PLNPlugin\manage(), ManualPaymentPlugin\saveSettings(), PaypalPaymentPlugin\saveSettings(), BlockPlugin\setEnabled(), GatewayPlugin\setEnabled(), LazyLoadPlugin\setEnabled(), and OAIMetadataFormatPlugin_JATS\setEnabled().
string Plugin::$pluginCategory |
Category name this plugin is registered to
Definition at line 62 of file Plugin.inc.php.
Referenced by getCategory().
string Plugin::$pluginPath |
Path name to files for this plugin
Definition at line 56 of file Plugin.inc.php.
Referenced by getCurrentVersion(), MetadataPlugin\getInstallControlledVocabFiles(), getPluginPath(), and getTemplateResource().
PKPRequest Plugin::$request |
the current request object
Definition at line 68 of file Plugin.inc.php.
Referenced by QuickSubmitPlugin\_cancelSubmit(), QuickSubmitPlugin\_deleteUploadedImage(), HtmlArticleGalleyPlugin\_getHTMLContents(), DataciteExportPlugin\_getObjectUrl(), LensGalleyPlugin\_getXMLContents(), HtmlArticleGalleyPlugin\_handleOjsUrl(), LensGalleyPlugin\_handleOjsUrl(), MarkupGatewayPlugin\_initXMLPSWrapper(), QuickSubmitPlugin\_reloadForm(), QuickSubmitPlugin\_saveSubmit(), QuickSubmitPlugin\_saveUploadedImage(), QuickSubmitPlugin\_showFileUploadForm(), QuickSubmitPlugin\_uploadImage(), ImmersionThemePlugin\addIssueTemplateData(), URNPubIdPlugin\addJavaScript(), UsageStatsPlugin\addJavascriptData(), BrowseBySectionPlugin\addMenuItemTypes(), BrowseBySectionPlugin\addSitemapURLs(), ImmersionThemePlugin\addSiteWideData(), ImmersionThemePlugin\addToIssueForm(), LensGalleyPlugin\articleCallback(), HtmlArticleGalleyPlugin\articleDownloadCallback(), LensGalleyPlugin\articleDownloadCallback(), DublinCoreMetaPlugin\articleView(), HtmlArticleGalleyPlugin\articleViewCallback(), OrcidProfilePlugin\buildOAuthUrl(), OrcidProfilePlugin\buildOrcidWork(), PKPUsageEventPlugin\buildUsageEvent(), AnnouncementFeedPlugin\callbackAddLinks(), WebFeedPlugin\callbackAddLinks(), StaticPagesPlugin\callbackHandleContent(), PKPAcronPlugin\callbackLoadHandler(), MarkupPlugin\callbackLoadMarkupHandler(), SwordPlugin\callbackSettingsTab(), MarkupPlugin\callbackShowArticlesBatchConversionTabs(), StaticPagesPlugin\callbackShowWebsiteSettingsTabs(), MarkupPlugin\callbackShowWebsiteSettingsTabs(), RecommendByAuthorPlugin\callbackTemplateArticlePageFooter(), RecommendBySimilarityPlugin\callbackTemplateArticlePageFooter(), MarkupPlugin\callbackUserProfile(), DataciteExportPlugin\depositXML(), DOIPubIdExportPlugin\display(), ViewReportPlugin\display(), DOAJExportPlugin\display(), ArticleReportPlugin\display(), PKPUsageStatsReportPlugin\display(), SubscriptionReportPlugin\display(), ReviewReportPlugin\display(), PubMedExportPlugin\display(), QuickSubmitPlugin\display(), ImportExportPlugin\display(), NativeImportExportPlugin\display(), PKPUserImportExportPlugin\display(), SwordImportExportPlugin\display(), PubObjectsExportPlugin\display(), CounterReportPlugin\display(), DataciteExportPlugin\executeExportAction(), DOAJExportPlugin\executeExportAction(), PubObjectsExportPlugin\executeExportAction(), CrossRefExportPlugin\executeExportAction(), ResolverPlugin\exportHoldings(), ResolverPlugin\fetch(), AnnouncementFeedGatewayPlugin\fetch(), WebFeedGatewayPlugin\fetch(), PLNGatewayPlugin\fetch(), MarkupBatchGatewayPlugin\fetch(), MarkupGatewayPlugin\fetch(), MarkupPlugin\fetchGateway(), ImportExportPlugin\getActions(), GoogleAnalyticsPlugin\getActions(), PKPPubIdPlugin\getActions(), PKPAcronPlugin\getActions(), CustomBlockManagerPlugin\getActions(), SubscriptionSSOPlugin\getActions(), AnnouncementFeedPlugin\getActions(), PLNPlugin\getActions(), WebFeedPlugin\getActions(), ReportPlugin\getActions(), StaticPagesPlugin\getActions(), MarkupPlugin\getActions(), UsageStatsPlugin\getActions(), SwordPlugin\getActions(), OrcidProfilePlugin\getActions(), CitationStyleLanguagePlugin\getArticleTemplateData(), CitationStyleLanguagePlugin\getCitation(), BrowseBlockPlugin\getContents(), MakeSubmissionBlockPlugin\getContents(), InformationBlockPlugin\getContents(), SubscriptionBlockPlugin\getContents(), LanguageToggleBlockPlugin\getContents(), AnnouncementFeedBlockPlugin\getContents(), WebFeedBlockPlugin\getContents(), CustomBlockPlugin\getContents(), MarkupPlugin\getCssUrl(), OAIMetadataFormatPlugin_JATS\getEnabled(), StaticPagesPlugin\getJavaScriptURL(), MarkupPlugin\getJsUrl(), SwordPlugin\getJsUrl(), LensGalleyPlugin\getLensPath(), DOIPubIdPlugin\getLinkActions(), URNPubIdPlugin\getLinkActions(), OrcidProfilePlugin\getOrcidUrl(), TexturePlugin\getPluginUrl(), getRequest(), PLNPlugin\getServiceDocument(), CrossRefExportPlugin\getStatusActions(), CrossRefExportPlugin\getStatusMessage(), TexturePlugin\getTextureUrl(), UsageEventPlugin\getUsageEventData(), PKPUsageEventPlugin\getUsageEventData(), ManualPaymentPlugin\handle(), PaypalPaymentPlugin\handle(), OrcidProfilePlugin\handleFormDisplay(), OrcidProfilePlugin\handlePublicationStatusChange(), OrcidProfilePlugin\handleSubmissionSubmitStep3FormExecute(), OrcidProfilePlugin\handleTemplateDisplay(), OrcidProfilePlugin\handleUserPublicProfileDisplay(), HealthSciencesThemePlugin\hasEmbeddedCSS(), ImmersionThemePlugin\hasEmbeddedCSS(), ImmersionThemePlugin\homepageAnnouncements(), BootstrapThreeThemePlugin\init(), DefaultThemePlugin\init(), BrowseBySectionPlugin\initDataSectionFormFields(), ThemePlugin\isActive(), LensGalleyPlugin\issueCallback(), PdfJsViewerPlugin\issueCallback(), CriticalTimesThemePlugin\loadArticleTemplateData(), SubscriptionSSOPlugin\loadHandlerCallback(), CriticalTimesThemePlugin\loadIssueTemplateData(), CriticalTimesThemePlugin\loadIssueTocHandler(), CriticalTimesThemePlugin\loadIssueTocTemplateData(), UsageStatsPlugin\loadJavascript(), CriticalTimesThemePlugin\loadSpotlightTemplateData(), CriticalTimesThemePlugin\loadTemplateData(), HealthSciencesThemePlugin\loadTemplateData(), PubIdPlugin\manage(), GoogleAnalyticsPlugin\manage(), PubObjectsExportPlugin\manage(), PKPPubIdPlugin\manage(), PKPAcronPlugin\manage(), SubscriptionSSOPlugin\manage(), CustomBlockManagerPlugin\manage(), AnnouncementFeedPlugin\manage(), WebFeedPlugin\manage(), UsageStatsPlugin\manage(), MarkupPlugin\manage(), PLNPlugin\manage(), OrcidProfilePlugin\manage(), SwordPlugin\performAutomaticDeposits(), ImmersionThemePlugin\readIssueFormFields(), BrowseBySectionPlugin\readSectionFormFields(), CustomBlockManagerPlugin\register(), MarkupPlugin\register(), UsageStatsPlugin\register(), TinyMCEPlugin\registerJS(), GoogleAnalyticsPlugin\registerScript(), OrcidProfilePlugin\registrationFilter(), ManualPaymentPlugin\saveSettings(), PaypalPaymentPlugin\saveSettings(), OrcidProfilePlugin\sendAuthorMail(), OrcidProfilePlugin\sendSubmissionToOrcid(), OAIMetadataFormatPlugin_JATS\setEnabled(), BrowseBySectionPlugin\setMenuItemDisplayDetails(), PdfJsViewerPlugin\submissionCallback(), GoogleScholarPlugin\submissionView(), SubscriptionSSOPlugin\subscribedUserCallback(), TexturePlugin\templateFetchCallback(), and MarkupPlugin\templateFetchCallback().