Actions

Plugin events: Difference between revisions

From LimeSurvey Manual

(→‎Specific Model events: Add models list link)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
At version 2.50 build 160425 the following events are available for plugins to subscribe to:
As of version 5 the following events are available for plugins to subscribe to:
 
NB: Version 2.60.0 is not the same as version 2.6, which is the new number for version 2.06. 2.60.0 comes after 2.59.1.


== Global Events ==
== Global Events ==


*[[afterFindSurvey]]
*[[afterFindSurvey]]
*[[afterGenerateToken]]
*[[afterPluginLoad]]
*[[afterPluginLoad]]
*[[afterQuickMenuLoad]]
*[[afterQuickMenuLoad]]
Line 11: Line 10:
*[[afterSurveyComplete]]
*[[afterSurveyComplete]]
*[[afterSurveyDeactivate]]
*[[afterSurveyDeactivate]]
*[[afterSurveyQuestionAssessment]]{{NewIn|v=2.62|b=170207}}
*[[afterSurveyQuestionAssessment]]
*[[afterSurveyQuota]]{{NewIn|v=2.05|b=141006}}
*[[afterSurveyQuota]]
*[[afterSurveySettingsSave]]
*[[afterSurveySettingsSave]]
*[[beforeActivate]]
*[[beforeActivate]]
*[[beforeAdminMenuRender]] {{NewIn|v=2.50|b=160426}}
*[[beforeAdminMenuRender]]  
*[[beforeEmail]]{{NewIn|v=4.0.0}}
*[[beforeEmail]]
*[[beforeCloseHtml]]{{NewIn|v=2.60.0}}
*[[beforeCloseHtml]]
*[[beforeControllerAction]]{{NewIn|v=2.50|b=160425}}
*[[beforeControllerAction]]
*[[beforeDeactivate]]
*[[beforeDeactivate]]
*[[beforeHasPermission]]{{NewIn|v=2.06}}
*[[beforeHasPermission]]
*[[beforeLoadResponse]]
*[[beforeLoadResponse]]
*[[beforePermissionSetSave]]
*[[beforePermissionSetSave]]
*[[beforePluginManagerMenuRender]]{{NewIn|v=4.0.0}}
*[[beforePluginManagerMenuRender]]
*[[beforeQuestionRender]]{{NewIn|v=2.05|b=140922}}
*[[beforeQuestionRender]]
*[[beforeRegister]]{{NewIn|v=2.06}}
*[[beforeRegister]]
*[[beforeRegisterForm]]{{NewIn|v=2.06}}
*[[beforeRegisterForm]]
*[[beforeSideMenuRender]]{{NewIn|v=2.51.0}}
*[[beforeSideMenuRender]]
*[[beforeSurveyAdminView]]
*[[beforeSurveyAdminView]]
*[[beforeSurveyActivate]] {{NewIn|v=3.15|b=181017}}
*[[beforeSurveyActivate]]  
*[[beforeSurveyBarRender]] {{NewIn|v=3.15|b=181017}}
*[[beforeSurveyBarRender]]  
*[[beforeSurveyDeactivate]]{{NewIn|v=2.5}}
*[[beforeSurveyDeactivate]]
*[[beforeSurveyEmail]]{{NewIn|v=4.0.0}}
*[[beforeSurveyEmail]]
*[[beforeSurveyPage]]{{NewIn|v=2.05|b=140109}}
*[[beforeSurveyPage]]
*[[beforeSurveySettings]]
*[[beforeSurveySettings]]
*[[beforeSurveysStartpageRender]]{{DeprecatedIn|v=3.0.0}}
*[[beforeSurveysStartpageRender]]{{DeprecatedIn|v=3.0.0}}
*[[beforeTokenEmail]]{{NewIn|v=2.05|b=140404}}
*[[beforeTokenEmail]]
*[[beforeTwigRenderTemplate]]
*[[beforeToolsMenuRender]]
*[[beforeToolsMenuRender]]
*[[beforeUrlCheck]]{{NewIn|v=3.12.2}}
*[[beforeUrlCheck]]
*[[beforeWelcomePageRender]]
*[[createNewUser]]
*[[createNewUser]]
*[[createRandomPassword]]{{NewIn|v=4.0.0|b=190523}}
*[[createRandomPassword]]
*[[checkPasswordRequirement]]{{NewIn|v=4.0.0|b=190523}}
*[[checkPasswordRequirement]]
*[[ExpressionScript EngineStart]] WIP {{NewIn|v=4.0.0-dev}}
*[[ExpressionManagerStart]]  
*[[getGlobalBasePermissions]]]{{NewIn|v=3.0.0}}
*[[getGlobalBasePermissions]]
*[[getPluginTwigPath]]{{NewIn|v=3.10.0}}
*[[getPluginTwigPath]]
*[[getValidScreenFiles]]
*[[listExportOptions]]
*[[listExportOptions]]
*[[listExportPlugins]]
*[[listExportPlugins]]
Line 50: Line 52:
*[[newDirectRequest]]
*[[newDirectRequest]]
*[[newExport]]
*[[newExport]]
*[[NewQuestionAttributes|newQuestionAttributes]]{{NewIn|v=2.50|b=160731}}
*[[NewQuestionAttributes|newQuestionAttributes]]
*[[newSurveySettings]]
*[[newSurveySettings]]
*[[newUnsecureRequest|NewUnsecureRequest]]
*[[newUnsecureRequest|NewUnsecureRequest]]
*[[onSurveyDenied]]{{NewIn|v=3.0.0}}
*[[onSurveyDenied]]
*[[setVariableExpressionEnd]]{{NewIn|v=4.0.0}}
*[[setVariableExpressionEnd]]
*[[saveSurveyForm]]{{NewIn|v=5.3.8}}


== CLI Events ==
== CLI Events ==
Line 60: Line 63:
This events needs to be called with php cli command.
This events needs to be called with php cli command.


*[[cron (command)|cron]]{{NewIn|v=2.05|b=140404}}
*[[cron (command)|cron]]
*[[direct (command)|direct]]{{NewIn|v=2.63.0|b=170304}}
*[[direct (command)|direct]]


== Authentification related events ==
== Authentification related events ==

Latest revision as of 12:17, 23 February 2024

As of version 5 the following events are available for plugins to subscribe to:

Global Events

CLI Events

This events needs to be called with php cli command.

Authentification related events


Model Events

All models (Survey, Question, etc.) support a series of before & after events.

Specific Model events

These include model-specific events (example for Survey model):

  • beforeSurveyDelete
  • beforeSurveySave
  • afterSurveyDelete
  • afterSurveySave

Available model in application/models/.

Dynamic model events (New in 3.15.1 )

  • beforeTokenDelete
  • beforeTokenSave
  • afterTokenDelete
  • afterTokenSave
  • beforeResponseDelete
  • beforeResponseSave
  • afterResponseDelete
  • afterResponseSave
  • beforeTokenDynamicDelete
  • beforeTokenDynamicSave
  • afterTokenDynamicDelete
  • afterTokenDynamicSave
  • beforeSurveyDynamicDelete
  • beforeSurveyDynamicSave
  • afterSurveyDynamicDelete
  • afterSurveyDynamicSave

Generic events

As well as generic events independent of the model's name:

In all of the above events, the associated model object is available as part of event data:

$model = $this->event->get('model');