[ticket/12691] Add core.delete_pm to funtion delete_pm

Add core.delete_pm to funtion delete_pm.
Event will return:
int $user_id - ID of the user requested the message delete
array $msg_ids - array of all messages to be deleted
int $folder_id - ID of the user folder where the messages are stored
Justification:
Allow extensions to capture this event
and act as intended by ext author

PHPBB3-12691
[ticket/12691] Change event to core.delete_pm_before

Just a requested change by nickvergessen

PHPBB3-12691
[ticket/12691] Comment change

Change a bit the core event comment

PHPBB3-12691
Merge pull request #2575 from lucifer4o/ticket/12691

[ticket/12691] Add core.delete_pm to funtion delete_pm

* lucifer4o/ticket/12691:
  [ticket/12691] Comment change
  [ticket/12691] Change event to core.delete_pm_before
  [ticket/12691] Add core.delete_pm to funtion delete_pm