Legacy Documentation
You are using the documentation for version 4.3.8. Go here for the latest version.
Publish Controller Extension Hooks¶
entry_save_and_close_redirect¶
-
entry_save_and_close_redirect
($entry)¶ This hook is executed when a member clicks Save & Close on the publish form, and provides an opportunity to change where the member is redirected to.
How it’s called:
$redirect_url = ee()->extensions->call('entry_save_and_close_redirect', $entry);
Parameters: - $entry (ChannelEntry) – Model object of the channel entry being saved
Return type: String of the URL to redirect to
New in version 4.0.0.
publish_live_preview_route¶
-
publish_live_preview_route
($entry_data, $uri, $template_id)¶ This hook is executed when a request is made to create or update the live preview rendering, and allows you change the request URI that should be used for the entry, and also optionally change the template ID to use to render the preview. You’ll be passed the URI and template ID that live preview will otherwise use if you do not change them.
Note
You must return an array with both a
uri
key andtemplate_id
key. Even if you do not alter one of them, you must still return the value you were originally passed in the method parameter.How it’s called:
$route = ee()->extensions->call('publish_live_preview_route', array_merge($_POST, $data), $uri, $template_id); $uri = $route['uri']; $template_id = $route['template_id'];
Example return:
return [ 'uri' => 'my/special/uri', 'template_id' => 5 ];
Parameters: - $entry_data (array) – Entry data merged with POST data, contains entire publish form data
- $uri (string) – The URI to be used for live preview with URL title and entry ID variable parsed, and is either based on the channel’s preview URI setting or the entry’s Pages module URI
- $template_id (int) – The template ID, either derived from the channel’s preview URI setting or the entry’s Pages module template setting.
Return type: Array with
uri
key andtemplate_id
keyNew in version 4.2.0.