EVENTS.txt 55 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512
  1. InitializePlugin: a chance to initialize a plugin in a complete environment
  2. CleanupPlugin: a chance to cleanup a plugin at the end of a program
  3. StartActionExecute: Right before the "prepare" call of the current Action
  4. - $action: the current Action object
  5. - &$args: array of arguments, referenced so you can modify the array
  6. EndActionExecute: Right after the "handle" call of the current Action
  7. - $action: the current Action object
  8. StartPrimaryNav: Showing the primary nav menu
  9. - $action: the current action
  10. EndPrimaryNav: At the end of the primary nav menu
  11. - $action: the current action
  12. StartSecondaryNav: Showing the secondary nav menu
  13. - $action: the current action
  14. EndSecondaryNav: At the end of the secondary nav menu
  15. - $action: the current action
  16. StartShowStyles: Showing Style links; good place to add UA style resets
  17. - $action: the current action
  18. EndShowStyles: End showing Style links; good place to add custom styles
  19. - $action: the current action
  20. StartShowStylesheets: Showing stylesheet links
  21. - $action: the current action
  22. EndShowStylesheets: End showing stylesheet links; good place to add handheld or JavaScript dependant styles
  23. - $action: the current action
  24. StartShowUAStyles: Showing custom User-Agent style links
  25. - $action: the current action
  26. EndShowUAStyles: End showing custom User-Agent links; good place to add user-agent (e.g., filter, -webkit, -moz) specific styles
  27. - $action: the current action
  28. StartShowScripts: Showing JavaScript links
  29. - $action: the current action
  30. EndShowScripts: End showing JavaScript links; good place to add custom links
  31. - $action: the current action
  32. StartShowJQueryScripts: Showing JQuery script links
  33. - $action: the current action
  34. EndShowJQueryScripts: End showing JQuery script links
  35. - $action: the current action
  36. StartShowStatusNetScripts: Showing StatusNet script links (use this to link to a CDN or something)
  37. - $action: the current action
  38. EndShowStatusNetScripts: End showing StatusNet script links
  39. - $action: the current action
  40. StartShowSections: Start the list of sections in the sidebar
  41. - $action: the current action
  42. EndShowSections: End the list of sections in the sidebar
  43. - $action: the current action
  44. StartShowHeader: Showing before the header container
  45. - $action: the current action
  46. EndShowHeader: Showing after the header container
  47. - $action: the current action
  48. StartShowFooter: Showing before the footer container
  49. - $action: the current action
  50. EndShowFooter: Showing after the footer container
  51. - $action: the current action
  52. StartShowContentBlock: Showing before the content container
  53. - $action: the current action
  54. EndShowContentBlock: Showing after the content container
  55. - $action: the current action
  56. StartShowAside: Showing before the Aside container
  57. - $action: the current action
  58. EndShowAside: Showing after the Aside container
  59. - $action: the current action
  60. StartShowNoticeFormData: Showing before the notice form data
  61. - $action: the current action
  62. EndShowNoticeFormData: Showing after the notice form data
  63. - $action: the current action
  64. StartNoticeSave: before inserting a notice (good place for content filters)
  65. - $notice: notice being saved (no ID or URI)
  66. EndNoticeSave: after inserting a notice and related code
  67. - $notice: notice that was saved (with ID and URI)
  68. StartShowLocalNavBlock: Showing the local nav menu
  69. - $action: the current action
  70. EndShowLocalNavBlock: At the end of the local nav menu
  71. - $action: the current action
  72. StartShowHTML: Chance to set document headers (e.g., content type, charset, language), DOCTYPE and html element properties
  73. - $action: the current action
  74. EndShowHTML: Showing after the html element
  75. - $action: the current action
  76. StartPublicGroupNav: Showing the public group nav menu
  77. - $menu: the menu widget; use $menu->action for output
  78. EndPublicGroupNav: At the end of the public group nav menu
  79. - $menu: the menu widget; use $menu->action for output
  80. StartSubGroupNav: Showing the subscriptions group nav menu
  81. - $menu: the menu widget; use $menu->action for output
  82. EndSubGroupNav: At the end of the subscriptions group nav menu
  83. - $menu: the menu widget; use $menu->action for output
  84. StartInitializeRouter: Before the router instance has been initialized; good place to add routes
  85. - $m: the Net_URL_Mapper that has just been set up
  86. RouterInitialized: After the router instance has been initialized
  87. - $m: the Net_URL_Mapper that has just been set up
  88. StartLogout: Before logging out
  89. - $action: the logout action
  90. EndLogout: After logging out
  91. - $action: the logout action
  92. ArgsInitialize: After the argument array has been initialized
  93. - $args: associative array of arguments, can be modified
  94. StartAddressData: Allows the site owner to provide additional information about themselves for contact (e.g., tagline, email, location)
  95. - $action: the current action
  96. EndAddressData: At the end of <address>
  97. - $action: the current action
  98. StartShowSiteNotice: Before showing site notice
  99. - $action: the current action
  100. EndShowSiteNotice: After showing site notice
  101. - $action: the current action
  102. StartLoginGroupNav: Before showing the login and register navigation menu
  103. - $action: the current action
  104. EndLoginGroupNav: After showing the login and register navigation menu
  105. - $action: the current action
  106. StartAccountSettingsNav: Before showing the account settings menu
  107. - $action: the current action
  108. EndAccountSettingsNav: After showing the account settings menu
  109. - $action: the current action
  110. StartAccountSettingsProfileMenuItem: Before showing the Profile menu item
  111. - $widget: AccountSettingsNav instance being shown
  112. EndAccountSettingsProfileMenuItem: After showing the Profile menu item
  113. - $widget: AccountSettingsNav instance being shown
  114. StartAccountSettingsAvatarMenuItem: Before showing the Avatar menu item
  115. - $widget: AccountSettingsNav instance being shown
  116. EndAccountSettingsAvatarMenuItem: After showing the Avatar menu item
  117. - $widget: AccountSettingsNav instance being shown
  118. StartAccountSettingsPasswordMenuItem: Before showing the Password menu item
  119. - $widget: AccountSettingsNav instance being shown
  120. EndAccountSettingsPasswordMenuItem: After showing the Password menu item
  121. - $widget: AccountSettingsNav instance being shown
  122. StartAccountSettingsEmailMenuItem: Before showing the Email menu item
  123. - $widget: AccountSettingsNav instance being shown
  124. EndAccountSettingsEmailMenuItem: After showing the Email menu item
  125. - $widget: AccountSettingsNav instance being shown
  126. StartAccountSettingsDesignMenuItem: Before showing the Design menu item
  127. - $widget: AccountSettingsNav instance being shown
  128. EndAccountSettingsDesignMenuItem: After showing the Design menu item
  129. - $widget: AccountSettingsNav instance being shown
  130. StartAccountSettingsOtherMenuItem: Before showing the Other menu item
  131. - $widget: AccountSettingsNav instance being shown
  132. EndAccountSettingsOtherMenuItem: After showing the Other menu item
  133. - $widget: AccountSettingsNav instance being shown
  134. Autoload: When trying to autoload a class
  135. - $cls: the class being sought. A plugin might require_once the file for the class.
  136. SensitiveAction: determines if an action is 'sensitive' and should use SSL
  137. - $action: name of the action, like 'login'
  138. - $sensitive: flag for whether this is a sensitive action
  139. LoginAction: determines if an action is a 'login' action (OK for public view in private mode)
  140. - $action: name of the action, like 'register'
  141. - $login: flag for whether this is a login action
  142. StartShowHead: called before showing the <head> element and children
  143. - $action: action object being show
  144. EndShowHead: called after showing the <head> element (and </head>)
  145. - $action: action object being shown
  146. StartShowBody: called before showing the <body> element and children
  147. - $action: action object being shown
  148. EndShowBody: called after showing the <body> element (and </body>)
  149. - $action: action object being shown
  150. StartPersonalGroupNav: beginning of personal group nav menu
  151. - $menu: Menu list object being shown
  152. - $target: Profile for whom it is shown
  153. - $scoped: Profile of currently logged in user (or null)
  154. EndPersonalGroupNav: end of personal group nav menu (good place to add a menu item)
  155. - $action: action object being shown
  156. StartEndHTML: just before the </html> tag
  157. - $action: action object being shown
  158. EndEndHTML: just after the </html> tag
  159. - $action: action object being shown
  160. FinalAction: After prepare() (and possible handle) in Action class.
  161. - $status: result of "prepare" call on action
  162. - $action: Action that is currently running
  163. StartShowDesign: just before showing a site, user, or group design
  164. - $action: action object being shown
  165. EndShowDesign: just after showing a site, user, or group design
  166. - $action: action object being shown
  167. StartShowExportData: just before showing the <div> with export data (feeds)
  168. - $action: action object being shown
  169. EndShowExportData: just after showing the <div> with export data (feeds)
  170. - $action: action object being shown
  171. StartShowNoticeItem: just before showing the notice item
  172. - $item: The NoticeListItem object being shown
  173. EndShowNoticeItem: just after showing the notice item
  174. - $item: the NoticeListItem object being shown
  175. StartShowNoticeItemNotice: just before outputting the "top" notice part of a NoticeListItem to HTML
  176. - $item: The NoticeListItem object being shown
  177. EndShowNoticeItemNotice: just after outputting the "top" notice part of a NoticeListItem to HTML
  178. - $item: The NoticeListItem object being shown
  179. StartShowNoticeContent: just before outputting the content part of a Notice
  180. - $stored: The Notice object
  181. - $out: HTMLOutputter for writing to
  182. - $scoped: optional Profile object for permission scoping
  183. EndShowNoticeContent: just after outputting the content part of a Notice, plugins must call this manually
  184. - $stored: The Notice object
  185. - $out: HTMLOutputter for writing to
  186. - $scoped: optional Profile object for permission scoping
  187. StartShowNoticeInfo: just before showing notice info
  188. - $item: The NoticeListItem object being shown
  189. EndShowNoticeInfo: just after showing notice info
  190. - $item: The NoticeListItem object being shown
  191. StartShowNoticeOptions: just before showing notice options like fave, repeat, etc.
  192. - $item: the NoticeListItem object being shown
  193. EndShowNoticeOptions: just after showing notice options like fave, repeat, etc.
  194. - $item: the NoticeListItem object being shown
  195. StartShowPageNotice: just before showing the page notice (instructions or error)
  196. - $action: action object being shown
  197. EndShowPageNotice: just after showing the page notice (instructions or error)
  198. - $action: action object being shown
  199. StartShowPageTitle: just before showing the main h1 title of a page (only for registration)
  200. - $action: action object being shown
  201. StartProfileFormData: just before showing text entry fields on profile settings page
  202. - $action: action object being shown
  203. EndProfileFormData: just after showing text entry fields on profile settings page
  204. - $action: action object being shown
  205. StartProfileSaveForm: before starting to save a profile settings form
  206. - $action: action object being shown
  207. EndProfileSaveForm: after saving a profile settings form (after commit, no profile or user object!)
  208. - $action: action object being shown
  209. StartEmailFormData: just before showing form input fields on email settings page
  210. - $action: Action object being shown
  211. - $scoped: Profile for whom settings are being configured
  212. EndEmailFormData: just after showing form input fields on email settings page
  213. - $action: action object being shown
  214. - $scoped: Profile for whom settings are being configured
  215. StartEmailSaveForm: before starting to save a email settings form
  216. - $action: action object being shown
  217. - $scoped: Profile user having their email settings saved
  218. EndEmailSaveForm: after saving a email settings form (after commit)
  219. - $action: action object being shown
  220. - $scoped: Profile user having their email settings saved
  221. StartRegistrationFormData: just before showing text entry fields on registration page
  222. - $action: action object being shown
  223. EndRegistrationFormData: just after showing text entry fields on registration page
  224. - $action: action object being shown
  225. StartRegistrationTry: before validating and saving a new user
  226. - $action: action object being shown
  227. EndRegistrationTry: after saving a new user (note: no profile or user object!)
  228. - $action: action object being shown
  229. StartAvatarFormData: before displaying avatar form
  230. - $action: action object being shown
  231. EndAvatarFormData: after displaying avatar form
  232. - $action: action object being shown
  233. StartAvatarSaveForm: before saving the avatar
  234. - $action: action object being shown
  235. EndAvatarSaveForm: after saving the avatar
  236. - $action: action object being shown
  237. StartNewQueueManager: before trying to start a new queue manager; good for plugins implementing new queue manager classes
  238. - $qm: empty queue manager to set
  239. StartInitializeQueueManager: about to register queue handlers in the queue manager; good for plugins to register own handlers
  240. - $qm: queue manager
  241. EndInitializeQueueManager: after registering queue handlers in the queue manager; good for plugins to register own handlers
  242. - $qm: queue manager
  243. RedirectToLogin: event when we force a redirect to login (like when going to a settings page on a remembered login)
  244. - $action: action object being shown
  245. - $user: current user
  246. StartLoadDoc: before loading a help doc (hook this to show your own documentation)
  247. - $title: title of the document
  248. - $output: HTML output to show
  249. EndLoadDoc: after loading a help doc (hook this to modify other documentation)
  250. - $title: title of the document
  251. - $output: HTML output to show
  252. StartApiRss: after the rss <channel> element is started
  253. - $action: action object being shown
  254. StartApiAtom: after the <feed> element is started
  255. - $action: action object being shown
  256. StartEnqueueNotice: about to add a notice to the queues (good place to add a new transport)
  257. - $notice: the notice being added
  258. - &$transports: modifiable list of transports (as strings) to queue for
  259. EndEnqueueNotice: after adding a notice to the queues
  260. - $notice: the notice being added
  261. - $transports: modifiable list of transports to use
  262. UnqueueHandleNotice: Handle a notice when no queue manager is available
  263. - $notice: the notice to handle
  264. - $queue: the "queue" that is being executed
  265. GetValidDaemons: Just before determining which daemons to run
  266. - &$daemons: modifiable list of daemon scripts to run, filenames relative to scripts/
  267. HandleQueuedNotice: Handle a queued notice at queue time (or immediately if no queue)
  268. - &$notice: notice to handle
  269. StartHtmlElement: Reight before outputting the HTML element - allows plugins to add namespaces
  270. - $action: the current action
  271. - &$attrs: attributes for the HTML element
  272. EndHtmlElement: Right after outputting the HTML element
  273. - $action: the current action
  274. - &$attrs: attributes for the HTML element
  275. StartShowHeadElements: Right after the <head> tag
  276. - $action: the current action
  277. EndShowHeadElements: Right before the </head> tag; put <script>s here if you need them in <head>
  278. - $action: the current action
  279. CheckSchema: chance to check the schema
  280. StartProfileRemoteSubscribe: Before showing the link to remote subscription
  281. - $userprofile: UserProfile widget
  282. - &$profile: the profile being shown
  283. EndProfileRemoteSubscribe: After showing the link to remote subscription
  284. - $userprofile: UserProfile widget
  285. - &$profile: the profile being shown
  286. StartGroupSubscribe: Before showing the link to remote subscription
  287. - $action: the current action
  288. - $group: the group being shown
  289. EndGroupSubscribe: After showing the link to remote subscription
  290. - $action: the current action
  291. - $group: the group being shown
  292. StartProfilePageProfileSection: Starting to show the section of the
  293. profile page with the actual profile data;
  294. hook to prevent showing the profile (e.g.)
  295. - $userprofile: UserProfile widget
  296. - &$profile: the profile being shown
  297. StartProfilePageProfileElements: inside the section, before the first
  298. element; prepend elements here
  299. - $userprofile: UserProfile widget
  300. - &$profile: the profile being shown
  301. EndProfilePageProfileElements: inside the section, after the last element;
  302. append elements here
  303. - $userprofile: UserProfile widget
  304. - &$profile: the profile being shown
  305. EndProfilePageProfileSection: After showing the section of the profile
  306. page with the profile elements
  307. - $userprofile: UserProfile widget
  308. - &$profile: the profile being shown
  309. StartProfilePageActionsSection: Starting to show the section of the
  310. profile page with action links; hook
  311. to hide them (for example)
  312. - $userprofile: UserProfile widget
  313. - &$profile: the profile being shown
  314. StartProfilePageActionsElements: inside the list, before the first
  315. element; prepend elements here
  316. - $userprofile: UserProfile widget
  317. - &$profile: the profile being shown
  318. EndProfilePageActionsElements: inside the list, after the last element;
  319. append elements here
  320. - $userprofile: UserProfile widget
  321. - &$profile: the profile being shown
  322. EndProfilePageActionsSection: After showing the section of the profile
  323. page with the entity actions
  324. - $userprofile: UserProfile widget
  325. - &$profile: the profile being shown
  326. StartProfilePageAvatar: before showing the avatar on the profile page
  327. - $userprofile: UserProfile widget
  328. - &$profile: the profile being shown
  329. EndProfilePageAvatar: after showing the avatar on the profile page
  330. - $userprofile: UserProfile widget
  331. - &$profile: the profile being shown
  332. StartProfilePageNickname: before showing the nickname on the profile page
  333. - $userprofile: UserProfile widget
  334. - &$profile: the profile being shown
  335. EndProfilePageNickname: after showing the nickname on the profile page
  336. - $userprofile: UserProfile widget
  337. - &$profile: the profile being shown
  338. StartProfilePageFullName: before showing the fullname on the profile page
  339. - $userprofile: UserProfile widget
  340. - &$profile: the profile being shown
  341. EndProfilePageFullName: after showing the fullname on the profile page
  342. - $userprofile: UserProfile widget
  343. - &$profile: the profile being shown
  344. StartProfilePageLocation: before showing the location on the profile page
  345. - $userprofile: UserProfile widget
  346. - &$profile: the profile being shown
  347. EndProfilePageLocation: after showing the location on the profile page
  348. - $userprofile: UserProfile widget
  349. - &$profile: the profile being shown
  350. StartProfilePageHomepage: before showing the homepage link on the profile page
  351. - $userprofile: UserProfile widget
  352. - &$profile: the profile being shown
  353. EndProfilePageHomepage: after showing the homepage on the profile page
  354. - $userprofile: UserProfile widget
  355. - &$profile: the profile being shown
  356. StartProfilePageBio: before showing the bio on the profile page
  357. - $userprofile: UserProfile widget
  358. - &$profile: the profile being shown
  359. EndProfilePageBio: after showing the bio on the profile page
  360. - $userprofile: UserProfile widget
  361. - &$profile: the profile being shown
  362. StartProfilePageProfileTags: before showing the tags on the profile page
  363. - $userprofile: UserProfile widget
  364. - &$profile: the profile being shown
  365. EndProfilePageProfileTags: after showing the tags on the profile page
  366. - $userprofile: UserProfile widget
  367. - &$profile: the profile being shown
  368. StartProfileList: when starting a list of profiles (before <ul>)
  369. - $profilelist: ProfileList widget, with $profile, $action, and $out
  370. EndProfileList: when ending a list of profiles (after </ul>)
  371. - $profilelist: ProfileList widget
  372. StartProfileListItem: when starting to show a profile list item
  373. - $item: ProfileListItem widget
  374. EndProfileListItem: after showing a profile list item
  375. - $item: ProfileListItem widget
  376. StartProfileListItemProfile: the profile data part of the item
  377. - $item: ProfileListItem widget
  378. EndProfileListItemProfile: the profile data part of the item
  379. - $item: ProfileListItem widget
  380. StartProfileListItemActions: the actions (buttons) for an item
  381. - $item: ProfileListItem widget
  382. EndProfileListItemActions: the actions (buttons) for an item
  383. - $item: ProfileListItem widget
  384. StartProfileListItemProfileElements: inside the <div>
  385. - $item: ProfileListItem widget
  386. EndProfileListItemProfileElements: inside the <div>
  387. - $item: ProfileListItem widget
  388. StartProfileListItemAvatar: Showing a profile list avatar
  389. - $item: ProfileListItem widget
  390. EndProfileListItemAvatar: Showing a profile list avatar
  391. - $item: ProfileListItem widget
  392. StartProfileListItemFullName: Showing the profile list full name
  393. - $item: ProfileListItem widget
  394. EndProfileListItemFullName: Showing the profile list full name
  395. - $item: ProfileListItem widget
  396. StartProfileListItemLocation: Showing the profile list location
  397. - $item: ProfileListItem widget
  398. EndProfileListItemLocation: Showing the profile list location
  399. - $item: ProfileListItem widget
  400. StartProfileListItemHomepage: Showing the profile list homepage
  401. - $item: ProfileListItem widget
  402. EndProfileListItemHomepage: Showing the profile list homepage
  403. - $item: ProfileListItem widget
  404. StartProfileListItemBio: Showing the profile list bio
  405. - $item: ProfileListItem widget
  406. EndProfileListItemBio: Showing the profile list bio
  407. - $item: ProfileListItem widget
  408. StartProfileListItemActionElements: Showing the profile list actions (prepend a button here, or replace all buttons)
  409. - $item: ProfileListItem widget
  410. EndProfileListItemActionElements: Showing profile list actions (append a button here)
  411. - $item: ProfileListItem widget
  412. StartUserXRDS: Start XRDS output (right after the opening XRDS tag)
  413. - $action: the current action
  414. - &$xrdsoutputter - XRDSOutputter object to write to
  415. EndUserXRDS: End XRDS output (right before the closing XRDS tag)
  416. - $action: the current action
  417. - &$xrdsoutputter - XRDSOutputter object to write to
  418. StartPublicXRDS: Start XRDS output (right after the opening XRDS tag)
  419. - $action: the current action
  420. - &$xrdsoutputter - XRDSOutputter object to write to
  421. EndPublicXRDS: End XRDS output (right before the closing XRDS tag)
  422. - $action: the current action
  423. - &$xrdsoutputter - XRDSOutputter object to write to
  424. StartCheckPassword: Check a username/password
  425. - $nickname: The nickname to check
  426. - $password: The password to check
  427. - &$authenticatedUser: set to User object if credentials match a user.
  428. EndCheckPassword: After checking a username/password pair
  429. - $nickname: The nickname that was checked
  430. - $password: The password that was checked
  431. - $authenticatedUser: User object if credentials match a user, else null.
  432. StartChangePassword: Before changing a password
  433. - Profile $target: The profile of the User that is changing password
  434. - $oldpassword: the user's old password
  435. - $newpassword: the desired new password
  436. EndChangePassword: After changing a password
  437. - Profile $target: The profile of the User that just changed its password
  438. StartHashPassword: Generate a hashed version of the password (like a salted crypt)
  439. - &$hashed: Hashed version of the password, later put in the database
  440. - $password: The password that should be hashed
  441. - $profile: Profile that this password and hash belongs to. Can be null.
  442. StartSetUser: Before setting the currently logged in user
  443. - $user: user
  444. EndSetUser: After setting the currently logged in user
  445. - $user: user
  446. StartSetApiUser: Before setting the current API user
  447. - &$user: user, can be set during event handling (return false to stop processing)
  448. EndSetApiUser: After setting the current API user
  449. - $user: user, only called if this is an actual user
  450. StartHasRole: Before determing if the a profile has a given role
  451. - $profile: profile in question
  452. - $name: name of the role in question
  453. - &$has_role: does this profile have the named role?
  454. EndHasRole: Before determing if the a profile has a given role
  455. - $profile: profile in question
  456. - $name: name of the role in question
  457. - $has_role: does this profile have the named role?
  458. UserDeleteRelated: Specify additional tables to delete entries from when deleting users
  459. - $user: User object
  460. - &$related: array of DB_DataObject class names to delete entries on matching user_id.
  461. GetUrlShorteners: Specify URL shorteners that are available for use
  462. - &$shorteners: append your shortener to this array like so: $shorteners[shortenerName]=array('display'=>display, 'freeService'=>boolean)
  463. StartShortenUrl: About to shorten a URL
  464. - $url: url to be shortened
  465. - $shortenerName: name of the requested shortener
  466. - &$shortenedUrl: short version of the url
  467. EndShortenUrl: After a URL has been shortened
  468. - $url: url to be shortened
  469. - $shortenerName: name of the requested shortener
  470. - $shortenedUrl: short version of the url
  471. StartCssLinkElement: Before a <link rel="stylesheet"..> element is written
  472. - $action
  473. - &$src
  474. - &$theme
  475. - &$media
  476. EndCssLinkElement: After a <link rel="stylesheet"..> element is written
  477. - $action
  478. - $src
  479. - $theme
  480. - $media
  481. StartStyleElement: Before a <style...> element is written
  482. - $action
  483. - &$code
  484. - &$type
  485. - &$media
  486. EndStyleElement: After a <style...> element is written
  487. - $action
  488. - $code
  489. - $type
  490. - $media
  491. StartScriptElement: Before a <script...> element is written
  492. - $action
  493. - &$src
  494. - &$type
  495. EndScriptElement: After a <script...> element is written
  496. - $action
  497. - $src
  498. - $type
  499. StartInlineScriptElement: Before a <script...> element is written
  500. - $action
  501. - &$code
  502. - &$type
  503. EndInlineScriptElement: After a <script...> element is written
  504. - $action
  505. - $code
  506. - $type
  507. StartLog: Before writing to the logs
  508. - &$priority
  509. - &$msg
  510. - &$filename
  511. EndLog: After writing to the logs
  512. - $priority
  513. - $msg
  514. - $filename
  515. StartBlockProfile: when we're about to block
  516. - $user: the person doing the block
  517. - $profile: the person getting blocked, can be remote
  518. EndBlockProfile: when a block has succeeded
  519. - $user: the person doing the block
  520. - $profile: the person blocked, can be remote
  521. StartUnblockProfile: when we're about to unblock
  522. - $user: the person doing the unblock
  523. - $profile: the person getting unblocked, can be remote
  524. EndUnblockProfile: when an unblock has succeeded
  525. - $user: the person doing the unblock
  526. - $profile: the person unblocked, can be remote
  527. StartSubscribe: when a subscription is starting
  528. - $profile: Profile that is subscribing
  529. - $other: Profile that is being subscribed to
  530. EndSubscribe: when a subscription is finished
  531. - $profile: Profile that is subscribing
  532. - $other: Profile that is being subscribed to
  533. StartUnsubscribe: when an unsubscribe is starting
  534. - $profile: Profile that is unsubscribing
  535. - $other: Profile that is being unsubscribed from
  536. EndUnsubscribe: when an unsubscribe is done
  537. - $profile: Profile that is unsubscribing
  538. - $other: Profile that is being unsubscribed from
  539. StartJoinGroup: when a user is joining a group
  540. - $group: the group being joined
  541. - $profile: the local or remote user joining
  542. EndJoinGroup: when a user finishes joining a group
  543. - $group: the group being joined
  544. - $profile: the local or remote user joining
  545. StartLeaveGroup: when a user is leaving a group
  546. - $group: the group being left
  547. - $profile: the local or remote user leaving
  548. EndLeaveGroup: when a user has left a group
  549. - $group: the group being left
  550. - $profile: the local or remote user leaving
  551. StartShowContentLicense: Showing the default license for content
  552. - $action: the current action
  553. EndShowContentLicense: Showing the default license for content
  554. - $action: the current action
  555. GetImTransports: Get IM transports that are available
  556. - &$transports: append your transport to this array like so: $transports[transportName]=array('display'=>display)
  557. NormalizeImScreenname: Normalize an IM screenname
  558. - $transport: transport the screenname is on
  559. - &$screenname: screenname to be normalized
  560. ValidateImScreenname: Validate an IM screenname
  561. - $transport: transport the screenname is on
  562. - $screenname: screenname to be validated
  563. - $valid: is the screenname valid?
  564. SendImConfirmationCode: Send a confirmation code to confirm a user owns an IM screenname
  565. - $transport: transport the screenname exists on
  566. - $screenname: screenname being confirmed
  567. - $code: confirmation code for confirmation URL
  568. - $user: user requesting the confirmation
  569. StartUserRegister: When a new user is being registered
  570. - $profile: Profile object with new profile data (no ID yet)
  571. EndUserRegister: When a new user has been registered
  572. - $profile: Profile object with new profile data
  573. StartRobotsTxt: Before outputting the robots.txt page
  574. - &$action: RobotstxtAction being shown
  575. EndRobotsTxt: After the default robots.txt page (good place for customization)
  576. - &$action: RobotstxtAction being shown
  577. StartGetProfileUri: When determining the canonical URI for a given profile
  578. - $profile: the current profile
  579. - &$uri: the URI
  580. EndGetProfileUri: After determining the canonical URI for a given profile
  581. - $profile: the current profile
  582. - &$uri: the URI
  583. StartGetProfileAcctUri: Get the acct: URI for a Profile (or throw ProfileNoAcctUriException)
  584. - $profile: Profile of user we want to get acct: URI for
  585. - &$acct: string with the resulting acct: uri
  586. EndGetProfileAcctUri: Last attempts to get the acct: URI for a Profile (or throw ProfileNoAcctUriException)
  587. - $profile: Profile of user we want to get acct: URI for
  588. - &$acct: string with the resulting acct: uri
  589. StartFindMentions: start finding mentions in a block of text
  590. - $sender: sender profile
  591. - $text: plain text version of the notice
  592. - &$mentions: mentions found so far. Array of arrays; each array
  593. has 'mentioned' (array of mentioned profiles), 'url' (url to link as),
  594. 'title' (title of the link), 'position' (position of the text to
  595. replace), 'text' (text to replace)
  596. EndFindMentions: end finding mentions in a block of text
  597. - $sender: sender profile
  598. - $text: plain text version of the notice
  599. - &$mentions: mentions found so far. Array of arrays; each array
  600. has 'mentioned' (array of mentioned profiles), 'url' (url to link as),
  601. 'title' (title of the link), 'position' (position of the text to
  602. replace), 'text' (text to replace)
  603. StartShowSubscriptionsContent: before showing the subscriptions content
  604. - $action: the current action
  605. EndShowSubscriptionsContent: after showing the subscriptions content
  606. - $action: the current action
  607. StartShowUserGroupsContent: before showing the user groups content
  608. - $action: the current action
  609. EndShowUserGroupsContent: after showing the user groups content
  610. - $action: the current action
  611. StartShowAllContent: before showing the all (you and friends) content
  612. - $action: the current action
  613. EndShowAllContent: after showing the all (you and friends) content
  614. - $action: the current action
  615. StartShowSubscriptionsMiniList: at the start of subscriptions mini list
  616. - $action: the current action
  617. EndShowSubscriptionsMiniList: at the end of subscriptions mini list
  618. - $action: the current action
  619. StartShowGroupsMiniList: at the start of groups mini list
  620. - $action: the current action
  621. EndShowGroupsMiniList: at the end of groups mini list
  622. - $action: the current action
  623. StartDeleteUserForm: starting the data in the form for deleting a user
  624. - $action: action being shown
  625. - $user: user being deleted
  626. EndDeleteUserForm: Ending the data in the form for deleting a user
  627. - $action: action being shown
  628. - $user: user being deleted
  629. StartDeleteUser: handling the post for deleting a user
  630. - $action: action being shown
  631. - $user: user being deleted
  632. EndDeleteUser: handling the post for deleting a user
  633. - $action: action being shown
  634. - $user: user being deleted
  635. StartNoticeAsActivity: before converting a notice to an activity
  636. - $notice: notice being converted
  637. - &$activity: initially empty activity
  638. EndNoticeAsActivity: after converting a notice to an activity (good time to customize!)
  639. - $notice: notice being converted
  640. - &$activity: activity, now more-or-less full
  641. StartNoticeSaveWeb: before saving a notice through the Web interface
  642. - $action: action being executed (instance of NewNoticeAction)
  643. - &$authorId: integer ID of the author
  644. - &$text: text of the notice
  645. - &$options: additional options (location, replies, etc.)
  646. EndNoticeSaveWeb: after saving a notice through the Web interface
  647. - $action: action being executed (instance of NewNoticeAction)
  648. - $notice: notice that was saved
  649. StartRssEntryArray: at the start of copying a notice to an array
  650. - $notice: the notice being copied
  651. - &$entry: the entry (empty at beginning)
  652. EndRssEntryArray: at the end of copying a notice to an array
  653. - $notice: the notice being copied
  654. - &$entry: the entry, with all the fields filled up
  655. NoticeDeleteRelated: at the beginning of deleting related fields to a notice
  656. - $notice: notice being deleted
  657. FileDeleteRelated: at the beginning of deleting related fields to a File
  658. - $notice: File being deleted
  659. StartShowHeadTitle: when beginning to show the <title> element
  660. - $action: action being shown
  661. EndShowHeadTitle: when done showing the <title>
  662. - $action: action being shown
  663. StartShowPageTitle: when beginning to show the page title <h1>
  664. - $action: action being shown
  665. EndShowPageTitle: when done showing the page title <h1>
  666. - $action: action being shown
  667. StartDeleteOwnNotice: when a user starts to delete their own notice
  668. - $user: the user doing the delete
  669. - $notice: the notice being deleted
  670. EndDeleteOwnNotice: when a user has deleted their own notice
  671. - $user: the user doing the delete
  672. - $notice: the notice being deleted
  673. StartShowFeedLinkList: before showing the feed list in the sidebar
  674. - $action: action being executed
  675. - $feeds: list of feeds to show
  676. EndShowFeedLinkList: after showing the feed list in the sidebar
  677. - $action: action being executed
  678. - $feeds: list of feeds shown
  679. StartShowFeedLink: before showing an individual feed item
  680. - $action: action being executed
  681. - $feed: feed to show
  682. EndShowFeedLink: after showing an individual feed
  683. - $action: action being executed
  684. - $feed: feed to show
  685. StartShowNoticeForm: before showing the notice form (before <form>)
  686. - $action: action being executed
  687. EndShowNoticeForm: after showing the notice form (after <form>)
  688. - $action: action being executed
  689. StartShowEntryForms: microapp entry form tab data
  690. - &$tabs: tab assoc array with 'tag' => (title, href to create new entry)
  691. StartGrantRole: when a role is being assigned
  692. - $profile: profile that will have the role
  693. - $role: string name of the role
  694. EndGrantRole: when a role has been successfully assigned
  695. - $profile: profile that will have the role
  696. - $role: string name of the role
  697. StartRevokeRole: when a role is being revoked
  698. - $profile: profile that will lose the role
  699. - $role: string name of the role
  700. EndRevokeRole: when a role has been revoked
  701. - $profile: profile that lost the role
  702. - $role: string name of the role
  703. StartAtomPubNewActivity: When a new activity comes in through Atom Pub API
  704. - &$activity: received activity
  705. - $profile: profile of the user publishing the entry
  706. - &$notice: notice created; initially null, can be set
  707. EndAtomPubNewActivity: When a new activity comes in through Atom Pub API
  708. - $activity: received activity
  709. - $profile: profile of the user publishing the entry
  710. - $notice: notice that was created
  711. AdminPanelCheck: When checking whether the current user can access a given admin panel
  712. - $name: Name of the admin panel
  713. - &$isOK: Boolean whether the user is allowed to use the panel
  714. StartAdminPanelNav: Before displaying the first item in the list of admin panels
  715. - $nav The AdminPanelNav widget
  716. EndAdminPanelNav: After displaying the last item in the list of admin panels
  717. - $nav The AdminPanelNav widget
  718. StartActivityObjectFromNotice: When converting a notice to an activity:object
  719. - $notice: The notice being converted
  720. - &$object: The resulting object. Fill this and return false to override defaults.
  721. EndActivityObjectFromNotice: After converting a notice to an activity:object
  722. - $notice: The notice being converted
  723. - &$object: The resulting object. Can be edited
  724. StartActivityObjectFromProfile: When converting a profile to an activity:object
  725. - $profile: The profile being converted
  726. - &$object: The (empty) object. Fill it up and return false to override defaults.
  727. EndActivityObjectFromProfile: After converting a profile to an activity:object
  728. - $profile: The profile being converted
  729. - &$object: The finished object. Can be tweaked
  730. StartActivityObjectFromGroup: When converting a group to an activity:object
  731. - $group: The group being converted
  732. - &$object: The (empty) object. Fill and return false to override.
  733. EndActivityObjectFromGroup: After converting a group to an activity:object
  734. - $group: The group being converted
  735. - &$object: The finished object. Tweak as needed.
  736. StartImportActivity: when we start to import an activity
  737. - $user: User to make the author import
  738. - $author: Author of the feed; good for comparisons
  739. - $activity: The current activity
  740. - $trusted: How "trusted" the process is
  741. - &$done: Return value; whether to continue
  742. EndImportActivity: when we finish importing an activity
  743. - $user: User to make the author import
  744. - $author: Author of the feed; good for comparisons
  745. - $activity: The current activity
  746. - $trusted: How "trusted" the process is
  747. StartProfileSettingsActions: when we're showing account-management action list
  748. - $action: Action being shown (use for output)
  749. EndProfileSettingsActions: when we're showing account-management action list
  750. - $action: Action being shown (use for output)
  751. StartOpenNoticeListItemElement: Before the opening <li> of a notice list element
  752. - $nli: The notice list item being shown
  753. EndOpenNoticeListItemElement: After the opening <li> of a notice list element
  754. - $nli: The notice list item being shown
  755. StartCloseNoticeListItemElement: Before the closing </li> of a notice list element
  756. - $nli: The notice list item being shown
  757. EndCloseNoticeListItemElement: After the closing </li> of a notice list element
  758. - $nli: The notice list item being shown
  759. StartGroupEditFormData: Beginning the group edit form entries
  760. - $form: The form widget being shown
  761. EndGroupEditFormData: Ending the group edit form entries
  762. - $form: The form widget being shown
  763. StartGroupSave: After initializing but before saving a group
  764. - &$group: group about to be saved
  765. EndGroupSave: After saving a group, aliases, and first member
  766. - $group: group that was saved
  767. StartInterpretCommand: Before running a command
  768. - $cmd: First word in the string, 'foo' in 'foo argument'
  769. - $arg: Argument, if any, like 'argument' in 'foo argument'
  770. - $user: User who issued the command
  771. - &$result: Resulting command; you can set this!
  772. EndInterpretCommand: Before running a command
  773. - $cmd: First word in the string, 'foo' in 'foo argument'
  774. - $arg: Argument, if any, like 'argument' in 'foo argument'
  775. - $user: User who issued the command
  776. - $result: Resulting command
  777. StartGroupActionsList: Start the list of actions on a group profile page (after <ul>, before first <li>)
  778. - $action: action being executed (for output and params)
  779. - $group: group for the page
  780. EndGroupActionsList: End the list of actions on a group profile page (before </ul>, after last </li>)
  781. - $action: action being executed (for output and params)
  782. - $group: group for the page
  783. StartGroupProfileElements: Start showing stuff about the group on its profile page
  784. - $action: action being executed (for output and params)
  785. - $group: group for the page
  786. EndGroupProfileElements: Start showing stuff about the group on its profile page
  787. - $action: action being executed (for output and params)
  788. - $group: group for the page
  789. StartShowProfileTagContent: When showing a people tag page
  790. - $action: action being executed (for output and params)
  791. EndShowProfileTagContent: After showing the contents of a people tag page
  792. - $action: action being executed (for output and params)
  793. StartShowTaggedProfilesMiniList: at the start of mini list of tagged profiles
  794. - $action: action being executed (for output and params)
  795. EndShowTaggedProfilesMiniList: at the end of mini list of tagged profiles
  796. - $action: action being executed (for output and params)
  797. StartShowProfileTagSubscribersMiniList: at the start of mini list of people tag subscribers
  798. - $action: action being executed (for output and params)
  799. EndShowProfileTagSubscribersMiniList: at the end of mini list of people tag subscribers
  800. - $action: action being executed (for output and params)
  801. StartTagProfileAction: When starting to show profile tagging page
  802. - $action: action being executed (for output and params)
  803. - $profile: profile being tagged
  804. EndTagProfileAction: After showing profile tagging page
  805. - $action: action being executed (for output and params)
  806. - $profile: profile being tagged
  807. StartProfileCompletionSearch: When starting a profile search for autocompletion
  808. - $action: action being executed (for output and params)
  809. - &$profile: result Profile objects
  810. - $search_engine: the search engine
  811. EndProfileCompletionSearch: After search results for profile autocompletion have been found
  812. - $action: profilec completion action
  813. - &$profile: current result Profile objects
  814. - $search_engine: The search engine object
  815. StartShowTagProfileForm: When showing people tagging form
  816. - $action: action being executed (for output and params)
  817. - $profile: profile being tagged
  818. EndShowTagProfileForm: After showing people tagging form
  819. - $action: action being executed (for output and params)
  820. - $profile: profile being tagged
  821. StartSavePeopletags: When starting to save people tags
  822. - $action: action being executed (for output and params)
  823. - $tagstring: string input, a list of tags
  824. EndSavePeopletags: After saving people tags
  825. - $action: action being executed (for output and params)
  826. - $tagstring: string input, a list of tags
  827. StartProfiletagGetUri: when generating the Uri for a people tag
  828. - $profile_list: the people tag, a Profile_list object
  829. - &$uri: the URI
  830. EndProfiletagGetUri: after generating the uri for a people tag
  831. - $profile_list: the people tag, a Profile_list object
  832. - &$uri: the URI
  833. StartUserPeopletagHomeUrl: when generating the homepage url for a people tag
  834. - $profile_list: the people tag, a Profile_list object
  835. - &$url: the URL
  836. EndUserPeopletagHomeUrl: after generating the homepage url for a people tag
  837. - $profile_list: the people tag, a Profile_list object
  838. - &$url: the URL
  839. StartProfiletagPermalink: when generating the permalink url for a people tag
  840. - $profile_list: the people tag, a Profile_list object
  841. - &$url: the URL
  842. EndProfiletagPermalink: after generating the permalink url for a people tag
  843. - $profile_list: the people tag, a Profile_list object
  844. - &$url: the URL
  845. StartTagProfile: when tagging a profile
  846. - $tagger: profile tagging
  847. - $tagged: profile being tagged
  848. - $tag: the tag
  849. EndTagProfile: after tagging a profile
  850. - $newtag: the newly created Profile_tag object
  851. StartUntagProfile: when deleting a people tag
  852. - $ptag: the Profile_tag object being deleted
  853. EndUntagProfile: after deleting a people tag
  854. - $orig: a copy of the deleted Profile_tag object
  855. StartSubscribePeopletag: when subscribing to a people tag
  856. - $peopletag: Profile_list object being subscribed to
  857. - $profile: subscriber's profile
  858. EndSubscribePeopletag: after subscribing to a people tag
  859. - $profile_list: the people tag, a Profile_list object: Profile_list object being subscribed to
  860. - $profile: subscriber's profile
  861. StartUnsubscribePeopletag: when unsubscribing to a people tag
  862. - $profile_list: the people tag, a Profile_list object: Profile_list object being subscribed to
  863. - $profile: subscriber's profile
  864. EndUnsubscribePeopletag: after unsubscribing to a people tag
  865. - $peopletag: Profile_list object being subscribed to
  866. - $profile: subscriber's profile
  867. StartActivityObjectFromPeopletag: while starting to create an ActivityObject from a people tag
  868. - $profile_list: the people tag, a Profile_list object
  869. - &$object: activity object
  870. EndActivityObjectFromPeopletag: after making an ActivityObject from a people tag
  871. - $profile_list: the people tag, a Profile_list object
  872. - &$object: activity object
  873. StartPeopletagGroupNav: Showing the people tag nav menu
  874. - $menu: the menu widget; use $menu->action for output
  875. EndPeopletagGroupNav: after showing the people tag nav menu
  876. - $menu: the menu widget; use $menu->action for output
  877. StartShowPeopletagItem: when showing a people tag
  878. - $widget: PeopletagListItem widget
  879. EndShowPeopletagItem: after showing a people tag
  880. - $widget: PeopletagListItem widget
  881. StartSubscribePeopletagForm: when showing people tag subscription form
  882. - $action: action being executed (for output and params)
  883. - $peopletag: people tag being subscribed to
  884. EndSubscribePeopletagForm: after showing the people tag subscription form
  885. - $action: action being executed (for output and params)
  886. - $peopletag: people tag being subscribed to
  887. StartShowPeopletags: when showing a textual list of people tags
  888. - $widget: PeopletagsWidget; use $widget->out for output
  889. - $tagger: profile of the tagger
  890. - $tagged: profile tagged
  891. EndShowPeopletags: after showing a textual list of people tags
  892. - $widget: PeopletagsWidget; use $widget->out for output
  893. - $tagger: profile of the tagger
  894. - $tagged: profile tagged
  895. StartProfileListItemTags: when showing people tags in a profile list item widget
  896. - $widget: ProfileListItem widget
  897. EndProfileListItemTags: after showing people tags in a profile list item widget
  898. - $widget: ProfileListItem widget
  899. StartActivityObjectOutputAtom: Called at start of Atom XML output generation for ActivityObject chunks, just inside the <activity:object>. Cancel the event to take over its output completely (you're responsible for calling the matching End event if so)
  900. - $obj: ActivityObject
  901. - $out: XMLOutputter to append custom output
  902. EndActivityObjectOutputAtom: Called at end of Atom XML output generation for ActivityObject chunks, just inside the </activity:object>
  903. - $obj: ActivityObject
  904. - $out: XMLOutputter to append custom output
  905. StartActivityObjectOutputJson: Called at start of JSON output generation for ActivityObject chunks: the array has not yet been filled out. Cancel the event to take over its output completely (you're responsible for calling the matching End event if so)
  906. - $obj ActivityObject
  907. - &$out: array to be serialized; you're free to modify it
  908. EndActivityObjectOutputJson: Called at end of JSON output generation for ActivityObject chunks: the array has not yet been filled out.
  909. - $obj ActivityObject
  910. - &$out: array to be serialized; you're free to modify it
  911. StartNoticeWhoGets: Called at start of inbox delivery prep; plugins can schedule notices to go to particular profiles that would otherwise not have reached them. Canceling will take over the entire addressing operation. Be aware that output can be cached or used several times, so should remain idempotent.
  912. - $notice Notice
  913. - &$ni: in/out array mapping profile IDs to constants: NOTICE_INBOX_SOURCE_SUB etc
  914. EndNoticeWhoGets: Called at end of inbox delivery prep; plugins can filter out profiles from receiving inbox delivery here. Be aware that output can be cached or used several times, so should remain idempotent.
  915. - $notice Notice
  916. - &$ni: in/out array mapping profile IDs to constants: NOTICE_INBOX_SOURCE_SUB etc
  917. StartDefaultLocalNav: When showing the default local nav
  918. - $menu: the menu
  919. - $user: current user
  920. EndDefaultLocalNav: When showing the default local nav
  921. - $menu: the menu
  922. - $user: current user
  923. StartShowAccountProfileBlock: When showing the profile block for an account
  924. - $out: XMLOutputter to append custom output
  925. - $profile: the profile being shown
  926. EndShowAccountProfileBlock: After showing the profile block for an account
  927. - $out: XMLOutputter to append custom output
  928. - $profile: the profile being shown
  929. StartShowGroupProfileBlock: When showing the profile block for a group
  930. - $out: XMLOutputter to append custom output
  931. - $profile: the profile being shown
  932. EndShowGroupProfileBlock: After showing the profile block for a group
  933. - $out: XMLOutputter to append custom output
  934. - $group: the group being shown
  935. StartShowConversation: start the listing of a conversation
  936. - $action: Action object (used mainly as HTMLOutputter)
  937. - $conv: Conversation object, has functions to retrieve relevant notices
  938. - $scoped: Profile for scoping (null if not logged in)
  939. EndShowConversation: after the listing of a conversation
  940. - $action: Action object (used mainly as HTMLOutputter)
  941. - $conv: Conversation object, has functions to retrieve relevant notices
  942. - $scoped: Profile for scoping (null if not logged in)
  943. StartShowThreadedNoticeTail: when showing the replies etc. to a notice
  944. - $nli: parent noticelistitem
  945. - $notice: parent notice
  946. - &$children: list of children
  947. EndShowThreadedNoticeTail: when showing the replies etc. to a notice
  948. - $nli: parent noticelistitem
  949. - $notice: parent notice
  950. - $children: list of children
  951. StartShowThreadedNoticeSub: when showing a reply to a notice
  952. - $nli: parent noticelistitem
  953. - $parent: parent notice
  954. - $child: child notice
  955. EndShowThreadedNoticeSub: when showing a reply to a notice
  956. - $nli: parent noticelistitem
  957. - $parent: parent notice
  958. - $child: child notice
  959. StartAddEmailAddress: when adding an email address through the Web UI
  960. - $user: user getting the new address
  961. - $email: email being added
  962. EndAddEmailAddress: done adding an email address through the Web UI
  963. - $user: user getting the new address
  964. - $email: email being added
  965. StartValidateEmailInvite: when validating an email address for invitations
  966. - $user: user doing the invite
  967. - $email: email address
  968. - &$valid: flag for if it's valid; can be modified
  969. EndValidateEmailInvite: after validating an email address for invitations
  970. - $user: user doing the invite
  971. - $email: email address
  972. - &$valid: flag for if it's valid; can be modified
  973. StartLocalURL: before resolving a local url for an action
  974. - &$action: action to find a path for
  975. - &$paramsi: parameters to pass to the action
  976. - &$fragment: any url fragement
  977. - &$addSession: whether to add session variable
  978. - &$url: resulting URL to local resource
  979. EndLocalURL: before resolving a local url for an action
  980. - &$action: action to find a path for
  981. - &$paramsi: parameters to pass to the action
  982. - &$fragment: any url fragement
  983. - &$addSession: whether to add session variable
  984. - &$url: resulting URL to local resource
  985. StartProfileGetAvatar: When getting an avatar for a profile
  986. - $profile: profile
  987. - $size: size of the avatar
  988. - &$avatar: avatar
  989. EndProfileGetAvatar: After getting an avatar for a profile
  990. - $profile: profile
  991. - $size: size of the avatar
  992. - &$avatar: avatar
  993. StartRegisterSuccess: Before showing the registration success message
  994. - $action: the registration action
  995. StartRegisterSuccess: After showing the registration success message
  996. - $action: the registration action
  997. StartDocFileForTitle: Before searching for a doc or mail template
  998. - $title: Title we're looking for
  999. - &$paths: Paths we're searching
  1000. - &$filename: Filename so far (set this if you want)
  1001. EndDocFileForTitle: After searching for a doc or mail template
  1002. - $title: Title we looked for
  1003. - $paths: Paths we searched
  1004. - &$filename: Filename so far (set this if you want)
  1005. StartReadWriteTables: when noting which tables must be read-write, even on read-only actions
  1006. - &$tables: list of table names
  1007. - &$rwdb: read-write database URI
  1008. EndReadWriteTables: after noting which tables must be read-write, even on read-only actions
  1009. - $tables: list of table names
  1010. - $rwdb: read-write database URI
  1011. StartShowInviteForm: Right before displaying the invitations form
  1012. - $action: invitation action
  1013. EndShowInviteForm: After displaying the invitations form
  1014. - $action: invitation action
  1015. StartSendInvitations: Right before sending invitations
  1016. - $action: invitation action
  1017. EndSendInvitations: Right after sending invitations
  1018. - $action: invitation action
  1019. StartShowInvitationSuccess: Right before showing invitations success msg
  1020. - $action: invitation action
  1021. EndShowInvitationSuccess: After showing invitations success msg
  1022. - $action: invitation action
  1023. StartUpgrade: when starting a site upgrade
  1024. EndUpgrade: when ending a site upgrade; good place to do your own upgrades
  1025. HaveIMPlugin: is there an IM plugin loaded?
  1026. - &$haveIMPlugin: set me to true if you're loaded!
  1027. StartShowNoticeOptionItems: Before showing first controls in a notice list item; inside the div
  1028. - $nli: NoticeListItem being shown
  1029. EndShowNoticeOptionItems: After showing last controls in a notice list item; inside the div
  1030. - $nli: NoticeListItem being shown
  1031. StartNoticeInScope: Before checking if a notice should be visible to a user
  1032. - $notice: The notice to check
  1033. - $profile: The profile to check for scope
  1034. - &$bResult: The boolean result; fill this in if you want to skip
  1035. EndNoticeInScope: After checking if a notice should be visible to a user
  1036. - $notice: The notice to check
  1037. - $profile: The profile to check for scope
  1038. - &$bResult: The boolean result; overwrite this if you so desire
  1039. StartNoticeListPrefill: Before pre-filling a list of notices with extra data
  1040. - &$notices: Notices to be pre-filled
  1041. - $avatarSize: The avatar size for the list
  1042. EndNoticeListPrefill: After pre-filling a list of notices with extra data
  1043. - &$notices: Notices that were pre-filled
  1044. - &$profiles: Profiles that were pre-filled
  1045. - $avatarSize: The avatar size for the list
  1046. OtherAccountProfiles: Hook to add account profiles to a user account profile block
  1047. - $profile: the Profile being shown
  1048. - &$others: Modifiable array of profile info arrays. Each one has the following fields:
  1049. href: link to the profile
  1050. text: text for the profile
  1051. image: mini image for the profile
  1052. CreateFileImageThumbnailSource: Hook to create image thumbnail source from a File
  1053. - $file: 'File' object to source the image from
  1054. - &$imgPath: Path to image file which can be used as source for our thumbnail algorithm.
  1055. - $media: MIME media type ('image', 'video', 'audio' etc.)
  1056. StartResizeImageFile: Hook to resize an image and output it to a file. No matching End event yet.
  1057. - $imagefile: ImageFile object we're resizing.
  1058. - $outpath: string with output filepath
  1059. - $box: array with size ('width', 'height') and boundary box('x', 'y', 'w', 'h').
  1060. FillImageFileMetadata: Get more metadata about the ImageFile if it is perhaps not a real local file
  1061. - $imagefile ImageFile object which we're getting metadata for (such as animated status, width/height etc.)
  1062. StartShowAttachmentRepresentation: Attachment representation, full file (or in rare cases thumbnails/previews).
  1063. - $out: HTMLOutputter class to use for outputting HTML.
  1064. - $file: 'File' object which we're going to show representation for.
  1065. EndShowAttachmentRepresentation: Executed after Attachment representation, despite perhaps being unsupported media.
  1066. - $out: HTMLOutputter class to use for outputting HTML.
  1067. - $file: 'File' object which we're going to show representation for.
  1068. ShowUnsupportedAttachmentRepresentation: Attachment representation, full file (or in rare cases thumbnails/previews).
  1069. - $out: HTMLOutputter class to use for outputting HTML.
  1070. - $file: 'File' object which we're going to show representation for.
  1071. StartNotifyMentioned: During notice distribution, we send notifications (email, im...) to the profiles who were somehow mentioned.
  1072. - $stored: Notice object that is being distributed.
  1073. - &$mentioned_ids: Array of profile IDs (not just for local users) who got mentioned by the notice.
  1074. EndNotifyMentioned: During notice distribution, we send notifications (email, im...) to the profiles who were somehow mentioned.
  1075. - $stored: Notice object that is being distributed.
  1076. - $mentioned_ids: Array of profile IDs (not just for local users) who got mentioned by the notice.
  1077. StartHomeStubNavItems: Go back Home nav items. Default includes just one item 'home'
  1078. - $out: HTMLOutputter used to output (usually an Action, but not always!)
  1079. - &$items: Referenced array of items in the nav (add if desired)
  1080. EndHomeStubNavItems:
  1081. - $out: HTMLOutputter used to output (usually an Action, but not always!)
  1082. - $items: array of menu items
  1083. StartSubMenu: Before outputting a submenu (including enclosing tags) to HTML
  1084. - $out: HTMLOutputter used to output (usually an Action, but not always!)
  1085. - $menu: The Menu object outputted as a submenu.
  1086. - $label: Localized text which represents the menu item.
  1087. EndSubMenu: After outputting a submenu (including enclosing tags) to HTML
  1088. - $out: HTMLOutputter used to output (usually an Action, but not always!)
  1089. - $menu: The Menu object outputted as a submenu.
  1090. - $label: Localized text which represents the menu item.
  1091. StartDocNav: Before outputting the docs Nav
  1092. - $nav: The DoclNav widget
  1093. EndDocNav: After outputting the docs Nav
  1094. - $nav: The DoclNav widget
  1095. StartNoticeSearch: Before finding notices that match the given query
  1096. - string $query: The text query
  1097. StartNoticeSearchShowResults: Before displaying notices matching the query
  1098. - $out: HTMLOutputter used to output
  1099. - $query: The text query
  1100. - $notices: Array of DB notice objects
  1101. EndNoticeSearchShowResults: After displaying notices matching the query
  1102. - $out: HTMLOutputter used to output
  1103. - $query: The text query
  1104. - $notices: Array of DB notice objects