1 InitializePlugin: a chance to initialize a plugin in a complete environment
3 CleanupPlugin: a chance to cleanup a plugin at the end of a program
5 StartPrimaryNav: Showing the primary nav menu
6 - $action: the current action
8 EndPrimaryNav: At the end of the primary nav menu
9 - $action: the current action
11 StartSecondaryNav: Showing the secondary nav menu
12 - $action: the current action
14 EndSecondaryNav: At the end of the secondary nav menu
15 - $action: the current action
17 StartShowStyles: Showing Style links; good place to add UA style resets
18 - $action: the current action
20 EndShowStyles: End showing Style links; good place to add custom styles
21 - $action: the current action
23 StartShowStatusNetStyles: Showing StatusNet Style links
24 - $action: the current action
26 EndShowStatusNetStyles: End showing StatusNet Style links; good place to add handheld or JavaScript dependant styles
27 - $action: the current action
29 StartShowLaconicaStyles: backwards compatibility; deprecated
30 - $action: the current action
32 EndShowLaconicaStyles: backwards compatibility; deprecated
33 - $action: the current action
35 StartShowUAStyles: Showing custom User-Agent style links
36 - $action: the current action
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
41 StartShowScripts: Showing JavaScript links
42 - $action: the current action
44 EndShowScripts: End showing JavaScript links; good place to add custom
45 links like Google Analytics
46 - $action: the current action
48 StartShowJQueryScripts: Showing JQuery script links (use this to link to e.g. Google mirrors)
49 - $action: the current action
51 EndShowJQueryScripts: End showing JQuery script links
52 - $action: the current action
54 StartShowStatusNetScripts: Showing StatusNet script links (use this to link to a CDN or something)
55 - $action: the current action
57 EndShowStatusNetScripts: End showing StatusNet script links
58 - $action: the current action
60 StartShowLaconicaScripts: backwards compatibility; deprecated
61 - $action: the current action
63 EndShowLaconicaScripts: backwards compatibility; deprecated
64 - $action: the current action
66 StartShowSections: Start the list of sections in the sidebar
67 - $action: the current action
69 EndShowSections: End the list of sections in the sidebar
70 - $action: the current action
72 StartShowHeader: Showing before the header container
73 - $action: the current action
75 EndShowHeader: Showing after the header container
76 - $action: the current action
78 StartShowFooter: Showing before the footer container
79 - $action: the current action
81 EndShowFooter: Showing after the footer container
82 - $action: the current action
84 StartShowContentBlock: Showing before the content container
85 - $action: the current action
87 EndShowContentBlock: Showing after the content container
88 - $action: the current action
90 StartShowAside: Showing before the Aside container
91 - $action: the current action
93 EndShowAside: Showing after the Aside container
94 - $action: the current action
96 StartShowNoticeFormData: Showing before the notice form data
97 - $action: the current action
99 EndShowNoticeFormData: Showing after the notice form data
100 - $action: the current action
102 StartNoticeSave: before inserting a notice (good place for content filters)
103 - $notice: notice being saved (no ID or URI)
105 EndNoticeSave: after inserting a notice and related code
106 - $notice: notice that was saved (with ID and URI)
108 StartShowLocalNavBlock: Showing the local nav menu
109 - $action: the current action
111 EndShowLocalNavBlock: At the end of the local nav menu
112 - $action: the current action
114 StartShowHTML: Chance to set document headers (e.g., content type, charset, language), DOCTYPE and html element properties
115 - $action: the current action
117 EndShowHTML: Showing after the html element
118 - $action: the current action
120 StartPublicGroupNav: Showing the public group nav menu
121 - $action: the current action
123 EndPublicGroupNav: At the end of the public group nav menu
124 - $action: the current action
126 StartSubGroupNav: Showing the subscriptions group nav menu
127 - $action: the current action
129 EndSubGroupNav: At the end of the subscriptions group nav menu
130 - $action: the current action
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
135 RouterInitialized: After the router instance has been initialized
136 - $m: the Net_URL_Mapper that has just been set up
138 StartLogout: Before logging out
139 - $action: the logout action
141 EndLogout: After logging out
142 - $action: the logout action
144 ArgsInitialized: After the argument array has been initialized
145 - $args: associative array of arguments, can be modified
147 StartAddressData: Allows the site owner to provide additional information about themselves for contact (e.g., tagline, email, location)
148 - $action: the current action
150 EndAddressData: At the end of <address>
151 - $action: the current action
153 StartShowSiteNotice: Before showing site notice
154 - $action: the current action
156 EndShowSiteNotice: After showing site notice
157 - $action: the current action
159 StartLoginGroupNav: Before showing the login and register navigation menu
160 - $action: the current action
162 EndLoginGroupNav: After showing the login and register navigation menu
163 - $action: the current action
165 StartAccountSettingsNav: Before showing the account settings menu
166 - $action: the current action
168 EndAccountSettingsNav: After showing the account settings menu
169 - $action: the current action
171 StartAccountSettingsProfileMenuItem: Before showing the Profile menu item
172 - $widget: AccountSettingsNav instance being shown
174 EndAccountSettingsProfileMenuItem: After showing the Profile menu item
175 - $widget: AccountSettingsNav instance being shown
177 StartAccountSettingsAvatarMenuItem: Before showing the Avatar menu item
178 - $widget: AccountSettingsNav instance being shown
180 EndAccountSettingsAvatarMenuItem: After showing the Avatar menu item
181 - $widget: AccountSettingsNav instance being shown
183 StartAccountSettingsPasswordMenuItem: Before showing the Password menu item
184 - $widget: AccountSettingsNav instance being shown
186 EndAccountSettingsPasswordMenuItem: After showing the Password menu item
187 - $widget: AccountSettingsNav instance being shown
189 StartAccountSettingsEmailMenuItem: Before showing the Email menu item
190 - $widget: AccountSettingsNav instance being shown
192 EndAccountSettingsEmailMenuItem: After showing the Email menu item
193 - $widget: AccountSettingsNav instance being shown
195 StartAccountSettingsDesignMenuItem: Before showing the Design menu item
196 - $widget: AccountSettingsNav instance being shown
198 EndAccountSettingsDesignMenuItem: After showing the Design menu item
199 - $widget: AccountSettingsNav instance being shown
201 StartAccountSettingsOtherMenuItem: Before showing the Other menu item
202 - $widget: AccountSettingsNav instance being shown
204 EndAccountSettingsOtherMenuItem: After showing the Other menu item
205 - $widget: AccountSettingsNav instance being shown
207 Autoload: When trying to autoload a class
208 - $cls: the class being sought. A plugin might require_once the file for the class.
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
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
218 StartShowHead: called before showing the <head> element and children
219 - $action: action object being show
221 EndShowHead: called after showing the <head> element (and </head>)
222 - $action: action object being shown
224 StartShowBody: called before showing the <body> element and children
225 - $action: action object being shown
227 EndShowBody: called after showing the <body> element (and </body>)
228 - $action: action object being shown
230 StartPersonalGroupNav: beginning of personal group nav menu
231 - $action: action object being shown
233 EndPersonalGroupNav: end of personal group nav menu (good place to add a menu item)
234 - $action: action object being shown
236 StartGroupGroupNav: Showing the group nav menu
237 - $action: the current action
239 EndGroupGroupNav: At the end of the group nav menu
240 - $action: the current action
242 StartEndHTML: just before the </html> tag
243 - $action: action object being shown
245 EndEndHTML: just after the </html> tag
246 - $action: action object being shown
248 StartShowDesign: just before showing a site, user, or group design
249 - $action: action object being shown
251 EndShowDesign: just after showing a site, user, or group design
252 - $action: action object being shown
254 StartShowExportData: just before showing the <div> with export data (feeds)
255 - $action: action object being shown
257 EndShowExportData: just after showing the <div> with export data (feeds)
258 - $action: action object being shown
260 StartShowNoticeItem: just before showing the notice item
261 - $action: action object being shown
263 EndShowNoticeItem: just after showing the notice item
264 - $action: action object being shown
266 StartShowPageNotice: just before showing the page notice (instructions or error)
267 - $action: action object being shown
269 EndShowPageNotice: just after showing the page notice (instructions or error)
270 - $action: action object being shown
272 StartShowPageTitle: just before showing the main h1 title of a page (only for registration)
273 - $action: action object being shown
275 StartProfileFormData: just before showing text entry fields on profile settings page
276 - $action: action object being shown
278 EndProfileFormData: just after showing text entry fields on profile settings page
279 - $action: action object being shown
281 StartProfileSaveForm: before starting to save a profile settings form
282 - $action: action object being shown
284 EndProfileSaveForm: after saving a profile settings form (after commit, no profile or user object!)
285 - $action: action object being shown
287 StartRegistrationFormData: just before showing text entry fields on registration page
288 - $action: action object being shown
290 EndRegistrationFormData: just after showing text entry fields on registration page
291 - $action: action object being shown
293 StartRegistrationTry: before validating and saving a new user
294 - $action: action object being shown
296 EndRegistrationTry: after saving a new user (note: no profile or user object!)
297 - $action: action object being shown
299 StartAvatarFormData: before displaying avatar form
300 - $action: action object being shown
302 EndAvatarFormData: after displaying avatar form
303 - $action: action object being shown
305 StartAvatarSaveForm: before saving the avatar
306 - $action: action object being shown
308 EndAvatarSaveForm: after saving the avatar
309 - $action: action object being shown
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
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
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
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
326 StartApiRss: after the rss <channel> element is started
327 - $action: action object being shown
329 StartApiAtom: after the <feed> element is started
330 - $action: action object being shown
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
336 EndEnqueueNotice: after adding a notice to the queues
337 - $notice: the notice being added
338 - $transports: modifiable list of transports to use
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
344 GetValidDaemons: Just before determining which daemons to run
345 - &$daemons: modifiable list of daemon scripts to run, filenames relative to scripts/
347 HandleQueuedNotice: Handle a queued notice at queue time (or immediately if no queue)
348 - &$notice: notice to handle
350 StartShowHeadElements: Right after the <head> tag
351 - $action: the current action
353 EndShowHeadElements: Right before the </head> tag; put <script>s here if you need them in <head>
354 - $action: the current action
356 CheckSchema: chance to check the schema
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
364 StartProfilePageProfileElements: inside the section, before the first
365 element; prepend elements here
366 - $userprofile: UserProfile widget
367 - &$profile: the profile being shown
369 EndProfilePageProfileElements: inside the section, after the last element;
371 - $userprofile: UserProfile widget
372 - &$profile: the profile being shown
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
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
385 StartProfilePageActionsElements: inside the list, before the first
386 element; prepend elements here
387 - $userprofile: UserProfile widget
388 - &$profile: the profile being shown
390 EndProfilePageActionsElements: inside the list, after the last element;
392 - $userprofile: UserProfile widget
393 - &$profile: the profile being shown
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
400 StartProfilePageAvatar: before showing the avatar on the profile page
401 - $userprofile: UserProfile widget
402 - &$profile: the profile being shown
404 EndProfilePageAvatar: after showing the avatar on the profile page
405 - $userprofile: UserProfile widget
406 - &$profile: the profile being shown
408 StartProfilePageNickname: before showing the nickname on the profile page
409 - $userprofile: UserProfile widget
410 - &$profile: the profile being shown
412 EndProfilePageNickname: after showing the nickname on the profile page
413 - $userprofile: UserProfile widget
414 - &$profile: the profile being shown
416 StartProfilePageFullName: before showing the fullname on the profile page
417 - $userprofile: UserProfile widget
418 - &$profile: the profile being shown
420 EndProfilePageFullName: after showing the fullname on the profile page
421 - $userprofile: UserProfile widget
422 - &$profile: the profile being shown
424 StartProfilePageLocation: before showing the location on the profile page
425 - $userprofile: UserProfile widget
426 - &$profile: the profile being shown
428 EndProfilePageLocation: after showing the location on the profile page
429 - $userprofile: UserProfile widget
430 - &$profile: the profile being shown
432 StartProfilePageHomepage: before showing the homepage link on the profile page
433 - $userprofile: UserProfile widget
434 - &$profile: the profile being shown
436 EndProfilePageHomepage: after showing the homepage on the profile page
437 - $userprofile: UserProfile widget
438 - &$profile: the profile being shown
440 StartProfilePageBio: before showing the bio on the profile page
441 - $userprofile: UserProfile widget
442 - &$profile: the profile being shown
444 EndProfilePageBio: after showing the bio on the profile page
445 - $userprofile: UserProfile widget
446 - &$profile: the profile being shown
448 StartProfilePageProfileTags: before showing the tags on the profile page
449 - $userprofile: UserProfile widget
450 - &$profile: the profile being shown
452 EndProfilePageProfileTags: after showing the tags on the profile page
453 - $userprofile: UserProfile widget
454 - &$profile: the profile being shown
456 StartProfileList: when starting a list of profiles (before <ul>)
457 - $profilelist: ProfileList widget, with $profile, $action, and $out
459 EndProfileList: when ending a list of profiles (after </ul>)
460 - $profilelist: ProfileList widget
462 StartProfileListItem: when starting to show a profile list item
463 - $item: ProfileListItem widget
465 EndProfileListItem: after showing a profile list item
466 - $item: ProfileListItem widget
468 StartProfileListItemProfile: the profile data part of the item
469 - $item: ProfileListItem widget
471 EndProfileListItemProfile: the profile data part of the item
472 - $item: ProfileListItem widget
474 StartProfileListItemActions: the actions (buttons) for an item
475 - $item: ProfileListItem widget
477 EndProfileListItemActions: the actions (buttons) for an item
478 - $item: ProfileListItem widget
480 StartProfileListItemProfileElements: inside the <div>
481 - $item: ProfileListItem widget
483 EndProfileListItemProfileElements: inside the <div>
484 - $item: ProfileListItem widget
486 StartProfileListItemAvatar: Showing a profile list avatar
487 - $item: ProfileListItem widget
489 EndProfileListItemAvatar: Showing a profile list avatar
490 - $item: ProfileListItem widget
492 StartProfileListItemFullName: Showing the profile list full name
493 - $item: ProfileListItem widget
495 EndProfileListItemFullName: Showing the profile list full name
496 - $item: ProfileListItem widget
498 StartProfileListItemLocation: Showing the profile list location
499 - $item: ProfileListItem widget
501 EndProfileListItemLocation: Showing the profile list location
502 - $item: ProfileListItem widget
504 StartProfileListItemHomepage: Showing the profile list homepage
505 - $item: ProfileListItem widget
507 EndProfileListItemHomepage: Showing the profile list homepage
508 - $item: ProfileListItem widget
510 StartProfileListItemBio: Showing the profile list bio
511 - $item: ProfileListItem widget
513 EndProfileListItemBio: Showing the profile list bio
514 - $item: ProfileListItem widget
516 StartProfileListItemActionElements: Showing the profile list actions (prepend a button here, or replace all buttons)
517 - $item: ProfileListItem widget
519 EndProfileListItemActionElements: Showing profile list actions (append a button here)
520 - $item: ProfileListItem widget
522 StartUserXRDS: Start XRDS output (right after the opening XRDS tag)
523 - $action: the current action
524 - &$xrdsoutputter - XRDSOutputter object to write to
526 EndUserXRDS: End XRDS output (right before the closing XRDS tag)
527 - $action: the current action
528 - &$xrdsoutputter - XRDSOutputter object to write to
530 StartPublicXRDS: Start XRDS output (right after the opening XRDS tag)
531 - $action: the current action
532 - &$xrdsoutputter - XRDSOutputter object to write to
534 EndPublicXRDS: End XRDS output (right before the closing XRDS tag)
535 - $action: the current action
536 - &$xrdsoutputter - XRDSOutputter object to write to
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.
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.
548 StartChangePassword: Before changing a password
550 - $oldpassword: the user's old password
551 - $newpassword: the desired new password
553 EndChangePassword: After changing a password
556 StartSetUser: Before setting the currently logged in user
559 EndSetUser: After setting the currently logged in user
562 StartSetApiUser: Before setting the current API user
565 EndSetApiUser: After setting the current API user
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?
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?
578 UserDeleteRelated: Specify additional tables to delete entries from when deleting users
580 - &$related: array of DB_DataObject class names to delete entries on matching user_id.
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)
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
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
595 StartCssLinkElement: Before a <link rel="stylesheet"..> element is written
601 EndCssLinkElement: After a <link rel="stylesheet"..> element is written
607 StartStyleElement: Before a <style...> element is written
613 EndStyleElement: After a <style...> element is written
619 StartScriptElement: Before a <script...> element is written
624 EndScriptElement: After a <script...> element is written
629 StartInlineScriptElement: Before a <script...> element is written
634 EndInlineScriptElement: After a <script...> element is written
639 StartLog: Before writing to the logs
644 EndLog: After writing to the logs
649 StartBlockProfile: when we're about to block
650 - $user: the person doing the block
651 - $profile: the person getting blocked, can be remote
653 EndBlockProfile: when a block has succeeded
654 - $user: the person doing the block
655 - $profile: the person blocked, can be remote
657 StartUnblockProfile: when we're about to unblock
658 - $user: the person doing the unblock
659 - $profile: the person getting unblocked, can be remote
661 EndUnblockProfile: when an unblock has succeeded
662 - $user: the person doing the unblock
663 - $profile: the person unblocked, can be remote
665 StartSubscribe: when a subscription is starting
666 - $user: the person subscribing
667 - $other: the person being subscribed to
669 EndSubscribe: when a subscription is finished
670 - $user: the person subscribing
671 - $other: the person being subscribed to
673 StartUnsubscribe: when an unsubscribe is starting
674 - $user: the person unsubscribing
675 - $other: the person being unsubscribed from
677 EndUnsubscribe: when an unsubscribe is done
678 - $user: the person unsubscribing
679 - $other: the person being unsubscribed to
681 StartJoinGroup: when a user is joining a group
682 - $group: the group being joined
683 - $user: the user joining
685 EndJoinGroup: when a user finishes joining a group
686 - $group: the group being joined
687 - $user: the user joining
689 StartLeaveGroup: when a user is leaving a group
690 - $group: the group being left
691 - $user: the user leaving
693 EndLeaveGroup: when a user has left a group
694 - $group: the group being left
695 - $user: the user leaving
697 StartShowContentLicense: Showing the default license for content
698 - $action: the current action
700 EndShowContentLicense: Showing the default license for content
701 - $action: the current action
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)
707 EndUserRegister: When a new user has been registered
708 - &$profile: new profile data
709 - &$user: new user account
711 StartRobotsTxt: Before outputting the robots.txt page
712 - &$action: RobotstxtAction being shown
714 EndRobotsTxt: After the default robots.txt page (good place for customization)
715 - &$action: RobotstxtAction being shown