Piwigo Core Triggers

Name Type Variables Usage in the core Commentary
allow_increment_element_hit_count trigger_change bool $content_not_set picture.php
batch_manager_perform_filters trigger_change array $filter_sets, array $bulk_manager_filter admin\batch_manager.php New in 2.7
batch_manager_register_filters trigger_change array $bulk_manager_filter admin\batch_manager.php New in 2.7
batch_manager_url_filter trigger_change array $bulk_manager_filter, string $filter admin\batch_manager.php New in 2.7.
begin_delete_elements trigger_notify array $ids admin\include\functions.inc.php (delete_elements)
blockmanager_apply trigger_notify object $menublock include\block.class.php (BlockManager::apply) use this trigger to modify existing menu blocks
blockmanager_prepare_display trigger_notify object $this include\block.class.php (BlockManager::prepare_display)
blockmanager_register_blocks trigger_notify object $menu include\block.class.php (BlockManager::load_registered_blocks) use this trigger to add menu block
clean_iptc_value trigger_change string $value include\functions_metadata.inc.php (clean_iptc_value)
combined_css trigger_change string $href, Combinable $$combinable include\template.class.php (Template::flush)
combined_css_postfilter trigger_change string $css include\template.class.php (Template::process_css)
combined_script trigger_change string $ret, string $script include\template.class.php (Template::make_script_src)
delete_categories trigger_notify array $ids admin\include\functions.inc.php (delete_categories)
delete_group trigger_notify array $groupids admin\group_list.php
admin\include\functions.inc.php (delete_group)
delete_elements trigger_notify array $ids admin\include\functions.inc.php (delete_elements)
delete_tags trigger_notify array $tag_ids admin\include\functions.inc.php (delete_tags)
delete_user trigger_notify int $user_id admin\include\functions.inc.php (delete_user)
element_set_global_action trigger_notify string $action, array $collection admin\batch_manager_global.php
format_exif_data trigger_change array $exif, string $filename, array $map include\functions_metadata.inc.php (get_exif_data)
functions_history_included trigger_notify admin\include\functions_history.inc.php
functions_mail_included trigger_notify include\functions_mail.inc.php
get_admin_advanced_features_links trigger_change array $advanced_features admin\maintenance.php
get_admin_plugin_menu_links trigger_change array admin.php use this trigger to add links into admin plugins menu
get_admins_site_links trigger_change array $plugin_links, int $site_id, bool $is_remote admin\site_manager.php
get_batch_manager_prefilters trigger_change array $prefilters admin\batch_manager_global.php use this trigger to add prefilters into batch manager global
get_categories_menu_sql_where trigger_change string $where, bool $user_expand, bool $filter_enabled include\functions_category.inc.php (get_categories_menu)
get_category_preferred_image_orders trigger_change array include\functions_category.inc.php (get_category_preferred_image_orders)
get_download_url trigger_change string $url, array $element_info include\functions_picture.inc.php (get_download_url)
get_element_metadata_available trigger_change bool , string $element_path picture.php
get_element_url trigger_change string $url, array $element_info include\functions_picture.inc.php (get_element_url)
get_high_location trigger_change string $location, array $element_info include\functions_picture.inc.php (get_high_location)
get_high_url trigger_change string $url, array $element_info include\functions_picture.inc.php (get_high_url)
get_history trigger_change array , array $page_search, array $types admin\history.php
get_image_location trigger_change string $path, array $element_info include\functions_picture.inc.php (get_image_location)
get_popup_help_content trigger_change string $help_content, string $page admin\popuphelp.php
popuphelp.php
get_pwg_themes trigger_change array $themes include\functions.inc.php (get_pwg_themes)
get_thumbnail_title trigger_change string $title, array $info include\functions.inc.php (get_thumbnail_title)
get_comments_derivative_params trigger_change ImageStdParams comments.php New in 2.4
get_index_album_derivative_params trigger_change ImageStdParams includecategory_cats.php
include\category_default.inc.php
New in 2.4
get_src_image_url trigger_change string $url, SrcImage $this include\derivative.inc.php (SrcImage::__construct) New in 2.4
get_derivative_url trigger_change string $url, ImageStdParams , SrcImage $this, string $rel_url include\derivative.inc.php (SrcImage::url, SrcImage::get_url) New in 2.4
get_tag_alt_names trigger_change array , string $raw_name admin\tags.php
admin\include\functions.php (get_taglist)
New in 2.4
get_tag_name_like_where trigger_change array , string $tag_name admin\include\functions.php (tag_id_from_tag_name) New in 2.7
get_webmaster_mail_address trigger_change string $email include\functions.inc.php (get_webmaster_mail_address) New in 2.6
init trigger_notify include\common.inc.php this action is called just after the common initialization, $conf, $user and $page (partial) variables are availables
invalidate_user_cache trigger_notify bool $full admin\include\functions.inc.php (invalidate_user_cache)
load_conf trigger_notify string $condition include\functions.inc.php (load_conf_from_db) New in 2.6. Warning: you can't trigger the first call done une common.inc.php. Use init instead.
list_check_integrity trigger_notify object $this admin\include\check_integrity.class.php (check_integrity::check)
load_image_library trigger_notify object $this admin\include\image.class.php (pwg_image::__construct)
load_profile_in_template trigger_notify array $userdata profile.php (load_profile_in_template)
loading_lang trigger_notify include\common.inc.php
include\functions.inc.php (redirect_html)
include\functions_mail.inc.php (switch_lang_to)
nbm.php
loc_after_page_header trigger_notify include\page_header.php
loc_begin_about trigger_notify about.php
loc_begin_admin trigger_notify admin.php
loc_begin_admin_page trigger_notify admin.php
loc_begin_cat_list trigger_notify admin\cat_list.php
loc_begin_cat_modify trigger_notify admin\cat_modify.php
loc_begin_element_set_global trigger_notify admin\batch_manager_global.php
loc_begin_element_set_unit trigger_notify admin\batch_manager_unit.php
loc_begin_index trigger_notify index.php
loc_begin_index_category_thumbnails trigger_notify array $categories include\category_cats.inc.php
loc_begin_index_thumbnails trigger_notify array $pictures include\category_default.inc.php
loc_begin_page_header trigger_notify include\page_header.php
loc_begin_page_tail trigger_notify include\page_tail.php
loc_begin_picture trigger_notify picture.php
loc_begin_profile trigger_notify profile.php
loc_begin_password trigger_notify password.php New in 2.5
loc_begin_register trigger_notify register.php New in 2.5
loc_begin_search trigger_notify search.php New in 2.5
loc_begin_tags trigger_notify tags.php New in 2.5
loc_begin_comments trigger_notify comments.php New in 2.5
loc_begin_identification trigger_notify identification.php New in 2.5
loc_begin_notification trigger_notify notification.php New in 2.5
loc_end_add_uploaded_file trigger_notify array $image_infos admin\include\functions_upload.inc.php (add_uploaded_file) New in 2.11
empty_lounge trigger_notify array $rows admin\include\functions.php (empty_lounge) New in 12
ws_images_uploadCompleted trigger_notify array $upload_data include\ws_functions\pwg.images.php (ws_images_uploadCompleted) New in 12
loc_end_password trigger_notify password.php New in 2.5
loc_end_register trigger_notify register.php New in 2.5
loc_end_search trigger_notify search.php New in 2.5
loc_end_tags trigger_notify tags.php New in 2.5
loc_end_comments trigger_notify comments.php New in 2.5
loc_end_identification trigger_notify identification.php New in 2.5
loc_end_notification trigger_notify notification.php New in 2.5
loc_end_admin trigger_notify admin.php
loc_end_cat_list trigger_notify admin\cat_list.php
loc_end_cat_modify trigger_notify admin\cat_modify.php
loc_end_element_set_global trigger_notify admin\batch_manager_global.php
loc_end_element_set_unit trigger_notify admin\batch_manager_unit.php
loc_end_help trigger_notify admin\help.php
loc_end_index trigger_notify index.php
loc_end_index_category_thumbnails trigger_change array $tpl_thumbnails_var include\category_cats.inc.php
loc_end_index_thumbnails trigger_change array $tpl_thumbnails_var, array $pictures include\category_default.inc.php
loc_end_no_photo_yet trigger_notify include\no_photo_yet.inc.php
loc_end_page_header trigger_notify include\page_header.php
loc_end_page_tail trigger_notify include\page_tail.php
loc_end_photo_add_direct trigger_notify admin\photo_add_direct.php
loc_end_picture trigger_notify picture.php
loc_end_picture_modify trigger_notify admin\picture_modify.php New in 2.6.3
loc_end_profile trigger_notify profile.php
loc_end_section_init trigger_notify include\section_init.inc.php this action is called after section initilization, $page variable is fully defined
loc_end_themes_installed trigger_notify admin\themes_installed.php New in 2.6.3
loc_visible_user_list trigger_change array $visible_user_list admin\user_list.php
login_failure trigger_notify string $username include\functions_user.inc.php (try_log_user)
login_success trigger_notify string $username include\functions_user.inc.php (auto_login, try_log_user)
nbm_event_handler_added trigger_notify admin\notification_by_mail.php
nbm_render_global_customize_mail_content trigger_change string $customize_mail_content admin\notification_by_mail.php (do_action_send_mail_notification)
nbm_render_user_customize_mail_content trigger_change string $customize_mail_content, string $nbm_user admin\notification_by_mail.php (do_action_send_mail_notification)
perform_batch_manager_prefilters trigger_change array $filter_sets, string $prefilter admin\batch_manager.php
picture_pictures_data trigger_change array $picture picture.php
plugins_loaded trigger_notify include\functions_plugins.inc.php (load_plugins)
pwg_log_allowed trigger_change bool $do_log, int $image_id, string $image_type include\functions.inc.php (pwg_log)
register_user trigger_notify array $user include\functions_user.inc.php (register_user)
register_user_check trigger_change array $errors, array $user include\functions_user.inc.php (register_user)
render_category_description trigger_change string $category_description, string $action include\category_cats.inc.php
include\section_init.inc.php
include\ws_functions.inc.php (ws_categories_getList, ws_categories_getAdminList)
render_category_literal_description trigger_change string $category_description include\category_cats.inc.php
render_category_name trigger_change string $category_name, string $location admin\cat_list.php
include\ws_functions.inc.php (ws_categories_getList, ws_categories_getAdminList, ws_categories_move)
render_comment_author trigger_change string $comment_author admin\comments.php
comments.php
include\picture_comment.inc.php
render_comment_content trigger_change string $comment_content admin\comments.php
comments.php
include\picture_comment.inc.php
render_element_content trigger_change string $content, array $current_picture picture.php
render_element_name trigger_change string $element_name include\functions_html.inc.php (render_element_name)
render_element_description trigger_change string $element_description, string $action picture.php
include\functions_html.inc.php (render_element_description)
render_lost_password_mail_content trigger_change string $message password.php (process_password_request)
render_page_banner trigger_change string $gallery_title include\page_header.php
render_tag_name trigger_change string $tag_name, array $tag admin\include\functions.php (get_taglist)
admin\tags.php
admin\history.php
include\functions_tag.inc.php (get_available_tags, get_all_tags, get_common_tags)
include\functions_html.inc.php (get_tags_content_title)
include\functions_search.inc.php (get_qsearch_tags)
render_tag_url trigger_change string $tag_name admin\include\functions.php (tag_id_from_tag_name, create_tag)
admin\tags.php
save_profile_from_post trigger_notify int $user_id profile.php (save_profile_from_post)
before_send_mail trigger_change bool $result, mixed $to, array $arguments, PHPMailer $mail include\functions_mail.inc.php (pwg_mail)
before_parse_mail_template trigger_notify string $cache_key, string $content_type include\functions_mail.inc.php (pwg_mail)
sendResponse trigger_notify string $encodedResponse include\ws_core.inc.php (PwgServer::sendResponse)
set_status_header trigger_notify int $code, string $text include\functions_html.inc.php (set_status_header)
tabsheet_before_select trigger_change array $sheets, string $tabsheet_id include\tabsheet.class.php (tabsheet::select) New in 2.4, use this trigger to add tabs to a tabsheets
trigger trigger_notify array include\functions_plugins.inc.php (trigger_change, trigger_notify)
user_comment_check trigger_change string $comment_action, array $comm include\functions_comment.inc.php (insert_user_comment, update_user_comment) use this trigger to add conditions on comment validation
user_comment_deletion trigger_notify mixed $comment_id include\functions_comment.inc.php (delete_user_comment) $comment_id is and int or an array of int
user_comment_insertion trigger_notify array $comm include\picture_comment.inc.php
user_comment_validation trigger_notify mixed $comment_id include\functions_comment.inc.php (validate_user_comment) $comment_id is and int or an array of int
user_init trigger_notify array $user include\user.inc.php
ws_add_methods trigger_notify object $this include\ws_core.inc.php (PwgServer::run)
ws_invoke_allowed trigger_change bool , string $methodName, array $params include\ws_core.inc.php (PwgServer::invoke)
user_logout trigger_notify int $user_id include\functions_user.inc.php (logout_user) New in 2.5
user_login trigger_notify int $user_id include\functions_user.inc.php (log_user) New in 2.5
try_log_user trigger_change boolean $success, string $username, string $password, bool $remember_me include\functions_user.inc.php (try_log_user) New in 2.5. Used by identification form to check user credentials and log user. If success is true, another login method already succeed. Return true if your method succeed.
combinable_preparse trigger_notify Template $template, Combinable $$combinable, FileCombiner $$combiner include\template.class.php (FileCombiner::process_combinable) New in 2.6.
user_list_columns trigger_change string[] $aColumns admin\user_list_backend.php New in 2.6.
after_render_user_list trigger_change array $output admin\user_list_backend.php New in 2.6.
update_rating_score trigger_change boolean $done, int $element_id include\functions_rate.inc.php New in 2.6.
picture_modify_before_update trigger_change array $data admin\picture_modify.php New in 2.6.2.
ws_users_getList trigger_change array $users include\ws_functions\pwg.users.php New in 2.6.2.