Skip to content
  • Solutions
    By Role
    • For Developers
    • For Content Managers
    • For Agencies
    • For IT Admins
    • For Web Hosters
    • For Developers
    • For Content Managers
    • For Agencies
    • For IT Admins
    • For Web Hosters
    By Infrastructure
    • Overview
    • AWS
    • Microsoft Azure
    • Alibaba Cloud
    • Google Cloud Platform
    • Vultr
    • Overview
    • AWS
    • Microsoft Azure
    • Alibaba Cloud
    • Google Cloud Platform
    • Vultr
    • Digital Ocean
    • Linode
    • Upcloud
    • Oracle
    • OVH
    • Digital Ocean
    • Linode
    • Upcloud
    • Oracle
    • OVH
  • Product
    • Plesk Features
    • Plesk Editions
    • What’s new
    • Pricing
    • Roadmap
    • Lifecycle Policy
    • Extensions Catalogue
  • Pricing
  • Extensions
    Featured Extensions
    • SocialBee
    • WP Toolkit
    • Sitejet Builder for Plesk
    • SEO Toolkit
    • Joomla! Toolkit
    • Premium Email
    • Email Security
    • SocialBee
    • WP Toolkit
    • Sitejet Builder for Plesk
    • SEO Toolkit
    • Joomla! Toolkit
    • Premium Email
    • Email Security
    Bundles and packs:
    • Business and Collaboration Edition
    • WP pack
    • Hosting pack
    • Power pack
    • Language pack
    • Business and Collaboration Edition
    • WP pack
    • Hosting pack
    • Power pack
    • Language pack

    See all Extensions

  • For Partners
    • Plesk Contributor Program
    • Plesk Partner Program
    • Affiliate program
    • Plesk University
  • Help Center
    • Documentation
    • Professional Services
    • Support
    • Contact Us
    • Wiki
    • Forum
  • Plesk 360 login
  • Free Trial
  • Pricing
  • Solutions
    • By Role
      • For Developers
      • For Content Managers
      • For Agencies
      • For IT Admins
      • For Web Hosters
    • By Infrastructure
      • Overview
      • Plesk on Amazon Web Services (AWS & Lightsail)
      • Microsoft Azure
      • Alibaba Cloud
      • Google Cloud Platform
      • Vultr
      • DigitalOcean
      • Linode
      • UpCloud
      • Oracle
      • OVH
  • Products
  • Pricing
  • Extensions
    • Featured Extensions
      • SocialBee
      • WP Toolkit
      • Sitejet Builder for Plesk
      • SEO Toolkit
      • Joomla! Toolkit
      • Premium Email
      • Email Security
    • Bundles and packs:
      • Business and Collaboration Edition
      • WP pack
      • Hosting pack
      • Power pack
      • Language pack
      • See all Extensions
  • For Partners
    • Plesk Contributor Program
    • Plesk Partner Program
    • Affiliate Program
    • Plesk University
  • Help Center
    • Documentation
    • Professional Services
    • Support
    • Contact Us
    • Wiki
    • Forum
  • Plesk 360 login
  • Free Trial
  • Pricing
  • Solutions
    • By Role
      • For Developers
      • For Content Managers
      • For Agencies
      • For IT Admins
      • For Web Hosters
    • By Infrastructure
      • Overview
      • Plesk on Amazon Web Services (AWS & Lightsail)
      • Microsoft Azure
      • Alibaba Cloud
      • Google Cloud Platform
      • Vultr
      • DigitalOcean
      • Linode
      • UpCloud
      • Oracle
      • OVH
  • Products
  • Pricing
  • Extensions
    • Featured Extensions
      • SocialBee
      • WP Toolkit
      • Sitejet Builder for Plesk
      • SEO Toolkit
      • Joomla! Toolkit
      • Premium Email
      • Email Security
    • Bundles and packs:
      • Business and Collaboration Edition
      • WP pack
      • Hosting pack
      • Power pack
      • Language pack
      • See all Extensions
  • For Partners
    • Plesk Contributor Program
    • Plesk Partner Program
    • Affiliate Program
    • Plesk University
  • Help Center
    • Documentation
    • Professional Services
    • Support
    • Contact Us
    • Wiki
    • Forum
  • Plesk 360 login
  • Free Trial
Plesk 360 login
Free Trial

Knowledge Base

handleEvent Method

 
extensions guideplesk features available for extensionssubscribe to plesk eventsaction logbusiness

This method is called by Plesk once per business logic event. It
contains event parameters that can be used by extensions.

Input arguments

$objectType

Data type: string.

Specifies the type of the affected object.

For details on allowed values for this argument, refer to the Object
Types and Actions
section.

$objectId

Data type: integer.

Specifies ID of the affected object. 0 if not applicable (singleton
object like ‘client_limit_size’).

$action

Data type: string.

Specifies the action caused the event. Each action has the following
presentation: <$objectId>_<postfix>.

Allowed postfixes: create | update | delete | start | stop |
restart | reached | added | removed | login | logout | change |
install | reconfigure | upgrade | expired

$oldValues

Data type: associative array.

Contains object parameters that are updated after the event happened.
The array contains one entry per changed parameter. The entry key is the
action log parameter name, and the entry value is the old value of the
parameter.

Example:

array(
    'ip_address' => '192.0.2.12',
    'ip_mask' => '255.255.255.0',
    'interface' => 'eth0'
    'ip_type' => 'shared'
)

$newValues

Data type: associative array.

Contains object parameters that are updated after the event happened
(one entry per changed parameter). The set of keys in this array will be
exactly the same as for $oldValues. The entry key is the action log
parameter name, and the entry value is the new value of the parameter.

For details on what array items are available for a combination of an
action and objects affected by the action, refer to the Old and New
Values Combinations
section. For details on the meaning
of a specific key, refer to the Old and New Values
Description
section.

Note: 1. Some parameters appear in both arrays for informational purposes
even if unchanged.

2. All parameters values are stored as strings. For instance, the
value of a boolean parameter is the true or false string.

Return values

None.

Tweet
Share
Share
Email
0 Shares
Read the full article
Related Posts

What is NIXStats, How Did it Originate, and More

Read More »

Plesk WP Toolkit 5.4 Release: Action Log, wp-cron Management Workflow, SSL Support, and More

Read More »

Top eCommerce Trends to Upgrade your 2021 Strategy

Read More »
Knowledge Base

Plesk Features Available for Extensions

Read More »

Extensions Reference

Read More »

Available Licensing Models – Freemium Extensions

Read More »

Issuing Custom Licenses for Extensions

Read More »

Hosting Wiki

  • DBMS Interface
  • Plesk
X-twitter Linkedin Youtube Reddit Github
  • Product
  • Login
  • Pricing
  • Editions
  • For Partners
  • Partner Program
  • Contributor Program
  • Affiliate Program
  • Plesk University
  • Company
  • Blog
  • Careers
  • Events
  • About Plesk
  • Our Brand
  • Resources
  • User and Admin guides
  • Help Center
  • Migrate to Plesk
  • Contact Us
  • Hosting Wiki
  • Forum
  • Legal
  • Legal
  • Privacy Policy
  • Imprint

© 2025 WebPros International GmbH

Part of the WebPros®  Family