SloodleUser.html 57 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493
  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="_sloodle---lib---user.php.html">/sloodle/lib/user.php</a> (line <span class="field"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a31">31</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">string|bool</span>
  169. <a href="#autoregister_avatar_user" title="details" class="method-name">autoregister_avatar_user</a>
  170. ()
  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="#delete_avatar" title="details" class="method-name">delete_avatar</a>
  176. ()
  177. </div>
  178. <div class="method-definition">
  179. <img src="../media/images/Method.png" alt=" "/>
  180. <span class="method-result">void</span>
  181. <a href="#enrol" title="details" class="method-name">enrol</a>
  182. ([<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>)
  183. </div>
  184. <div class="method-definition">
  185. <img src="../media/images/Method.png" alt=" "/>
  186. <span class="method-result">mixed</span>
  187. <a href="#get_avatar_id" title="details" class="method-name">get_avatar_id</a>
  188. ()
  189. </div>
  190. <div class="method-definition">
  191. <img src="../media/images/Method.png" alt=" "/>
  192. <span class="method-result">int</span>
  193. <a href="#get_avatar_last_active" title="details" class="method-name">get_avatar_last_active</a>
  194. ()
  195. </div>
  196. <div class="method-definition">
  197. <img src="../media/images/Method.png" alt=" "/>
  198. <span class="method-result">string</span>
  199. <a href="#get_avatar_name" title="details" class="method-name">get_avatar_name</a>
  200. ()
  201. </div>
  202. <div class="method-definition">
  203. <img src="../media/images/Method.png" alt=" "/>
  204. <span class="method-result">string</span>
  205. <a href="#get_avatar_uuid" title="details" class="method-name">get_avatar_uuid</a>
  206. ()
  207. </div>
  208. <div class="method-definition">
  209. <img src="../media/images/Method.png" alt=" "/>
  210. <span class="method-result">array</span>
  211. <a href="#get_enrolled_courses" title="details" class="method-name">get_enrolled_courses</a>
  212. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  213. </div>
  214. <div class="method-definition">
  215. <img src="../media/images/Method.png" alt=" "/>
  216. <span class="method-result">array</span>
  217. <a href="#get_staff_courses" title="details" class="method-name">get_staff_courses</a>
  218. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  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_username" title="details" class="method-name">get_username</a>
  224. ()
  225. </div>
  226. <div class="method-definition">
  227. <img src="../media/images/Method.png" alt=" "/>
  228. <span class="method-result">string|null</span>
  229. <a href="#get_user_email" title="details" class="method-name">get_user_email</a>
  230. ()
  231. </div>
  232. <div class="method-definition">
  233. <img src="../media/images/Method.png" alt=" "/>
  234. <span class="method-result">string</span>
  235. <a href="#get_user_firstname" title="details" class="method-name">get_user_firstname</a>
  236. ()
  237. </div>
  238. <div class="method-definition">
  239. <img src="../media/images/Method.png" alt=" "/>
  240. <span class="method-result">mixed</span>
  241. <a href="#get_user_id" title="details" class="method-name">get_user_id</a>
  242. ()
  243. </div>
  244. <div class="method-definition">
  245. <img src="../media/images/Method.png" alt=" "/>
  246. <span class="method-result">string</span>
  247. <a href="#get_user_lastname" title="details" class="method-name">get_user_lastname</a>
  248. ()
  249. </div>
  250. <div class="method-definition">
  251. <img src="../media/images/Method.png" alt=" "/>
  252. <span class="method-result">bool</span>
  253. <a href="#is_avatar_linked" title="details" class="method-name">is_avatar_linked</a>
  254. ()
  255. </div>
  256. <div class="method-definition">
  257. <img src="../media/images/Method.png" alt=" "/>
  258. <span class="method-result">bool</span>
  259. <a href="#is_avatar_loaded" title="details" class="method-name">is_avatar_loaded</a>
  260. ()
  261. </div>
  262. <div class="method-definition">
  263. <img src="../media/images/Method.png" alt=" "/>
  264. <span class="method-result">void</span>
  265. <a href="#is_enrolled" title="details" class="method-name">is_enrolled</a>
  266. (<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>)
  267. </div>
  268. <div class="method-definition">
  269. <img src="../media/images/Method.png" alt=" "/>
  270. <span class="method-result">void</span>
  271. <a href="#is_staff" title="details" class="method-name">is_staff</a>
  272. (<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>)
  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_user_loaded" title="details" class="method-name">is_user_loaded</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="#link_avatar" title="details" class="method-name">link_avatar</a>
  284. ()
  285. </div>
  286. <div class="method-definition">
  287. <img src="../media/images/Method.png" alt=" "/>
  288. <span class="method-result">bool</span>
  289. <a href="#load_avatar" title="details" class="method-name">load_avatar</a>
  290. (<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>)
  291. </div>
  292. <div class="method-definition">
  293. <img src="../media/images/Method.png" alt=" "/>
  294. <span class="method-result">bool</span>
  295. <a href="#load_avatar_by_id" title="details" class="method-name">load_avatar_by_id</a>
  296. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  297. </div>
  298. <div class="method-definition">
  299. <img src="../media/images/Method.png" alt=" "/>
  300. <span class="method-result">bool,string</span>
  301. <a href="#load_linked_avatar" title="details" class="method-name">load_linked_avatar</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="#load_linked_user" title="details" class="method-name">load_linked_user</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_user" title="details" class="method-name">load_user</a>
  314. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</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="#login" title="details" class="method-name">login</a>
  320. ()
  321. </div>
  322. <div class="method-definition">
  323. <img src="../media/images/Method.png" alt=" "/>
  324. <span class="method-result">void</span>
  325. <a href="#purge_password_notifications" title="details" class="method-name">purge_password_notifications</a>
  326. ()
  327. </div>
  328. <div class="method-definition">
  329. <img src="../media/images/Method.png" alt=" "/>
  330. <span class="method-result">string|bool</span>
  331. <a href="#reset_password" title="details" class="method-name">reset_password</a>
  332. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$require</span> = <span class="var-default">true</span>])
  333. </div>
  334. <div class="method-definition">
  335. <img src="../media/images/Method.png" alt=" "/>
  336. <span class="method-result">void</span>
  337. <a href="#set_avatar_last_active" title="details" class="method-name">set_avatar_last_active</a>
  338. ([<span class="var-type">int</span>&nbsp;<span class="var-name">$timestamp</span> = <span class="var-default">null</span>])
  339. </div>
  340. <div class="method-definition">
  341. <img src="../media/images/Method.png" alt=" "/>
  342. <span class="method-result">void</span>
  343. <a href="#set_avatar_name" title="details" class="method-name">set_avatar_name</a>
  344. (<span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  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="#set_avatar_uuid" title="details" class="method-name">set_avatar_uuid</a>
  350. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>)
  351. </div>
  352. <div class="method-definition">
  353. <img src="../media/images/Method.png" alt=" "/>
  354. <span class="method-result">bool</span>
  355. <a href="#write_avatar" title="details" class="method-name">write_avatar</a>
  356. ()
  357. </div>
  358. </div>
  359. </div>
  360. </div>
  361. <a name="sec-vars"></a>
  362. <div class="info-box">
  363. <div class="info-box-title">Variables</div>
  364. <div class="nav-bar">
  365. <a href="#sec-description">Description</a> |
  366. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  367. |
  368. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  369. </div>
  370. <div class="info-box-body">
  371. <a name="var$avatar_data" id="$avatar_data"><!-- --></A>
  372. <div class="oddrow">
  373. <div class="var-header">
  374. <img src="../media/images/PrivateVariable.png" />
  375. <span class="var-title">
  376. <span class="var-type">object</span>
  377. <span class="var-name">$avatar_data</span>
  378. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a49">49</a></span>)
  379. </span>
  380. </div>
  381. <!-- ========== Info from phpDoc block ========= -->
  382. <p class="short-description">Internal only - avatar data.</p>
  383. <p class="description"><p>In Moodle, corresponds to a record from the 'sloodle_users' table.</p></p>
  384. <ul class="tags">
  385. <li><span class="field">access:</span> private</li>
  386. </ul>
  387. </div>
  388. <a name="var$user_data" id="$user_data"><!-- --></A>
  389. <div class="evenrow">
  390. <div class="var-header">
  391. <img src="../media/images/PrivateVariable.png" />
  392. <span class="var-title">
  393. <span class="var-type">obejct</span>
  394. <span class="var-name">$user_data</span>
  395. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a57">57</a></span>)
  396. </span>
  397. </div>
  398. <!-- ========== Info from phpDoc block ========= -->
  399. <p class="short-description">Internal only - user data. (i.e. VLE user) In Moodle, corresponds to a record from the 'user' table.</p>
  400. <ul class="tags">
  401. <li><span class="field">access:</span> private</li>
  402. </ul>
  403. </div>
  404. <a name="var$_session" id="$_session"><!-- --></A>
  405. <div class="oddrow">
  406. <div class="var-header">
  407. <img src="../media/images/Variable.png" />
  408. <span class="var-title">
  409. <span class="var-type">object</span>
  410. <span class="var-name">$_session</span>
  411. = <span class="var-default"> null</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a41">41</a></span>)
  412. </span>
  413. </div>
  414. <!-- ========== Info from phpDoc block ========= -->
  415. <p class="short-description">Internal only - reference to the containing <a href="../sloodle/SloodleSession.html">SloodleSession</a> object.</p>
  416. <p class="description"><p>Note: always check that it is not null before use!</p></p>
  417. <ul class="tags">
  418. <li><span class="field">access:</span> protected</li>
  419. </ul>
  420. </div>
  421. </div>
  422. </div>
  423. <a name="sec-methods"></a>
  424. <div class="info-box">
  425. <div class="info-box-title">Methods</div>
  426. <div class="nav-bar">
  427. <a href="#sec-description">Description</a> |
  428. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  429. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  430. </div>
  431. <div class="info-box-body">
  432. <A NAME='method_detail'></A>
  433. <a name="methodSloodleUser" id="SloodleUser"><!-- --></a>
  434. <div class="evenrow">
  435. <div class="method-header">
  436. <img src="../media/images/Constructor.png" />
  437. <span class="method-title">Constructor SloodleUser</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a67">67</a></span>)
  438. </div>
  439. <!-- ========== Info from phpDoc block ========= -->
  440. <p class="short-description">Class constructor.</p>
  441. <ul class="tags">
  442. <li><span class="field">access:</span> public</li>
  443. </ul>
  444. <div class="method-signature">
  445. <span class="method-result">SloodleUser</span>
  446. <span class="method-name">
  447. SloodleUser
  448. </span>
  449. (<span class="var-type">object</span>&nbsp;<span class="var-name">&$_session</span>)
  450. </div>
  451. <ul class="parameters">
  452. <li>
  453. <span class="var-type">object</span>
  454. <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>
  455. </ul>
  456. </div>
  457. <a name="methodadd_linked_avatar" id="add_linked_avatar"><!-- --></a>
  458. <div class="oddrow">
  459. <div class="method-header">
  460. <img src="../media/images/Method.png" />
  461. <span class="method-title">add_linked_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a359">359</a></span>)
  462. </div>
  463. <!-- ========== Info from phpDoc block ========= -->
  464. <p class="short-description">Adds a new avatar to the database, and link it to the specified user.</p>
  465. <p class="description"><p>If successful, it deletes any matching avatar details from pending users list.</p></p>
  466. <ul class="tags">
  467. <li><span class="field">return:</span> True if successful, or false if not.</li>
  468. <li><span class="field">access:</span> public</li>
  469. </ul>
  470. <div class="method-signature">
  471. <span class="method-result">bool</span>
  472. <span class="method-name">
  473. add_linked_avatar
  474. </span>
  475. (<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>)
  476. </div>
  477. <ul class="parameters">
  478. <li>
  479. <span class="var-type">mixed</span>
  480. <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>
  481. <li>
  482. <span class="var-type">string</span>
  483. <span class="var-name">$uuid</span><span class="var-description">: UUID of the avatar</span> </li>
  484. <li>
  485. <span class="var-type">string</span>
  486. <span class="var-name">$avname</span><span class="var-description">: Name of the avatar</span> </li>
  487. </ul>
  488. </div>
  489. <a name="methodadd_pending_avatar" id="add_pending_avatar"><!-- --></a>
  490. <div class="evenrow">
  491. <div class="method-header">
  492. <img src="../media/images/Method.png" />
  493. <span class="method-title">add_pending_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a389">389</a></span>)
  494. </div>
  495. <!-- ========== Info from phpDoc block ========= -->
  496. <p class="short-description">Adds a new unlinked avatar to the database (the entry is pending linking)</p>
  497. <ul class="tags">
  498. <li><span class="field">return:</span> Returns the database object if successul, or false if not.</li>
  499. <li><span class="field">access:</span> public</li>
  500. </ul>
  501. <div class="method-signature">
  502. <span class="method-result">object|bool</span>
  503. <span class="method-name">
  504. add_pending_avatar
  505. </span>
  506. (<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>])
  507. </div>
  508. <ul class="parameters">
  509. <li>
  510. <span class="var-type">string</span>
  511. <span class="var-name">$uuid</span><span class="var-description">: UUID of the avatar</span> </li>
  512. <li>
  513. <span class="var-type">string</span>
  514. <span class="var-name">$avname</span><span class="var-description">: Name of the avatar</span> </li>
  515. <li>
  516. <span class="var-type">int</span>
  517. <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>
  518. </ul>
  519. </div>
  520. <a name="methodautoregister_avatar_user" id="autoregister_avatar_user"><!-- --></a>
  521. <div class="oddrow">
  522. <div class="method-header">
  523. <img src="../media/images/Method.png" />
  524. <span class="method-title">autoregister_avatar_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a419">419</a></span>)
  525. </div>
  526. <!-- ========== Info from phpDoc block ========= -->
  527. <p class="short-description">Auto-register a new user account for the current avatar.</p>
  528. <p class="description"><p>NOTE: this does NOT respect ANYTHING but the most basic Moodle accounts. Use at your own risk!</p></p>
  529. <ul class="tags">
  530. <li><span class="field">return:</span> The new password (plaintext) if successful, or false if not</li>
  531. <li><span class="field">access:</span> public</li>
  532. </ul>
  533. <div class="method-signature">
  534. <span class="method-result">string|bool</span>
  535. <span class="method-name">
  536. autoregister_avatar_user
  537. </span>
  538. ()
  539. </div>
  540. </div>
  541. <a name="methoddelete_avatar" id="delete_avatar"><!-- --></a>
  542. <div class="evenrow">
  543. <div class="method-header">
  544. <img src="../media/images/Method.png" />
  545. <span class="method-title">delete_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a256">256</a></span>)
  546. </div>
  547. <!-- ========== Info from phpDoc block ========= -->
  548. <p class="short-description">Deletes the current avatar from the database.</p>
  549. <ul class="tags">
  550. <li><span class="field">return:</span> True if successful, or false on failure</li>
  551. <li><span class="field">access:</span> public</li>
  552. </ul>
  553. <div class="method-signature">
  554. <span class="method-result">bool</span>
  555. <span class="method-name">
  556. delete_avatar
  557. </span>
  558. ()
  559. </div>
  560. </div>
  561. <a name="methodenrol" id="enrol"><!-- --></a>
  562. <div class="oddrow">
  563. <div class="method-header">
  564. <img src="../media/images/Method.png" />
  565. <span class="method-title">enrol</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a671">671</a></span>)
  566. </div>
  567. <!-- ========== Info from phpDoc block ========= -->
  568. <p class="short-description">Enrols the current user in the specified course</p>
  569. <p class="description"><p>NOTE: a side effect of this is that it logs-in the user</p></p>
  570. <ul class="tags">
  571. <li><span class="field">access:</span> public</li>
  572. </ul>
  573. <div class="method-signature">
  574. <span class="method-result">void</span>
  575. <span class="method-name">
  576. enrol
  577. </span>
  578. ([<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>)
  579. </div>
  580. <ul class="parameters">
  581. <li>
  582. <span class="var-type">object</span>
  583. <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>
  584. <li>
  585. <span class="var-type">bool</span>
  586. <span class="var-name">1</span><span class="var-description">: True if successful (or the user was already enrolled), or false otherwise</span> </li>
  587. </ul>
  588. </div>
  589. <a name="methodget_avatar_id" id="get_avatar_id"><!-- --></a>
  590. <div class="evenrow">
  591. <div class="method-header">
  592. <img src="../media/images/Method.png" />
  593. <span class="method-title">get_avatar_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a80">80</a></span>)
  594. </div>
  595. <!-- ========== Info from phpDoc block ========= -->
  596. <p class="short-description">Gets the unique ID of the avatar.</p>
  597. <ul class="tags">
  598. <li><span class="field">return:</span> Type depends on VLE. (Integer on Moodle). Returns null if there is no avatar.</li>
  599. <li><span class="field">access:</span> public</li>
  600. </ul>
  601. <div class="method-signature">
  602. <span class="method-result">mixed</span>
  603. <span class="method-name">
  604. get_avatar_id
  605. </span>
  606. ()
  607. </div>
  608. </div>
  609. <a name="methodget_avatar_last_active" id="get_avatar_last_active"><!-- --></a>
  610. <div class="oddrow">
  611. <div class="method-header">
  612. <img src="../media/images/Method.png" />
  613. <span class="method-title">get_avatar_last_active</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a185">185</a></span>)
  614. </div>
  615. <!-- ========== Info from phpDoc block ========= -->
  616. <p class="short-description">Gets the timestamp of whenever the avatar was last active</p>
  617. <div class="method-signature">
  618. <span class="method-result">int</span>
  619. <span class="method-name">
  620. get_avatar_last_active
  621. </span>
  622. ()
  623. </div>
  624. </div>
  625. <a name="methodget_avatar_name" id="get_avatar_name"><!-- --></a>
  626. <div class="evenrow">
  627. <div class="method-header">
  628. <img src="../media/images/Method.png" />
  629. <span class="method-title">get_avatar_name</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a139">139</a></span>)
  630. </div>
  631. <!-- ========== Info from phpDoc block ========= -->
  632. <p class="short-description">Gets the name of the avatar</p>
  633. <div class="method-signature">
  634. <span class="method-result">string</span>
  635. <span class="method-name">
  636. get_avatar_name
  637. </span>
  638. ()
  639. </div>
  640. </div>
  641. <a name="methodget_avatar_uuid" id="get_avatar_uuid"><!-- --></a>
  642. <div class="oddrow">
  643. <div class="method-header">
  644. <img src="../media/images/Method.png" />
  645. <span class="method-title">get_avatar_uuid</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a120">120</a></span>)
  646. </div>
  647. <!-- ========== Info from phpDoc block ========= -->
  648. <p class="short-description">Gets the UUID of the avatar</p>
  649. <div class="method-signature">
  650. <span class="method-result">string</span>
  651. <span class="method-name">
  652. get_avatar_uuid
  653. </span>
  654. ()
  655. </div>
  656. </div>
  657. <a name="methodget_enrolled_courses" id="get_enrolled_courses"><!-- --></a>
  658. <div class="evenrow">
  659. <div class="method-header">
  660. <img src="../media/images/Method.png" />
  661. <span class="method-title">get_enrolled_courses</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a551">551</a></span>)
  662. </div>
  663. <!-- ========== Info from phpDoc block ========= -->
  664. <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>
  665. <p class="description"><p>WARNING: this function is not very efficient, and will likely be very slow on large sites.</p></p>
  666. <ul class="tags">
  667. <li><span class="field">return:</span> A numeric array of <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> objects</li>
  668. <li><span class="field">access:</span> public</li>
  669. </ul>
  670. <div class="method-signature">
  671. <span class="method-result">array</span>
  672. <span class="method-name">
  673. get_enrolled_courses
  674. </span>
  675. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  676. </div>
  677. <ul class="parameters">
  678. <li>
  679. <span class="var-type">mixed</span>
  680. <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>
  681. </ul>
  682. </div>
  683. <a name="methodget_staff_courses" id="get_staff_courses"><!-- --></a>
  684. <div class="oddrow">
  685. <div class="method-header">
  686. <img src="../media/images/Method.png" />
  687. <span class="method-title">get_staff_courses</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a588">588</a></span>)
  688. </div>
  689. <!-- ========== Info from phpDoc block ========= -->
  690. <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>
  691. <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>
  692. <ul class="tags">
  693. <li><span class="field">return:</span> A numeric array of <a href="../sloodle/SloodleCourse.html">SloodleCourse</a> objects</li>
  694. <li><span class="field">access:</span> public</li>
  695. </ul>
  696. <div class="method-signature">
  697. <span class="method-result">array</span>
  698. <span class="method-name">
  699. get_staff_courses
  700. </span>
  701. ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$category</span> = <span class="var-default">null</span>])
  702. </div>
  703. <ul class="parameters">
  704. <li>
  705. <span class="var-type">mixed</span>
  706. <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>
  707. </ul>
  708. </div>
  709. <a name="methodget_username" id="get_username"><!-- --></a>
  710. <div class="evenrow">
  711. <div class="method-header">
  712. <img src="../media/images/Method.png" />
  713. <span class="method-title">get_username</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a158">158</a></span>)
  714. </div>
  715. <!-- ========== Info from phpDoc block ========= -->
  716. <p class="short-description">Gets the user's username</p>
  717. <div class="method-signature">
  718. <span class="method-result">string</span>
  719. <span class="method-name">
  720. get_username
  721. </span>
  722. ()
  723. </div>
  724. </div>
  725. <a name="methodget_user_email" id="get_user_email"><!-- --></a>
  726. <div class="oddrow">
  727. <div class="method-header">
  728. <img src="../media/images/Method.png" />
  729. <span class="method-title">get_user_email</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a205">205</a></span>)
  730. </div>
  731. <!-- ========== Info from phpDoc block ========= -->
  732. <p class="short-description">Gets the user's email address.</p>
  733. <ul class="tags">
  734. <li><span class="field">return:</span> The user's email address, or null if none is specified of if email is disabled.</li>
  735. </ul>
  736. <div class="method-signature">
  737. <span class="method-result">string|null</span>
  738. <span class="method-name">
  739. get_user_email
  740. </span>
  741. ()
  742. </div>
  743. </div>
  744. <a name="methodget_user_firstname" id="get_user_firstname"><!-- --></a>
  745. <div class="evenrow">
  746. <div class="method-header">
  747. <img src="../media/images/Method.png" />
  748. <span class="method-title">get_user_firstname</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a167">167</a></span>)
  749. </div>
  750. <!-- ========== Info from phpDoc block ========= -->
  751. <p class="short-description">Gets the first name of the user</p>
  752. <div class="method-signature">
  753. <span class="method-result">string</span>
  754. <span class="method-name">
  755. get_user_firstname
  756. </span>
  757. ()
  758. </div>
  759. </div>
  760. <a name="methodget_user_id" id="get_user_id"><!-- --></a>
  761. <div class="oddrow">
  762. <div class="method-header">
  763. <img src="../media/images/Method.png" />
  764. <span class="method-title">get_user_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a91">91</a></span>)
  765. </div>
  766. <!-- ========== Info from phpDoc block ========= -->
  767. <p class="short-description">Gets the unique ID of the VLE user.</p>
  768. <ul class="tags">
  769. <li><span class="field">return:</span> Type depends on VLE. (Integer on Moodle). Returns null if there is no user</li>
  770. <li><span class="field">access:</span> public</li>
  771. </ul>
  772. <div class="method-signature">
  773. <span class="method-result">mixed</span>
  774. <span class="method-name">
  775. get_user_id
  776. </span>
  777. ()
  778. </div>
  779. </div>
  780. <a name="methodget_user_lastname" id="get_user_lastname"><!-- --></a>
  781. <div class="evenrow">
  782. <div class="method-header">
  783. <img src="../media/images/Method.png" />
  784. <span class="method-title">get_user_lastname</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a176">176</a></span>)
  785. </div>
  786. <!-- ========== Info from phpDoc block ========= -->
  787. <p class="short-description">Gets the last name of the user</p>
  788. <div class="method-signature">
  789. <span class="method-result">string</span>
  790. <span class="method-name">
  791. get_user_lastname
  792. </span>
  793. ()
  794. </div>
  795. </div>
  796. <a name="methodis_avatar_linked" id="is_avatar_linked"><!-- --></a>
  797. <div class="oddrow">
  798. <div class="method-header">
  799. <img src="../media/images/Method.png" />
  800. <span class="method-title">is_avatar_linked</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a219">219</a></span>)
  801. </div>
  802. <!-- ========== Info from phpDoc block ========= -->
  803. <p class="short-description">Determines whether or not the current user and avatar are linked.</p>
  804. <ul class="tags">
  805. <li><span class="field">return:</span> True if they are linked, or false if not.</li>
  806. </ul>
  807. <div class="method-signature">
  808. <span class="method-result">bool</span>
  809. <span class="method-name">
  810. is_avatar_linked
  811. </span>
  812. ()
  813. </div>
  814. </div>
  815. <a name="methodis_avatar_loaded" id="is_avatar_loaded"><!-- --></a>
  816. <div class="evenrow">
  817. <div class="method-header">
  818. <img src="../media/images/Method.png" />
  819. <span class="method-title">is_avatar_loaded</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a101">101</a></span>)
  820. </div>
  821. <!-- ========== Info from phpDoc block ========= -->
  822. <p class="short-description">Determines whether or not an avatar is loaded.</p>
  823. <div class="method-signature">
  824. <span class="method-result">bool</span>
  825. <span class="method-name">
  826. is_avatar_loaded
  827. </span>
  828. ()
  829. </div>
  830. </div>
  831. <a name="methodis_enrolled" id="is_enrolled"><!-- --></a>
  832. <div class="oddrow">
  833. <div class="method-header">
  834. <img src="../media/images/Method.png" />
  835. <span class="method-title">is_enrolled</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a621">621</a></span>)
  836. </div>
  837. <!-- ========== Info from phpDoc block ========= -->
  838. <p class="short-description">Is the current user enrolled in the specified course?</p>
  839. <p class="description"><p>NOTE: a side effect of this is that it logs-in the user</p></p>
  840. <ul class="tags">
  841. <li><span class="field">todo:</span> Update to match parameter format and handling of <a href="../sloodle/SloodleUser.html#methodenrol">enrol()</a> function.</li>
  842. <li><span class="field">access:</span> public</li>
  843. </ul>
  844. <div class="method-signature">
  845. <span class="method-result">void</span>
  846. <span class="method-name">
  847. is_enrolled
  848. </span>
  849. (<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>)
  850. </div>
  851. <ul class="parameters">
  852. <li>
  853. <span class="var-type">mixed</span>
  854. <span class="var-name">$course</span><span class="var-description">: Unique identifier of the course -- type depends on VLE (integer for Moodle)</span> </li>
  855. <li>
  856. <span class="var-type">bool</span>
  857. <span class="var-name">1</span><span class="var-description">: True if the user is enrolled, or false if not.</span> </li>
  858. <li>
  859. <span class="var-type"></span>
  860. <span class="var-name">$courseid</span> </li>
  861. </ul>
  862. </div>
  863. <a name="methodis_staff" id="is_staff"><!-- --></a>
  864. <div class="evenrow">
  865. <div class="method-header">
  866. <img src="../media/images/Method.png" />
  867. <span class="method-title">is_staff</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a647">647</a></span>)
  868. </div>
  869. <!-- ========== Info from phpDoc block ========= -->
  870. <p class="short-description">Is the current user Sloodle staff in the specified course?</p>
  871. <p class="description"><p>NOTE: a side effect of this is that it logs-in the user</p></p>
  872. <ul class="tags">
  873. <li><span class="field">todo:</span> Update to match parameter format and handling of <a href="../sloodle/SloodleUser.html#methodenrol">enrol()</a> function.</li>
  874. <li><span class="field">access:</span> public</li>
  875. </ul>
  876. <div class="method-signature">
  877. <span class="method-result">void</span>
  878. <span class="method-name">
  879. is_staff
  880. </span>
  881. (<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>)
  882. </div>
  883. <ul class="parameters">
  884. <li>
  885. <span class="var-type">mixed</span>
  886. <span class="var-name">$course</span><span class="var-description">: Unique identifier of the course -- type depends on VLE (integer for Moodle)</span> </li>
  887. <li>
  888. <span class="var-type">bool</span>
  889. <span class="var-name">1</span><span class="var-description">: True if the user is staff, or false if not.</span> </li>
  890. <li>
  891. <span class="var-type"></span>
  892. <span class="var-name">$courseid</span> </li>
  893. </ul>
  894. </div>
  895. <a name="methodis_user_loaded" id="is_user_loaded"><!-- --></a>
  896. <div class="oddrow">
  897. <div class="method-header">
  898. <img src="../media/images/Method.png" />
  899. <span class="method-title">is_user_loaded</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a110">110</a></span>)
  900. </div>
  901. <!-- ========== Info from phpDoc block ========= -->
  902. <p class="short-description">Determines whether or not a VLE user is loaded.</p>
  903. <div class="method-signature">
  904. <span class="method-result">bool</span>
  905. <span class="method-name">
  906. is_user_loaded
  907. </span>
  908. ()
  909. </div>
  910. </div>
  911. <a name="methodlink_avatar" id="link_avatar"><!-- --></a>
  912. <div class="evenrow">
  913. <div class="method-header">
  914. <img src="../media/images/Method.png" />
  915. <span class="method-title">link_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a234">234</a></span>)
  916. </div>
  917. <!-- ========== Info from phpDoc block ========= -->
  918. <p class="short-description">Links the current avatar to the current user.</p>
  919. <p class="description"><p><strong>NOTE:</strong> does not remove any other avatar links to the VLE user.</p></p>
  920. <ul class="tags">
  921. <li><span class="field">return:</span> True if successful or false otherwise.</li>
  922. <li><span class="field">access:</span> public</li>
  923. </ul>
  924. <div class="method-signature">
  925. <span class="method-result">bool</span>
  926. <span class="method-name">
  927. link_avatar
  928. </span>
  929. ()
  930. </div>
  931. </div>
  932. <a name="methodload_avatar" id="load_avatar"><!-- --></a>
  933. <div class="oddrow">
  934. <div class="method-header">
  935. <img src="../media/images/Method.png" />
  936. <span class="method-title">load_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a292">292</a></span>)
  937. </div>
  938. <!-- ========== Info from phpDoc block ========= -->
  939. <p class="short-description">Finds an avatar with the given UUID and/or name, and loads its data.</p>
  940. <p class="description"><p>The UUID is searched for first. If that is not found, then the name is used.</p></p>
  941. <ul class="tags">
  942. <li><span class="field">return:</span> True if successful, or false otherwise</li>
  943. <li><span class="field">access:</span> public</li>
  944. </ul>
  945. <div class="method-signature">
  946. <span class="method-result">bool</span>
  947. <span class="method-name">
  948. load_avatar
  949. </span>
  950. (<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>)
  951. </div>
  952. <ul class="parameters">
  953. <li>
  954. <span class="var-type">string</span>
  955. <span class="var-name">$uuid</span><span class="var-description">: The UUID of the avatar, or blank to search only by name.</span> </li>
  956. <li>
  957. <span class="var-type">string</span>
  958. <span class="var-name">$avname</span><span class="var-description">: The name of the avatar, or blank to search only by UUID.</span> </li>
  959. </ul>
  960. </div>
  961. <a name="methodload_avatar_by_id" id="load_avatar_by_id"><!-- --></a>
  962. <div class="evenrow">
  963. <div class="method-header">
  964. <img src="../media/images/Method.png" />
  965. <span class="method-title">load_avatar_by_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a271">271</a></span>)
  966. </div>
  967. <!-- ========== Info from phpDoc block ========= -->
  968. <p class="short-description">Loads the specified avatar from the database.</p>
  969. <ul class="tags">
  970. <li><span class="field">return:</span> True if successful, or false otherwise.</li>
  971. <li><span class="field">access:</span> public</li>
  972. </ul>
  973. <div class="method-signature">
  974. <span class="method-result">bool</span>
  975. <span class="method-name">
  976. load_avatar_by_id
  977. </span>
  978. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  979. </div>
  980. <ul class="parameters">
  981. <li>
  982. <span class="var-type">mixed</span>
  983. <span class="var-name">$id</span><span class="var-description">: The ID of the avatar (type depends on VLE; integer for Moodle)</span> </li>
  984. </ul>
  985. </div>
  986. <a name="methodload_linked_avatar" id="load_linked_avatar"><!-- --></a>
  987. <div class="oddrow">
  988. <div class="method-header">
  989. <img src="../media/images/Method.png" />
  990. <span class="method-title">load_linked_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a489">489</a></span>)
  991. </div>
  992. <!-- ========== Info from phpDoc block ========= -->
  993. <p class="short-description">Load the avatar linked to the current user.</p>
  994. <ul class="tags">
  995. <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>
  996. <li><span class="field">access:</span> public</li>
  997. </ul>
  998. <div class="method-signature">
  999. <span class="method-result">bool,string</span>
  1000. <span class="method-name">
  1001. load_linked_avatar
  1002. </span>
  1003. ()
  1004. </div>
  1005. </div>
  1006. <a name="methodload_linked_user" id="load_linked_user"><!-- --></a>
  1007. <div class="evenrow">
  1008. <div class="method-header">
  1009. <img src="../media/images/Method.png" />
  1010. <span class="method-title">load_linked_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a511">511</a></span>)
  1011. </div>
  1012. <!-- ========== Info from phpDoc block ========= -->
  1013. <p class="short-description">Find the VLE user linked to the current avatar.</p>
  1014. <ul class="tags">
  1015. <li><span class="field">return:</span> True if successful, or false if no link was found</li>
  1016. <li><span class="field">access:</span> public</li>
  1017. </ul>
  1018. <div class="method-signature">
  1019. <span class="method-result">bool</span>
  1020. <span class="method-name">
  1021. load_linked_user
  1022. </span>
  1023. ()
  1024. </div>
  1025. </div>
  1026. <a name="methodload_user" id="load_user"><!-- --></a>
  1027. <div class="oddrow">
  1028. <div class="method-header">
  1029. <img src="../media/images/Method.png" />
  1030. <span class="method-title">load_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a320">320</a></span>)
  1031. </div>
  1032. <!-- ========== Info from phpDoc block ========= -->
  1033. <p class="short-description">Load the specified user from the database</p>
  1034. <ul class="tags">
  1035. <li><span class="field">return:</span> True if successful, or false on failure</li>
  1036. <li><span class="field">access:</span> public</li>
  1037. </ul>
  1038. <div class="method-signature">
  1039. <span class="method-result">bool</span>
  1040. <span class="method-name">
  1041. load_user
  1042. </span>
  1043. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$id</span>)
  1044. </div>
  1045. <ul class="parameters">
  1046. <li>
  1047. <span class="var-type">mixed</span>
  1048. <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>
  1049. </ul>
  1050. </div>
  1051. <a name="methodlogin" id="login"><!-- --></a>
  1052. <div class="evenrow">
  1053. <div class="method-header">
  1054. <img src="../media/images/Method.png" />
  1055. <span class="method-title">login</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a532">532</a></span>)
  1056. </div>
  1057. <!-- ========== Info from phpDoc block ========= -->
  1058. <p class="short-description">Internally 'log-in' the current user.</p>
  1059. <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>
  1060. <ul class="tags">
  1061. <li><span class="field">return:</span> True if successful, or false otherwise.</li>
  1062. <li><span class="field">access:</span> public</li>
  1063. </ul>
  1064. <div class="method-signature">
  1065. <span class="method-result">bool</span>
  1066. <span class="method-name">
  1067. login
  1068. </span>
  1069. ()
  1070. </div>
  1071. </div>
  1072. <a name="methodpurge_password_notifications" id="purge_password_notifications"><!-- --></a>
  1073. <div class="oddrow">
  1074. <div class="method-header">
  1075. <img src="../media/images/Method.png" />
  1076. <span class="method-title">purge_password_notifications</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a776">776</a></span>)
  1077. </div>
  1078. <!-- ========== Info from phpDoc block ========= -->
  1079. <p class="short-description">If the system is waiting to send a password notification to this user, then remove it</p>
  1080. <div class="method-signature">
  1081. <span class="method-result">void</span>
  1082. <span class="method-name">
  1083. purge_password_notifications
  1084. </span>
  1085. ()
  1086. </div>
  1087. </div>
  1088. <a name="methodreset_password" id="reset_password"><!-- --></a>
  1089. <div class="evenrow">
  1090. <div class="method-header">
  1091. <img src="../media/images/Method.png" />
  1092. <span class="method-title">reset_password</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a739">739</a></span>)
  1093. </div>
  1094. <!-- ========== Info from phpDoc block ========= -->
  1095. <p class="short-description">Resets the user's password</p>
  1096. <ul class="tags">
  1097. <li><span class="field">return:</span> The new password if successful, or false otherwise (if $require was false).</li>
  1098. </ul>
  1099. <div class="method-signature">
  1100. <span class="method-result">string|bool</span>
  1101. <span class="method-name">
  1102. reset_password
  1103. </span>
  1104. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$require</span> = <span class="var-default">true</span>])
  1105. </div>
  1106. <ul class="parameters">
  1107. <li>
  1108. <span class="var-type">bool</span>
  1109. <span class="var-name">$require</span><span class="var-description">: If true, then the script will be terminated if the operation fails</span> </li>
  1110. </ul>
  1111. </div>
  1112. <a name="methodset_avatar_last_active" id="set_avatar_last_active"><!-- --></a>
  1113. <div class="oddrow">
  1114. <div class="method-header">
  1115. <img src="../media/images/Method.png" />
  1116. <span class="method-title">set_avatar_last_active</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a195">195</a></span>)
  1117. </div>
  1118. <!-- ========== Info from phpDoc block ========= -->
  1119. <p class="short-description">Sets the timestamp of when the user was last active</p>
  1120. <div class="method-signature">
  1121. <span class="method-result">void</span>
  1122. <span class="method-name">
  1123. set_avatar_last_active
  1124. </span>
  1125. ([<span class="var-type">int</span>&nbsp;<span class="var-name">$timestamp</span> = <span class="var-default">null</span>])
  1126. </div>
  1127. <ul class="parameters">
  1128. <li>
  1129. <span class="var-type">int</span>
  1130. <span class="var-name">$timestamp</span><span class="var-description">: A UNIX timestamp, or null to use the current time</span> </li>
  1131. </ul>
  1132. </div>
  1133. <a name="methodset_avatar_name" id="set_avatar_name"><!-- --></a>
  1134. <div class="evenrow">
  1135. <div class="method-header">
  1136. <img src="../media/images/Method.png" />
  1137. <span class="method-title">set_avatar_name</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a149">149</a></span>)
  1138. </div>
  1139. <!-- ========== Info from phpDoc block ========= -->
  1140. <p class="short-description">Sets the name of the avatar</p>
  1141. <div class="method-signature">
  1142. <span class="method-result">void</span>
  1143. <span class="method-name">
  1144. set_avatar_name
  1145. </span>
  1146. (<span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span>)
  1147. </div>
  1148. <ul class="parameters">
  1149. <li>
  1150. <span class="var-type">string</span>
  1151. <span class="var-name">$avname</span><span class="var-description">: The new avatar name</span> </li>
  1152. </ul>
  1153. </div>
  1154. <a name="methodset_avatar_uuid" id="set_avatar_uuid"><!-- --></a>
  1155. <div class="oddrow">
  1156. <div class="method-header">
  1157. <img src="../media/images/Method.png" />
  1158. <span class="method-title">set_avatar_uuid</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a130">130</a></span>)
  1159. </div>
  1160. <!-- ========== Info from phpDoc block ========= -->
  1161. <p class="short-description">Sets the UUID of the avatar</p>
  1162. <div class="method-signature">
  1163. <span class="method-result">void</span>
  1164. <span class="method-name">
  1165. set_avatar_uuid
  1166. </span>
  1167. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>)
  1168. </div>
  1169. <ul class="parameters">
  1170. <li>
  1171. <span class="var-type">string</span>
  1172. <span class="var-name">$uuid</span><span class="var-description">: The new UUID</span> </li>
  1173. </ul>
  1174. </div>
  1175. <a name="methodwrite_avatar" id="write_avatar"><!-- --></a>
  1176. <div class="evenrow">
  1177. <div class="method-header">
  1178. <img src="../media/images/Method.png" />
  1179. <span class="method-title">write_avatar</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__sloodlelibuser.php.html#a342">342</a></span>)
  1180. </div>
  1181. <!-- ========== Info from phpDoc block ========= -->
  1182. <p class="short-description">Uses the current avatar data to update the database.</p>
  1183. <ul class="tags">
  1184. <li><span class="field">return:</span> True if successful, or false if the update fails</li>
  1185. <li><span class="field">access:</span> public</li>
  1186. </ul>
  1187. <div class="method-signature">
  1188. <span class="method-result">bool</span>
  1189. <span class="method-name">
  1190. write_avatar
  1191. </span>
  1192. ()
  1193. </div>
  1194. </div>
  1195. </div>
  1196. </div>
  1197. <p class="notes" id="credit">
  1198. Documentation generated on Mon, 16 Jun 2008 15:57:04 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  1199. </p>
  1200. </div></body>
  1201. </html>