]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - EVENTS.txt
parse_url returns an associative array - not an object
[quix0rs-gnu-social.git] / EVENTS.txt
1 InitializePlugin: a chance to initialize a plugin in a complete environment
2
3 CleanupPlugin: a chance to cleanup a plugin at the end of a program
4
5 StartPrimaryNav: Showing the primary nav menu
6 - $action: the current action
7
8 EndPrimaryNav: At the end of the primary nav menu
9 - $action: the current action
10
11 StartSecondaryNav: Showing the secondary nav menu
12 - $action: the current action
13
14 EndSecondaryNav: At the end of the secondary nav menu
15 - $action: the current action
16
17 StartShowStyles: Showing Style links; good place to add UA style resets
18 - $action: the current action
19
20 EndShowStyles: End showing Style links; good place to add custom styles
21 - $action: the current action
22
23 StartShowStatusNetStyles: Showing StatusNet Style links
24 - $action: the current action
25
26 EndShowStatusNetStyles: End showing StatusNet Style links;  good place to add handheld or JavaScript dependant styles
27 - $action: the current action
28
29 StartShowLaconicaStyles: backwards compatibility; deprecated
30 - $action: the current action
31
32 EndShowLaconicaStyles: backwards compatibility; deprecated
33 - $action: the current action
34
35 StartShowUAStyles: Showing custom User-Agent style links
36 - $action: the current action
37
38 EndShowUAStyles: End showing custom User-Agent links; good place to add user-agent (e.g., filter, -webkit, -moz) specific styles
39 - $action: the current action
40
41 StartShowScripts: Showing JavaScript links
42 - $action: the current action
43
44 EndShowScripts: End showing JavaScript links; good place to add custom
45                 links like Google Analytics
46 - $action: the current action
47
48 StartShowJQueryScripts: Showing JQuery script links (use this to link to e.g. Google mirrors)
49 - $action: the current action
50
51 EndShowJQueryScripts: End showing JQuery script links
52 - $action: the current action
53
54 StartShowStatusNetScripts: Showing StatusNet script links (use this to link to a CDN or something)
55 - $action: the current action
56
57 EndShowStatusNetScripts: End showing StatusNet script links
58 - $action: the current action
59
60 StartShowLaconicaScripts: backwards compatibility; deprecated
61 - $action: the current action
62
63 EndShowLaconicaScripts: backwards compatibility; deprecated
64 - $action: the current action
65
66 StartShowSections: Start the list of sections in the sidebar
67 - $action: the current action
68
69 EndShowSections: End the list of sections in the sidebar
70 - $action: the current action
71
72 StartShowHeader: Showing before the header container
73 - $action: the current action
74
75 EndShowHeader: Showing after the header container
76 - $action: the current action
77
78 StartShowFooter: Showing before the footer container
79 - $action: the current action
80
81 EndShowFooter: Showing after the footer container
82 - $action: the current action
83
84 StartShowContentBlock: Showing before the content container
85 - $action: the current action
86
87 EndShowContentBlock: Showing after the content container
88 - $action: the current action
89
90 StartShowAside: Showing before the Aside container
91 - $action: the current action
92
93 EndShowAside: Showing after the Aside container
94 - $action: the current action
95
96 StartShowNoticeFormData: Showing before the notice form data
97 - $action: the current action
98
99 EndShowNoticeFormData: Showing after the notice form data
100 - $action: the current action
101
102 StartNoticeSave: before inserting a notice (good place for content filters)
103 - $notice: notice being saved (no ID or URI)
104
105 EndNoticeSave: after inserting a notice and related code
106 - $notice: notice that was saved (with ID and URI)
107
108 StartShowLocalNavBlock: Showing the local nav menu
109 - $action: the current action
110
111 EndShowLocalNavBlock: At the end of the local nav menu
112 - $action: the current action
113
114 StartShowHTML: Chance to set document headers (e.g., content type, charset, language), DOCTYPE and html element properties
115 - $action: the current action
116
117 EndShowHTML: Showing after the html element
118 - $action: the current action
119
120 StartPublicGroupNav: Showing the public group nav menu
121 - $action: the current action
122
123 EndPublicGroupNav: At the end of the public group nav menu
124 - $action: the current action
125
126 StartSubGroupNav: Showing the subscriptions group nav menu
127 - $action: the current action
128
129 EndSubGroupNav: At the end of the subscriptions group nav menu
130 - $action: the current action
131
132 StartInitializeRouter: Before the router instance has been initialized; good place to add routes
133 - $m: the Net_URL_Mapper that has just been set up
134
135 RouterInitialized: After the router instance has been initialized
136 - $m: the Net_URL_Mapper that has just been set up
137
138 StartLogout: Before logging out
139 - $action: the logout action
140
141 EndLogout: After logging out
142 - $action: the logout action
143
144 ArgsInitialized: After the argument array has been initialized
145 - $args: associative array of arguments, can be modified
146
147 StartAddressData: Allows the site owner to provide additional information about themselves for contact (e.g., tagline, email, location)
148 - $action: the current action
149
150 EndAddressData: At the end of <address>
151 - $action: the current action
152
153 StartShowSiteNotice: Before showing site notice
154 - $action: the current action
155
156 EndShowSiteNotice: After showing site notice
157 - $action: the current action
158
159 StartLoginGroupNav: Before showing the login and register navigation menu
160 - $action: the current action
161
162 EndLoginGroupNav: After showing the login and register navigation menu
163 - $action: the current action
164
165 StartAccountSettingsNav: Before showing the account settings menu
166 - $action: the current action
167
168 EndAccountSettingsNav: After showing the account settings menu
169 - $action: the current action
170
171 StartAccountSettingsProfileMenuItem: Before showing the Profile menu item
172 - $widget: AccountSettingsNav instance being shown
173
174 EndAccountSettingsProfileMenuItem: After showing the Profile menu item
175 - $widget: AccountSettingsNav instance being shown
176
177 StartAccountSettingsAvatarMenuItem: Before showing the Avatar menu item
178 - $widget: AccountSettingsNav instance being shown
179
180 EndAccountSettingsAvatarMenuItem: After showing the Avatar menu item
181 - $widget: AccountSettingsNav instance being shown
182
183 StartAccountSettingsPasswordMenuItem: Before showing the Password menu item
184 - $widget: AccountSettingsNav instance being shown
185
186 EndAccountSettingsPasswordMenuItem: After showing the Password menu item
187 - $widget: AccountSettingsNav instance being shown
188
189 StartAccountSettingsEmailMenuItem: Before showing the Email menu item
190 - $widget: AccountSettingsNav instance being shown
191
192 EndAccountSettingsEmailMenuItem: After showing the Email menu item
193 - $widget: AccountSettingsNav instance being shown
194
195 StartAccountSettingsDesignMenuItem: Before showing the Design menu item
196 - $widget: AccountSettingsNav instance being shown
197
198 EndAccountSettingsDesignMenuItem: After showing the Design menu item
199 - $widget: AccountSettingsNav instance being shown
200
201 StartAccountSettingsOtherMenuItem: Before showing the Other menu item
202 - $widget: AccountSettingsNav instance being shown
203
204 EndAccountSettingsOtherMenuItem: After showing the Other menu item
205 - $widget: AccountSettingsNav instance being shown
206
207 Autoload: When trying to autoload a class
208 - $cls: the class being sought. A plugin might require_once the file for the class.
209
210 SensitiveAction: determines if an action is 'sensitive' and should use SSL
211 - $action: name of the action, like 'login'
212 - $sensitive: flag for whether this is a sensitive action
213
214 LoginAction: determines if an action is a 'login' action (OK for public view in private mode)
215 - $action: name of the action, like 'register'
216 - $login: flag for whether this is a login action
217
218 StartShowHead: called before showing the <head> element and children
219 - $action: action object being show
220
221 EndShowHead: called after showing the <head> element (and </head>)
222 - $action: action object being shown
223
224 StartShowBody: called before showing the <body> element and children
225 - $action: action object being shown
226
227 EndShowBody: called after showing the <body> element (and </body>)
228 - $action: action object being shown
229
230 StartPersonalGroupNav: beginning of personal group nav menu
231 - $action: action object being shown
232
233 EndPersonalGroupNav: end of personal group nav menu (good place to add a menu item)
234 - $action: action object being shown
235
236 StartGroupGroupNav: Showing the group nav menu
237 - $action: the current action
238
239 EndGroupGroupNav: At the end of the group nav menu
240 - $action: the current action
241
242 StartEndHTML: just before the </html> tag
243 - $action: action object being shown
244
245 EndEndHTML: just after the </html> tag
246 - $action: action object being shown
247
248 StartShowDesign: just before showing a site, user, or group design
249 - $action: action object being shown
250
251 EndShowDesign: just after showing a site, user, or group design
252 - $action: action object being shown
253
254 StartShowExportData: just before showing the <div> with export data (feeds)
255 - $action: action object being shown
256
257 EndShowExportData: just after showing the <div> with export data (feeds)
258 - $action: action object being shown
259
260 StartShowNoticeItem: just before showing the notice item
261 - $action: action object being shown
262
263 EndShowNoticeItem: just after showing the notice item
264 - $action: action object being shown
265
266 StartShowPageNotice: just before showing the page notice (instructions or error)
267 - $action: action object being shown
268
269 EndShowPageNotice: just after showing the page notice (instructions or error)
270 - $action: action object being shown
271
272 StartShowPageTitle: just before showing the main h1 title of a page (only for registration)
273 - $action: action object being shown
274
275 StartProfileFormData: just before showing text entry fields on profile settings page
276 - $action: action object being shown
277
278 EndProfileFormData: just after showing text entry fields on profile settings page
279 - $action: action object being shown
280
281 StartProfileSaveForm: before starting to save a profile settings form
282 - $action: action object being shown
283
284 EndProfileSaveForm: after saving a profile settings form (after commit, no profile or user object!)
285 - $action: action object being shown
286
287 StartRegistrationFormData: just before showing text entry fields on registration page
288 - $action: action object being shown
289
290 EndRegistrationFormData: just after showing text entry fields on registration page
291 - $action: action object being shown
292
293 StartRegistrationTry: before validating and saving a new user
294 - $action: action object being shown
295
296 EndRegistrationTry: after saving a new user (note: no profile or user object!)
297 - $action: action object being shown
298
299 StartAvatarFormData: before displaying avatar form
300 - $action: action object being shown
301
302 EndAvatarFormData: after displaying avatar form
303 - $action: action object being shown
304
305 StartAvatarSaveForm: before saving the avatar
306 - $action: action object being shown
307
308 EndAvatarSaveForm: after saving the avatar
309 - $action: action object being shown
310
311 StartNewQueueManager: before trying to start a new queue manager; good for plugins implementing new queue manager classes
312 - $qm: empty queue manager to set
313
314 RedirectToLogin: event when we force a redirect to login (like when going to a settings page on a remembered login)
315 - $action: action object being shown
316 - $user: current user
317
318 StartLoadDoc: before loading a help doc (hook this to show your own documentation)
319 - $title: title of the document
320 - $output: HTML output to show
321
322 EndLoadDoc: after loading a help doc (hook this to modify other documentation)
323 - $title: title of the document
324 - $output: HTML output to show
325
326 StartApiRss: after the rss <channel> element is started
327 - $action: action object being shown
328
329 StartApiAtom: after the <feed> element is started
330 - $action: action object being shown
331
332 StartEnqueueNotice: about to add a notice to the queues (good place to add a new transport)
333 - $notice: the notice being added
334 - &$transports: modifiable list of transports (as strings) to queue for
335
336 EndEnqueueNotice: after adding a notice to the queues
337 - $notice: the notice being added
338 - $transports: modifiable list of transports to use
339
340 UnqueueHandleNotice: Handle a notice when no queue manager is available
341 - $notice: the notice to handle
342 - $queue: the "queue" that is being executed
343
344 GetValidDaemons: Just before determining which daemons to run
345 - &$daemons: modifiable list of daemon scripts to run, filenames relative to scripts/
346
347 HandleQueuedNotice: Handle a queued notice at queue time (or immediately if no queue)
348 - &$notice: notice to handle
349
350 StartShowHeadElements: Right after the <head> tag
351 - $action: the current action
352
353 EndShowHeadElements: Right before the </head> tag; put <script>s here if you need them in <head>
354 - $action: the current action
355
356 CheckSchema: chance to check the schema
357
358 StartProfilePageProfileSection: Starting to show the section of the
359                               profile page with the actual profile data;
360                               hook to prevent showing the profile (e.g.)
361 - $userprofile: UserProfile widget
362 - &$profile: the profile being shown
363
364 StartProfilePageProfileElements: inside the section, before the first
365                                element; prepend elements here
366 - $userprofile: UserProfile widget
367 - &$profile: the profile being shown
368
369 EndProfilePageProfileElements: inside the section, after the last element;
370                              append elements here
371 - $userprofile: UserProfile widget
372 - &$profile: the profile being shown
373
374 EndProfilePageProfileSection: After showing the section of the profile
375                             page with the profile elements
376 - $userprofile: UserProfile widget
377 - &$profile: the profile being shown
378
379 StartProfilePageActionsSection: Starting to show the section of the
380                                     profile page with action links; hook
381                                     to hide them (for example)
382 - $userprofile: UserProfile widget
383 - &$profile: the profile being shown
384
385 StartProfilePageActionsElements: inside the list, before the first
386                                      element; prepend elements here
387 - $userprofile: UserProfile widget
388 - &$profile: the profile being shown
389
390 EndProfilePageActionsElements: inside the list, after the last element;
391                                    append elements here
392 - $userprofile: UserProfile widget
393 - &$profile: the profile being shown
394
395 EndProfilePageActionsSection: After showing the section of the profile
396                                   page with the entity actions
397 - $userprofile: UserProfile widget
398 - &$profile: the profile being shown
399
400 StartProfilePageAvatar: before showing the avatar on the profile page
401 - $userprofile: UserProfile widget
402 - &$profile: the profile being shown
403
404 EndProfilePageAvatar: after showing the avatar on the profile page
405 - $userprofile: UserProfile widget
406 - &$profile: the profile being shown
407
408 StartProfilePageNickname: before showing the nickname on the profile page
409 - $userprofile: UserProfile widget
410 - &$profile: the profile being shown
411
412 EndProfilePageNickname: after showing the nickname on the profile page
413 - $userprofile: UserProfile widget
414 - &$profile: the profile being shown
415
416 StartProfilePageFullName: before showing the fullname on the profile page
417 - $userprofile: UserProfile widget
418 - &$profile: the profile being shown
419
420 EndProfilePageFullName: after showing the fullname on the profile page
421 - $userprofile: UserProfile widget
422 - &$profile: the profile being shown
423
424 StartProfilePageLocation: before showing the location on the profile page
425 - $userprofile: UserProfile widget
426 - &$profile: the profile being shown
427
428 EndProfilePageLocation: after showing the location on the profile page
429 - $userprofile: UserProfile widget
430 - &$profile: the profile being shown
431
432 StartProfilePageHomepage: before showing the homepage link on the profile page
433 - $userprofile: UserProfile widget
434 - &$profile: the profile being shown
435
436 EndProfilePageHomepage: after showing the homepage on the profile page
437 - $userprofile: UserProfile widget
438 - &$profile: the profile being shown
439
440 StartProfilePageBio: before showing the bio on the profile page
441 - $userprofile: UserProfile widget
442 - &$profile: the profile being shown
443
444 EndProfilePageBio: after showing the bio on the profile page
445 - $userprofile: UserProfile widget
446 - &$profile: the profile being shown
447
448 StartProfilePageProfileTags: before showing the tags on the profile page
449 - $userprofile: UserProfile widget
450 - &$profile: the profile being shown
451
452 EndProfilePageProfileTags: after showing the tags on the profile page
453 - $userprofile: UserProfile widget
454 - &$profile: the profile being shown
455
456 StartProfileList: when starting a list of profiles (before <ul>)
457 - $profilelist: ProfileList widget, with $profile, $action, and $out
458
459 EndProfileList: when ending a list of profiles (after </ul>)
460 - $profilelist: ProfileList widget
461
462 StartProfileListItem: when starting to show a profile list item
463 - $item: ProfileListItem widget
464
465 EndProfileListItem: after showing a profile list item
466 - $item: ProfileListItem widget
467
468 StartProfileListItemProfile: the profile data part of the item
469 - $item: ProfileListItem widget
470
471 EndProfileListItemProfile: the profile data part of the item
472 - $item: ProfileListItem widget
473
474 StartProfileListItemActions: the actions (buttons) for an item
475 - $item: ProfileListItem widget
476
477 EndProfileListItemActions: the actions (buttons) for an item
478 - $item: ProfileListItem widget
479
480 StartProfileListItemProfileElements: inside the <div>
481 - $item: ProfileListItem widget
482
483 EndProfileListItemProfileElements: inside the <div>
484 - $item: ProfileListItem widget
485
486 StartProfileListItemAvatar: Showing a profile list avatar
487 - $item: ProfileListItem widget
488
489 EndProfileListItemAvatar: Showing a profile list avatar
490 - $item: ProfileListItem widget
491
492 StartProfileListItemFullName: Showing the profile list full name
493 - $item: ProfileListItem widget
494
495 EndProfileListItemFullName: Showing the profile list full name
496 - $item: ProfileListItem widget
497
498 StartProfileListItemLocation: Showing the profile list location
499 - $item: ProfileListItem widget
500
501 EndProfileListItemLocation: Showing the profile list location
502 - $item: ProfileListItem widget
503
504 StartProfileListItemHomepage: Showing the profile list homepage
505 - $item: ProfileListItem widget
506
507 EndProfileListItemHomepage: Showing the profile list homepage
508 - $item: ProfileListItem widget
509
510 StartProfileListItemBio: Showing the profile list bio
511 - $item: ProfileListItem widget
512
513 EndProfileListItemBio: Showing the profile list bio
514 - $item: ProfileListItem widget
515
516 StartProfileListItemActionElements: Showing the profile list actions (prepend a button here, or replace all buttons)
517 - $item: ProfileListItem widget
518
519 EndProfileListItemActionElements: Showing profile list actions (append a button here)
520 - $item: ProfileListItem widget
521
522 StartUserXRDS: Start XRDS output (right after the opening XRDS tag)
523 - $action: the current action
524 - &$xrdsoutputter - XRDSOutputter object to write to
525
526 EndUserXRDS: End XRDS output (right before the closing XRDS tag)
527 - $action: the current action
528 - &$xrdsoutputter - XRDSOutputter object to write to
529
530 StartPublicXRDS: Start XRDS output (right after the opening XRDS tag)
531 - $action: the current action
532 - &$xrdsoutputter - XRDSOutputter object to write to
533
534 EndPublicXRDS: End XRDS output (right before the closing XRDS tag)
535 - $action: the current action
536 - &$xrdsoutputter - XRDSOutputter object to write to
537
538 StartCheckPassword: Check a username/password
539 - $nickname: The nickname to check
540 - $password: The password to check
541 - &$authenticatedUser: set to User object if credentials match a user.
542
543 EndCheckPassword: After checking a username/password pair
544 - $nickname: The nickname that was checked
545 - $password: The password that was checked
546 - $authenticatedUser: User object if credentials match a user, else null.
547
548 StartChangePassword: Before changing a password
549 - $user: user
550 - $oldpassword: the user's old password
551 - $newpassword: the desired new password
552
553 EndChangePassword: After changing a password
554 - $user: user
555
556 StartSetUser: Before setting the currently logged in user
557 - $user: user
558
559 EndSetUser: After setting the currently logged in user
560 - $user: user
561
562 StartSetApiUser: Before setting the current API user
563 - $user: user
564
565 EndSetApiUser: After setting the current API user
566 - $user: user
567
568 StartHasRole: Before determing if the a profile has a given role
569 - $profile: profile in question
570 - $name: name of the role in question
571 - &$has_role: does this profile have the named role?
572
573 EndHasRole: Before determing if the a profile has a given role
574 - $profile: profile in question
575 - $name: name of the role in question
576 - $has_role: does this profile have the named role?
577
578 UserDeleteRelated: Specify additional tables to delete entries from when deleting users
579 - $user: User object
580 - &$related: array of DB_DataObject class names to delete entries on matching user_id.
581
582 GetUrlShorteners: Specify URL shorteners that are available for use
583 - &$shorteners: append your shortener to this array like so: $shorteners[shortenerName]=array('display'=>display, 'freeService'=>boolean)
584
585 StartShortenUrl: About to shorten a URL
586 - $url: url to be shortened
587 - $shortenerName: name of the requested shortener
588 - &$shortenedUrl: short version of the url
589
590 EndShortenUrl: After a URL has been shortened
591 - $url: url to be shortened
592 - $shortenerName: name of the requested shortener
593 - $shortenedUrl: short version of the url
594
595 StartCssLinkElement: Before a <link rel="stylesheet"..> element is written
596 - $action
597 - &$src
598 - &$theme
599 - &$media
600
601 EndCssLinkElement: After a <link rel="stylesheet"..> element is written
602 - $action
603 - $src
604 - $theme
605 - $media
606
607 StartStyleElement: Before a <style...> element is written
608 - $action
609 - &$code
610 - &$type
611 - &$media
612
613 EndStyleElement: After a <style...> element is written
614 - $action
615 - $code
616 - $type
617 - $media
618
619 StartScriptElement: Before a <script...> element is written
620 - $action
621 - &$src
622 - &$type
623
624 EndScriptElement: After a <script...> element is written
625 - $action
626 - $src
627 - $type
628
629 StartInlineScriptElement: Before a <script...> element is written
630 - $action
631 - &$code
632 - &$type
633
634 EndInlineScriptElement: After a <script...> element is written
635 - $action
636 - $code
637 - $type
638
639 StartLog: Before writing to the logs
640 - &$priority
641 - &$msg
642 - &$filename
643
644 EndLog: After writing to the logs
645 - $priority
646 - $msg
647 - $filename
648
649 StartBlockProfile: when we're about to block
650 - $user: the person doing the block
651 - $profile: the person getting blocked, can be remote
652
653 EndBlockProfile: when a block has succeeded
654 - $user: the person doing the block
655 - $profile: the person blocked, can be remote
656
657 StartUnblockProfile: when we're about to unblock
658 - $user: the person doing the unblock
659 - $profile: the person getting unblocked, can be remote
660
661 EndUnblockProfile: when an unblock has succeeded
662 - $user: the person doing the unblock
663 - $profile: the person unblocked, can be remote
664
665 StartSubscribe: when a subscription is starting
666 - $user: the person subscribing
667 - $other: the person being subscribed to
668
669 EndSubscribe: when a subscription is finished
670 - $user: the person subscribing
671 - $other: the person being subscribed to
672
673 StartUnsubscribe: when an unsubscribe is starting
674 - $user: the person unsubscribing
675 - $other: the person being unsubscribed from
676
677 EndUnsubscribe: when an unsubscribe is done
678 - $user: the person unsubscribing
679 - $other: the person being unsubscribed to
680
681 StartJoinGroup: when a user is joining a group
682 - $group: the group being joined
683 - $user: the user joining
684
685 EndJoinGroup: when a user finishes joining a group
686 - $group: the group being joined
687 - $user: the user joining
688
689 StartLeaveGroup: when a user is leaving a group
690 - $group: the group being left
691 - $user: the user leaving
692
693 EndLeaveGroup: when a user has left a group
694 - $group: the group being left
695 - $user: the user leaving
696
697 StartShowContentLicense: Showing the default license for content
698 - $action: the current action
699
700 EndShowContentLicense: Showing the default license for content
701 - $action: the current action
702
703 StartUserRegister: When a new user is being registered
704 - &$profile: new profile data (no ID)
705 - &$user: new user account (no ID or URI)
706
707 EndUserRegister: When a new user has been registered
708 - &$profile: new profile data
709 - &$user: new user account
710
711 StartRobotsTxt: Before outputting the robots.txt page
712 - &$action: RobotstxtAction being shown
713
714 EndRobotsTxt: After the default robots.txt page (good place for customization)
715 - &$action: RobotstxtAction being shown
716