SloodleUser.html 58 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315
  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/SloodleLSLRequest.html">SloodleLSLRequest</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---sl_userlib.php.html">/lib/sl_userlib.php</a> (line <span class="field"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a29">29</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/Variable.png" alt=" " />
  121. <span class="var-type">array</span>
  122. <a href="#$enrolled_courses_cache" title="details" class="var-name">$enrolled_courses_cache</a>
  123. </div>
  124. <div class="var-title">
  125. <img src="../media/images/Variable.png" alt=" " />
  126. <span class="var-type">object</span>
  127. <a href="#$moodle_user_cache" title="details" class="var-name">$moodle_user_cache</a>
  128. </div>
  129. <div class="var-title">
  130. <img src="../media/images/PrivateVariable.png" alt=" " />
  131. <span class="var-type">int</span>
  132. <a href="#$moodle_user_id" title="details" class="var-name">$moodle_user_id</a>
  133. </div>
  134. <div class="var-title">
  135. <img src="../media/images/Variable.png" alt=" " />
  136. <span class="var-type">object</span>
  137. <a href="#$sloodle_user_cache" title="details" class="var-name">$sloodle_user_cache</a>
  138. </div>
  139. <div class="var-title">
  140. <img src="../media/images/PrivateVariable.png" alt=" " />
  141. <span class="var-type">int</span>
  142. <a href="#$sloodle_user_id" title="details" class="var-name">$sloodle_user_id</a>
  143. </div>
  144. </div>
  145. </div>
  146. </div>
  147. <a name="sec-method-summary"></a>
  148. <div class="info-box">
  149. <div class="info-box-title">Method Summary</span></div>
  150. <div class="nav-bar">
  151. <a href="#sec-description">Description</a> |
  152. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  153. |
  154. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  155. </div>
  156. <div class="info-box-body">
  157. <div class="method-summary">
  158. <div class="method-definition">
  159. <img src="../media/images/Constructor.png" alt=" "/>
  160. <span class="method-result">void</span>
  161. <a href="#SloodleUser" title="details" class="method-name">SloodleUser</a>
  162. ()
  163. </div>
  164. <div class="method-definition">
  165. <img src="../media/images/Method.png" alt=" "/>
  166. <span class="method-result">mixed</span>
  167. <a href="#create_moodle_user" title="details" class="method-name">create_moodle_user</a>
  168. (<span class="var-type"></span>&nbsp;<span class="var-name">$firstname</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$lastname</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$email</span>)
  169. </div>
  170. <div class="method-definition">
  171. <img src="../media/images/Method.png" alt=" "/>
  172. <span class="method-result">bool</span>
  173. <a href="#create_sloodle_user" title="details" class="method-name">create_sloodle_user</a>
  174. ([<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span> = <span class="var-default">''</span>], [<span class="var-type">int</span>&nbsp;<span class="var-name">$userid</span> = <span class="var-default">0</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginposition</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginpositionexpires</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginpositionregion</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginsecuritytoken</span> = <span class="var-default">''</span>])
  175. </div>
  176. <div class="method-definition">
  177. <img src="../media/images/Method.png" alt=" "/>
  178. <span class="method-result">mixed</span>
  179. <a href="#delete_login_position" title="details" class="method-name">delete_login_position</a>
  180. ()
  181. </div>
  182. <div class="method-definition">
  183. <img src="../media/images/Method.png" alt=" "/>
  184. <span class="method-result">mixed</span>
  185. <a href="#delete_sloodle_user" title="details" class="method-name">delete_sloodle_user</a>
  186. ()
  187. </div>
  188. <div class="method-definition">
  189. <img src="../media/images/Method.png" alt=" "/>
  190. <span class="method-result">mixed</span>
  191. <a href="#find_linked_moodle_user" title="details" class="method-name">find_linked_moodle_user</a>
  192. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>], [<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  193. </div>
  194. <div class="method-definition">
  195. <img src="../media/images/Method.png" alt=" "/>
  196. <span class="method-result">mixed</span>
  197. <a href="#find_linked_sloodle_user" title="details" class="method-name">find_linked_sloodle_user</a>
  198. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  199. </div>
  200. <div class="method-definition">
  201. <img src="../media/images/Method.png" alt=" "/>
  202. <span class="method-result">mixed</span>
  203. <a href="#find_sloodle_user" title="details" class="method-name">find_sloodle_user</a>
  204. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$name</span>, [<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  205. </div>
  206. <div class="method-definition">
  207. <img src="../media/images/Method.png" alt=" "/>
  208. <span class="method-result">void</span>
  209. <a href="#find_sloodle_user_by_login_position" title="details" class="method-name">find_sloodle_user_by_login_position</a>
  210. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$position</span>, [<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  211. </div>
  212. <div class="method-definition">
  213. <img src="../media/images/Method.png" alt=" "/>
  214. <span class="method-result">mixed</span>
  215. <a href="#generate_login_position" title="details" class="method-name">generate_login_position</a>
  216. (<span class="var-type">int</span>&nbsp;<span class="var-name">$expires</span>)
  217. </div>
  218. <div class="method-definition">
  219. <img src="../media/images/Method.png" alt=" "/>
  220. <span class="method-result">int</span>
  221. <a href="#get_moodle_user_id" title="details" class="method-name">get_moodle_user_id</a>
  222. ()
  223. </div>
  224. <div class="method-definition">
  225. <img src="../media/images/Method.png" alt=" "/>
  226. <span class="method-result">int</span>
  227. <a href="#get_sloodle_user_id" title="details" class="method-name">get_sloodle_user_id</a>
  228. ()
  229. </div>
  230. <div class="method-definition">
  231. <img src="../media/images/Method.png" alt=" "/>
  232. <span class="method-result">bool</span>
  233. <a href="#has_login_security_token" title="details" class="method-name">has_login_security_token</a>
  234. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>])
  235. </div>
  236. <div class="method-definition">
  237. <img src="../media/images/Method.png" alt=" "/>
  238. <span class="method-result">bool</span>
  239. <a href="#insert_sloodle_user_cache_to_db" title="details" class="method-name">insert_sloodle_user_cache_to_db</a>
  240. ()
  241. </div>
  242. <div class="method-definition">
  243. <img src="../media/images/Method.png" alt=" "/>
  244. <span class="method-result">void</span>
  245. <a href="#is_user_in_course" title="details" class="method-name">is_user_in_course</a>
  246. (<span class="var-type">int</span>&nbsp;<span class="var-name">$course_id</span>, [<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>], <span class="var-type">bool</span>&nbsp;<span class="var-name">2</span>)
  247. </div>
  248. <div class="method-definition">
  249. <img src="../media/images/Method.png" alt=" "/>
  250. <span class="method-result">mixed</span>
  251. <a href="#link_users" title="details" class="method-name">link_users</a>
  252. ()
  253. </div>
  254. <div class="method-definition">
  255. <img src="../media/images/Method.png" alt=" "/>
  256. <span class="method-result">bool</span>
  257. <a href="#login_moodle_user" title="details" class="method-name">login_moodle_user</a>
  258. ()
  259. </div>
  260. <div class="method-definition">
  261. <img src="../media/images/Method.png" alt=" "/>
  262. <span class="method-result">bool</span>
  263. <a href="#regenerate_login_security_token" title="details" class="method-name">regenerate_login_security_token</a>
  264. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  265. </div>
  266. <div class="method-definition">
  267. <img src="../media/images/Method.png" alt=" "/>
  268. <span class="method-result">void</span>
  269. <a href="#set_moodle_user_id" title="details" class="method-name">set_moodle_user_id</a>
  270. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>)
  271. </div>
  272. <div class="method-definition">
  273. <img src="../media/images/Method.png" alt=" "/>
  274. <span class="method-result">void</span>
  275. <a href="#set_sloodle_user_id" title="details" class="method-name">set_sloodle_user_id</a>
  276. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>)
  277. </div>
  278. <div class="method-definition">
  279. <img src="../media/images/Method.png" alt=" "/>
  280. <span class="method-result">mixed</span>
  281. <a href="#unlink_sloodle_user" title="details" class="method-name">unlink_sloodle_user</a>
  282. ()
  283. </div>
  284. <div class="method-definition">
  285. <img src="../media/images/Method.png" alt=" "/>
  286. <span class="method-result">True</span>
  287. <a href="#update_enrolled_courses_cache_from_db" title="details" class="method-name">update_enrolled_courses_cache_from_db</a>
  288. ()
  289. </div>
  290. <div class="method-definition">
  291. <img src="../media/images/Method.png" alt=" "/>
  292. <span class="method-result">mixed</span>
  293. <a href="#update_moodle_user_cache_from_db" title="details" class="method-name">update_moodle_user_cache_from_db</a>
  294. ()
  295. </div>
  296. <div class="method-definition">
  297. <img src="../media/images/Method.png" alt=" "/>
  298. <span class="method-result">mixed</span>
  299. <a href="#update_sloodle_user_cache_from_db" title="details" class="method-name">update_sloodle_user_cache_from_db</a>
  300. ()
  301. </div>
  302. <div class="method-definition">
  303. <img src="../media/images/Method.png" alt=" "/>
  304. <span class="method-result">mixed</span>
  305. <a href="#update_sloodle_user_cache_to_db" title="details" class="method-name">update_sloodle_user_cache_to_db</a>
  306. ()
  307. </div>
  308. <div class="method-definition">
  309. <img src="../media/images/Method.png" alt=" "/>
  310. <span class="method-result">mixed</span>
  311. <a href="#users_linked" title="details" class="method-name">users_linked</a>
  312. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>])
  313. </div>
  314. </div>
  315. </div>
  316. </div>
  317. <a name="sec-vars"></a>
  318. <div class="info-box">
  319. <div class="info-box-title">Variables</div>
  320. <div class="nav-bar">
  321. <a href="#sec-description">Description</a> |
  322. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  323. |
  324. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  325. </div>
  326. <div class="info-box-body">
  327. <a name="var$enrolled_courses_cache" id="$enrolled_courses_cache"><!-- --></A>
  328. <div class="oddrow">
  329. <div class="var-header">
  330. <img src="../media/images/Variable.png" />
  331. <span class="var-title">
  332. <span class="var-type">array</span>
  333. <span class="var-name">$enrolled_courses_cache</span>
  334. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a99">99</a></span>)
  335. </span>
  336. </div>
  337. <!-- ========== Info from phpDoc block ========= -->
  338. <p class="short-description">Cache of courses which the Moodle user is enrolled in Used by some functions fetching database data about a Moodle user's courses.</p>
  339. <p class="description"><p>It is an array which caches the list of courses the Moodle user is enrolled in Note that update is *not* automatic, but you can manually call {@link: update_enrolled_courses_cache_from_db()}. After construction, it will always be a numeric array of integers (but may be empty) Each element will be a course ID (integer).</p></p>
  340. <ul class="tags">
  341. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$moodle_user_cache">SloodleUser::$moodle_user_cache</a></li>
  342. <li><span class="field">access:</span> public</li>
  343. </ul>
  344. </div>
  345. <a name="var$moodle_user_cache" id="$moodle_user_cache"><!-- --></A>
  346. <div class="evenrow">
  347. <div class="var-header">
  348. <img src="../media/images/Variable.png" />
  349. <span class="var-title">
  350. <span class="var-type">object</span>
  351. <span class="var-name">$moodle_user_cache</span>
  352. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a86">86</a></span>)
  353. </span>
  354. </div>
  355. <!-- ========== Info from phpDoc block ========= -->
  356. <p class="short-description">Moodle user data cache.</p>
  357. <p class="description"><p>Used by various functions fetching database data about a Moodle user. Contents can also be used in subsequent function calls to prevent the need for an additional database query (typically by specifying a $use_cache parameter). Update is *not* automatic. It can be updated manually by calling {@link: update_moodle_user_cache_from_db()}. Unlike the Sloodle equivalent, this cannot be used to update the database After construction, it will always be an object.</p></p>
  358. <ul class="tags">
  359. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$enrolled_courses_cache">SloodleUser::$enrolled_courses_cache</a></li>
  360. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$sloodle_user_cache">SloodleUser::$sloodle_user_cache</a></li>
  361. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$moodle_user_id">SloodleUser::$moodle_user_id</a></li>
  362. <li><span class="field">access:</span> public</li>
  363. </ul>
  364. </div>
  365. <a name="var$moodle_user_id" id="$moodle_user_id"><!-- --></A>
  366. <div class="oddrow">
  367. <div class="var-header">
  368. <img src="../media/images/PrivateVariable.png" />
  369. <span class="var-title">
  370. <span class="var-type">int</span>
  371. <span class="var-name">$moodle_user_id</span>
  372. = <span class="var-default"> 0</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a52">52</a></span>)
  373. </span>
  374. </div>
  375. <!-- ========== Info from phpDoc block ========= -->
  376. <p class="short-description">Integer ID of a Moodle user entry in the database.</p>
  377. <p class="description"><p>Value 0 represents no user.</p></p>
  378. <ul class="tags">
  379. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$sloodle_user_id">SloodleUser::$sloodle_user_id</a></li>
  380. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$moodle_user_cache">SloodleUser::$moodle_user_cache</a></li>
  381. <li><span class="field">access:</span> private</li>
  382. </ul>
  383. </div>
  384. <a name="var$sloodle_user_cache" id="$sloodle_user_cache"><!-- --></A>
  385. <div class="evenrow">
  386. <div class="var-header">
  387. <img src="../media/images/Variable.png" />
  388. <span class="var-title">
  389. <span class="var-type">object</span>
  390. <span class="var-name">$sloodle_user_cache</span>
  391. = <span class="var-default"> NULL</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a70">70</a></span>)
  392. </span>
  393. </div>
  394. <!-- ========== Info from phpDoc block ========= -->
  395. <p class="short-description">Sloodle user data cache.</p>
  396. <p class="description"><p>Used by various functions fetching database data about a Sloodle user. Contents can also be used in subsequent function calls to prevent the need for an additional database query (typically by specifying a $use_cache parameter). Update is *not* automatic. It can be updated manually by calling {@link: update_sloodle_user_cache_from_db()}. Data placed here can also be used to edit the database using {@link: insert_sloodle_user_cache_to_db()} or {@link: update_sloodle_user_cache_to_db()}. After construction, it will always be an object.</p></p>
  397. <ul class="tags">
  398. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$moodle_user_cache">SloodleUser::$moodle_user_cache</a></li>
  399. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$sloodle_user_id">SloodleUser::$sloodle_user_id</a></li>
  400. <li><span class="field">access:</span> public</li>
  401. </ul>
  402. </div>
  403. <a name="var$sloodle_user_id" id="$sloodle_user_id"><!-- --></A>
  404. <div class="oddrow">
  405. <div class="var-header">
  406. <img src="../media/images/PrivateVariable.png" />
  407. <span class="var-title">
  408. <span class="var-type">int</span>
  409. <span class="var-name">$sloodle_user_id</span>
  410. = <span class="var-default"> 0</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a42">42</a></span>)
  411. </span>
  412. </div>
  413. <!-- ========== Info from phpDoc block ========= -->
  414. <p class="short-description">Integer ID of a Sloodle user entry in the database.</p>
  415. <p class="description"><p>Value 0 represents no user.</p></p>
  416. <ul class="tags">
  417. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$moodle_user_id">SloodleUser::$moodle_user_id</a></li>
  418. <li><span class="field">see:</span> <a href="../sloodle/SloodleUser.html#var$sloodle_user_cache">SloodleUser::$sloodle_user_cache</a></li>
  419. <li><span class="field">access:</span> private</li>
  420. </ul>
  421. </div>
  422. </div>
  423. </div>
  424. <a name="sec-methods"></a>
  425. <div class="info-box">
  426. <div class="info-box-title">Methods</div>
  427. <div class="nav-bar">
  428. <a href="#sec-description">Description</a> |
  429. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  430. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  431. </div>
  432. <div class="info-box-body">
  433. <A NAME='method_detail'></A>
  434. <a name="methodSloodleUser" id="SloodleUser"><!-- --></a>
  435. <div class="evenrow">
  436. <div class="method-header">
  437. <img src="../media/images/Constructor.png" />
  438. <span class="method-title">Constructor SloodleUser</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a109">109</a></span>)
  439. </div>
  440. <!-- ========== Info from phpDoc block ========= -->
  441. <p class="short-description">Class constructor.</p>
  442. <ul class="tags">
  443. <li><span class="field">access:</span> public</li>
  444. </ul>
  445. <div class="method-signature">
  446. <span class="method-result">void</span>
  447. <span class="method-name">
  448. SloodleUser
  449. </span>
  450. ()
  451. </div>
  452. </div>
  453. <a name="methodcreate_moodle_user" id="create_moodle_user"><!-- --></a>
  454. <div class="oddrow">
  455. <div class="method-header">
  456. <img src="../media/images/Method.png" />
  457. <span class="method-title">create_moodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a453">453</a></span>)
  458. </div>
  459. <!-- ========== Info from phpDoc block ========= -->
  460. <p class="short-description">Create a Moodle user account with the specified first name, last name and email address.</p>
  461. <ul class="tags">
  462. <li><span class="field">return:</span> True if successful, or a string error message if something goes wrong.</li>
  463. <li><span class="field">access:</span> public</li>
  464. </ul>
  465. <div class="method-signature">
  466. <span class="method-result">mixed</span>
  467. <span class="method-name">
  468. create_moodle_user
  469. </span>
  470. (<span class="var-type"></span>&nbsp;<span class="var-name">$firstname</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$lastname</span>, <span class="var-type"></span>&nbsp;<span class="var-name">$email</span>)
  471. </div>
  472. <ul class="parameters">
  473. <li>
  474. <span class="var-type"></span>
  475. <span class="var-name">$firstname</span> </li>
  476. <li>
  477. <span class="var-type"></span>
  478. <span class="var-name">$lastname</span> </li>
  479. <li>
  480. <span class="var-type"></span>
  481. <span class="var-name">$email</span> </li>
  482. </ul>
  483. </div>
  484. <a name="methodcreate_sloodle_user" id="create_sloodle_user"><!-- --></a>
  485. <div class="evenrow">
  486. <div class="method-header">
  487. <img src="../media/images/Method.png" />
  488. <span class="method-title">create_sloodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a347">347</a></span>)
  489. </div>
  490. <!-- ========== Info from phpDoc block ========= -->
  491. <p class="short-description">Create a new Sloodle user.</p>
  492. <p class="description"><p>All parameters are optional. To enable loginzone authentication, you *must* specify position and expiry time. Note that, if no login security token is specified, it is generated automatically. If successful, the new ID is stored and the user data is cached.</p></p>
  493. <ul class="tags">
  494. <li><span class="field">return:</span> True if successful, or false if not.</li>
  495. <li><span class="field">access:</span> public</li>
  496. </ul>
  497. <div class="method-signature">
  498. <span class="method-result">bool</span>
  499. <span class="method-name">
  500. create_sloodle_user
  501. </span>
  502. ([<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$avname</span> = <span class="var-default">''</span>], [<span class="var-type">int</span>&nbsp;<span class="var-name">$userid</span> = <span class="var-default">0</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginposition</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginpositionexpires</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginpositionregion</span> = <span class="var-default">''</span>], [<span class="var-type">string</span>&nbsp;<span class="var-name">$loginsecuritytoken</span> = <span class="var-default">''</span>])
  503. </div>
  504. <ul class="parameters">
  505. <li>
  506. <span class="var-type">string</span>
  507. <span class="var-name">$uuid</span><span class="var-description">: avatar UUID</span> </li>
  508. <li>
  509. <span class="var-type">string</span>
  510. <span class="var-name">$avname</span><span class="var-description">: avatar name</span> </li>
  511. <li>
  512. <span class="var-type">int</span>
  513. <span class="var-name">$userid</span><span class="var-description">: ID of Moodle user to be linked with this Sloodle user</span> </li>
  514. <li>
  515. <span class="var-type">string</span>
  516. <span class="var-name">$loginposition</span><span class="var-description">: a position vector of format &lt;x,y,z&gt;, representing the allocated loginzone position</span> </li>
  517. <li>
  518. <span class="var-type">string</span>
  519. <span class="var-name">$loginpositionexpires</span><span class="var-description">: an indication of when the allocated loginposition expires (format unknown)</span> </li>
  520. <li>
  521. <span class="var-type">string</span>
  522. <span class="var-name">$loginpositionregion</span><span class="var-description">: the name of the region in which the loginzone is (NOT IN USE YET!)</span> </li>
  523. <li>
  524. <span class="var-type">string</span>
  525. <span class="var-name">$loginsecuritytoken</span><span class="var-description">: a security token (random letters/numbers) used to allow secure authentication</span> </li>
  526. </ul>
  527. </div>
  528. <a name="methoddelete_login_position" id="delete_login_position"><!-- --></a>
  529. <div class="oddrow">
  530. <div class="method-header">
  531. <img src="../media/images/Method.png" />
  532. <span class="method-title">delete_login_position</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a379">379</a></span>)
  533. </div>
  534. <!-- ========== Info from phpDoc block ========= -->
  535. <p class="short-description">Clears the login position from the currently selected Sloodle user.</p>
  536. <p class="description"><p>This function will user the user identified by {@link:$sloodle_user_id}, retrieve all the user data, remove the login position values, and update the database.</p></p>
  537. <ul class="tags">
  538. <li><span class="field">return:</span> True if successful, false if the database query fails, or a string if an error occurs.</li>
  539. <li><span class="field">access:</span> public</li>
  540. </ul>
  541. <div class="method-signature">
  542. <span class="method-result">mixed</span>
  543. <span class="method-name">
  544. delete_login_position
  545. </span>
  546. ()
  547. </div>
  548. </div>
  549. <a name="methoddelete_sloodle_user" id="delete_sloodle_user"><!-- --></a>
  550. <div class="evenrow">
  551. <div class="method-header">
  552. <img src="../media/images/Method.png" />
  553. <span class="method-title">delete_sloodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a243">243</a></span>)
  554. </div>
  555. <!-- ========== Info from phpDoc block ========= -->
  556. <p class="short-description">Deletes the Sloodle user identified by {@link:$sloodle_user_id}.</p>
  557. <ul class="tags">
  558. <li><span class="field">return:</span> True if successful, false on failure, or a string error message if something goes wrong</li>
  559. <li><span class="field">access:</span> public</li>
  560. </ul>
  561. <div class="method-signature">
  562. <span class="method-result">mixed</span>
  563. <span class="method-name">
  564. delete_sloodle_user
  565. </span>
  566. ()
  567. </div>
  568. </div>
  569. <a name="methodfind_linked_moodle_user" id="find_linked_moodle_user"><!-- --></a>
  570. <div class="oddrow">
  571. <div class="method-header">
  572. <img src="../media/images/Method.png" />
  573. <span class="method-title">find_linked_moodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a611">611</a></span>)
  574. </div>
  575. <!-- ========== Info from phpDoc block ========= -->
  576. <p class="short-description">Find the Moodle user linked to the current Sloodle user.</p>
  577. <p class="description"><p>Stores the Moodle user ID in {@link:$moodle_user_id}.</p></p>
  578. <ul class="tags">
  579. <li><span class="field">return:</span> True if successful, false if no link was found, or a string if an error occurs</li>
  580. <li><span class="field">access:</span> public</li>
  581. </ul>
  582. <div class="method-signature">
  583. <span class="method-result">mixed</span>
  584. <span class="method-name">
  585. find_linked_moodle_user
  586. </span>
  587. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>], [<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  588. </div>
  589. <ul class="parameters">
  590. <li>
  591. <span class="var-type">bool</span>
  592. <span class="var-name">$use_cache</span><span class="var-description">: If true (not default) this function will use the local Sloodle user cache instead of querying the database again.</span> </li>
  593. <li>
  594. <span class="var-type">bool</span>
  595. <span class="var-name">$cache_data</span><span class="var-description">: If true (default) then the Moodle user data is automatically cached by this function</span> </li>
  596. </ul>
  597. </div>
  598. <a name="methodfind_linked_sloodle_user" id="find_linked_sloodle_user"><!-- --></a>
  599. <div class="evenrow">
  600. <div class="method-header">
  601. <img src="../media/images/Method.png" />
  602. <span class="method-title">find_linked_sloodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a579">579</a></span>)
  603. </div>
  604. <!-- ========== Info from phpDoc block ========= -->
  605. <p class="short-description">Find the Sloodle user linked to the current Moodle user.</p>
  606. <p class="description"><p>Stores the Sloodle user ID in {@link:$sloodle_user_id}.</p></p>
  607. <ul class="tags">
  608. <li><span class="field">return:</span> True if successful, false if no link was found, or a string if an error occurs</li>
  609. <li><span class="field">access:</span> public</li>
  610. </ul>
  611. <div class="method-signature">
  612. <span class="method-result">mixed</span>
  613. <span class="method-name">
  614. find_linked_sloodle_user
  615. </span>
  616. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  617. </div>
  618. <ul class="parameters">
  619. <li>
  620. <span class="var-type">bool</span>
  621. <span class="var-name">$cache_data</span><span class="var-description">: If true (default) then the Sloodle user data is automatically cached by this function.</span> </li>
  622. </ul>
  623. </div>
  624. <a name="methodfind_sloodle_user" id="find_sloodle_user"><!-- --></a>
  625. <div class="oddrow">
  626. <div class="method-header">
  627. <img src="../media/images/Method.png" />
  628. <span class="method-title">find_sloodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a548">548</a></span>)
  629. </div>
  630. <!-- ========== Info from phpDoc block ========= -->
  631. <p class="short-description">Attempts to find a Sloodle user by their UUID and/or avatar nam.</p>
  632. <p class="description"><p>Note: the UUID takes precedence, but the name can be used as a fall-back. The ID of the user is stored in {@link:$sloodle_user_id}.</p></p>
  633. <ul class="tags">
  634. <li><span class="field">return:</span> True if successful, false if user was not found, or a string is some other error occurred.</li>
  635. <li><span class="field">access:</span> public</li>
  636. </ul>
  637. <div class="method-signature">
  638. <span class="method-result">mixed</span>
  639. <span class="method-name">
  640. find_sloodle_user
  641. </span>
  642. (<span class="var-type">string</span>&nbsp;<span class="var-name">$uuid</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$name</span>, [<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  643. </div>
  644. <ul class="parameters">
  645. <li>
  646. <span class="var-type">string</span>
  647. <span class="var-name">$uuid</span><span class="var-description">: The UUID of the avatar</span> </li>
  648. <li>
  649. <span class="var-type">string</span>
  650. <span class="var-name">$name</span><span class="var-description">: The name of the avatar</span> </li>
  651. <li>
  652. <span class="var-type">bool</span>
  653. <span class="var-name">$cache_data</span><span class="var-description">: If true (default) then the user data is stored in the cache variable, {@link:$sloodle_user_cache}.</span> </li>
  654. </ul>
  655. </div>
  656. <a name="methodfind_sloodle_user_by_login_position" id="find_sloodle_user_by_login_position"><!-- --></a>
  657. <div class="evenrow">
  658. <div class="method-header">
  659. <img src="../media/images/Method.png" />
  660. <span class="method-title">find_sloodle_user_by_login_position</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a660">660</a></span>)
  661. </div>
  662. <!-- ========== Info from phpDoc block ========= -->
  663. <p class="short-description">Attempt to find a Sloodle user by their loginzone position If successful, the user ID is stored in {@link:$sloodle_user_id} and the function returns true.</p>
  664. <p class="description"><p>If no user was found for the given position, false is returned (this may occur if the LoginZone position has expired). If an error occurs, then a string containing an error message is returned.</p></p>
  665. <ul class="tags">
  666. <li><span class="field">access:</span> public</li>
  667. </ul>
  668. <div class="method-signature">
  669. <span class="method-result">void</span>
  670. <span class="method-name">
  671. find_sloodle_user_by_login_position
  672. </span>
  673. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$position</span>, [<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  674. </div>
  675. <ul class="parameters">
  676. <li>
  677. <span class="var-type">mixed</span>
  678. <span class="var-name">$position</span><span class="var-description">: A vector, either as a string (&quot;&lt;x,y,z&gt;&quot;) or an associative array.</span> </li>
  679. <li>
  680. <span class="var-type">bool</span>
  681. <span class="var-name">$cache_data</span><span class="var-description">: If true (default) then the user data is cached. Otherwise it is discarded.</span> </li>
  682. </ul>
  683. </div>
  684. <a name="methodgenerate_login_position" id="generate_login_position"><!-- --></a>
  685. <div class="oddrow">
  686. <div class="method-header">
  687. <img src="../media/images/Method.png" />
  688. <span class="method-title">generate_login_position</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a402">402</a></span>)
  689. </div>
  690. <!-- ========== Info from phpDoc block ========= -->
  691. <p class="short-description">Generates a new login position for the current Sloodle user.</p>
  692. <p class="description"><p>Stores the new login position in the database, and refreshes the user cache</p></p>
  693. <ul class="tags">
  694. <li><span class="field">return:</span> A numerical array containing the new position if successful, FALSE on failure, or a string if an error occurs</li>
  695. <li><span class="field">access:</span> public</li>
  696. </ul>
  697. <div class="method-signature">
  698. <span class="method-result">mixed</span>
  699. <span class="method-name">
  700. generate_login_position
  701. </span>
  702. (<span class="var-type">int</span>&nbsp;<span class="var-name">$expires</span>)
  703. </div>
  704. <ul class="parameters">
  705. <li>
  706. <span class="var-type">int</span>
  707. <span class="var-name">$expires</span><span class="var-description">: A timestamp indicating when the position should expire.</span> </li>
  708. </ul>
  709. </div>
  710. <a name="methodget_moodle_user_id" id="get_moodle_user_id"><!-- --></a>
  711. <div class="evenrow">
  712. <div class="method-header">
  713. <img src="../media/images/Method.png" />
  714. <span class="method-title">get_moodle_user_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a146">146</a></span>)
  715. </div>
  716. <!-- ========== Info from phpDoc block ========= -->
  717. <p class="short-description">Accessor: gets the Moodle user ID member, {@link: $moodle_user_id}.</p>
  718. <ul class="tags">
  719. <li><span class="field">access:</span> public</li>
  720. </ul>
  721. <div class="method-signature">
  722. <span class="method-result">int</span>
  723. <span class="method-name">
  724. get_moodle_user_id
  725. </span>
  726. ()
  727. </div>
  728. </div>
  729. <a name="methodget_sloodle_user_id" id="get_sloodle_user_id"><!-- --></a>
  730. <div class="oddrow">
  731. <div class="method-header">
  732. <img src="../media/images/Method.png" />
  733. <span class="method-title">get_sloodle_user_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a125">125</a></span>)
  734. </div>
  735. <!-- ========== Info from phpDoc block ========= -->
  736. <p class="short-description">Accessor: gets the Sloodle user ID member, {@link: $sloodle_user_id}.</p>
  737. <ul class="tags">
  738. <li><span class="field">access:</span> public</li>
  739. </ul>
  740. <div class="method-signature">
  741. <span class="method-result">int</span>
  742. <span class="method-name">
  743. get_sloodle_user_id
  744. </span>
  745. ()
  746. </div>
  747. </div>
  748. <a name="methodhas_login_security_token" id="has_login_security_token"><!-- --></a>
  749. <div class="evenrow">
  750. <div class="method-header">
  751. <img src="../media/images/Method.png" />
  752. <span class="method-title">has_login_security_token</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a770">770</a></span>)
  753. </div>
  754. <!-- ========== Info from phpDoc block ========= -->
  755. <p class="short-description">Checks if the current Sloodle user has a login security token</p>
  756. <ul class="tags">
  757. <li><span class="field">return:</span> True if the user has a login security token, or false otherwise.</li>
  758. <li><span class="field">access:</span> public</li>
  759. </ul>
  760. <div class="method-signature">
  761. <span class="method-result">bool</span>
  762. <span class="method-name">
  763. has_login_security_token
  764. </span>
  765. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>])
  766. </div>
  767. <ul class="parameters">
  768. <li>
  769. <span class="var-type">bool</span>
  770. <span class="var-name">$use_cache</span><span class="var-description">: If true then the cached user data will be used instead of querying the database.</span> </li>
  771. </ul>
  772. </div>
  773. <a name="methodinsert_sloodle_user_cache_to_db" id="insert_sloodle_user_cache_to_db"><!-- --></a>
  774. <div class="oddrow">
  775. <div class="method-header">
  776. <img src="../media/images/Method.png" />
  777. <span class="method-title">insert_sloodle_user_cache_to_db</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a317">317</a></span>)
  778. </div>
  779. <!-- ========== Info from phpDoc block ========= -->
  780. <p class="short-description">Use the Sloodle user cache to insert a new entry in the Sloodle user database table.</p>
  781. <p class="description"><p>Uses the object entirely as-is, except that the 'id' field is ignored. The ID of the new entry is stored in {@link:$sloodle_user_id}.</p></p>
  782. <ul class="tags">
  783. <li><span class="field">return:</span> True if successful, or false on failure.</li>
  784. <li><span class="field">access:</span> public</li>
  785. </ul>
  786. <div class="method-signature">
  787. <span class="method-result">bool</span>
  788. <span class="method-name">
  789. insert_sloodle_user_cache_to_db
  790. </span>
  791. ()
  792. </div>
  793. </div>
  794. <a name="methodis_user_in_course" id="is_user_in_course"><!-- --></a>
  795. <div class="evenrow">
  796. <div class="method-header">
  797. <img src="../media/images/Method.png" />
  798. <span class="method-title">is_user_in_course</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a831">831</a></span>)
  799. </div>
  800. <!-- ========== Info from phpDoc block ========= -->
  801. <p class="short-description">Checks if the current Moodle user is already enrolled in the specified course.</p>
  802. <ul class="tags">
  803. <li><span class="field">access:</span> public</li>
  804. </ul>
  805. <div class="method-signature">
  806. <span class="method-result">void</span>
  807. <span class="method-name">
  808. is_user_in_course
  809. </span>
  810. (<span class="var-type">int</span>&nbsp;<span class="var-name">$course_id</span>, [<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>], <span class="var-type">bool</span>&nbsp;<span class="var-name">2</span>)
  811. </div>
  812. <ul class="parameters">
  813. <li>
  814. <span class="var-type">int</span>
  815. <span class="var-name">$course_id</span><span class="var-description">: ID number of a course to check.</span> </li>
  816. <li>
  817. <span class="var-type">bool</span>
  818. <span class="var-name">$use_cache</span><span class="var-description">: If true (not default) then the function uses the enrolled courses cache, instead of querying the database for new data.</span> </li>
  819. <li>
  820. <span class="var-type">bool</span>
  821. <span class="var-name">2</span><span class="var-description">: True if the user is enrolled, or false if not.</span> </li>
  822. </ul>
  823. </div>
  824. <a name="methodlink_users" id="link_users"><!-- --></a>
  825. <div class="oddrow">
  826. <div class="method-header">
  827. <img src="../media/images/Method.png" />
  828. <span class="method-title">link_users</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a200">200</a></span>)
  829. </div>
  830. <!-- ========== Info from phpDoc block ========= -->
  831. <p class="short-description">Links the current Sloodle and Moodle accounts together.</p>
  832. <p class="description"><p><strong>NOTE:</strong> does not remove any other links to the Moodle account.</p></p>
  833. <ul class="tags">
  834. <li><span class="field">return:</span> True if successful, false on failure, or a string error message if something goes wrong</li>
  835. <li><span class="field">access:</span> public</li>
  836. </ul>
  837. <div class="method-signature">
  838. <span class="method-result">mixed</span>
  839. <span class="method-name">
  840. link_users
  841. </span>
  842. ()
  843. </div>
  844. </div>
  845. <a name="methodlogin_moodle_user" id="login_moodle_user"><!-- --></a>
  846. <div class="evenrow">
  847. <div class="method-header">
  848. <img src="../media/images/Method.png" />
  849. <span class="method-title">login_moodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a728">728</a></span>)
  850. </div>
  851. <!-- ========== Info from phpDoc block ========= -->
  852. <p class="short-description">Performs an internal login of the current Moodle user.</p>
  853. <p class="description"><p>Stores all the user data in the global $USER variable. Note: if login fails, $USER is unchanged. Additionally, note that this function will not perform automatic registration.</p></p>
  854. <ul class="tags">
  855. <li><span class="field">return:</span> True if successful, or false otherwise.</li>
  856. <li><span class="field">access:</span> public</li>
  857. </ul>
  858. <div class="method-signature">
  859. <span class="method-result">bool</span>
  860. <span class="method-name">
  861. login_moodle_user
  862. </span>
  863. ()
  864. </div>
  865. </div>
  866. <a name="methodregenerate_login_security_token" id="regenerate_login_security_token"><!-- --></a>
  867. <div class="oddrow">
  868. <div class="method-header">
  869. <img src="../media/images/Method.png" />
  870. <span class="method-title">regenerate_login_security_token</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a747">747</a></span>)
  871. </div>
  872. <!-- ========== Info from phpDoc block ========= -->
  873. <p class="short-description">Generates a new login security token for the current Sloodle user</p>
  874. <ul class="tags">
  875. <li><span class="field">return:</span> True if successful, or false if an error occurs (such as there being no current Sloodle user)</li>
  876. <li><span class="field">access:</span> public</li>
  877. </ul>
  878. <div class="method-signature">
  879. <span class="method-result">bool</span>
  880. <span class="method-name">
  881. regenerate_login_security_token
  882. </span>
  883. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$cache_data</span> = <span class="var-default">TRUE</span>])
  884. </div>
  885. <ul class="parameters">
  886. <li>
  887. <span class="var-type">bool</span>
  888. <span class="var-name">$cache_data</span><span class="var-description">: If true (default) then the new login security token will be stored in the Sloodle user cache (as well as the database).</span> </li>
  889. </ul>
  890. </div>
  891. <a name="methodset_moodle_user_id" id="set_moodle_user_id"><!-- --></a>
  892. <div class="evenrow">
  893. <div class="method-header">
  894. <img src="../media/images/Method.png" />
  895. <span class="method-title">set_moodle_user_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a157">157</a></span>)
  896. </div>
  897. <!-- ========== Info from phpDoc block ========= -->
  898. <p class="short-description">Accessor: sets the Moodle user ID member, {@link: $moodle_user_id}.</p>
  899. <ul class="tags">
  900. <li><span class="field">access:</span> public</li>
  901. </ul>
  902. <div class="method-signature">
  903. <span class="method-result">void</span>
  904. <span class="method-name">
  905. set_moodle_user_id
  906. </span>
  907. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>)
  908. </div>
  909. <ul class="parameters">
  910. <li>
  911. <span class="var-type">int</span>
  912. <span class="var-name">$id</span><span class="var-description">: The integer ID of a Moodle user entry (or 0 for no entry).</span> </li>
  913. </ul>
  914. </div>
  915. <a name="methodset_sloodle_user_id" id="set_sloodle_user_id"><!-- --></a>
  916. <div class="oddrow">
  917. <div class="method-header">
  918. <img src="../media/images/Method.png" />
  919. <span class="method-title">set_sloodle_user_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a136">136</a></span>)
  920. </div>
  921. <!-- ========== Info from phpDoc block ========= -->
  922. <p class="short-description">Accessor: sets the Sloodle user ID member, {@link: $sloodle_user_id}.</p>
  923. <ul class="tags">
  924. <li><span class="field">access:</span> public</li>
  925. </ul>
  926. <div class="method-signature">
  927. <span class="method-result">void</span>
  928. <span class="method-name">
  929. set_sloodle_user_id
  930. </span>
  931. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>)
  932. </div>
  933. <ul class="parameters">
  934. <li>
  935. <span class="var-type">int</span>
  936. <span class="var-name">$id</span><span class="var-description">: The integer ID of a Sloodle user entry (or 0 for no entry).</span> </li>
  937. </ul>
  938. </div>
  939. <a name="methodunlink_sloodle_user" id="unlink_sloodle_user"><!-- --></a>
  940. <div class="evenrow">
  941. <div class="method-header">
  942. <img src="../media/images/Method.png" />
  943. <span class="method-title">unlink_sloodle_user</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a221">221</a></span>)
  944. </div>
  945. <!-- ========== Info from phpDoc block ========= -->
  946. <p class="short-description">Completely unlinks the Sloodle user from any Moodle account.</p>
  947. <ul class="tags">
  948. <li><span class="field">return:</span> True if successful, false on failure, or a string error message if something goes wrong</li>
  949. <li><span class="field">access:</span> public</li>
  950. </ul>
  951. <div class="method-signature">
  952. <span class="method-result">mixed</span>
  953. <span class="method-name">
  954. unlink_sloodle_user
  955. </span>
  956. ()
  957. </div>
  958. </div>
  959. <a name="methodupdate_enrolled_courses_cache_from_db" id="update_enrolled_courses_cache_from_db"><!-- --></a>
  960. <div class="oddrow">
  961. <div class="method-header">
  962. <img src="../media/images/Method.png" />
  963. <span class="method-title">update_enrolled_courses_cache_from_db</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a801">801</a></span>)
  964. </div>
  965. <!-- ========== Info from phpDoc block ========= -->
  966. <p class="short-description">Use the database to update the cache of courses which the current Moodle user is enrolled in.</p>
  967. <p class="description"><p>Note that admins are considered by this function to be enrolled in all courses.</p></p>
  968. <ul class="tags">
  969. <li><span class="field">return:</span> if successul, or false otherwise.</li>
  970. <li><span class="field">access:</span> public</li>
  971. </ul>
  972. <div class="method-signature">
  973. <span class="method-result">True</span>
  974. <span class="method-name">
  975. update_enrolled_courses_cache_from_db
  976. </span>
  977. ()
  978. </div>
  979. </div>
  980. <a name="methodupdate_moodle_user_cache_from_db" id="update_moodle_user_cache_from_db"><!-- --></a>
  981. <div class="evenrow">
  982. <div class="method-header">
  983. <img src="../media/images/Method.png" />
  984. <span class="method-title">update_moodle_user_cache_from_db</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a273">273</a></span>)
  985. </div>
  986. <!-- ========== Info from phpDoc block ========= -->
  987. <p class="short-description">Update the Moodle user cache ({@link:$moodle_user_cache}) from the database</p>
  988. <ul class="tags">
  989. <li><span class="field">return:</span> True if successful, false on failure, or a string error message if something goes wrong</li>
  990. <li><span class="field">access:</span> public</li>
  991. </ul>
  992. <div class="method-signature">
  993. <span class="method-result">mixed</span>
  994. <span class="method-name">
  995. update_moodle_user_cache_from_db
  996. </span>
  997. ()
  998. </div>
  999. </div>
  1000. <a name="methodupdate_sloodle_user_cache_from_db" id="update_sloodle_user_cache_from_db"><!-- --></a>
  1001. <div class="oddrow">
  1002. <div class="method-header">
  1003. <img src="../media/images/Method.png" />
  1004. <span class="method-title">update_sloodle_user_cache_from_db</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a257">257</a></span>)
  1005. </div>
  1006. <!-- ========== Info from phpDoc block ========= -->
  1007. <p class="short-description">Updates the Sloodle user cache ({@link:$sloodle_user_cache}) from the database</p>
  1008. <ul class="tags">
  1009. <li><span class="field">return:</span> True if successful, false on failure, or a string error message if something goes wrong</li>
  1010. <li><span class="field">access:</span> public</li>
  1011. </ul>
  1012. <div class="method-signature">
  1013. <span class="method-result">mixed</span>
  1014. <span class="method-name">
  1015. update_sloodle_user_cache_from_db
  1016. </span>
  1017. ()
  1018. </div>
  1019. </div>
  1020. <a name="methodupdate_sloodle_user_cache_to_db" id="update_sloodle_user_cache_to_db"><!-- --></a>
  1021. <div class="evenrow">
  1022. <div class="method-header">
  1023. <img src="../media/images/Method.png" />
  1024. <span class="method-title">update_sloodle_user_cache_to_db</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a291">291</a></span>)
  1025. </div>
  1026. <!-- ========== Info from phpDoc block ========= -->
  1027. <p class="short-description">Use the Sloodle user cache to update an entry in the Sloodle users database table.</p>
  1028. <p class="description"><p>Uses the object-entirely as-is, so the 'id' field must be accurate. Ignores anu unset fields.</p></p>
  1029. <ul class="tags">
  1030. <li><span class="field">return:</span> True if successful, false if the query fails, or a string error message if something goes wrong</li>
  1031. <li><span class="field">access:</span> public</li>
  1032. </ul>
  1033. <div class="method-signature">
  1034. <span class="method-result">mixed</span>
  1035. <span class="method-name">
  1036. update_sloodle_user_cache_to_db
  1037. </span>
  1038. ()
  1039. </div>
  1040. </div>
  1041. <a name="methodusers_linked" id="users_linked"><!-- --></a>
  1042. <div class="oddrow">
  1043. <div class="method-header">
  1044. <img src="../media/images/Method.png" />
  1045. <span class="method-title">users_linked</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_userlib.php.html#a171">171</a></span>)
  1046. </div>
  1047. <!-- ========== Info from phpDoc block ========= -->
  1048. <p class="short-description">Determines whether or not the current Sloodle and Moodle users are linked.</p>
  1049. <ul class="tags">
  1050. <li><span class="field">return:</span> Ture if users are linked, false if not, or a string error message if something goes wrong.</li>
  1051. <li><span class="field">access:</span> public</li>
  1052. </ul>
  1053. <div class="method-signature">
  1054. <span class="method-result">mixed</span>
  1055. <span class="method-name">
  1056. users_linked
  1057. </span>
  1058. ([<span class="var-type">bool</span>&nbsp;<span class="var-name">$use_cache</span> = <span class="var-default">FALSE</span>])
  1059. </div>
  1060. <ul class="parameters">
  1061. <li>
  1062. <span class="var-type">bool</span>
  1063. <span class="var-name">$use_cache</span><span class="var-description">: If true (not default) then the Sloodle and Moodle user caches ({@link:$sloodle_user_cache} and {@link:$moodle_user_cache})will be used instead of querying the database.</span> </li>
  1064. </ul>
  1065. </div>
  1066. </div>
  1067. </div>
  1068. <p class="notes" id="credit">
  1069. Documentation generated on Tue, 04 Mar 2008 15:08:56 +0000 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  1070. </p>
  1071. </div></body>
  1072. </html>