_lib---sl_generallib.php.html 47 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063
  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 page sl_generallib.php</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="file-name"><img src="../media/images/Page_logo.png" alt="File" style="vertical-align: middle">/lib/sl_generallib.php</h2>
  85. <a name="sec-description"></a>
  86. <div class="info-box">
  87. <div class="info-box-title">Description</div>
  88. <div class="nav-bar">
  89. <span class="disabled">Description</span> |
  90. <a href="#sec-includes">Includes</a>
  91. | <a href="#sec-functions">Functions</a>
  92. </div>
  93. <div class="info-box-body">
  94. <!-- ========== Info from phpDoc block ========= -->
  95. <p class="short-description">Sloodle general library.</p>
  96. <p class="description"><p>Provides various utility functionality for general Sloodle purposes.</p></p>
  97. <ul class="tags">
  98. <li><span class="field">copyright:</span> Copyright (c) 2007-8 Sloodle (various contributors)</li>
  99. <li><span class="field">contributor:</span> Edmund Edgar</li>
  100. <li><span class="field">contributor:</span> Peter R. Bloomfield</li>
  101. <li><span class="field">filesource:</span> <a href="../__filesource/fsource_sloodle__libsl_generallib.php.html">Source Code for this file</a></li>
  102. <li><span class="field">license:</span> <a href="http://www.gnu.org/licenses/gpl-3.0.html">GNU GPL v3</a></li>
  103. </ul>
  104. </div>
  105. </div>
  106. <a name="sec-includes"></a>
  107. <div class="info-box">
  108. <div class="info-box-title">Includes</div>
  109. <div class="nav-bar">
  110. <a href="#sec-description">Description</a> |
  111. <span class="disabled">Includes</span>
  112. | <a href="#sec-functions">Functions</a>
  113. </div>
  114. <div class="info-box-body">
  115. <a name="_SLOODLE_DIRROOT_/lib/sl_iolib_php"><!-- --></a>
  116. <div class="evenrow">
  117. <div>
  118. <img src="../media/images/Page.png" alt=" " />
  119. <span class="include-title">
  120. <span class="include-type">require_once</span>
  121. (<span class="include-name">SLOODLE_DIRROOT.'/lib/sl_iolib.php'</span>)
  122. (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a22">22</a></span>)
  123. </span>
  124. </div>
  125. <!-- ========== Info from phpDoc block ========= -->
  126. <p class="short-description">Include the IO library.</p>
  127. </div>
  128. </div>
  129. </div>
  130. <a name="sec-functions"></a>
  131. <div class="info-box">
  132. <div class="info-box-title">Functions</div>
  133. <div class="nav-bar">
  134. <a href="#sec-description">Description</a> |
  135. <a href="#sec-includes">Includes</a>
  136. | <span class="disabled">Functions</span>
  137. </div>
  138. <div class="info-box-body">
  139. <a name="functionsloodle_add_to_log" id="functionsloodle_add_to_log"><!-- --></a>
  140. <div class="oddrow">
  141. <div>
  142. <img src="../media/images/Function.png" />
  143. <span class="method-title">sloodle_add_to_log</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a295">295</a></span>)
  144. </div>
  145. <!-- ========== Info from phpDoc block ========= -->
  146. <p class="short-description">Old logging function</p>
  147. <ul class="tags">
  148. <li><span class="field">todo:</span> <strong>May require update?</strong></li>
  149. </ul>
  150. <div class="method-signature">
  151. <span class="method-result">void</span>
  152. <span class="method-name">
  153. sloodle_add_to_log
  154. </span>
  155. ([<span class="var-type"></span>&nbsp;<span class="var-name">$courseid</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$module</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$action</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$url</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$cmid</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$info</span> = <span class="var-default">null</span>])
  156. </div>
  157. <ul class="parameters">
  158. <li>
  159. <span class="var-type"></span>
  160. <span class="var-name">$courseid</span> </li>
  161. <li>
  162. <span class="var-type"></span>
  163. <span class="var-name">$module</span> </li>
  164. <li>
  165. <span class="var-type"></span>
  166. <span class="var-name">$action</span> </li>
  167. <li>
  168. <span class="var-type"></span>
  169. <span class="var-name">$url</span> </li>
  170. <li>
  171. <span class="var-type"></span>
  172. <span class="var-name">$cmid</span> </li>
  173. <li>
  174. <span class="var-type"></span>
  175. <span class="var-name">$info</span> </li>
  176. </ul>
  177. </div>
  178. <a name="functionsloodle_array_to_vector" id="functionsloodle_array_to_vector"><!-- --></a>
  179. <div class="evenrow">
  180. <div>
  181. <img src="../media/images/Function.png" />
  182. <span class="method-title">sloodle_array_to_vector</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a420">420</a></span>)
  183. </div>
  184. <!-- ========== Info from phpDoc block ========= -->
  185. <p class="short-description">Converts an array vector to a string vector.</p>
  186. <p class="description"><p>Array vector should be associative, containing elements 'x', 'y', and 'z'. Converts to a string vector of format &quot;&lt;x,y,z&gt;&quot;.</p></p>
  187. <ul class="tags">
  188. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_round_vector">sloodle_round_vector()</a></li>
  189. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_vector_to_array">sloodle_vector_to_array()</a></li>
  190. </ul>
  191. <div class="method-signature">
  192. <span class="method-result">string</span>
  193. <span class="method-name">
  194. sloodle_array_to_vector
  195. </span>
  196. (<span class="var-type"></span>&nbsp;<span class="var-name">$arr</span>)
  197. </div>
  198. <ul class="parameters">
  199. <li>
  200. <span class="var-type"></span>
  201. <span class="var-name">$arr</span> </li>
  202. </ul>
  203. </div>
  204. <a name="functionsloodle_check_course_module_instance_type" id="functionsloodle_check_course_module_instance_type"><!-- --></a>
  205. <div class="oddrow">
  206. <div>
  207. <img src="../media/images/Function.png" />
  208. <span class="method-title">sloodle_check_course_module_instance_type</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a468">468</a></span>)
  209. </div>
  210. <!-- ========== Info from phpDoc block ========= -->
  211. <p class="short-description">Determines if the specified course module instance is of the named type.</p>
  212. <p class="description"><p>For example, this can check if a particular instance is a &quot;forum&quot; or a &quot;chat&quot;.</p></p>
  213. <ul class="tags">
  214. <li><span class="field">return:</span> True if the module is of the specified type, or false otherwise</li>
  215. </ul>
  216. <div class="method-signature">
  217. <span class="method-result">bool</span>
  218. <span class="method-name">
  219. sloodle_check_course_module_instance_type
  220. </span>
  221. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$module_name</span>)
  222. </div>
  223. <ul class="parameters">
  224. <li>
  225. <span class="var-type">int</span>
  226. <span class="var-name">$id</span><span class="var-description">: The integer ID of a course module instance</span> </li>
  227. <li>
  228. <span class="var-type">string</span>
  229. <span class="var-name">$module_name</span><span class="var-description">: Module type to check (must be the exact name of an installed module, e.g. 'sloodle' or 'quiz')</span> </li>
  230. </ul>
  231. </div>
  232. <a name="functionsloodle_finished_login_coordinates" id="functionsloodle_finished_login_coordinates"><!-- --></a>
  233. <div class="evenrow">
  234. <div>
  235. <img src="../media/images/Function.png" />
  236. <span class="method-title">sloodle_finished_login_coordinates</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a535">535</a></span>)
  237. </div>
  238. <!-- ========== Info from phpDoc block ========= -->
  239. <p class="short-description">Generates teleport coordinates for a user who has already finished the LoginZone process.</p>
  240. <ul class="tags">
  241. <li><span class="field">return:</span> An associated array vector</li>
  242. </ul>
  243. <div class="method-signature">
  244. <span class="method-result">array</span>
  245. <span class="method-name">
  246. sloodle_finished_login_coordinates
  247. </span>
  248. ()
  249. </div>
  250. </div>
  251. <a name="functionsloodle_get_auth_method" id="functionsloodle_get_auth_method"><!-- --></a>
  252. <div class="oddrow">
  253. <div>
  254. <img src="../media/images/Function.png" />
  255. <span class="method-title">sloodle_get_auth_method</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a133">133</a></span>)
  256. </div>
  257. <!-- ========== Info from phpDoc block ========= -->
  258. <p class="short-description">Gets the site-wide authentication from the configuration table.</p>
  259. <ul class="tags">
  260. <li><span class="field">return:</span> A string containing the authentication method, or FALSE if none has yet been specified</li>
  261. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  262. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_auth_method">sloodle_set_auth_method()</a></li>
  263. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_is_automatic_registration_on">sloodle_is_automatic_registration_on()</a></li>
  264. </ul>
  265. <div class="method-signature">
  266. <span class="method-result">mixed</span>
  267. <span class="method-name">
  268. sloodle_get_auth_method
  269. </span>
  270. ()
  271. </div>
  272. </div>
  273. <a name="functionsloodle_get_config" id="functionsloodle_get_config"><!-- --></a>
  274. <div class="evenrow">
  275. <div>
  276. <img src="../media/images/Function.png" />
  277. <span class="method-title">sloodle_get_config</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a56">56</a></span>)
  278. </div>
  279. <!-- ========== Info from phpDoc block ========= -->
  280. <p class="short-description">Gets a Sloodle configuration value from Moodle's &quot;config&quot; table.</p>
  281. <p class="description"><p>This function does not necessarily need to be used. All configuration data is available as named members of Moodle's $CFG global variable. <strong>NOTE:</strong> in Sloodle debug mode, this function will terminate the script with an error if the name is not prefixed with &quot;sloodle_&quot;.</p></p>
  282. <ul class="tags">
  283. <li><span class="field">return:</span> A string containing the configuration value, or false if the query failed (e.g. if the named value didn't exist)</li>
  284. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_config">sloodle_set_config()</a></li>
  285. </ul>
  286. <div class="method-signature">
  287. <span class="method-result">mixed</span>
  288. <span class="method-name">
  289. sloodle_get_config
  290. </span>
  291. (<span class="var-type">string</span>&nbsp;<span class="var-name">$name</span>)
  292. </div>
  293. <ul class="parameters">
  294. <li>
  295. <span class="var-type">string</span>
  296. <span class="var-name">$name</span><span class="var-description">: The name of the value to be stored (should be prefixed with &quot;sloodle_&quot;)</span> </li>
  297. </ul>
  298. </div>
  299. <a name="functionsloodle_get_course_module_instance" id="functionsloodle_get_course_module_instance"><!-- --></a>
  300. <div class="oddrow">
  301. <div>
  302. <img src="../media/images/Function.png" />
  303. <span class="method-title">sloodle_get_course_module_instance</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a431">431</a></span>)
  304. </div>
  305. <!-- ========== Info from phpDoc block ========= -->
  306. <p class="short-description">Obtains the identified course module instance database record.</p>
  307. <ul class="tags">
  308. <li><span class="field">return:</span> A database record if successful, or false if it could not be found</li>
  309. </ul>
  310. <div class="method-signature">
  311. <span class="method-result">mixed</span>
  312. <span class="method-name">
  313. sloodle_get_course_module_instance
  314. </span>
  315. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>)
  316. </div>
  317. <ul class="parameters">
  318. <li>
  319. <span class="var-type">int</span>
  320. <span class="var-name">$id</span><span class="var-description">: The integer ID of a course module instance</span> </li>
  321. </ul>
  322. </div>
  323. <a name="functionsloodle_get_distribution_list" id="functionsloodle_get_distribution_list"><!-- --></a>
  324. <div class="evenrow">
  325. <div>
  326. <img src="../media/images/Function.png" />
  327. <span class="method-title">sloodle_get_distribution_list</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a237">237</a></span>)
  328. </div>
  329. <!-- ========== Info from phpDoc block ========= -->
  330. <p class="short-description">Gets an array of the names of all objects in the Object Distributor.</p>
  331. <p class="description"><p><strong>NOTE:</strong> Stored in the Moodle configuration table as value &quot;sloodle_distrib_objects&quot;. Must be set manually as a pipe-delimited list, e.g. &quot;object1|object2|object3&quot;.</p></p>
  332. <ul class="tags">
  333. <li><span class="field">return:</span> A numeric array of strings (will be an empty array if no objects are available)</li>
  334. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  335. </ul>
  336. <div class="method-signature">
  337. <span class="method-result">array</span>
  338. <span class="method-name">
  339. sloodle_get_distribution_list
  340. </span>
  341. ()
  342. </div>
  343. </div>
  344. <a name="functionsloodle_get_loginzone_pos" id="functionsloodle_get_loginzone_pos"><!-- --></a>
  345. <div class="oddrow">
  346. <div>
  347. <img src="../media/images/Function.png" />
  348. <span class="method-title">sloodle_get_loginzone_pos</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a160">160</a></span>)
  349. </div>
  350. <!-- ========== Info from phpDoc block ========= -->
  351. <p class="short-description">Gets the position of the site-wide LoginZone object.</p>
  352. <ul class="tags">
  353. <li><span class="field">return:</span> A string containing the position of the LoginZone object (&quot;&lt;x,y,z&gt;&quot;), or FALSE if no LoginZone data has yet been stored</li>
  354. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  355. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_loginzone_pos">sloodle_set_loginzone_pos()</a></li>
  356. </ul>
  357. <div class="method-signature">
  358. <span class="method-result">mixed</span>
  359. <span class="method-name">
  360. sloodle_get_loginzone_pos
  361. </span>
  362. ()
  363. </div>
  364. </div>
  365. <a name="functionsloodle_get_loginzone_region" id="functionsloodle_get_loginzone_region"><!-- --></a>
  366. <div class="evenrow">
  367. <div>
  368. <img src="../media/images/Function.png" />
  369. <span class="method-title">sloodle_get_loginzone_region</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a212">212</a></span>)
  370. </div>
  371. <!-- ========== Info from phpDoc block ========= -->
  372. <p class="short-description">Gets the name of the region where the site-wide LoginZone object was most recently rezzed.</p>
  373. <ul class="tags">
  374. <li><span class="field">return:</span> A string containing the name of a region (e.g. &quot;virtuALBA&quot;), or FALSE if no LoginZone data has yet been stored</li>
  375. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  376. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_loginzone_region">sloodle_set_loginzone_region()</a></li>
  377. </ul>
  378. <div class="method-signature">
  379. <span class="method-result">mixed</span>
  380. <span class="method-name">
  381. sloodle_get_loginzone_region
  382. </span>
  383. ()
  384. </div>
  385. </div>
  386. <a name="functionsloodle_get_loginzone_size" id="functionsloodle_get_loginzone_size"><!-- --></a>
  387. <div class="oddrow">
  388. <div>
  389. <img src="../media/images/Function.png" />
  390. <span class="method-title">sloodle_get_loginzone_size</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a186">186</a></span>)
  391. </div>
  392. <!-- ========== Info from phpDoc block ========= -->
  393. <p class="short-description">Gets the size of the site-wide LoginZone object.</p>
  394. <ul class="tags">
  395. <li><span class="field">return:</span> A string containing the dimensions of the LoginZone object (&quot;&lt;x,y,z&gt;&quot;), or FALSE if no LoginZone data has yet been stored</li>
  396. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  397. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_loginzone_size">sloodle_set_loginzone_size()</a></li>
  398. </ul>
  399. <div class="method-signature">
  400. <span class="method-result">mixed</span>
  401. <span class="method-name">
  402. sloodle_get_loginzone_size
  403. </span>
  404. ()
  405. </div>
  406. </div>
  407. <a name="functionsloodle_get_module_id" id="functionsloodle_get_module_id"><!-- --></a>
  408. <div class="evenrow">
  409. <div>
  410. <img src="../media/images/Function.png" />
  411. <span class="method-title">sloodle_get_module_id</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a489">489</a></span>)
  412. </div>
  413. <!-- ========== Info from phpDoc block ========= -->
  414. <p class="short-description">Obtains the ID number of the specified module (type not instance).</p>
  415. <ul class="tags">
  416. <li><span class="field">return:</span> Integer containing module ID, or false if it is not installed</li>
  417. </ul>
  418. <div class="method-signature">
  419. <span class="method-result">mixed</span>
  420. <span class="method-name">
  421. sloodle_get_module_id
  422. </span>
  423. (<span class="var-type">string</span>&nbsp;<span class="var-name">$name</span>)
  424. </div>
  425. <ul class="parameters">
  426. <li>
  427. <span class="var-type">string</span>
  428. <span class="var-name">$name</span><span class="var-description">: The name of the module type to check, e.g. 'sloodle' or 'forum'</span> </li>
  429. </ul>
  430. </div>
  431. <a name="functionsloodle_get_prim_password" id="functionsloodle_get_prim_password"><!-- --></a>
  432. <div class="oddrow">
  433. <div>
  434. <img src="../media/images/Function.png" />
  435. <span class="method-title">sloodle_get_prim_password</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a78">78</a></span>)
  436. </div>
  437. <!-- ========== Info from phpDoc block ========= -->
  438. <p class="short-description">Gets the site-wide Sloodle prim password from the configuration table.</p>
  439. <ul class="tags">
  440. <li><span class="field">return:</span> A string containing the prim password, or FALSE if no password has yet been specified</li>
  441. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  442. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_prim_password">sloodle_set_prim_password()</a></li>
  443. </ul>
  444. <div class="method-signature">
  445. <span class="method-result">mixed</span>
  446. <span class="method-name">
  447. sloodle_get_prim_password
  448. </span>
  449. ()
  450. </div>
  451. </div>
  452. <a name="functionsloodle_is_automatic_registration_on" id="functionsloodle_is_automatic_registration_on"><!-- --></a>
  453. <div class="evenrow">
  454. <div>
  455. <img src="../media/images/Function.png" />
  456. <span class="method-title">sloodle_is_automatic_registration_on</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a118">118</a></span>)
  457. </div>
  458. <!-- ========== Info from phpDoc block ========= -->
  459. <p class="short-description">Determines whether or not automatic registration is enabled.</p>
  460. <ul class="tags">
  461. <li><span class="field">return:</span> True if automatic registration is enabled, or false otherwise.</li>
  462. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  463. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_auth_method">sloodle_set_auth_method()</a></li>
  464. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_auth_method">sloodle_get_auth_method()</a></li>
  465. </ul>
  466. <div class="method-signature">
  467. <span class="method-result">bool</span>
  468. <span class="method-name">
  469. sloodle_is_automatic_registration_on
  470. </span>
  471. ()
  472. </div>
  473. </div>
  474. <a name="functionsloodle_is_course_module_instance_visible" id="functionsloodle_is_course_module_instance_visible"><!-- --></a>
  475. <div class="oddrow">
  476. <div>
  477. <img src="../media/images/Function.png" />
  478. <span class="method-title">sloodle_is_course_module_instance_visible</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a442">442</a></span>)
  479. </div>
  480. <!-- ========== Info from phpDoc block ========= -->
  481. <p class="short-description">Determines whether or not the specified course module instance is visible.</p>
  482. <p class="description"><p>Checks that the instance itself and the course section are both valid.</p></p>
  483. <ul class="tags">
  484. <li><span class="field">return:</span> True if visible, or false if invisible or not found</li>
  485. </ul>
  486. <div class="method-signature">
  487. <span class="method-result">bool</span>
  488. <span class="method-name">
  489. sloodle_is_course_module_instance_visible
  490. </span>
  491. (<span class="var-type">int</span>&nbsp;<span class="var-name">$id</span>)
  492. </div>
  493. <ul class="parameters">
  494. <li>
  495. <span class="var-type">int</span>
  496. <span class="var-name">$id</span><span class="var-description">: The integer ID of a course module instance.</span> </li>
  497. </ul>
  498. </div>
  499. <a name="functionsloodle_is_installed" id="functionsloodle_is_installed"><!-- --></a>
  500. <div class="evenrow">
  501. <div>
  502. <img src="../media/images/Function.png" />
  503. <span class="method-title">sloodle_is_installed</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a336">336</a></span>)
  504. </div>
  505. <!-- ========== Info from phpDoc block ========= -->
  506. <p class="short-description">Determines whether or not Sloodle is installed.</p>
  507. <p class="description"><p>Queries Moodle's modules table for a Sloodle entry. <strong>NOTE:</strong> does not check for the presence of the Sloodle files.</p></p>
  508. <ul class="tags">
  509. <li><span class="field">return:</span> True if Sloodle is installed, or false otherwise.</li>
  510. </ul>
  511. <div class="method-signature">
  512. <span class="method-result">bool</span>
  513. <span class="method-name">
  514. sloodle_is_installed
  515. </span>
  516. ()
  517. </div>
  518. </div>
  519. <a name="functionsloodle_login_zone_coordinates" id="functionsloodle_login_zone_coordinates"><!-- --></a>
  520. <div class="oddrow">
  521. <div>
  522. <img src="../media/images/Function.png" />
  523. <span class="method-title">sloodle_login_zone_coordinates</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a614">614</a></span>)
  524. </div>
  525. <!-- ========== Info from phpDoc block ========= -->
  526. <p class="short-description">Calculates the maximum and minimum bounds of the site-wide LoginZone.</p>
  527. <p class="description"><p>Returns the bounds as a numeric array of two associate array vectors: ($max, $min). (Or returns false if no LoginZone position/size could be found in the Moodle configuration table).</p></p>
  528. <div class="method-signature">
  529. <span class="method-result">array</span>
  530. <span class="method-name">
  531. sloodle_login_zone_coordinates
  532. </span>
  533. ()
  534. </div>
  535. </div>
  536. <a name="functionsloodle_position_is_in_login_zone" id="functionsloodle_position_is_in_login_zone"><!-- --></a>
  537. <div class="evenrow">
  538. <div>
  539. <img src="../media/images/Function.png" />
  540. <span class="method-title">sloodle_position_is_in_login_zone</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a505">505</a></span>)
  541. </div>
  542. <!-- ========== Info from phpDoc block ========= -->
  543. <p class="short-description">Checks if the specified position is in the current (site-wide) loginzone.</p>
  544. <ul class="tags">
  545. <li><span class="field">return:</span> True if position is in LoginZone, or false if not</li>
  546. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_login_zone_coordinates">sloodle_login_zone_coordinates()</a></li>
  547. </ul>
  548. <div class="method-signature">
  549. <span class="method-result">bool</span>
  550. <span class="method-name">
  551. sloodle_position_is_in_login_zone
  552. </span>
  553. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$pos</span>)
  554. </div>
  555. <ul class="parameters">
  556. <li>
  557. <span class="var-type">mixed</span>
  558. <span class="var-name">$pos</span><span class="var-description">: A string vector or an associated array vector</span> </li>
  559. </ul>
  560. </div>
  561. <a name="functionsloodle_prim_password" id="functionsloodle_prim_password"><!-- --></a>
  562. <div class="oddrow">
  563. <div>
  564. <img src="../media/images/Function.png" />
  565. <span class="method-title">sloodle_prim_password</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a106">106</a></span>)
  566. </div>
  567. <!-- ========== Info from phpDoc block ========= -->
  568. <p class="short-description">Old form of the {@link: sloodle_set_prim_password()} function.</p>
  569. <p class="description"><p>Now deliberately terminates the script if called. <strong>DO NOT USE!</strong></p></p>
  570. <ul class="tags">
  571. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_prim_password">sloodle_get_prim_password()</a></li>
  572. <li><span class="field">deprecated:</span> </li>
  573. </ul>
  574. <div class="method-signature">
  575. <span class="method-result">void</span>
  576. <span class="method-name">
  577. sloodle_prim_password
  578. </span>
  579. ()
  580. </div>
  581. </div>
  582. <a name="functionsloodle_random_position_in_zone" id="functionsloodle_random_position_in_zone"><!-- --></a>
  583. <div class="evenrow">
  584. <div>
  585. <img src="../media/images/Function.png" />
  586. <span class="method-title">sloodle_random_position_in_zone</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a561">561</a></span>)
  587. </div>
  588. <!-- ========== Info from phpDoc block ========= -->
  589. <p class="short-description">Generates a random position within the specified cubic zone.</p>
  590. <ul class="tags">
  591. <li><span class="field">return:</span> An associative vector array</li>
  592. </ul>
  593. <div class="method-signature">
  594. <span class="method-result">array</span>
  595. <span class="method-name">
  596. sloodle_random_position_in_zone
  597. </span>
  598. (<span class="var-type">array</span>&nbsp;<span class="var-name">$zonemax</span>, <span class="var-type">array</span>&nbsp;<span class="var-name">$zonemin</span>)
  599. </div>
  600. <ul class="parameters">
  601. <li>
  602. <span class="var-type">array</span>
  603. <span class="var-name">$zonemax</span><span class="var-description">: Associative array vector specifying the maximum boundary of the cubic zone</span> </li>
  604. <li>
  605. <span class="var-type">array</span>
  606. <span class="var-name">$zonemin</span><span class="var-description">: Associative array vector specifying the minimum boundary of the cubic zone</span> </li>
  607. </ul>
  608. </div>
  609. <a name="functionsloodle_random_security_token" id="functionsloodle_random_security_token"><!-- --></a>
  610. <div class="oddrow">
  611. <div>
  612. <img src="../media/images/Function.png" />
  613. <span class="method-title">sloodle_random_security_token</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a348">348</a></span>)
  614. </div>
  615. <!-- ========== Info from phpDoc block ========= -->
  616. <p class="short-description">Generates a random login security token.</p>
  617. <p class="description"><p>Uses mixed-case letters and numbers to generate a random 16-character string.</p></p>
  618. <ul class="tags">
  619. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_random_web_password">sloodle_random_web_password()</a></li>
  620. </ul>
  621. <div class="method-signature">
  622. <span class="method-result">string</span>
  623. <span class="method-name">
  624. sloodle_random_security_token
  625. </span>
  626. ()
  627. </div>
  628. </div>
  629. <a name="functionsloodle_random_web_password" id="functionsloodle_random_web_password"><!-- --></a>
  630. <div class="evenrow">
  631. <div>
  632. <img src="../media/images/Function.png" />
  633. <span class="method-title">sloodle_random_web_password</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a372">372</a></span>)
  634. </div>
  635. <!-- ========== Info from phpDoc block ========= -->
  636. <p class="short-description">Generates a random web password Uses mixed-case letters and numbers to generate a random 8-character string.</p>
  637. <ul class="tags">
  638. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_random_security_token">sloodle_random_security_token()</a></li>
  639. </ul>
  640. <div class="method-signature">
  641. <span class="method-result">string</span>
  642. <span class="method-name">
  643. sloodle_random_web_password
  644. </span>
  645. ()
  646. </div>
  647. </div>
  648. <a name="functionsloodle_round_vector" id="functionsloodle_round_vector"><!-- --></a>
  649. <div class="oddrow">
  650. <div>
  651. <img src="../media/images/Function.png" />
  652. <span class="method-title">sloodle_round_vector</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a581">581</a></span>)
  653. </div>
  654. <!-- ========== Info from phpDoc block ========= -->
  655. <p class="short-description">Rounds the specified 3d vector integer values.</p>
  656. <p class="description"><p>Can handle/return a string vector, or an array vector. (Output type matches input type).</p></p>
  657. <div class="method-signature">
  658. <span class="method-result">mixed</span>
  659. <span class="method-name">
  660. sloodle_round_vector
  661. </span>
  662. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$pos</span>)
  663. </div>
  664. <ul class="parameters">
  665. <li>
  666. <span class="var-type">mixed</span>
  667. <span class="var-name">$pos</span><span class="var-description">: Either a string vector or an array vector</span> </li>
  668. </ul>
  669. </div>
  670. <a name="functionsloodle_send_xmlrpc_message" id="functionsloodle_send_xmlrpc_message"><!-- --></a>
  671. <div class="evenrow">
  672. <div>
  673. <img src="../media/images/Function.png" />
  674. <span class="method-title">sloodle_send_xmlrpc_message</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a253">253</a></span>)
  675. </div>
  676. <!-- ========== Info from phpDoc block ========= -->
  677. <p class="short-description">Sends an XMLRPC message into Second Life.</p>
  678. <ul class="tags">
  679. <li><span class="field">return:</span> True if successful, or false if an error occurs</li>
  680. </ul>
  681. <div class="method-signature">
  682. <span class="method-result">bool</span>
  683. <span class="method-name">
  684. sloodle_send_xmlrpc_message
  685. </span>
  686. (<span class="var-type">string</span>&nbsp;<span class="var-name">$channel</span>, <span class="var-type">int</span>&nbsp;<span class="var-name">$intval</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$strval</span>)
  687. </div>
  688. <ul class="parameters">
  689. <li>
  690. <span class="var-type">string</span>
  691. <span class="var-name">$channel</span><span class="var-description">: A string containing a UUID identifying the XMLRPC channel in SL to be used</span> </li>
  692. <li>
  693. <span class="var-type">int</span>
  694. <span class="var-name">$intval</span><span class="var-description">: An integer value to be sent in the message</span> </li>
  695. <li>
  696. <span class="var-type">string</span>
  697. <span class="var-name">$strval</span><span class="var-description">: A string value to be sent in the message</span> </li>
  698. </ul>
  699. </div>
  700. <a name="functionsloodle_set_auth_method" id="functionsloodle_set_auth_method"><!-- --></a>
  701. <div class="oddrow">
  702. <div>
  703. <img src="../media/images/Function.png" />
  704. <span class="method-title">sloodle_set_auth_method</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a147">147</a></span>)
  705. </div>
  706. <!-- ========== Info from phpDoc block ========= -->
  707. <p class="short-description">Sets the site-wide authentication method in the Moodle configuration table.</p>
  708. <p class="description"><p><strong>Note:</strong> no validation is performed on the parameter except to establish that it is a string</p></p>
  709. <ul class="tags">
  710. <li><span class="field">return:</span> True if successful, or false if the query failed</li>
  711. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_config">sloodle_set_config()</a></li>
  712. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_auth_method">sloodle_get_auth_method()</a></li>
  713. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_is_automatic_registration_on">sloodle_is_automatic_registration_on()</a></li>
  714. </ul>
  715. <div class="method-signature">
  716. <span class="method-result">bool</span>
  717. <span class="method-name">
  718. sloodle_set_auth_method
  719. </span>
  720. (<span class="var-type">string</span>&nbsp;<span class="var-name">$auth</span>)
  721. </div>
  722. <ul class="parameters">
  723. <li>
  724. <span class="var-type">string</span>
  725. <span class="var-name">$auth</span><span class="var-description">: A string containing the authentication method, &quot;web&quot; for web-based, or &quot;autoregister&quot; for automatic registration</span> </li>
  726. </ul>
  727. </div>
  728. <a name="functionsloodle_set_config" id="functionsloodle_set_config"><!-- --></a>
  729. <div class="evenrow">
  730. <div>
  731. <img src="../media/images/Function.png" />
  732. <span class="method-title">sloodle_set_config</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a35">35</a></span>)
  733. </div>
  734. <!-- ========== Info from phpDoc block ========= -->
  735. <p class="short-description">Sets a Sloodle configuration value.</p>
  736. <p class="description"><p>This data will be stored in Moodle's &quot;config&quot; table, so it will persist even after Sloodle is uninstalled. After being set, it will be available (read-only) as a named member of Moodle's $CFG variable. <strong>NOTE:</strong> in Sloodle debug mode, this function will terminate the script with an error if the name is not prefixed with &quot;sloodle_&quot;.</p></p>
  737. <ul class="tags">
  738. <li><span class="field">return:</span> True on success, or false on failure (may fail if database query encountered an error)</li>
  739. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_config">sloodle_get_config()</a></li>
  740. </ul>
  741. <div class="method-signature">
  742. <span class="method-result">bool</span>
  743. <span class="method-name">
  744. sloodle_set_config
  745. </span>
  746. (<span class="var-type">string</span>&nbsp;<span class="var-name">$name</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$value</span>)
  747. </div>
  748. <ul class="parameters">
  749. <li>
  750. <span class="var-type">string</span>
  751. <span class="var-name">$name</span><span class="var-description">: The name of the value to be stored (should be prefixed with &quot;sloodle_&quot;)</span> </li>
  752. <li>
  753. <span class="var-type">string</span>
  754. <span class="var-name">$value</span><span class="var-description">: The string representation of the value to be stored</span> </li>
  755. </ul>
  756. </div>
  757. <a name="functionsloodle_set_loginzone_pos" id="functionsloodle_set_loginzone_pos"><!-- --></a>
  758. <div class="oddrow">
  759. <div>
  760. <img src="../media/images/Function.png" />
  761. <span class="method-title">sloodle_set_loginzone_pos</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a172">172</a></span>)
  762. </div>
  763. <!-- ========== Info from phpDoc block ========= -->
  764. <p class="short-description">Sets the position of the site-wide LoginZone object (stored in the Moodle configuration table).</p>
  765. <ul class="tags">
  766. <li><span class="field">return:</span> True if successful, or false otherwise</li>
  767. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_config">sloodle_set_config()</a></li>
  768. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_loginzone_pos">sloodle_get_loginzone_pos()</a></li>
  769. </ul>
  770. <div class="method-signature">
  771. <span class="method-result">bool</span>
  772. <span class="method-name">
  773. sloodle_set_loginzone_pos
  774. </span>
  775. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$pos</span>)
  776. </div>
  777. <ul class="parameters">
  778. <li>
  779. <span class="var-type">mixed</span>
  780. <span class="var-name">$pos</span><span class="var-description">: Either a string vector &quot;&lt;x,y,z&gt;&quot; or an associative vector array {x,y,z}</span> </li>
  781. </ul>
  782. </div>
  783. <a name="functionsloodle_set_loginzone_region" id="functionsloodle_set_loginzone_region"><!-- --></a>
  784. <div class="evenrow">
  785. <div>
  786. <img src="../media/images/Function.png" />
  787. <span class="method-title">sloodle_set_loginzone_region</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a223">223</a></span>)
  788. </div>
  789. <!-- ========== Info from phpDoc block ========= -->
  790. <p class="short-description">Sets the name of the region where the site-wide LoginZone object was most recently rezzed.</p>
  791. <ul class="tags">
  792. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_config">sloodle_set_config()</a></li>
  793. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_loginzone_region">sloodle_get_loginzone_region()</a></li>
  794. </ul>
  795. <div class="method-signature">
  796. <span class="method-result">void</span>
  797. <span class="method-name">
  798. sloodle_set_loginzone_region
  799. </span>
  800. (<span class="var-type">string</span>&nbsp;<span class="var-name">$region</span>)
  801. </div>
  802. <ul class="parameters">
  803. <li>
  804. <span class="var-type">string</span>
  805. <span class="var-name">$region</span><span class="var-description">: A string containing the name of a region (e.g. &quot;virtuALBA&quot;)</span> </li>
  806. </ul>
  807. </div>
  808. <a name="functionsloodle_set_loginzone_size" id="functionsloodle_set_loginzone_size"><!-- --></a>
  809. <div class="oddrow">
  810. <div>
  811. <img src="../media/images/Function.png" />
  812. <span class="method-title">sloodle_set_loginzone_size</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a198">198</a></span>)
  813. </div>
  814. <!-- ========== Info from phpDoc block ========= -->
  815. <p class="short-description">Sets the size of the site-wide LoginZone object (stored in the Moodle configuration table).</p>
  816. <ul class="tags">
  817. <li><span class="field">return:</span> True if successful, or false otherwise</li>
  818. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_config">sloodle_set_config()</a></li>
  819. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_loginzone_size">sloodle_get_loginzone_size()</a></li>
  820. </ul>
  821. <div class="method-signature">
  822. <span class="method-result">bool</span>
  823. <span class="method-name">
  824. sloodle_set_loginzone_size
  825. </span>
  826. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$size</span>)
  827. </div>
  828. <ul class="parameters">
  829. <li>
  830. <span class="var-type">mixed</span>
  831. <span class="var-name">$size</span><span class="var-description">: Either a string vector &quot;&lt;x,y,z&gt;&quot; or an associative vector array {x,y,z}</span> </li>
  832. </ul>
  833. </div>
  834. <a name="functionsloodle_set_prim_password" id="functionsloodle_set_prim_password"><!-- --></a>
  835. <div class="evenrow">
  836. <div>
  837. <img src="../media/images/Function.png" />
  838. <span class="method-title">sloodle_set_prim_password</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a91">91</a></span>)
  839. </div>
  840. <!-- ========== Info from phpDoc block ========= -->
  841. <p class="short-description">Sets the site-wide Sloodle prim password from the configuration table.</p>
  842. <p class="description"><p><strong>Note:</strong> this functio peforms no validation on the input value, except to determine that it is a string.</p></p>
  843. <ul class="tags">
  844. <li><span class="field">return:</span> True if the database query was successful, or false otherwise</li>
  845. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_set_config">sloodle_set_config()</a></li>
  846. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_get_prim_password">sloodle_get_prim_password()</a></li>
  847. </ul>
  848. <div class="method-signature">
  849. <span class="method-result">bool</span>
  850. <span class="method-name">
  851. sloodle_set_prim_password
  852. </span>
  853. (<span class="var-type">string</span>&nbsp;<span class="var-name">$password</span>)
  854. </div>
  855. <ul class="parameters">
  856. <li>
  857. <span class="var-type">string</span>
  858. <span class="var-name">$password</span><span class="var-description">: A string containing the prim password</span> </li>
  859. </ul>
  860. </div>
  861. <a name="functionsloodle_vector_to_array" id="functionsloodle_vector_to_array"><!-- --></a>
  862. <div class="oddrow">
  863. <div>
  864. <img src="../media/images/Function.png" />
  865. <span class="method-title">sloodle_vector_to_array</span> (line <span class="line-number"><a href="../__filesource/fsource_sloodle__libsl_generallib.php.html#a400">400</a></span>)
  866. </div>
  867. <!-- ========== Info from phpDoc block ========= -->
  868. <p class="short-description">Converts a string vector to an array vector.</p>
  869. <p class="description"><p>String vector should be of format &quot;&lt;x,y,z&gt;&quot;. Converts to associative array with members 'x', 'y', and 'z'. Returns false if input parameter was not of correct format.</p></p>
  870. <ul class="tags">
  871. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_round_vector">sloodle_round_vector()</a></li>
  872. <li><span class="field">see:</span> <a href="../sloodle/_lib---sl_generallib.php.html#functionsloodle_array_to_vector">sloodle_array_to_vector()</a></li>
  873. </ul>
  874. <div class="method-signature">
  875. <span class="method-result">mixed</span>
  876. <span class="method-name">
  877. sloodle_vector_to_array
  878. </span>
  879. (<span class="var-type">string</span>&nbsp;<span class="var-name">$vector</span>)
  880. </div>
  881. <ul class="parameters">
  882. <li>
  883. <span class="var-type">string</span>
  884. <span class="var-name">$vector</span><span class="var-description">: A string vector of format &quot;&lt;x,y,z&gt;&quot;.</span> </li>
  885. </ul>
  886. </div>
  887. </div>
  888. </div>
  889. <p class="notes" id="credit">
  890. Documentation generated on Tue, 04 Mar 2008 15:08:40 +0000 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
  891. </p>
  892. </div></body>
  893. </html>