SloodleUser.html 64 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title>Docs For Class SloodleUser</title>
  7. <link rel="stylesheet" href="../media/stylesheet.css" />
  8. <script src="../media/lib/classTree.js"></script>
  9. <script language="javascript" type="text/javascript">
  10. var imgPlus = new Image();
  11. var imgMinus = new Image();
  12. imgPlus.src = "../media/images/plus.png";
  13. imgMinus.src = "../media/images/minus.png";
  14. function showNode(Node){
  15. switch(navigator.family){
  16. case 'nn4':
  17. // Nav 4.x code fork...
  18. var oTable = document.layers["span" + Node];
  19. var oImg = document.layers["img" + Node];
  20. break;
  21. case 'ie4':
  22. // IE 4/5 code fork...
  23. var oTable = document.all["span" + Node];
  24. var oImg = document.all["img" + Node];
  25. break;
  26. case 'gecko':
  27. // Standards Compliant code fork...
  28. var oTable = document.getElementById("span" + Node);
  29. var oImg = document.getElementById("img" + Node);
  30. break;
  31. }
  32. oImg.src = imgMinus.src;
  33. oTable.style.display = "block";
  34. }
  35. function hideNode(Node){
  36. switch(navigator.family){
  37. case 'nn4':
  38. // Nav 4.x code fork...
  39. var oTable = document.layers["span" + Node];
  40. var oImg = document.layers["img" + Node];
  41. break;
  42. case 'ie4':
  43. // IE 4/5 code fork...
  44. var oTable = document.all["span" + Node];
  45. var oImg = document.all["img" + Node];
  46. break;
  47. case 'gecko':
  48. // Standards Compliant code fork...
  49. var oTable = document.getElementById("span" + Node);
  50. var oImg = document.getElementById("img" + Node);
  51. break;
  52. }
  53. oImg.src = imgPlus.src;
  54. oTable.style.display = "none";
  55. }
  56. function nodeIsVisible(Node){
  57. switch(navigator.family){
  58. case 'nn4':
  59. // Nav 4.x code fork...
  60. var oTable = document.layers["span" + Node];
  61. break;
  62. case 'ie4':
  63. // IE 4/5 code fork...
  64. var oTable = document.all["span" + Node];
  65. break;
  66. case 'gecko':
  67. // Standards Compliant code fork...
  68. var oTable = document.getElementById("span" + Node);
  69. break;
  70. }
  71. return (oTable && oTable.style.display == "block");
  72. }
  73. function toggleNodeVisibility(Node){
  74. if (nodeIsVisible(Node)){
  75. hideNode(Node);
  76. }else{
  77. showNode(Node);
  78. }
  79. }
  80. </script>
  81. </head>
  82. <body>
  83. <div class="page-body">
  84. <h2 class="class-name"><img src="../media/images/Class_logo.png"
  85. alt=" Class"
  86. title=" Class"
  87. style="vertical-align: middle"> SloodleUser</h2>
  88. <a name="sec-description"></a>
  89. <div class="info-box">
  90. <div class="info-box-title">Description</div>
  91. <div class="nav-bar">
  92. <span class="disabled">Description</span> |
  93. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  94. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  95. </div>
  96. <div class="info-box-body">
  97. <!-- ========== Info from phpDoc block ========= -->
  98. <p class="short-description">A class to represent a single user, including Moodle and Sloodle data.</p>
  99. <ul class="tags">
  100. <li><span class="field">usedby:</span> <a href="../sloodle/SloodleRequest.html">SloodleRequest</a> - Stores and processes user data incoming from an HTTP request</li>
  101. </ul>
  102. <p class="notes">
  103. Located in <a class="field" href="_lib---user.php.html">/lib/user.php</a> (line <span class="field"><a href="../__filesource/fsource_sloodle__libuser.php.html#a33">33</a></span>)
  104. </p>
  105. <pre></pre>
  106. </div>
  107. </div>
  108. <a name="sec-var-summary"></a>
  109. <div class="info-box">
  110. <div class="info-box-title">Variable Summary</span></div>
  111. <div class="nav-bar">
  112. <a href="#sec-description">Description</a> |
  113. <span class="disabled">Vars</span> (<a href="#sec-vars">details</a>)
  114. |
  115. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  116. </div>
  117. <div class="info-box-body">
  118. <div class="var-summary">
  119. <div class="var-title">
  120. <img src="../media/images/PrivateVariable.png" alt=" " />
  121. <span class="var-type">object</span>
  122. <a href="#$avatar_data" title="details" class="var-name">$avatar_data</a>
  123. </div>
  124. <div class="var-title">
  125. <img src="../media/images/PrivateVariable.png" alt=" " />
  126. <span class="var-type">obejct</span>
  127. <a href="#$user_data" title="details" class="var-name">$user_data</a>
  128. </div>
  129. <div class="var-title">
  130. <img src="../media/images/Variable.png" alt=" " />
  131. <span class="var-type">object</span>
  132. <a href="#$_session" title="details" class="var-name">$_session</a>
  133. </div>
  134. </div>
  135. </div>
  136. </div>
  137. <a name="sec-method-summary"></a>
  138. <div class="info-box">
  139. <div class="info-box-title">Method Summary</span></div>
  140. <div class="nav-bar">
  141. <a href="#sec-description">Description</a> |
  142. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  143. |
  144. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  145. </div>
  146. <div class="info-box-body">
  147. <div class="method-summary">
  148. <div class="method-definition">
  149. <img src="../media/images/Constructor.png" alt=" "/>
  150. <span class="method-result">SloodleUser</span>
  151. <a href="#SloodleUser" title="details" class="method-name">SloodleUser</a>
  152. (<span class="var-type">object</span>&nbsp;<span class="var-name">&$_session</span>)
  153. </div>
  154. <div class="method-definition">
  155. <img src="../media/images/Method.png" alt=" "/>
  156. <span class="method-result">bool</span>
  157. <a href="#add_linked_avatar" title="details" class="method-name">add_linked_avatar</a>
  158. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$userid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  159. </div>
  160. <div class="method-definition">
  161. <img src="../media/images/Method.png" alt=" "/>
  162. <span class="method-result">object|bool</span>
  163. <a href="#add_pending_avatar" title="details" class="method-name">add_pending_avatar</a>
  164. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>, [<span class="var-type">int</span>&nbsp;<span class="var-name">$timestamp</span> = <span class="var-default">null</span>])
  165. </div>
  166. <div class="method-definition">
  167. <img src="../media/images/Method.png" alt=" "/>
  168. <span class="method-result">int|bool</span>
  169. <a href="#add_user_object" title="details" class="method-name">add_user_object</a>
  170. (<span class="var-type">string</span>&nbsp;<span class="var-name">$avuuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$objuuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$objname</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$password</span>)
  171. </div>
  172. <div class="method-definition">
  173. <img src="../media/images/Method.png" alt=" "/>
  174. <span class="method-result">bool</span>
  175. <a href="#authorise_user_object" title="details" class="method-name">authorise_user_object</a>
  176. (<span class="var-type">int</span>&nbsp;<span class="var-name">$authid</span>)
  177. </div>
  178. <div class="method-definition">
  179. <img src="../media/images/Method.png" alt=" "/>
  180. <span class="method-result">string|bool</span>
  181. <a href="#autoregister_avatar_user" title="details" class="method-name">autoregister_avatar_user</a>
  182. ()
  183. </div>
  184. <div class="method-definition">
  185. <img src="../media/images/Method.png" alt=" "/>
  186. <span class="method-result">bool</span>
  187. <a href="#delete_avatar" title="details" class="method-name">delete_avatar</a>
  188. ()
  189. </div>
  190. <div class="method-definition">
  191. <img src="../media/images/Method.png" alt=" "/>
  192. <span class="method-result">void</span>
  193. <a href="#delete_user_object" title="details" class="method-name">delete_user_object</a>
  194. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>)
  195. </div>
  196. <div class="method-definition">
  197. <img src="../media/images/Method.png" alt=" "/>
  198. <span class="method-result">void</span>
  199. <a href="#enrol" title="details" class="method-name">enrol</a>
  200. ([<span class="var-type">object</span>&nbsp;<span class="var-name">$sloodle_course</span> = <span class="var-default">null</span>], <span class="var-type">bool</span>&nbsp;<span class="var-name">1</span>)
  201. </div>
  202. <div class="method-definition">
  203. <img src="../media/images/Method.png" alt=" "/>
  204. <span class="method-result">mixed</span>
  205. <a href="#get_avatar_id" title="details" class="method-name">get_avatar_id</a>
  206. ()
  207. </div>
  208. <div class="method-definition">
  209. <img src="../media/images/Method.png" alt=" "/>
  210. <span class="method-result">int</span>
  211. <a href="#get_avatar_last_active" title="details" class="method-name">get_avatar_last_active</a>
  212. ()
  213. </div>
  214. <div class="method-definition">
  215. <img src="../media/images/Method.png" alt=" "/>
  216. <span class="method-result">string</span>
  217. <a href="#get_avatar_name" title="details" class="method-name">get_avatar_name</a>
  218. ()
  219. </div>
  220. <div class="method-definition">
  221. <img src="../media/images/Method.png" alt=" "/>
  222. <span class="method-result">string</span>
  223. <a href="#get_avatar_uuid" title="details" class="method-name">get_avatar_uuid</a>
  224. ()
  225. </div>
  226. <div class="method-definition">
  227. <img src="../media/images/Method.png" alt=" "/>
  228. <span class="method-result">array</span>
  229. <a href="#get_enrolled_courses" title="details" class="method-name">get_enrolled_courses</a>
  230. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  231. </div>
  232. <div class="method-definition">
  233. <img src="../media/images/Method.png" alt=" "/>
  234. <span class="method-result">array</span>
  235. <a href="#get_staff_courses" title="details" class="method-name">get_staff_courses</a>
  236. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  237. </div>
  238. <div class="method-definition">
  239. <img src="../media/images/Method.png" alt=" "/>
  240. <span class="method-result">string</span>
  241. <a href="#get_username" title="details" class="method-name">get_username</a>
  242. ()
  243. </div>
  244. <div class="method-definition">
  245. <img src="../media/images/Method.png" alt=" "/>
  246. <span class="method-result">string|null</span>
  247. <a href="#get_user_email" title="details" class="method-name">get_user_email</a>
  248. ()
  249. </div>
  250. <div class="method-definition">
  251. <img src="../media/images/Method.png" alt=" "/>
  252. <span class="method-result">string</span>
  253. <a href="#get_user_firstname" title="details" class="method-name">get_user_firstname</a>
  254. ()
  255. </div>
  256. <div class="method-definition">
  257. <img src="../media/images/Method.png" alt=" "/>
  258. <span class="method-result">mixed</span>
  259. <a href="#get_user_id" title="details" class="method-name">get_user_id</a>
  260. ()
  261. </div>
  262. <div class="method-definition">
  263. <img src="../media/images/Method.png" alt=" "/>
  264. <span class="method-result">string</span>
  265. <a href="#get_user_lastname" title="details" class="method-name">get_user_lastname</a>
  266. ()
  267. </div>
  268. <div class="method-definition">
  269. <img src="../media/images/Method.png" alt=" "/>
  270. <span class="method-result">array</span>
  271. <a href="#get_user_objects" title="details" class="method-name">get_user_objects</a>
  272. ()
  273. </div>
  274. <div class="method-definition">
  275. <img src="../media/images/Method.png" alt=" "/>
  276. <span class="method-result">bool</span>
  277. <a href="#is_avatar_linked" title="details" class="method-name">is_avatar_linked</a>
  278. ()
  279. </div>
  280. <div class="method-definition">
  281. <img src="../media/images/Method.png" alt=" "/>
  282. <span class="method-result">bool</span>
  283. <a href="#is_avatar_loaded" title="details" class="method-name">is_avatar_loaded</a>
  284. ()
  285. </div>
  286. <div class="method-definition">
  287. <img src="../media/images/Method.png" alt=" "/>
  288. <span class="method-result">void</span>
  289. <a href="#is_enrolled" title="details" class="method-name">is_enrolled</a>
  290. (<span class="var-type"></span>&nbsp;<span class="var-name">$courseid</span>, <span class="var-type">mixed</span>&nbsp;<span class="var-name">$course</span>, <span class="var-type">bool</span>&nbsp;<span class="var-name">1</span>)
  291. </div>
  292. <div class="method-definition">
  293. <img src="../media/images/Method.png" alt=" "/>
  294. <span class="method-result">void</span>
  295. <a href="#is_staff" title="details" class="method-name">is_staff</a>
  296. (<span class="var-type"></span>&nbsp;<span class="var-name">$courseid</span>, <span class="var-type">mixed</span>&nbsp;<span class="var-name">$course</span>, <span class="var-type">bool</span>&nbsp;<span class="var-name">1</span>)
  297. </div>
  298. <div class="method-definition">
  299. <img src="../media/images/Method.png" alt=" "/>
  300. <span class="method-result">bool</span>
  301. <a href="#is_user_loaded" title="details" class="method-name">is_user_loaded</a>
  302. ()
  303. </div>
  304. <div class="method-definition">
  305. <img src="../media/images/Method.png" alt=" "/>
  306. <span class="method-result">bool</span>
  307. <a href="#link_avatar" title="details" class="method-name">link_avatar</a>
  308. ()
  309. </div>
  310. <div class="method-definition">
  311. <img src="../media/images/Method.png" alt=" "/>
  312. <span class="method-result">bool</span>
  313. <a href="#load_avatar" title="details" class="method-name">load_avatar</a>
  314. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  315. </div>
  316. <div class="method-definition">
  317. <img src="../media/images/Method.png" alt=" "/>
  318. <span class="method-result">bool</span>
  319. <a href="#load_avatar_by_id" title="details" class="method-name">load_avatar_by_id</a>
  320. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  321. </div>
  322. <div class="method-definition">
  323. <img src="../media/images/Method.png" alt=" "/>
  324. <span class="method-result">bool,string</span>
  325. <a href="#load_linked_avatar" title="details" class="method-name">load_linked_avatar</a>
  326. ()
  327. </div>
  328. <div class="method-definition">
  329. <img src="../media/images/Method.png" alt=" "/>
  330. <span class="method-result">bool</span>
  331. <a href="#load_linked_user" title="details" class="method-name">load_linked_user</a>
  332. ()
  333. </div>
  334. <div class="method-definition">
  335. <img src="../media/images/Method.png" alt=" "/>
  336. <span class="method-result">bool</span>
  337. <a href="#load_user" title="details" class="method-name">load_user</a>
  338. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  339. </div>
  340. <div class="method-definition">
  341. <img src="../media/images/Method.png" alt=" "/>
  342. <span class="method-result">bool</span>
  343. <a href="#login" title="details" class="method-name">login</a>
  344. ()
  345. </div>
  346. <div class="method-definition">
  347. <img src="../media/images/Method.png" alt=" "/>
  348. <span class="method-result">void</span>
  349. <a href="#purge_password_notifications" title="details" class="method-name">purge_password_notifications</a>
  350. ()
  351. </div>
  352. <div class="method-definition">
  353. <img src="../media/images/Method.png" alt=" "/>
  354. <span class="method-result">string|bool</span>
  355. <a href="#reset_password" title="details" class="method-name">reset_password</a>
  356. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$require</span> = <span class="var-default">true</span>])
  357. </div>
  358. <div class="method-definition">
  359. <img src="../media/images/Method.png" alt=" "/>
  360. <span class="method-result">void</span>
  361. <a href="#set_avatar_last_active" title="details" class="method-name">set_avatar_last_active</a>
  362. ([<span class="var-type">int</span>&nbsp;<span class="var-name">$timestamp</span> = <span class="var-default">null</span>])
  363. </div>
  364. <div class="method-definition">
  365. <img src="../media/images/Method.png" alt=" "/>
  366. <span class="method-result">void</span>
  367. <a href="#set_avatar_name" title="details" class="method-name">set_avatar_name</a>
  368. (<span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  369. </div>
  370. <div class="method-definition">
  371. <img src="../media/images/Method.png" alt=" "/>
  372. <span class="method-result">void</span>
  373. <a href="#set_avatar_uuid" title="details" class="method-name">set_avatar_uuid</a>
  374. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>)
  375. </div>
  376. <div class="method-definition">
  377. <img src="../media/images/Method.png" alt=" "/>
  378. <span class="method-result">bool</span>
  379. <a href="#write_avatar" title="details" class="method-name">write_avatar</a>
  380. ()
  381. </div>
  382. </div>
  383. </div>
  384. </div>
  385. <a name="sec-vars"></a>
  386. <div class="info-box">
  387. <div class="info-box-title">Variables</div>
  388. <div class="nav-bar">
  389. <a href="#sec-description">Description</a> |
  390. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  391. |
  392. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  393. </div>
  394. <div class="info-box-body">
  395. <a name="var$avatar_data" id="$avatar_data"><!-- --></A>
  396. <div class="evenrow">
  397. <div class="var-header">
  398. <img src="../media/images/PrivateVariable.png" />
  399. <span class="var-title">
  400. <span class="var-type">object</span>
  401. <span class="var-name">$avatar_data</span>
  402. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a51">51</a></span>)
  403. </span>
  404. </div>
  405. <!-- ========== Info from phpDoc block ========= -->
  406. <p class="short-description">Internal only - avatar data.</p>
  407. <p class="description"><p>In Moodle, corresponds to a record from the 'sloodle_users' table.</p></p>
  408. <ul class="tags">
  409. <li><span class="field">access:</span> private</li>
  410. </ul>
  411. </div>
  412. <a name="var$user_data" id="$user_data"><!-- --></A>
  413. <div class="oddrow">
  414. <div class="var-header">
  415. <img src="../media/images/PrivateVariable.png" />
  416. <span class="var-title">
  417. <span class="var-type">obejct</span>
  418. <span class="var-name">$user_data</span>
  419. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a59">59</a></span>)
  420. </span>
  421. </div>
  422. <!-- ========== Info from phpDoc block ========= -->
  423. <p class="short-description">Internal only - user data. (i.e. VLE user) In Moodle, corresponds to a record from the 'user' table.</p>
  424. <ul class="tags">
  425. <li><span class="field">access:</span> private</li>
  426. </ul>
  427. </div>
  428. <a name="var$_session" id="$_session"><!-- --></A>
  429. <div class="evenrow">
  430. <div class="var-header">
  431. <img src="../media/images/Variable.png" />
  432. <span class="var-title">
  433. <span class="var-type">object</span>
  434. <span class="var-name">$_session</span>
  435. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a43">43</a></span>)
  436. </span>
  437. </div>
  438. <!-- ========== Info from phpDoc block ========= -->
  439. <p class="short-description">Internal only - reference to the containing <a href="../sloodle/SloodleSession.html">SloodleSession</a> object.</p>
  440. <p class="description"><p>Note: always check that it is not null before use!</p></p>
  441. <ul class="tags">
  442. <li><span class="field">access:</span> protected</li>
  443. </ul>
  444. </div>
  445. </div>
  446. </div>
  447. <a name="sec-methods"></a>
  448. <div class="info-box">
  449. <div class="info-box-title">Methods</div>
  450. <div class="nav-bar">
  451. <a href="#sec-description">Description</a> |
  452. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  453. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  454. </div>
  455. <div class="info-box-body">
  456. <A NAME='method_detail'></A>
  457. <a name="methodSloodleUser" id="SloodleUser"><!-- --></a>
  458. <div class="oddrow">
  459. <div class="method-header">
  460. <img src="../media/images/Constructor.png" />
  461. <span class="method-title">Constructor SloodleUser</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a69">69</a></span>)
  462. </div>
  463. <!-- ========== Info from phpDoc block ========= -->
  464. <p class="short-description">Class constructor.</p>
  465. <ul class="tags">
  466. <li><span class="field">access:</span> public</li>
  467. </ul>
  468. <div class="method-signature">
  469. <span class="method-result">SloodleUser</span>
  470. <span class="method-name">
  471. SloodleUser
  472. </span>
  473. (<span class="var-type">object</span>&nbsp;<span class="var-name">&$_session</span>)
  474. </div>
  475. <ul class="parameters">
  476. <li>
  477. <span class="var-type">object</span>
  478. <span class="var-name">&$_session</span><span class="var-description">: Reference to the containing <a href="../sloodle/SloodleSession.html">SloodleSession</a> object, if available.</span> </li>
  479. </ul>
  480. </div>
  481. <a name="methodadd_linked_avatar" id="add_linked_avatar"><!-- --></a>
  482. <div class="evenrow">
  483. <div class="method-header">
  484. <img src="../media/images/Method.png" />
  485. <span class="method-title">add_linked_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a361">361</a></span>)
  486. </div>
  487. <!-- ========== Info from phpDoc block ========= -->
  488. <p class="short-description">Adds a new avatar to the database, and link it to the specified user.</p>
  489. <p class="description"><p>If successful, it deletes any matching avatar details from pending users list.</p></p>
  490. <ul class="tags">
  491. <li><span class="field">return:</span> True if successful, or false if not.</li>
  492. <li><span class="field">access:</span> public</li>
  493. </ul>
  494. <div class="method-signature">
  495. <span class="method-result">bool</span>
  496. <span class="method-name">
  497. add_linked_avatar
  498. </span>
  499. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$userid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  500. </div>
  501. <ul class="parameters">
  502. <li>
  503. <span class="var-type">mixed</span>
  504. <span class="var-name">$userid</span><span class="var-description">: Site-wide unique ID of a user (type depends on VLE; integer for Moodle)</span> </li>
  505. <li>
  506. <span class="var-type">string</span>
  507. <span class="var-name">$uuid</span><span class="var-description">: UUID of the avatar</span> </li>
  508. <li>
  509. <span class="var-type">string</span>
  510. <span class="var-name">$avname</span><span class="var-description">: Name of the avatar</span> </li>
  511. </ul>
  512. </div>
  513. <a name="methodadd_pending_avatar" id="add_pending_avatar"><!-- --></a>
  514. <div class="oddrow">
  515. <div class="method-header">
  516. <img src="../media/images/Method.png" />
  517. <span class="method-title">add_pending_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a391">391</a></span>)
  518. </div>
  519. <!-- ========== Info from phpDoc block ========= -->
  520. <p class="short-description">Adds a new unlinked avatar to the database (the entry is pending linking)</p>
  521. <ul class="tags">
  522. <li><span class="field">return:</span> Returns the database object if successul, or false if not.</li>
  523. <li><span class="field">access:</span> public</li>
  524. </ul>
  525. <div class="method-signature">
  526. <span class="method-result">object|bool</span>
  527. <span class="method-name">
  528. add_pending_avatar
  529. </span>
  530. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>, [<span class="var-type">int</span>&nbsp;<span class="var-name">$timestamp</span> = <span class="var-default">null</span>])
  531. </div>
  532. <ul class="parameters">
  533. <li>
  534. <span class="var-type">string</span>
  535. <span class="var-name">$uuid</span><span class="var-description">: UUID of the avatar</span> </li>
  536. <li>
  537. <span class="var-type">string</span>
  538. <span class="var-name">$avname</span><span class="var-description">: Name of the avatar</span> </li>
  539. <li>
  540. <span class="var-type">int</span>
  541. <span class="var-name">$timestamp</span><span class="var-description">: The timestamp at which to mark the update (or null to use the current timestamp). Entries expire after a certain period.</span> </li>
  542. </ul>
  543. </div>
  544. <a name="methodadd_user_object" id="add_user_object"><!-- --></a>
  545. <div class="evenrow">
  546. <div class="method-header">
  547. <img src="../media/images/Method.png" />
  548. <span class="method-title">add_user_object</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a820">820</a></span>)
  549. </div>
  550. <!-- ========== Info from phpDoc block ========= -->
  551. <p class="short-description">Adds or udpates the given user object as unauthorised.</p>
  552. <p class="description"><p>(This function can be called statically).</p></p>
  553. <ul class="tags">
  554. <li><span class="field">return:</span> Integer ID of the authorisation entry, or false otherwise</li>
  555. </ul>
  556. <div class="method-signature">
  557. <span class="method-result">int|bool</span>
  558. <span class="method-name">
  559. add_user_object
  560. </span>
  561. (<span class="var-type">string</span>&nbsp;<span class="var-name">$avuuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$objuuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$objname</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$password</span>)
  562. </div>
  563. <ul class="parameters">
  564. <li>
  565. <span class="var-type">string</span>
  566. <span class="var-name">$avuuid</span><span class="var-description">: UUID of the avatar the object will be authorised for</span> </li>
  567. <li>
  568. <span class="var-type">string</span>
  569. <span class="var-name">$objuuid</span><span class="var-description">: UUID of the object</span> </li>
  570. <li>
  571. <span class="var-type">string</span>
  572. <span class="var-name">$objname</span><span class="var-description">: Name of the object</span> </li>
  573. <li>
  574. <span class="var-type">string</span>
  575. <span class="var-name">$password</span><span class="var-description">: Password to store for the object</span> </li>
  576. </ul>
  577. </div>
  578. <a name="methodauthorise_user_object" id="authorise_user_object"><!-- --></a>
  579. <div class="oddrow">
  580. <div class="method-header">
  581. <img src="../media/images/Method.png" />
  582. <span class="method-title">authorise_user_object</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a795">795</a></span>)
  583. </div>
  584. <!-- ========== Info from phpDoc block ========= -->
  585. <p class="short-description">Authorises the given object for the current avatar.</p>
  586. <p class="description"><p>Note: the object must already exist in the database.</p></p>
  587. <ul class="tags">
  588. <li><span class="field">return:</span> True if successful, or false otherwise</li>
  589. </ul>
  590. <div class="method-signature">
  591. <span class="method-result">bool</span>
  592. <span class="method-name">
  593. authorise_user_object
  594. </span>
  595. (<span class="var-type">int</span>&nbsp;<span class="var-name">$authid</span>)
  596. </div>
  597. <ul class="parameters">
  598. <li>
  599. <span class="var-type">int</span>
  600. <span class="var-name">$authid</span><span class="var-description">: The ID of the authorisation entry</span> </li>
  601. </ul>
  602. </div>
  603. <a name="methodautoregister_avatar_user" id="autoregister_avatar_user"><!-- --></a>
  604. <div class="evenrow">
  605. <div class="method-header">
  606. <img src="../media/images/Method.png" />
  607. <span class="method-title">autoregister_avatar_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a421">421</a></span>)
  608. </div>
  609. <!-- ========== Info from phpDoc block ========= -->
  610. <p class="short-description">Auto-register a new user account for the current avatar.</p>
  611. <p class="description"><p>NOTE: this does NOT respect ANYTHING but the most basic Moodle accounts. Use at your own risk!</p></p>
  612. <ul class="tags">
  613. <li><span class="field">return:</span> The new password (plaintext) if successful, or false if not</li>
  614. <li><span class="field">access:</span> public</li>
  615. </ul>
  616. <div class="method-signature">
  617. <span class="method-result">string|bool</span>
  618. <span class="method-name">
  619. autoregister_avatar_user
  620. </span>
  621. ()
  622. </div>
  623. </div>
  624. <a name="methoddelete_avatar" id="delete_avatar"><!-- --></a>
  625. <div class="oddrow">
  626. <div class="method-header">
  627. <img src="../media/images/Method.png" />
  628. <span class="method-title">delete_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a258">258</a></span>)
  629. </div>
  630. <!-- ========== Info from phpDoc block ========= -->
  631. <p class="short-description">Deletes the current avatar from the database.</p>
  632. <ul class="tags">
  633. <li><span class="field">return:</span> True if successful, or false on failure</li>
  634. <li><span class="field">access:</span> public</li>
  635. </ul>
  636. <div class="method-signature">
  637. <span class="method-result">bool</span>
  638. <span class="method-name">
  639. delete_avatar
  640. </span>
  641. ()
  642. </div>
  643. </div>
  644. <a name="methoddelete_user_object" id="delete_user_object"><!-- --></a>
  645. <div class="evenrow">
  646. <div class="method-header">
  647. <img src="../media/images/Method.png" />
  648. <span class="method-title">delete_user_object</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a891">891</a></span>)
  649. </div>
  650. <!-- ========== Info from phpDoc block ========= -->
  651. <p class="short-description">Deletes a user-centric object by UUID.</p>
  652. <p class="description"><p>Note: the object must have been authorised for the current avatar.</p></p>
  653. <div class="method-signature">
  654. <span class="method-result">void</span>
  655. <span class="method-name">
  656. delete_user_object
  657. </span>
  658. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>)
  659. </div>
  660. <ul class="parameters">
  661. <li>
  662. <span class="var-type">string</span>
  663. <span class="var-name">$uuid</span><span class="var-description">: The UUID of the object to delete</span> </li>
  664. </ul>
  665. </div>
  666. <a name="methodenrol" id="enrol"><!-- --></a>
  667. <div class="oddrow">
  668. <div class="method-header">
  669. <img src="../media/images/Method.png" />
  670. <span class="method-title">enrol</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a673">673</a></span>)
  671. </div>
  672. <!-- ========== Info from phpDoc block ========= -->
  673. <p class="short-description">Enrols the current user in the specified course</p>
  674. <p class="description"><p>NOTE: a side effect of this is that it logs-in the user</p></p>
  675. <ul class="tags">
  676. <li><span class="field">access:</span> public</li>
  677. </ul>
  678. <div class="method-signature">
  679. <span class="method-result">void</span>
  680. <span class="method-name">
  681. enrol
  682. </span>
  683. ([<span class="var-type">object</span>&nbsp;<span class="var-name">$sloodle_course</span> = <span class="var-default">null</span>], <span class="var-type">bool</span>&nbsp;<span class="var-name">1</span>)
  684. </div>
  685. <ul class="parameters">
  686. <li>
  687. <span class="var-type">object</span>
  688. <span class="var-name">$sloodle_course</span><span class="var-description">: A <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> object setup for the necessary course. If null, then the <a href="../sloodle/SloodleUser.html#var$_session">$_session</a> member is queried instead.</span> </li>
  689. <li>
  690. <span class="var-type">bool</span>
  691. <span class="var-name">1</span><span class="var-description">: True if successful (or the user was already enrolled), or false otherwise</span> </li>
  692. </ul>
  693. </div>
  694. <a name="methodget_avatar_id" id="get_avatar_id"><!-- --></a>
  695. <div class="evenrow">
  696. <div class="method-header">
  697. <img src="../media/images/Method.png" />
  698. <span class="method-title">get_avatar_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a82">82</a></span>)
  699. </div>
  700. <!-- ========== Info from phpDoc block ========= -->
  701. <p class="short-description">Gets the unique ID of the avatar.</p>
  702. <ul class="tags">
  703. <li><span class="field">return:</span> Type depends on VLE. (Integer on Moodle). Returns null if there is no avatar.</li>
  704. <li><span class="field">access:</span> public</li>
  705. </ul>
  706. <div class="method-signature">
  707. <span class="method-result">mixed</span>
  708. <span class="method-name">
  709. get_avatar_id
  710. </span>
  711. ()
  712. </div>
  713. </div>
  714. <a name="methodget_avatar_last_active" id="get_avatar_last_active"><!-- --></a>
  715. <div class="oddrow">
  716. <div class="method-header">
  717. <img src="../media/images/Method.png" />
  718. <span class="method-title">get_avatar_last_active</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a187">187</a></span>)
  719. </div>
  720. <!-- ========== Info from phpDoc block ========= -->
  721. <p class="short-description">Gets the timestamp of whenever the avatar was last active</p>
  722. <div class="method-signature">
  723. <span class="method-result">int</span>
  724. <span class="method-name">
  725. get_avatar_last_active
  726. </span>
  727. ()
  728. </div>
  729. </div>
  730. <a name="methodget_avatar_name" id="get_avatar_name"><!-- --></a>
  731. <div class="evenrow">
  732. <div class="method-header">
  733. <img src="../media/images/Method.png" />
  734. <span class="method-title">get_avatar_name</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a141">141</a></span>)
  735. </div>
  736. <!-- ========== Info from phpDoc block ========= -->
  737. <p class="short-description">Gets the name of the avatar</p>
  738. <div class="method-signature">
  739. <span class="method-result">string</span>
  740. <span class="method-name">
  741. get_avatar_name
  742. </span>
  743. ()
  744. </div>
  745. </div>
  746. <a name="methodget_avatar_uuid" id="get_avatar_uuid"><!-- --></a>
  747. <div class="oddrow">
  748. <div class="method-header">
  749. <img src="../media/images/Method.png" />
  750. <span class="method-title">get_avatar_uuid</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a122">122</a></span>)
  751. </div>
  752. <!-- ========== Info from phpDoc block ========= -->
  753. <p class="short-description">Gets the UUID of the avatar</p>
  754. <div class="method-signature">
  755. <span class="method-result">string</span>
  756. <span class="method-name">
  757. get_avatar_uuid
  758. </span>
  759. ()
  760. </div>
  761. </div>
  762. <a name="methodget_enrolled_courses" id="get_enrolled_courses"><!-- --></a>
  763. <div class="evenrow">
  764. <div class="method-header">
  765. <img src="../media/images/Method.png" />
  766. <span class="method-title">get_enrolled_courses</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a553">553</a></span>)
  767. </div>
  768. <!-- ========== Info from phpDoc block ========= -->
  769. <p class="short-description">Gets a numeric array of <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> objects for courses the user is enrolled in.</p>
  770. <p class="description"><p>WARNING: this function is not very efficient, and will likely be very slow on large sites.</p></p>
  771. <ul class="tags">
  772. <li><span class="field">return:</span> A numeric array of <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> objects</li>
  773. <li><span class="field">access:</span> public</li>
  774. </ul>
  775. <div class="method-signature">
  776. <span class="method-result">array</span>
  777. <span class="method-name">
  778. get_enrolled_courses
  779. </span>
  780. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  781. </div>
  782. <ul class="parameters">
  783. <li>
  784. <span class="var-type">mixed</span>
  785. <span class="var-name">$category</span><span class="var-description">: Unique identifier of a category to limit the query to. Ignored if null. (Type depends on VLE; integer for Moodle)</span> </li>
  786. </ul>
  787. </div>
  788. <a name="methodget_staff_courses" id="get_staff_courses"><!-- --></a>
  789. <div class="oddrow">
  790. <div class="method-header">
  791. <img src="../media/images/Method.png" />
  792. <span class="method-title">get_staff_courses</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a590">590</a></span>)
  793. </div>
  794. <!-- ========== Info from phpDoc block ========= -->
  795. <p class="short-description">Gets a numeric array of <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> objects for courses the user is Sloodle staff.</p>
  796. <p class="description"><p>This relates to the &quot;mod/sloodle:staff&quot; capability. WARNING: this function is not very efficient, and will likely be very slow on large sites.</p></p>
  797. <ul class="tags">
  798. <li><span class="field">return:</span> A numeric array of <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> objects</li>
  799. <li><span class="field">access:</span> public</li>
  800. </ul>
  801. <div class="method-signature">
  802. <span class="method-result">array</span>
  803. <span class="method-name">
  804. get_staff_courses
  805. </span>
  806. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  807. </div>
  808. <ul class="parameters">
  809. <li>
  810. <span class="var-type">mixed</span>
  811. <span class="var-name">$category</span><span class="var-description">: Unique identifier of a category to limit the query to. Ignored if null. (Type depends on VLE; integer for Moodle)</span> </li>
  812. </ul>
  813. </div>
  814. <a name="methodget_username" id="get_username"><!-- --></a>
  815. <div class="evenrow">
  816. <div class="method-header">
  817. <img src="../media/images/Method.png" />
  818. <span class="method-title">get_username</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a160">160</a></span>)
  819. </div>
  820. <!-- ========== Info from phpDoc block ========= -->
  821. <p class="short-description">Gets the user's username</p>
  822. <div class="method-signature">
  823. <span class="method-result">string</span>
  824. <span class="method-name">
  825. get_username
  826. </span>
  827. ()
  828. </div>
  829. </div>
  830. <a name="methodget_user_email" id="get_user_email"><!-- --></a>
  831. <div class="oddrow">
  832. <div class="method-header">
  833. <img src="../media/images/Method.png" />
  834. <span class="method-title">get_user_email</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a207">207</a></span>)
  835. </div>
  836. <!-- ========== Info from phpDoc block ========= -->
  837. <p class="short-description">Gets the user's email address.</p>
  838. <ul class="tags">
  839. <li><span class="field">return:</span> The user's email address, or null if none is specified of if email is disabled.</li>
  840. </ul>
  841. <div class="method-signature">
  842. <span class="method-result">string|null</span>
  843. <span class="method-name">
  844. get_user_email
  845. </span>
  846. ()
  847. </div>
  848. </div>
  849. <a name="methodget_user_firstname" id="get_user_firstname"><!-- --></a>
  850. <div class="evenrow">
  851. <div class="method-header">
  852. <img src="../media/images/Method.png" />
  853. <span class="method-title">get_user_firstname</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a169">169</a></span>)
  854. </div>
  855. <!-- ========== Info from phpDoc block ========= -->
  856. <p class="short-description">Gets the first name of the user</p>
  857. <div class="method-signature">
  858. <span class="method-result">string</span>
  859. <span class="method-name">
  860. get_user_firstname
  861. </span>
  862. ()
  863. </div>
  864. </div>
  865. <a name="methodget_user_id" id="get_user_id"><!-- --></a>
  866. <div class="oddrow">
  867. <div class="method-header">
  868. <img src="../media/images/Method.png" />
  869. <span class="method-title">get_user_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a93">93</a></span>)
  870. </div>
  871. <!-- ========== Info from phpDoc block ========= -->
  872. <p class="short-description">Gets the unique ID of the VLE user.</p>
  873. <ul class="tags">
  874. <li><span class="field">return:</span> Type depends on VLE. (Integer on Moodle). Returns null if there is no user</li>
  875. <li><span class="field">access:</span> public</li>
  876. </ul>
  877. <div class="method-signature">
  878. <span class="method-result">mixed</span>
  879. <span class="method-name">
  880. get_user_id
  881. </span>
  882. ()
  883. </div>
  884. </div>
  885. <a name="methodget_user_lastname" id="get_user_lastname"><!-- --></a>
  886. <div class="evenrow">
  887. <div class="method-header">
  888. <img src="../media/images/Method.png" />
  889. <span class="method-title">get_user_lastname</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a178">178</a></span>)
  890. </div>
  891. <!-- ========== Info from phpDoc block ========= -->
  892. <p class="short-description">Gets the last name of the user</p>
  893. <div class="method-signature">
  894. <span class="method-result">string</span>
  895. <span class="method-name">
  896. get_user_lastname
  897. </span>
  898. ()
  899. </div>
  900. </div>
  901. <a name="methodget_user_objects" id="get_user_objects"><!-- --></a>
  902. <div class="oddrow">
  903. <div class="method-header">
  904. <img src="../media/images/Method.png" />
  905. <span class="method-title">get_user_objects</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a859">859</a></span>)
  906. </div>
  907. <!-- ========== Info from phpDoc block ========= -->
  908. <p class="short-description">Gets a list of all user-centric objects authorised for the current avatar.</p>
  909. <ul class="tags">
  910. <li><span class="field">return:</span> A numeric array of <a href="../sloodle/SloodleUserObject.html">SloodleUserObject</a> objects</li>
  911. </ul>
  912. <div class="method-signature">
  913. <span class="method-result">array</span>
  914. <span class="method-name">
  915. get_user_objects
  916. </span>
  917. ()
  918. </div>
  919. </div>
  920. <a name="methodis_avatar_linked" id="is_avatar_linked"><!-- --></a>
  921. <div class="evenrow">
  922. <div class="method-header">
  923. <img src="../media/images/Method.png" />
  924. <span class="method-title">is_avatar_linked</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a221">221</a></span>)
  925. </div>
  926. <!-- ========== Info from phpDoc block ========= -->
  927. <p class="short-description">Determines whether or not the current user and avatar are linked.</p>
  928. <ul class="tags">
  929. <li><span class="field">return:</span> True if they are linked, or false if not.</li>
  930. </ul>
  931. <div class="method-signature">
  932. <span class="method-result">bool</span>
  933. <span class="method-name">
  934. is_avatar_linked
  935. </span>
  936. ()
  937. </div>
  938. </div>
  939. <a name="methodis_avatar_loaded" id="is_avatar_loaded"><!-- --></a>
  940. <div class="oddrow">
  941. <div class="method-header">
  942. <img src="../media/images/Method.png" />
  943. <span class="method-title">is_avatar_loaded</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a103">103</a></span>)
  944. </div>
  945. <!-- ========== Info from phpDoc block ========= -->
  946. <p class="short-description">Determines whether or not an avatar is loaded.</p>
  947. <div class="method-signature">
  948. <span class="method-result">bool</span>
  949. <span class="method-name">
  950. is_avatar_loaded
  951. </span>
  952. ()
  953. </div>
  954. </div>
  955. <a name="methodis_enrolled" id="is_enrolled"><!-- --></a>
  956. <div class="evenrow">
  957. <div class="method-header">
  958. <img src="../media/images/Method.png" />
  959. <span class="method-title">is_enrolled</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a623">623</a></span>)
  960. </div>
  961. <!-- ========== Info from phpDoc block ========= -->
  962. <p class="short-description">Is the current user enrolled in the specified course?</p>
  963. <p class="description"><p>NOTE: a side effect of this is that it logs-in the user</p></p>
  964. <ul class="tags">
  965. <li><span class="field">todo:</span> Update to match parameter format and handling of <a href="../sloodle/SloodleUser.html#methodenrol">enrol()</a> function.</li>
  966. <li><span class="field">access:</span> public</li>
  967. </ul>
  968. <div class="method-signature">
  969. <span class="method-result">void</span>
  970. <span class="method-name">
  971. is_enrolled
  972. </span>
  973. (<span class="var-type"></span>&nbsp;<span class="var-name">$courseid</span>, <span class="var-type">mixed</span>&nbsp;<span class="var-name">$course</span>, <span class="var-type">bool</span>&nbsp;<span class="var-name">1</span>)
  974. </div>
  975. <ul class="parameters">
  976. <li>
  977. <span class="var-type">mixed</span>
  978. <span class="var-name">$course</span><span class="var-description">: Unique identifier of the course -- type depends on VLE (integer for Moodle)</span> </li>
  979. <li>
  980. <span class="var-type">bool</span>
  981. <span class="var-name">1</span><span class="var-description">: True if the user is enrolled, or false if not.</span> </li>
  982. <li>
  983. <span class="var-type"></span>
  984. <span class="var-name">$courseid</span> </li>
  985. </ul>
  986. </div>
  987. <a name="methodis_staff" id="is_staff"><!-- --></a>
  988. <div class="oddrow">
  989. <div class="method-header">
  990. <img src="../media/images/Method.png" />
  991. <span class="method-title">is_staff</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a649">649</a></span>)
  992. </div>
  993. <!-- ========== Info from phpDoc block ========= -->
  994. <p class="short-description">Is the current user Sloodle staff in the specified course?</p>
  995. <p class="description"><p>NOTE: a side effect of this is that it logs-in the user</p></p>
  996. <ul class="tags">
  997. <li><span class="field">todo:</span> Update to match parameter format and handling of <a href="../sloodle/SloodleUser.html#methodenrol">enrol()</a> function.</li>
  998. <li><span class="field">access:</span> public</li>
  999. </ul>
  1000. <div class="method-signature">
  1001. <span class="method-result">void</span>
  1002. <span class="method-name">
  1003. is_staff
  1004. </span>
  1005. (<span class="var-type"></span>&nbsp;<span class="var-name">$courseid</span>, <span class="var-type">mixed</span>&nbsp;<span class="var-name">$course</span>, <span class="var-type">bool</span>&nbsp;<span class="var-name">1</span>)
  1006. </div>
  1007. <ul class="parameters">
  1008. <li>
  1009. <span class="var-type">mixed</span>
  1010. <span class="var-name">$course</span><span class="var-description">: Unique identifier of the course -- type depends on VLE (integer for Moodle)</span> </li>
  1011. <li>
  1012. <span class="var-type">bool</span>
  1013. <span class="var-name">1</span><span class="var-description">: True if the user is staff, or false if not.</span> </li>
  1014. <li>
  1015. <span class="var-type"></span>
  1016. <span class="var-name">$courseid</span> </li>
  1017. </ul>
  1018. </div>
  1019. <a name="methodis_user_loaded" id="is_user_loaded"><!-- --></a>
  1020. <div class="evenrow">
  1021. <div class="method-header">
  1022. <img src="../media/images/Method.png" />
  1023. <span class="method-title">is_user_loaded</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a112">112</a></span>)
  1024. </div>
  1025. <!-- ========== Info from phpDoc block ========= -->
  1026. <p class="short-description">Determines whether or not a VLE user is loaded.</p>
  1027. <div class="method-signature">
  1028. <span class="method-result">bool</span>
  1029. <span class="method-name">
  1030. is_user_loaded
  1031. </span>
  1032. ()
  1033. </div>
  1034. </div>
  1035. <a name="methodlink_avatar" id="link_avatar"><!-- --></a>
  1036. <div class="oddrow">
  1037. <div class="method-header">
  1038. <img src="../media/images/Method.png" />
  1039. <span class="method-title">link_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a236">236</a></span>)
  1040. </div>
  1041. <!-- ========== Info from phpDoc block ========= -->
  1042. <p class="short-description">Links the current avatar to the current user.</p>
  1043. <p class="description"><p><strong>NOTE:</strong> does not remove any other avatar links to the VLE user.</p></p>
  1044. <ul class="tags">
  1045. <li><span class="field">return:</span> True if successful or false otherwise.</li>
  1046. <li><span class="field">access:</span> public</li>
  1047. </ul>
  1048. <div class="method-signature">
  1049. <span class="method-result">bool</span>
  1050. <span class="method-name">
  1051. link_avatar
  1052. </span>
  1053. ()
  1054. </div>
  1055. </div>
  1056. <a name="methodload_avatar" id="load_avatar"><!-- --></a>
  1057. <div class="evenrow">
  1058. <div class="method-header">
  1059. <img src="../media/images/Method.png" />
  1060. <span class="method-title">load_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a294">294</a></span>)
  1061. </div>
  1062. <!-- ========== Info from phpDoc block ========= -->
  1063. <p class="short-description">Finds an avatar with the given UUID and/or name, and loads its data.</p>
  1064. <p class="description"><p>The UUID is searched for first. If that is not found, then the name is used.</p></p>
  1065. <ul class="tags">
  1066. <li><span class="field">return:</span> True if successful, or false otherwise</li>
  1067. <li><span class="field">access:</span> public</li>
  1068. </ul>
  1069. <div class="method-signature">
  1070. <span class="method-result">bool</span>
  1071. <span class="method-name">
  1072. load_avatar
  1073. </span>
  1074. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  1075. </div>
  1076. <ul class="parameters">
  1077. <li>
  1078. <span class="var-type">string</span>
  1079. <span class="var-name">$uuid</span><span class="var-description">: The UUID of the avatar, or blank to search only by name.</span> </li>
  1080. <li>
  1081. <span class="var-type">string</span>
  1082. <span class="var-name">$avname</span><span class="var-description">: The name of the avatar, or blank to search only by UUID.</span> </li>
  1083. </ul>
  1084. </div>
  1085. <a name="methodload_avatar_by_id" id="load_avatar_by_id"><!-- --></a>
  1086. <div class="oddrow">
  1087. <div class="method-header">
  1088. <img src="../media/images/Method.png" />
  1089. <span class="method-title">load_avatar_by_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a273">273</a></span>)
  1090. </div>
  1091. <!-- ========== Info from phpDoc block ========= -->
  1092. <p class="short-description">Loads the specified avatar from the database.</p>
  1093. <ul class="tags">
  1094. <li><span class="field">return:</span> True if successful, or false otherwise.</li>
  1095. <li><span class="field">access:</span> public</li>
  1096. </ul>
  1097. <div class="method-signature">
  1098. <span class="method-result">bool</span>
  1099. <span class="method-name">
  1100. load_avatar_by_id
  1101. </span>
  1102. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  1103. </div>
  1104. <ul class="parameters">
  1105. <li>
  1106. <span class="var-type">mixed</span>
  1107. <span class="var-name">$id</span><span class="var-description">: The ID of the avatar (type depends on VLE; integer for Moodle)</span> </li>
  1108. </ul>
  1109. </div>
  1110. <a name="methodload_linked_avatar" id="load_linked_avatar"><!-- --></a>
  1111. <div class="evenrow">
  1112. <div class="method-header">
  1113. <img src="../media/images/Method.png" />
  1114. <span class="method-title">load_linked_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a491">491</a></span>)
  1115. </div>
  1116. <!-- ========== Info from phpDoc block ========= -->
  1117. <p class="short-description">Load the avatar linked to the current user.</p>
  1118. <ul class="tags">
  1119. <li><span class="field">return:</span> True if a link was loaded, false if there was no link, or string 'multi' if multiple avatars are linked</li>
  1120. <li><span class="field">access:</span> public</li>
  1121. </ul>
  1122. <div class="method-signature">
  1123. <span class="method-result">bool,string</span>
  1124. <span class="method-name">
  1125. load_linked_avatar
  1126. </span>
  1127. ()
  1128. </div>
  1129. </div>
  1130. <a name="methodload_linked_user" id="load_linked_user"><!-- --></a>
  1131. <div class="oddrow">
  1132. <div class="method-header">
  1133. <img src="../media/images/Method.png" />
  1134. <span class="method-title">load_linked_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a513">513</a></span>)
  1135. </div>
  1136. <!-- ========== Info from phpDoc block ========= -->
  1137. <p class="short-description">Find the VLE user linked to the current avatar.</p>
  1138. <ul class="tags">
  1139. <li><span class="field">return:</span> True if successful, or false if no link was found</li>
  1140. <li><span class="field">access:</span> public</li>
  1141. </ul>
  1142. <div class="method-signature">
  1143. <span class="method-result">bool</span>
  1144. <span class="method-name">
  1145. load_linked_user
  1146. </span>
  1147. ()
  1148. </div>
  1149. </div>
  1150. <a name="methodload_user" id="load_user"><!-- --></a>
  1151. <div class="evenrow">
  1152. <div class="method-header">
  1153. <img src="../media/images/Method.png" />
  1154. <span class="method-title">load_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a322">322</a></span>)
  1155. </div>
  1156. <!-- ========== Info from phpDoc block ========= -->
  1157. <p class="short-description">Load the specified user from the database</p>
  1158. <ul class="tags">
  1159. <li><span class="field">return:</span> True if successful, or false on failure</li>
  1160. <li><span class="field">access:</span> public</li>
  1161. </ul>
  1162. <div class="method-signature">
  1163. <span class="method-result">bool</span>
  1164. <span class="method-name">
  1165. load_user
  1166. </span>
  1167. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  1168. </div>
  1169. <ul class="parameters">
  1170. <li>
  1171. <span class="var-type">mixed</span>
  1172. <span class="var-name">$id</span><span class="var-description">: The unique identifier for the VLE user. (Type depends on VLE; integer for Moodle)</span> </li>
  1173. </ul>
  1174. </div>
  1175. <a name="methodlogin" id="login"><!-- --></a>
  1176. <div class="oddrow">
  1177. <div class="method-header">
  1178. <img src="../media/images/Method.png" />
  1179. <span class="method-title">login</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a534">534</a></span>)
  1180. </div>
  1181. <!-- ========== Info from phpDoc block ========= -->
  1182. <p class="short-description">Internally 'log-in' the current user.</p>
  1183. <p class="description"><p>In Moodle, this just stores all the user data in the global $USER variable. This function will not perform automatic registration.</p></p>
  1184. <ul class="tags">
  1185. <li><span class="field">return:</span> True if successful, or false otherwise.</li>
  1186. <li><span class="field">access:</span> public</li>
  1187. </ul>
  1188. <div class="method-signature">
  1189. <span class="method-result">bool</span>
  1190. <span class="method-name">
  1191. login
  1192. </span>
  1193. ()
  1194. </div>
  1195. </div>
  1196. <a name="methodpurge_password_notifications" id="purge_password_notifications"><!-- --></a>
  1197. <div class="evenrow">
  1198. <div class="method-header">
  1199. <img src="../media/images/Method.png" />
  1200. <span class="method-title">purge_password_notifications</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a778">778</a></span>)
  1201. </div>
  1202. <!-- ========== Info from phpDoc block ========= -->
  1203. <p class="short-description">If the system is waiting to send a password notification to this user, then remove it</p>
  1204. <div class="method-signature">
  1205. <span class="method-result">void</span>
  1206. <span class="method-name">
  1207. purge_password_notifications
  1208. </span>
  1209. ()
  1210. </div>
  1211. </div>
  1212. <a name="methodreset_password" id="reset_password"><!-- --></a>
  1213. <div class="oddrow">
  1214. <div class="method-header">
  1215. <img src="../media/images/Method.png" />
  1216. <span class="method-title">reset_password</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a741">741</a></span>)
  1217. </div>
  1218. <!-- ========== Info from phpDoc block ========= -->
  1219. <p class="short-description">Resets the user's password</p>
  1220. <ul class="tags">
  1221. <li><span class="field">return:</span> The new password if successful, or false otherwise (if $require was false).</li>
  1222. </ul>
  1223. <div class="method-signature">
  1224. <span class="method-result">string|bool</span>
  1225. <span class="method-name">
  1226. reset_password
  1227. </span>
  1228. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$require</span> = <span class="var-default">true</span>])
  1229. </div>
  1230. <ul class="parameters">
  1231. <li>
  1232. <span class="var-type">bool</span>
  1233. <span class="var-name">$require</span><span class="var-description">: If true, then the script will be terminated if the operation fails</span> </li>
  1234. </ul>
  1235. </div>
  1236. <a name="methodset_avatar_last_active" id="set_avatar_last_active"><!-- --></a>
  1237. <div class="evenrow">
  1238. <div class="method-header">
  1239. <img src="../media/images/Method.png" />
  1240. <span class="method-title">set_avatar_last_active</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a197">197</a></span>)
  1241. </div>
  1242. <!-- ========== Info from phpDoc block ========= -->
  1243. <p class="short-description">Sets the timestamp of when the user was last active</p>
  1244. <div class="method-signature">
  1245. <span class="method-result">void</span>
  1246. <span class="method-name">
  1247. set_avatar_last_active
  1248. </span>
  1249. ([<span class="var-type">int</span>&nbsp;<span class="var-name">$timestamp</span> = <span class="var-default">null</span>])
  1250. </div>
  1251. <ul class="parameters">
  1252. <li>
  1253. <span class="var-type">int</span>
  1254. <span class="var-name">$timestamp</span><span class="var-description">: A UNIX timestamp, or null to use the current time</span> </li>
  1255. </ul>
  1256. </div>
  1257. <a name="methodset_avatar_name" id="set_avatar_name"><!-- --></a>
  1258. <div class="oddrow">
  1259. <div class="method-header">
  1260. <img src="../media/images/Method.png" />
  1261. <span class="method-title">set_avatar_name</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a151">151</a></span>)
  1262. </div>
  1263. <!-- ========== Info from phpDoc block ========= -->
  1264. <p class="short-description">Sets the name of the avatar</p>
  1265. <div class="method-signature">
  1266. <span class="method-result">void</span>
  1267. <span class="method-name">
  1268. set_avatar_name
  1269. </span>
  1270. (<span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  1271. </div>
  1272. <ul class="parameters">
  1273. <li>
  1274. <span class="var-type">string</span>
  1275. <span class="var-name">$avname</span><span class="var-description">: The new avatar name</span> </li>
  1276. </ul>
  1277. </div>
  1278. <a name="methodset_avatar_uuid" id="set_avatar_uuid"><!-- --></a>
  1279. <div class="evenrow">
  1280. <div class="method-header">
  1281. <img src="../media/images/Method.png" />
  1282. <span class="method-title">set_avatar_uuid</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a132">132</a></span>)
  1283. </div>
  1284. <!-- ========== Info from phpDoc block ========= -->
  1285. <p class="short-description">Sets the UUID of the avatar</p>
  1286. <div class="method-signature">
  1287. <span class="method-result">void</span>
  1288. <span class="method-name">
  1289. set_avatar_uuid
  1290. </span>
  1291. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>)
  1292. </div>
  1293. <ul class="parameters">
  1294. <li>
  1295. <span class="var-type">string</span>
  1296. <span class="var-name">$uuid</span><span class="var-description">: The new UUID</span> </li>
  1297. </ul>
  1298. </div>
  1299. <a name="methodwrite_avatar" id="write_avatar"><!-- --></a>
  1300. <div class="oddrow">
  1301. <div class="method-header">
  1302. <img src="../media/images/Method.png" />
  1303. <span class="method-title">write_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libuser.php.html#a344">344</a></span>)
  1304. </div>
  1305. <!-- ========== Info from phpDoc block ========= -->
  1306. <p class="short-description">Uses the current avatar data to update the database.</p>
  1307. <ul class="tags">
  1308. <li><span class="field">return:</span> True if successful, or false if the update fails</li>
  1309. <li><span class="field">access:</span> public</li>
  1310. </ul>
  1311. <div class="method-signature">
  1312. <span class="method-result">bool</span>
  1313. <span class="method-name">
  1314. write_avatar
  1315. </span>
  1316. ()
  1317. </div>
  1318. </div>
  1319. </div>
  1320. </div>
  1321. <p class="notes" id="credit">
  1322. Documentation generated on Fri, 17 Jul 2009 11:02:37 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  1323. </p>
  1324. </div></body>
  1325. </html>