      |
Action Class Reference
[Action]
Inherited by AddTrackbackAction, AdminAction, AdminDefaultAction, AdminLoginAction, BlogAction, ResourceServerAction, SummaryAction, and WizardAction.
Public Member Functions | |
| Action ($actionInfo, $httpRequest) | |
| perform () | |
| validate () | |
| validationErrorProcessing () | |
| setValidationErrorView ($view) | |
| registerFieldValidator ($fieldName, $validator, $onlyIfAvailable=false) | |
| registerField ($fieldName) | |
| getView () | |
| setCommonData ($copyFormValues=false) | |
| setForwardAction ($nextActionKey) | |
| setSuccess ($success) | |
Public Attributes | |
| $_view | |
| $_request | |
| $_actionInfo | |
| $_fieldValidators | |
| $_validationErrorView | |
| $_previousAction | |
| $_isSuccess | |
Private Member Functions | |
| setPreviousAction ($previousAction) | |
| getPreviousAction () | |
| setForwardActionParameter ($param, $value) | |
Detailed Description
The base most basic action class is Action, which provides some common code and the Action.perform() method which should be implemented by child classes wishing to provide some business logic. At the end of the method, an Action class is expected to generate a valid View object (or a child class of View) that will be used by the Controller to render some contents to be sent to the client.Action classes are expected to at least provide their own logic in the Action.perform() method. In previous versions of pLog it was also necessary to provide data validation logic in the Action.validate() method, but that is not necessary anymore (albeit possible if needed) since the introduction of the new data validation framework (See the FormValidator class and the Validator and Validator_Rules modules) The Action.validate() method now provides some code of its own that triggers the data validation process if there is any data to be validated.
There is a lot more information about the data validation framework here: http://wiki.plogworld.net/index.php/PLog_1.0/Forms_and_data_validation
The View object that Action classes must create can be set via the private attribute Action._view or te method Action.setView(), though the first one is the most widely used throughout the core code.
Please keep in mind that it is advisable to call the Action.setCommonData() method at the very end of the Action.perform() method in our custom classes because it needs to perform some extra operations right before the view is sent back to the controller.
Definition at line 51 of file action.class.php.
Member Function Documentation
| Action.Action | ( | $ | actionInfo, | |
| $ | httpRequest | |||
| ) |
Constructor.
- Parameters:
-
actionInfo An ActionInfo object contaning information about the action httpRequest the HTTP request.
Definition at line 69 of file action.class.php.
Referenced by AddTrackbackAction.AddTrackbackAction(), AdminAction.AdminAction(), AdminDefaultAction.AdminDefaultAction(), AdminLoginAction.AdminLoginAction(), BlogAction.BlogAction(), ResourceServerAction.ResourceServerAction(), SummaryAction.SummaryAction(), and WizardAction.WizardAction().
| Action.getPreviousAction | ( | ) | [private] |
returns the reference to the previous action in the process flow
- Returns:
- A valid Action object, or null if there is no previous action
Definition at line 111 of file action.class.php.
| Action.getView | ( | ) |
This function does not need to be reimplemented by the childs of this class. It just returns the resulting view of the operation.
- Returns:
- A valid View object
Definition at line 242 of file action.class.php.
| Action.perform | ( | ) |
Receives the HTTP request from the client as parameter, so that we can extract the parameters and perform our business logic.
The result of this will be a view, which will normally be the output of the processing we just did or for example an error view showing an error message. Once we have completed processing, the controller will call the getView() method to get the resulting view and send it back to the customer.
- Returns:
- Returns nothing
Reimplemented in AddCommentAction, AddTrackbackAction, AdminAddArticleCategoryAction, AdminAddArticleCategoryAjaxAction, AdminAddBlogAction, AdminAddBlogCategoryAction, AdminAddBlogTemplateAction, AdminAddBlogUserAction, AdminAddCustomFieldAction, AdminAddGlobalArticleCategoryAction, AdminAddLinkAction, AdminAddLinkCategoryAction, AdminAddLocaleAction, AdminAddPostAction, AdminAddResourceAction, AdminAddResourceAlbumAction, AdminAddTemplateAction, AdminAddUserAction, AdminAdminBlogSelectAction, AdminBlogCategoriesAction, AdminBlogCustomFieldsAction, AdminBlogSecurityAction, AdminBlogSettingsAction, AdminChangeCommentsStatusAction, AdminChangeGalleryItemsAlbumAction, AdminChangeLinksCategoryAction, AdminChangePostsCategoryAction, AdminChangePostsStatusAction, AdminChangeTrackbacksStatusAction, AdminCleanupAction, AdminControlCenterAction, AdminCreateBlogAction, AdminCreateUserAction, AdminDefaultAction, AdminDeleteArticleCategoryAction, AdminDeleteBlogAction, AdminDeleteBlogCategoryAction, AdminDeleteBlogTemplateAction, AdminDeleteBlogUserPermissionsAction, AdminDeleteCommentAction, AdminDeleteCustomFieldsAction, AdminDeleteGalleryItemsAction, AdminDeleteGlobalArticleCategoryAction, AdminDeleteLinkAction, AdminDeleteLinkCategoryAction, AdminDeleteLocalesAction, AdminDeletePostAction, AdminDeleteReferrerAction, AdminDeleteResourceAction, AdminDeleteResourceAlbumAction, AdminDeleteTemplatesAction, AdminDeleteTrackbackAction, AdminDeleteUsersAction, AdminDoRegisterBlogAction, AdminEditArticleCategoriesAction, AdminEditArticleCategoryAction, AdminEditBlogAction, AdminEditBlogCategoryAction, AdminEditBlogTemplatesAction, AdminEditCommentsAction, AdminEditCustomFieldAction, AdminEditGlobalArticleCategoriesAction, AdminEditGlobalArticleCategoryAction, AdminEditLinkAction, AdminEditLinkCategoriesAction, AdminEditLinkCategoryAction, AdminEditLinksAction, AdminEditPostAction, AdminEditPostsAction, AdminEditResourceAlbumAction, AdminEditTemplatesAction, AdminEmptyAction, AdminGlobalSettingsAction, AdminLoginAction, AdminLogoutAction, AdminMainAction, AdminManageAction, AdminMarkCommentAction, AdminMarkTrackbackAction, AdminNewArticleCategoryAction, AdminNewBlogCategoryAction, AdminNewBlogTemplateAction, AdminNewBlogUserAction, AdminNewCustomFieldAction, AdminNewGlobalArticleCategoryAction, AdminNewLinkAction, AdminNewLinkCategoryAction, AdminNewLocaleAction, AdminNewPostAction, AdminNewResourceAction, AdminNewResourceAlbumAction, AdminNewTemplateAction, AdminPluginCenterAction, AdminPostStatsAction, AdminPreviewPostAction, AdminRegeneratePreviewAction, AdminRegisterBlogAction, AdminResendConfirmationAction, AdminResourceAlbumsAction, AdminResourceInfoAction, AdminResourcesAction, AdminResourcesGroupAction, AdminSaveDraftArticleAjaxAction, AdminSendTrackbacksAction, AdminShowBlogUsersAction, AdminSiteBlogsAction, AdminSiteLocalesAction, AdminSiteSettingsAction, AdminSiteUsersAction, AdminStatisticsAction, AdminUpdateArticleCategoryAction, AdminUpdateBlogCategoryAction, AdminUpdateBlogSettingsAction, AdminUpdateCustomFieldAction, AdminUpdateEditBlogAction, AdminUpdateGlobalArticleCategoryAction, AdminUpdateGlobalSettingsAction, AdminUpdateLinkAction, AdminUpdateLinkCategoryAction, AdminUpdatePostAction, AdminUpdateResourceAction, AdminUpdateResourceAlbumAction, AdminUpdateUserProfileAction, AdminUpdateUserSettingsAction, AdminUserProfileAction, AdminUserSettingsAction, AdminXmlPingAction, AdminBlogChooserAction, AdminBlogTemplateChooserAction, AdminResourceListAction, AdminUserChooserAction, AdminUserPictureSelectAction, CommentAction, DefaultAction, ResourceServerAction, RssAction, SearchAction, TemplateAction, ViewAlbumAction, ViewArticleAction, ViewArticleTrackbacksAction, ViewResourceAction, ActiveAccountAction, BlogListAction, BlogProfileAction, CheckUserNameAjaxAction, ChooseBlogTemplateAction, doBlogRegistration, doFinishRegister, doReadAgreement, doUserCreation, doUserRegister, PostListAction, SummaryCustomPageAction, SummaryDefaultAction, SummaryRegistrationAction, SummaryRssAction, SummarySearchAction, SummarySendResetEmail, SummarySetNewPassword, SummaryShowResetPasswordForm, SummaryUpdatePassword, UserListAction, UserProfileAction, WizardChecks, WizardIntro, WizardStepOne, WizardStepTwo, WizardStepThree, WizardStepFour, WizardStepFive, UpdateStepOne, UpdateStepTwo, UpdateStepThree, and UpdateFix111.
Definition at line 127 of file action.class.php.
| Action.registerField | ( | $ | fieldName | ) |
registers a new field whose value should be available to the view/template in case it needs to be reshown.Those fields that haven't been registered, will *not* be shown when rerunning the view.
- Parameters:
-
fieldName The name of the field from the form that we're going to register
- See also:
- FormValidator
Definition at line 228 of file action.class.php.
Referenced by AdminAddBlogAction.AdminAddBlogAction(), AdminAddBlogUserAction.AdminAddBlogUserAction(), AdminAddPostAction.AdminAddPostAction(), AdminAddUserAction.AdminAddUserAction(), AdminEditPostAction.AdminEditPostAction(), AdminUpdateBlogSettingsAction.AdminUpdateBlogSettingsAction(), AdminUpdateEditBlogAction.AdminUpdateEditBlogAction(), AdminUpdatePostAction.AdminUpdatePostAction(), AdminUpdateResourceAction.AdminUpdateResourceAction(), AdminUpdateResourceAlbumAction.AdminUpdateResourceAlbumAction(), AdminUpdateUserProfileAction.AdminUpdateUserProfileAction(), AdminUpdateUserSettingsAction.AdminUpdateUserSettingsAction(), doBlogRegistration.doBlogRegistration(), doUserCreation.doUserCreation(), and WizardStepFour.WizardStepFour().
| Action.registerFieldValidator | ( | $ | fieldName, | |
| $ | validator, | |||
| $ | onlyIfAvailable = false | |||
| ) |
registers a new validator, for validating data coming from fields
- Parameters:
-
fieldName The name of the field from the form that we're going to validate validator A valid class inheriting from the Validator base class and that implements the validate() method, that will be used for validating fields. onlyIfAvailable validate this field only if its value is not emtpy
- Returns:
- Always true
- See also:
- FormValidator
Definition at line 213 of file action.class.php.
Referenced by ActiveAccountAction.ActiveAccountAction(), AddCommentAction.AddCommentAction(), AddTrackbackAction.AddTrackbackAction(), AdminAddArticleCategoryAction.AdminAddArticleCategoryAction(), AdminAddBlogAction.AdminAddBlogAction(), AdminAddBlogCategoryAction.AdminAddBlogCategoryAction(), AdminAddBlogUserAction.AdminAddBlogUserAction(), AdminAddCustomFieldAction.AdminAddCustomFieldAction(), AdminAddGlobalArticleCategoryAction.AdminAddGlobalArticleCategoryAction(), AdminAddLinkAction.AdminAddLinkAction(), AdminAddLinkCategoryAction.AdminAddLinkCategoryAction(), AdminAddPostAction.AdminAddPostAction(), AdminAddResourceAction.AdminAddResourceAction(), AdminAddResourceAlbumAction.AdminAddResourceAlbumAction(), AdminAddUserAction.AdminAddUserAction(), AdminAdminBlogSelectAction.AdminAdminBlogSelectAction(), AdminChangeCommentsStatusAction.AdminChangeCommentsStatusAction(), AdminChangeGalleryItemsAlbumAction.AdminChangeGalleryItemsAlbumAction(), AdminChangeLinksCategoryAction.AdminChangeLinksCategoryAction(), AdminChangePostsCategoryAction.AdminChangePostsCategoryAction(), AdminChangePostsStatusAction.AdminChangePostsStatusAction(), AdminChangeTrackbacksStatusAction.AdminChangeTrackbacksStatusAction(), AdminDeleteArticleCategoryAction.AdminDeleteArticleCategoryAction(), AdminDeleteBlogAction.AdminDeleteBlogAction(), AdminDeleteBlogCategoryAction.AdminDeleteBlogCategoryAction(), AdminDeleteBlogTemplateAction.AdminDeleteBlogTemplateAction(), AdminDeleteBlogUserPermissionsAction.AdminDeleteBlogUserPermissionsAction(), AdminDeleteCommentAction.AdminDeleteCommentAction(), AdminDeleteCustomFieldsAction.AdminDeleteCustomFieldsAction(), AdminDeleteGalleryItemsAction.AdminDeleteGalleryItemsAction(), AdminDeleteGlobalArticleCategoryAction.AdminDeleteGlobalArticleCategoryAction(), AdminDeleteLinkAction.AdminDeleteLinkAction(), AdminDeleteLinkCategoryAction.AdminDeleteLinkCategoryAction(), AdminDeleteLocalesAction.AdminDeleteLocalesAction(), AdminDeletePostAction.AdminDeletePostAction(), AdminDeleteReferrerAction.AdminDeleteReferrerAction(), AdminDeleteResourceAction.AdminDeleteResourceAction(), AdminDeleteResourceAlbumAction.AdminDeleteResourceAlbumAction(), AdminDeleteTemplatesAction.AdminDeleteTemplatesAction(), AdminDeleteTrackbackAction.AdminDeleteTrackbackAction(), AdminDeleteUsersAction.AdminDeleteUsersAction(), AdminDoRegisterBlogAction.AdminDoRegisterBlogAction(), AdminEditArticleCategoryAction.AdminEditArticleCategoryAction(), AdminEditBlogAction.AdminEditBlogAction(), AdminEditCommentsAction.AdminEditCommentsAction(), AdminEditCustomFieldAction.AdminEditCustomFieldAction(), AdminEditGlobalArticleCategoryAction.AdminEditGlobalArticleCategoryAction(), AdminEditBlogCategoryAction.AdminEditGlobalArticleCategoryAction(), AdminEditLinkAction.AdminEditLinkAction(), AdminEditLinkCategoryAction.AdminEditLinkCategoryAction(), AdminEditLinksAction.AdminEditLinksAction(), AdminEditPostAction.AdminEditPostAction(), AdminEditResourceAlbumAction.AdminEditResourceAlbumAction(), AdminLoginAction.AdminLoginAction(), AdminMarkCommentAction.AdminMarkCommentAction(), AdminMarkTrackbackAction.AdminMarkTrackbackAction(), AdminResourceInfoAction.AdminNewResourceAlbumAction(), AdminPostStatsAction.AdminPostStatsAction(), AdminRegeneratePreviewAction.AdminRegeneratePreviewAction(), AdminResendConfirmationAction.AdminResendConfirmationAction(), AdminResourcesAction.AdminResourcesAction(), AdminUpdateArticleCategoryAction.AdminUpdateArticleCategoryAction(), AdminUpdateBlogCategoryAction.AdminUpdateBlogCategoryAction(), AdminUpdateBlogSettingsAction.AdminUpdateBlogSettingsAction(), AdminUpdateCustomFieldAction.AdminUpdateCustomFieldAction(), AdminUpdateEditBlogAction.AdminUpdateEditBlogAction(), AdminUpdateGlobalArticleCategoryAction.AdminUpdateGlobalArticleCategoryAction(), AdminUpdateLinkAction.AdminUpdateLinkAction(), AdminUpdateLinkCategoryAction.AdminUpdateLinkCategoryAction(), AdminUpdatePostAction.AdminUpdatePostAction(), AdminUpdateResourceAction.AdminUpdateResourceAction(), AdminUpdateResourceAlbumAction.AdminUpdateResourceAlbumAction(), AdminUpdateUserProfileAction.AdminUpdateUserProfileAction(), AdminUpdateUserSettingsAction.AdminUpdateUserSettingsAction(), AdminUserProfileAction.AdminUserProfileAction(), BlogProfileAction.BlogProfileAction(), ChooseBlogTemplateAction.ChooseBlogTemplateAction(), DefaultAction.DefaultAction(), doBlogRegistration.doBlogRegistration(), doFinishRegister.doFinishRegister(), doUserCreation.doUserCreation(), ResourceServerAction.ResourceServerAction(), RssAction.RssAction(), SearchAction.SearchAction(), SummarySearchAction.SummarySearchAction(), SummarySendResetEmail.SummarySendResetEmail(), SummaryUpdatePassword.SummaryUpdatePassword(), TemplateAction.TemplateAction(), UserProfileAction.UserProfileAction(), ViewAlbumAction.ViewAlbumAction(), ViewArticleAction.ViewArticleAction(), CommentAction.ViewArticleAction(), ViewArticleTrackbacksAction.ViewArticleTrackbacksAction(), ViewResourceAction.ViewResourceAction(), WizardStepFive.WizardStepFive(), WizardStepFour.WizardStepFour(), and WizardStepOne.WizardStepOne().
| Action.setCommonData | ( | $ | copyFormValues = false |
) |
we can do things here that are common to all the views. This method must be called just before the Action.perform() method has finished its processing since most of the child Action classes use it to do some kind of post-processing.
- Parameters:
-
copyFormValues Whether the values from fields that were registered via Action.registerFieldValidator() and Action.registerField() should be passed back to the view as variables or not. It defaults to 'false' but this parameter is useful in those cases when we would like to force an error to happen (not a validation error) and still keep the form values.
- Returns:
- Always true
Reimplemented in AdminAction, BlogAction, and SummaryAction.
Definition at line 259 of file action.class.php.
Referenced by UpdateStepOne.perform(), WizardStepFive.perform(), WizardStepFour.perform(), WizardStepThree.perform(), WizardStepTwo.perform(), WizardStepOne.perform(), WizardIntro.perform(), AdminLoginAction.perform(), and validationErrorProcessing().
| Action.setForwardAction | ( | $ | nextActionKey | ) |
after executing the current action we will not show the results but transfer the execution flow to another action. In other words, the Controller will detect that the processing is being passed to another Action class and instead of calling Action.getView() right after Action.perform() it will call the perform() method of the next action in the flow. It is only possible to specify one action to forward to at a time, but this feature can be used as many times as needed.
- Parameters:
-
actionKey The key of the action to which we're forwarding the process flow. This is not the class name of the action but the key name to which the action class has been assigned.
- Returns:
- Always true
Definition at line 288 of file action.class.php.
References Controller.setForwardAction().
| Action.setForwardActionParameter | ( | $ | param, | |
| $ | value | |||
| ) | [private] |
sets a parameter in the session... or in other words, make it available for the next coming action.
- Parameters:
-
param value
- Returns:
- Always true
Definition at line 304 of file action.class.php.
| Action.setPreviousAction | ( | $ | previousAction | ) | [private] |
- Parameters:
-
previousAction a valid Action object
- Returns:
- Always true
Definition at line 100 of file action.class.php.
| Action.setSuccess | ( | $ | success | ) |
This method can be used to trigger validation errors even if they did not really happen, or to disable errors if they happened.
- Parameters:
-
success Whether to force or unforce an error
Definition at line 315 of file action.class.php.
| Action.setValidationErrorView | ( | $ | view | ) |
sets the view that will be shown in case there is an error during the validation process... It makes things a bit easier for us when it comes to validate data. This view will only be used if validate() generates a validation error or if we force the action to generate an error via Action.setSuccess()
- Parameters:
-
view A valid View object
- Returns:
- Always true
- See also:
- View
Definition at line 195 of file action.class.php.
Referenced by AddCommentAction.AddCommentAction(), AddTrackbackAction.AddTrackbackAction(), AdminAddArticleCategoryAction.AdminAddArticleCategoryAction(), AdminAddBlogAction.AdminAddBlogAction(), AdminAddBlogCategoryAction.AdminAddBlogCategoryAction(), AdminAddBlogUserAction.AdminAddBlogUserAction(), AdminAddCustomFieldAction.AdminAddCustomFieldAction(), AdminAddGlobalArticleCategoryAction.AdminAddGlobalArticleCategoryAction(), AdminAddLinkAction.AdminAddLinkAction(), AdminAddLinkCategoryAction.AdminAddLinkCategoryAction(), AdminAddPostAction.AdminAddPostAction(), AdminAddResourceAction.AdminAddResourceAction(), AdminAddResourceAlbumAction.AdminAddResourceAlbumAction(), AdminAddUserAction.AdminAddUserAction(), AdminAdminBlogSelectAction.AdminAdminBlogSelectAction(), AdminChangeCommentsStatusAction.AdminChangeCommentsStatusAction(), AdminChangeGalleryItemsAlbumAction.AdminChangeGalleryItemsAlbumAction(), AdminChangeLinksCategoryAction.AdminChangeLinksCategoryAction(), AdminChangePostsCategoryAction.AdminChangePostsCategoryAction(), AdminChangePostsStatusAction.AdminChangePostsStatusAction(), AdminChangeTrackbacksStatusAction.AdminChangeTrackbacksStatusAction(), AdminDeleteArticleCategoryAction.AdminDeleteArticleCategoryAction(), AdminDeleteBlogAction.AdminDeleteBlogAction(), AdminDeleteBlogCategoryAction.AdminDeleteBlogCategoryAction(), AdminDeleteBlogTemplateAction.AdminDeleteBlogTemplateAction(), AdminDeleteBlogUserPermissionsAction.AdminDeleteBlogUserPermissionsAction(), AdminDeleteCommentAction.AdminDeleteCommentAction(), AdminDeleteCustomFieldsAction.AdminDeleteCustomFieldsAction(), AdminDeleteGalleryItemsAction.AdminDeleteGalleryItemsAction(), AdminDeleteGlobalArticleCategoryAction.AdminDeleteGlobalArticleCategoryAction(), AdminDeleteLinkAction.AdminDeleteLinkAction(), AdminDeleteLinkCategoryAction.AdminDeleteLinkCategoryAction(), AdminDeleteLocalesAction.AdminDeleteLocalesAction(), AdminDeletePostAction.AdminDeletePostAction(), AdminDeleteReferrerAction.AdminDeleteReferrerAction(), AdminDeleteResourceAction.AdminDeleteResourceAction(), AdminDeleteResourceAlbumAction.AdminDeleteResourceAlbumAction(), AdminDeleteTemplatesAction.AdminDeleteTemplatesAction(), AdminDeleteTrackbackAction.AdminDeleteTrackbackAction(), AdminDeleteUsersAction.AdminDeleteUsersAction(), AdminDoRegisterBlogAction.AdminDoRegisterBlogAction(), AdminEditArticleCategoryAction.AdminEditArticleCategoryAction(), AdminEditBlogAction.AdminEditBlogAction(), AdminEditCommentsAction.AdminEditCommentsAction(), AdminEditCustomFieldAction.AdminEditCustomFieldAction(), AdminEditGlobalArticleCategoryAction.AdminEditGlobalArticleCategoryAction(), AdminEditBlogCategoryAction.AdminEditGlobalArticleCategoryAction(), AdminEditLinkAction.AdminEditLinkAction(), AdminEditLinkCategoryAction.AdminEditLinkCategoryAction(), AdminEditLinksAction.AdminEditLinksAction(), AdminEditPostAction.AdminEditPostAction(), AdminEditResourceAlbumAction.AdminEditResourceAlbumAction(), AdminLoginAction.AdminLoginAction(), AdminMarkCommentAction.AdminMarkCommentAction(), AdminMarkTrackbackAction.AdminMarkTrackbackAction(), AdminResourceInfoAction.AdminNewResourceAlbumAction(), AdminPostStatsAction.AdminPostStatsAction(), AdminRegeneratePreviewAction.AdminRegeneratePreviewAction(), AdminResendConfirmationAction.AdminResendConfirmationAction(), AdminResourcesAction.AdminResourcesAction(), AdminUpdateArticleCategoryAction.AdminUpdateArticleCategoryAction(), AdminUpdateBlogCategoryAction.AdminUpdateBlogCategoryAction(), AdminUpdateBlogSettingsAction.AdminUpdateBlogSettingsAction(), AdminUpdateCustomFieldAction.AdminUpdateCustomFieldAction(), AdminUpdateEditBlogAction.AdminUpdateEditBlogAction(), AdminUpdateGlobalArticleCategoryAction.AdminUpdateGlobalArticleCategoryAction(), AdminUpdateLinkAction.AdminUpdateLinkAction(), AdminUpdateLinkCategoryAction.AdminUpdateLinkCategoryAction(), AdminUpdatePostAction.AdminUpdatePostAction(), AdminUpdateResourceAction.AdminUpdateResourceAction(), AdminUpdateResourceAlbumAction.AdminUpdateResourceAlbumAction(), AdminUpdateUserProfileAction.AdminUpdateUserProfileAction(), AdminUpdateUserSettingsAction.AdminUpdateUserSettingsAction(), AdminUserProfileAction.AdminUserProfileAction(), BlogProfileAction.BlogProfileAction(), ChooseBlogTemplateAction.ChooseBlogTemplateAction(), DefaultAction.DefaultAction(), doBlogRegistration.doBlogRegistration(), doFinishRegister.doFinishRegister(), doUserCreation.doUserCreation(), TemplateAction.perform(), ResourceServerAction.ResourceServerAction(), RssAction.RssAction(), SearchAction.SearchAction(), SummarySearchAction.SummarySearchAction(), SummarySendResetEmail.SummarySendResetEmail(), SummaryUpdatePassword.SummaryUpdatePassword(), TemplateAction.TemplateAction(), UserProfileAction.UserProfileAction(), AdminUpdateResourceAction.validate(), ViewAlbumAction.ViewAlbumAction(), ViewArticleAction.ViewArticleAction(), CommentAction.ViewArticleAction(), ViewArticleTrackbacksAction.ViewArticleTrackbacksAction(), ViewResourceAction.ViewResourceAction(), WizardStepFive.WizardStepFive(), WizardStepFour.WizardStepFour(), and WizardStepOne.WizardStepOne().
| Action.validate | ( | ) |
This method can be used for data validation and is always executed before perform(). If it returns 'true', execution will continue as normal. If it returns 'false', the process will be stopped and the current contents of the view will be returned. If the view is empty, an exception will be thrown.
As of pLog 1.0, it is not necessary to implement data validation code here and it is recommended to use the data validation framework (see methods Action.registerFieldValidator() and related) There is more information about the data validation framework in the wiki: http://wiki.plogworld.net/index.php/PLog_1.0/Forms_and_data_validation.
With the default code provided in the Action.validate() method, the callback method Action.validationErrorProcessing() will be called and after that, the view set via the Action.setValidationErrorView() will be used to generate the contents of the error message.
- Returns:
- Returns true if data is correct or false otherwise. See above for more details.
Reimplemented in AddCommentAction, AdminAddArticleCategoryAjaxAction, AdminAddBlogTemplateAction, AdminAddLocaleAction, AdminAddPostAction, AdminDoRegisterBlogAction, AdminMainAction, AdminNewResourceAction, AdminPostStatsAction, AdminSaveDraftArticleAjaxAction, AdminSendTrackbacksAction, AdminUpdateBlogSettingsAction, AdminUpdateGlobalSettingsAction, AdminUpdateResourceAction, AdminUpdateUserSettingsAction, AdminUserPictureSelectAction, DefaultAction, ResourceServerAction, ViewAlbumAction, ViewArticleAction, ViewArticleTrackbacksAction, ViewResourceAction, doBlogRegistration, SummaryRssAction, SummarySetNewPassword, and UpdateStepTwo.
Definition at line 148 of file action.class.php.
References validationErrorProcessing().
Referenced by BlogAction._getPage(), BlogAction.checkDateParameter(), WizardPagedAction.getPageFromRequest(), UpdateFix111.getTransformerIdFromRequest(), UpdateStepThree.getTransformerIdFromRequest(), SummaryDefaultAction.perform(), SummaryCustomPageAction.perform(), PostListAction.perform(), doUserCreation.perform(), CheckUserNameAjaxAction.perform(), and BlogListAction.perform().
| Action.validationErrorProcessing | ( | ) |
This method will be called when a validation error happens. Child classes are free to extend or reimplement this one and can be used as some sort of a trigger in order to do some cleanup if needed.
Ê
- Returns:
- nothing
Reimplemented in AddCommentAction.
Definition at line 168 of file action.class.php.
References setCommonData().
Referenced by doBlogRegistration.validate(), AdminUpdateBlogSettingsAction.validate(), and validate().
Member Data Documentation
| Action.$_actionInfo |
Definition at line 57 of file action.class.php.
| Action.$_fieldValidators |
Definition at line 58 of file action.class.php.
| Action.$_isSuccess |
Definition at line 61 of file action.class.php.
| Action.$_previousAction |
Definition at line 60 of file action.class.php.
| Action.$_request |
Definition at line 56 of file action.class.php.
| Action.$_validationErrorView |
Definition at line 59 of file action.class.php.
| Action.$_view |
Definition at line 55 of file action.class.php.