Added feature #11148: Remove static require_once() to t3lib and tslib and use autoloa...
[Packages/TYPO3.CMS.git] / t3lib / class.t3lib_userauthgroup.php
1 <?php
2 /***************************************************************
3 * Copyright notice
4 *
5 * (c) 1999-2009 Kasper Skaarhoj (kasperYYYY@typo3.com)
6 * All rights reserved
7 *
8 * This script is part of the TYPO3 project. The TYPO3 project is
9 * free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * The GNU General Public License can be found at
15 * http://www.gnu.org/copyleft/gpl.html.
16 * A copy is found in the textfile GPL.txt and important notices to the license
17 * from the author is found in LICENSE.txt distributed with these scripts.
18 *
19 *
20 * This script is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
24 *
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
27 /**
28 * Contains an extension class specifically for authentication/initialization of backend users in TYPO3
29 *
30 * $Id$
31 * Revised for TYPO3 3.6 July/2003 by Kasper Skaarhoj
32 *
33 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
34 */
35 /**
36 * [CLASS/FUNCTION INDEX of SCRIPT]
37 *
38 *
39 *
40 * 135: class t3lib_userAuthGroup extends t3lib_userAuth
41 *
42 * SECTION: Permission checking functions:
43 * 199: function isAdmin()
44 * 211: function isMemberOfGroup($groupId)
45 * 233: function doesUserHaveAccess($row,$perms)
46 * 250: function isInWebMount($id,$readPerms='',$exitOnError=0)
47 * 277: function modAccess($conf,$exitOnError)
48 * 328: function getPagePermsClause($perms)
49 * 367: function calcPerms($row)
50 * 405: function isRTE()
51 * 439: function check($type,$value)
52 * 456: function checkAuthMode($table,$field,$value,$authMode)
53 * 522: function checkLanguageAccess($langValue)
54 * 544: function recordEditAccessInternals($table,$idOrRow,$newRecord=FALSE)
55 * 619: function isPSet($lCP,$table,$type='')
56 * 636: function mayMakeShortcut()
57 * 650: function workspaceCannotEditRecord($table,$recData)
58 * 689: function workspaceCannotEditOfflineVersion($table,$recData)
59 * 712: function workspaceAllowLiveRecordsInPID($pid, $table)
60 * 733: function workspaceCreateNewRecord($pid, $table)
61 * 752: function workspaceAllowAutoCreation($table,$id,$recpid)
62 * 772: function workspaceCheckStageForCurrent($stage)
63 * 795: function workspacePublishAccess($wsid)
64 * 823: function workspaceSwapAccess()
65 * 835: function workspaceVersioningTypeAccess($type)
66 * 866: function workspaceVersioningTypeGetClosest($type)
67 *
68 * SECTION: Miscellaneous functions
69 * 909: function getTSConfig($objectString,$config='')
70 * 935: function getTSConfigVal($objectString)
71 * 947: function getTSConfigProp($objectString)
72 * 959: function inList($in_list,$item)
73 * 970: function returnWebmounts()
74 * 980: function returnFilemounts()
75 * 997: function jsConfirmation($bitmask)
76 *
77 * SECTION: Authentication methods
78 * 1035: function fetchGroupData()
79 * 1168: function fetchGroups($grList,$idList='')
80 * 1266: function setCachedList($cList)
81 * 1286: function addFileMount($title, $altTitle, $path, $webspace, $type)
82 * 1333: function addTScomment($str)
83 *
84 * SECTION: Workspaces
85 * 1369: function workspaceInit()
86 * 1412: function checkWorkspace($wsRec,$fields='uid,title,adminusers,members,reviewers,publish_access,stagechg_notification')
87 * 1487: function checkWorkspaceCurrent()
88 * 1500: function setWorkspace($workspaceId)
89 * 1528: function setWorkspacePreview($previewState)
90 * 1538: function getDefaultWorkspace()
91 *
92 * SECTION: Logging
93 * 1589: function writelog($type,$action,$error,$details_nr,$details,$data,$tablename='',$recuid='',$recpid='',$event_pid=-1,$NEWid='',$userId=0)
94 * 1621: function simplelog($message, $extKey='', $error=0)
95 * 1642: function checkLogFailures($email, $secondsBack=3600, $max=3)
96 *
97 * TOTAL FUNCTIONS: 45
98 * (This index is automatically created/updated by the extension "extdeveval")
99 *
100 */
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123 /**
124 * Extension to class.t3lib_userauth.php; Authentication of users in TYPO3 Backend
125 *
126 * Actually this class is extended again by t3lib_beuserauth which is the actual backend user class that will be instantiated.
127 * In fact the two classes t3lib_beuserauth and this class could just as well be one, single class since t3lib_userauthgroup is not - to my knowledge - used separately elsewhere. But for historical reasons they are two separate classes.
128 *
129 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
130 * @package TYPO3
131 * @subpackage t3lib
132 */
133 class t3lib_userAuthGroup extends t3lib_userAuth {
134 var $usergroup_column = 'usergroup'; // Should be set to the usergroup-column (id-list) in the user-record
135 var $usergroup_table = 'be_groups'; // The name of the group-table
136
137 // internal
138 var $groupData = Array( // This array holds lists of eg. tables, fields and other values related to the permission-system. See fetchGroupData
139 'filemounts' => Array() // Filemounts are loaded here
140 );
141 var $workspace = -99; // User workspace. -99 is ERROR (none available), -1 is offline, 0 is online, >0 is custom workspaces.
142 var $workspaceRec = array(); // Custom workspace record if any
143
144 var $userGroups = Array(); // This array will hold the groups that the user is a member of
145 var $userGroupsUID = Array(); // This array holds the uid's of the groups in the listed order
146 var $groupList =''; // This is $this->userGroupsUID imploded to a comma list... Will correspond to the 'usergroup_cached_list'
147 var $dataLists=array( // Used internally to accumulate data for the user-group. DONT USE THIS EXTERNALLY! Use $this->groupData instead
148 'webmount_list'=>'',
149 'filemount_list'=>'',
150 'fileoper_perms' => 0,
151 'modList'=>'',
152 'tables_select'=>'',
153 'tables_modify'=>'',
154 'pagetypes_select'=>'',
155 'non_exclude_fields'=>'',
156 'explicit_allowdeny'=>'',
157 'allowed_languages' => '',
158 'workspace_perms' => '',
159 'custom_options' => '',
160 );
161 var $includeHierarchy=array(); // For debugging/display of order in which subgroups are included.
162 var $includeGroupArray=array(); // List of group_id's in the order they are processed.
163
164 var $OS=''; // Set to 'WIN', if windows
165 var $TSdataArray=array(); // Used to accumulate the TSconfig data of the user
166 var $userTS_text = ''; // Contains the non-parsed user TSconfig
167 var $userTS = array(); // Contains the parsed user TSconfig
168 var $userTSUpdated=0; // Set internally if the user TSconfig was parsed and needs to be cached.
169 var $userTS_dontGetCached=0; // Set this from outside if you want the user TSconfig to ALWAYS be parsed and not fetched from cache.
170
171 var $RTE_errors = array(); // RTE availability errors collected.
172 var $errorMsg = ''; // Contains last error message
173
174 var $checkWorkspaceCurrent_cache=NULL; // Cache for checkWorkspaceCurrent()
175
176
177
178
179
180
181
182
183
184
185
186 /************************************
187 *
188 * Permission checking functions:
189 *
190 ************************************/
191
192 /**
193 * Returns true if user is admin
194 * Basically this function evaluates if the ->user[admin] field has bit 0 set. If so, user is admin.
195 *
196 * @return boolean
197 */
198 function isAdmin() {
199 return (($this->user['admin']&1) ==1);
200 }
201
202 /**
203 * Returns true if the current user is a member of group $groupId
204 * $groupId must be set. $this->groupList must contain groups
205 * Will return true also if the user is a member of a group through subgroups.
206 *
207 * @param integer Group ID to look for in $this->groupList
208 * @return boolean
209 */
210 function isMemberOfGroup($groupId) {
211 $groupId = intval($groupId);
212 if ($this->groupList && $groupId) {
213 return $this->inList($this->groupList, $groupId);
214 }
215 }
216
217 /**
218 * Checks if the permissions is granted based on a page-record ($row) and $perms (binary and'ed)
219 *
220 * Bits for permissions, see $perms variable:
221 *
222 * 1 - Show: See/Copy page and the pagecontent.
223 * 16- Edit pagecontent: Change/Add/Delete/Move pagecontent.
224 * 2- Edit page: Change/Move the page, eg. change title, startdate, hidden.
225 * 4- Delete page: Delete the page and pagecontent.
226 * 8- New pages: Create new pages under the page.
227 *
228 * @param array $row is the pagerow for which the permissions is checked
229 * @param integer $perms is the binary representation of the permission we are going to check. Every bit in this number represents a permission that must be set. See function explanation.
230 * @return boolean True or False upon evaluation
231 */
232 function doesUserHaveAccess($row,$perms) {
233 $userPerms = $this->calcPerms($row);
234 return ($userPerms & $perms)==$perms;
235 }
236
237 /**
238 * Checks if the page id, $id, is found within the webmounts set up for the user.
239 * This should ALWAYS be checked for any page id a user works with, whether it's about reading, writing or whatever.
240 * The point is that this will add the security that a user can NEVER touch parts outside his mounted pages in the page tree. This is otherwise possible if the raw page permissions allows for it. So this security check just makes it easier to make safe user configurations.
241 * If the user is admin OR if this feature is disabled (fx. by setting TYPO3_CONF_VARS['BE']['lockBeUserToDBmounts']=0) then it returns "1" right away
242 * Otherwise the function will return the uid of the webmount which was first found in the rootline of the input page $id
243 *
244 * @param integer Page ID to check
245 * @param string Content of "->getPagePermsClause(1)" (read-permissions). If not set, they will be internally calculated (but if you have the correct value right away you can save that database lookup!)
246 * @param boolean If set, then the function will exit with an error message.
247 * @return integer The page UID of a page in the rootline that matched a mount point
248 */
249 function isInWebMount($id,$readPerms='',$exitOnError=0) {
250 if (!$GLOBALS['TYPO3_CONF_VARS']['BE']['lockBeUserToDBmounts'] || $this->isAdmin()) return 1;
251 $id = intval($id);
252
253 // Check if input id is an offline version page in which case we will map id to the online version:
254 $checkRec = t3lib_beFUnc::getRecord('pages',$id,'pid,t3ver_oid');
255 if ($checkRec['pid']==-1) {
256 $id = intval($checkRec['t3ver_oid']);
257 }
258
259 if (!$readPerms) $readPerms = $this->getPagePermsClause(1);
260 if ($id>0) {
261 $wM = $this->returnWebmounts();
262 $rL = t3lib_BEfunc::BEgetRootLine($id,' AND '.$readPerms);
263
264 foreach($rL as $v) {
265 if ($v['uid'] && in_array($v['uid'],$wM)) {
266 return $v['uid'];
267 }
268 }
269 }
270 if ($exitOnError) {
271 t3lib_BEfunc::typo3PrintError ('Access Error','This page is not within your DB-mounts',0);
272 exit;
273 }
274 }
275
276 /**
277 * Checks access to a backend module with the $MCONF passed as first argument
278 *
279 * @param array $MCONF array of a backend module!
280 * @param boolean If set, an array will issue an error message and exit.
281 * @return boolean Will return true if $MCONF['access'] is not set at all, if the BE_USER is admin or if the module is enabled in the be_users/be_groups records of the user (specifically enabled). Will return false if the module name is not even found in $TBE_MODULES
282 */
283 function modAccess($conf,$exitOnError) {
284 if (!t3lib_BEfunc::isModuleSetInTBE_MODULES($conf['name'])) {
285 if ($exitOnError) {
286 t3lib_BEfunc::typo3PrintError ('Fatal Error','This module "'.$conf['name'].'" is not enabled in TBE_MODULES',0);
287 exit;
288 }
289 return FALSE;
290 }
291
292 // Workspaces check:
293 if ($conf['workspaces']) {
294 if (($this->workspace===0 && t3lib_div::inList($conf['workspaces'],'online')) ||
295 ($this->workspace===-1 && t3lib_div::inList($conf['workspaces'],'offline')) ||
296 ($this->workspace>0 && t3lib_div::inList($conf['workspaces'],'custom'))) {
297 // ok, go on...
298 } else {
299 if ($exitOnError) {
300 t3lib_BEfunc::typo3PrintError ('Workspace Error','This module "'.$conf['name'].'" is not available under the current workspace',0);
301 exit;
302 }
303 return FALSE;
304 }
305 }
306
307 // Returns true if conf[access] is not set at all or if the user is admin
308 if (!$conf['access'] || $this->isAdmin()) return TRUE;
309
310 // If $conf['access'] is set but not with 'admin' then we return true, if the module is found in the modList
311 if (!strstr($conf['access'],'admin') && $conf['name']) {
312 $acs = $this->check('modules',$conf['name']);
313 }
314 if (!$acs && $exitOnError) {
315 t3lib_BEfunc::typo3PrintError ('Access Error','You don\'t have access to this module.',0);
316 exit;
317 } else return $acs;
318 }
319
320 /**
321 * Returns a WHERE-clause for the pages-table where user permissions according to input argument, $perms, is validated.
322 * $perms is the "mask" used to select. Fx. if $perms is 1 then you'll get all pages that a user can actually see!
323 * 2^0 = show (1)
324 * 2^1 = edit (2)
325 * 2^2 = delete (4)
326 * 2^3 = new (8)
327 * If the user is 'admin' " 1=1" is returned (no effect)
328 * If the user is not set at all (->user is not an array), then " 1=0" is returned (will cause no selection results at all)
329 * The 95% use of this function is "->getPagePermsClause(1)" which will return WHERE clauses for *selecting* pages in backend listings - in other words this will check read permissions.
330 *
331 * @param integer Permission mask to use, see function description
332 * @return string Part of where clause. Prefix " AND " to this.
333 */
334 function getPagePermsClause($perms) {
335 global $TYPO3_CONF_VARS;
336 if (is_array($this->user)) {
337 if ($this->isAdmin()) {
338 return ' 1=1';
339 }
340
341 $perms = intval($perms); // Make sure it's integer.
342 $str= ' ('.
343 '(pages.perms_everybody & '.$perms.' = '.$perms.')'. // Everybody
344 ' OR (pages.perms_userid = '.$this->user['uid'].' AND pages.perms_user & '.$perms.' = '.$perms.')'; // User
345 if ($this->groupList) {
346 $str.= ' OR (pages.perms_groupid in ('.$this->groupList.') AND pages.perms_group & '.$perms.' = '.$perms.')'; // Group (if any is set)
347 }
348 $str.=')';
349
350 // ****************
351 // getPagePermsClause-HOOK
352 // ****************
353 if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['getPagePermsClause'])) {
354
355 foreach($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['getPagePermsClause'] as $_funcRef) {
356 $_params = array('currentClause' => $str, 'perms' => $perms);
357 $str = t3lib_div::callUserFunction($_funcRef, $_params, $this);
358 }
359 }
360
361 return $str;
362 } else {
363 return ' 1=0';
364 }
365 }
366
367 /**
368 * Returns a combined binary representation of the current users permissions for the page-record, $row.
369 * The perms for user, group and everybody is OR'ed together (provided that the page-owner is the user and for the groups that the user is a member of the group
370 * If the user is admin, 31 is returned (full permissions for all five flags)
371 *
372 * @param array Input page row with all perms_* fields available.
373 * @return integer Bitwise representation of the users permissions in relation to input page row, $row
374 */
375 function calcPerms($row) {
376 global $TYPO3_CONF_VARS;
377 if ($this->isAdmin()) {return 31;} // Return 31 for admin users.
378
379 $out=0;
380 if (isset($row['perms_userid']) && isset($row['perms_user']) && isset($row['perms_groupid']) && isset($row['perms_group']) && isset($row['perms_everybody']) && isset($this->groupList)) {
381 if ($this->user['uid']==$row['perms_userid']) {
382 $out|=$row['perms_user'];
383 }
384 if ($this->isMemberOfGroup($row['perms_groupid'])) {
385 $out|=$row['perms_group'];
386 }
387 $out|=$row['perms_everybody'];
388 }
389
390 // ****************
391 // CALCPERMS hook
392 // ****************
393 if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['calcPerms'])) {
394 foreach($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['calcPerms'] as $_funcRef) {
395 $_params = array(
396 'row' => $row,
397 'outputPermissions' => $out
398 );
399 $out = t3lib_div::callUserFunction($_funcRef, $_params, $this);
400 }
401 }
402
403 return $out;
404 }
405
406 /**
407 * Returns true if the RTE (Rich Text Editor) can be enabled for the user
408 * Strictly this is not permissions being checked but rather a series of settings like a loaded extension, browser/client type and a configuration option in ->uc[edit_RTE]
409 * The reasons for a FALSE return can be found in $this->RTE_errors
410 *
411 * @return boolean
412 */
413 function isRTE() {
414 global $CLIENT;
415
416 // Start:
417 $this->RTE_errors = array();
418 if (!$this->uc['edit_RTE'])
419 $this->RTE_errors[] = 'RTE is not enabled for user!';
420 if (!$GLOBALS['TYPO3_CONF_VARS']['BE']['RTEenabled'])
421 $this->RTE_errors[] = 'RTE is not enabled in $TYPO3_CONF_VARS["BE"]["RTEenabled"]';
422
423
424 // Acquire RTE object:
425 $RTE = &t3lib_BEfunc::RTEgetObj();
426 if (!is_object($RTE)) {
427 $this->RTE_errors = array_merge($this->RTE_errors, $RTE);
428 }
429
430 if (!count($this->RTE_errors)) {
431 return TRUE;
432 } else {
433 return FALSE;
434 }
435 }
436
437 /**
438 * Returns true if the $value is found in the list in a $this->groupData[] index pointed to by $type (array key).
439 * Can thus be users to check for modules, exclude-fields, select/modify permissions for tables etc.
440 * If user is admin true is also returned
441 * Please see the document Inside TYPO3 for examples.
442 *
443 * @param string The type value; "webmounts", "filemounts", "pagetypes_select", "tables_select", "tables_modify", "non_exclude_fields", "modules"
444 * @param string String to search for in the groupData-list
445 * @return boolean True if permission is granted (that is, the value was found in the groupData list - or the BE_USER is "admin")
446 */
447 function check($type,$value) {
448 if (isset($this->groupData[$type])) {
449 if ($this->isAdmin() || $this->inList($this->groupData[$type],$value)) {
450 return 1;
451 }
452 }
453 }
454
455 /**
456 * Checking the authMode of a select field with authMode set
457 *
458 * @param string Table name
459 * @param string Field name (must be configured in TCA and of type "select" with authMode set!)
460 * @param string Value to evaluation (single value, must not contain any of the chars ":,|")
461 * @param string Auth mode keyword (explicitAllow, explicitDeny, individual)
462 * @return boolean True or false whether access is granted or not.
463 */
464 function checkAuthMode($table,$field,$value,$authMode) {
465 global $TCA;
466
467 // Admin users can do anything:
468 if ($this->isAdmin()) return TRUE;
469
470 // Allow all blank values:
471 if (!strcmp($value,'')) return TRUE;
472
473 // Certain characters are not allowed in the value
474 if (preg_match('/[:|,]/',$value)) {
475 return FALSE;
476 }
477
478 // Initialize:
479 $testValue = $table.':'.$field.':'.$value;
480 $out = TRUE;
481
482 // Checking value:
483 switch((string)$authMode) {
484 case 'explicitAllow':
485 if (!$this->inList($this->groupData['explicit_allowdeny'],$testValue.':ALLOW')) {
486 $out = FALSE;
487 }
488 break;
489 case 'explicitDeny':
490 if ($this->inList($this->groupData['explicit_allowdeny'],$testValue.':DENY')) {
491 $out = FALSE;
492 }
493 break;
494 case 'individual':
495 t3lib_div::loadTCA($table);
496 if (is_array($TCA[$table]) && is_array($TCA[$table]['columns'][$field])) {
497 $items = $TCA[$table]['columns'][$field]['config']['items'];
498 if (is_array($items)) {
499 foreach($items as $iCfg) {
500 if (!strcmp($iCfg[1],$value) && $iCfg[4]) {
501 switch((string)$iCfg[4]) {
502 case 'EXPL_ALLOW':
503 if (!$this->inList($this->groupData['explicit_allowdeny'],$testValue.':ALLOW')) {
504 $out = FALSE;
505 }
506 break;
507 case 'EXPL_DENY':
508 if ($this->inList($this->groupData['explicit_allowdeny'],$testValue.':DENY')) {
509 $out = FALSE;
510 }
511 break;
512 }
513 break;
514 }
515 }
516 }
517 }
518 break;
519 }
520
521 return $out;
522 }
523
524 /**
525 * Checking if a language value (-1, 0 and >0 for sys_language records) is allowed to be edited by the user.
526 *
527 * @param integer Language value to evaluate
528 * @return boolean Returns true if the language value is allowed, otherwise false.
529 */
530 function checkLanguageAccess($langValue) {
531 if (strcmp(trim($this->groupData['allowed_languages']),'')) { // The users language list must be non-blank - otherwise all languages are allowed.
532 $langValue = intval($langValue);
533 if ($langValue != -1 && !$this->check('allowed_languages',$langValue)) { // Language must either be explicitly allowed OR the lang Value be "-1" (all languages)
534 return FALSE;
535 }
536 }
537 return TRUE;
538 }
539
540 /**
541 * Checking if a user has editing access to a record from a $TCA table.
542 * The checks does not take page permissions and other "environmental" things into account. It only deal with record internals; If any values in the record fields disallows it.
543 * For instance languages settings, authMode selector boxes are evaluated (and maybe more in the future).
544 * It will check for workspace dependent access.
545 * The function takes an ID (integer) or row (array) as second argument.
546 *
547 * @param string Table name
548 * @param mixed If integer, then this is the ID of the record. If Array this just represents fields in the record.
549 * @param boolean Set, if testing a new (non-existing) record array. Will disable certain checks that doesn't make much sense in that context.
550 * @return boolean True if OK, otherwise false
551 */
552 function recordEditAccessInternals($table,$idOrRow,$newRecord=FALSE) {
553 global $TCA;
554
555 if (isset($TCA[$table])) {
556 t3lib_div::loadTCA($table);
557
558 // Always return true for Admin users.
559 if ($this->isAdmin()) return TRUE;
560
561 // Fetching the record if the $idOrRow variable was not an array on input:
562 if (!is_array($idOrRow)) {
563 $idOrRow = t3lib_BEfunc::getRecord($table, $idOrRow);
564 if (!is_array($idOrRow)) {
565 $this->errorMsg = 'ERROR: Record could not be fetched.';
566 return FALSE;
567 }
568 }
569
570 // Checking languages:
571 if ($TCA[$table]['ctrl']['languageField']) {
572 if (isset($idOrRow[$TCA[$table]['ctrl']['languageField']])) { // Language field must be found in input row - otherwise it does not make sense.
573 if (!$this->checkLanguageAccess($idOrRow[$TCA[$table]['ctrl']['languageField']])) {
574 $this->errorMsg = 'ERROR: Language was not allowed.';
575 return FALSE;
576 }
577 } else {
578 $this->errorMsg = 'ERROR: The "languageField" field named "'.$TCA[$table]['ctrl']['languageField'].'" was not found in testing record!';
579 return FALSE;
580 }
581 }
582
583 // Checking authMode fields:
584 if (is_array($TCA[$table]['columns'])) {
585 foreach($TCA[$table]['columns'] as $fN => $fV) {
586 if (isset($idOrRow[$fN])) { //
587 if ($fV['config']['type']=='select' && $fV['config']['authMode'] && !strcmp($fV['config']['authMode_enforce'],'strict')) {
588 if (!$this->checkAuthMode($table,$fN,$idOrRow[$fN],$fV['config']['authMode'])) {
589 $this->errorMsg = 'ERROR: authMode "'.$fV['config']['authMode'].'" failed for field "'.$fN.'" with value "'.$idOrRow[$fN].'" evaluated';
590 return FALSE;
591 }
592 }
593 }
594 }
595 }
596
597 // Checking "editlock" feature (doesn't apply to new records)
598 if (!$newRecord && $TCA[$table]['ctrl']['editlock']) {
599 if (isset($idOrRow[$TCA[$table]['ctrl']['editlock']])) {
600 if ($idOrRow[$TCA[$table]['ctrl']['editlock']]) {
601 $this->errorMsg = 'ERROR: Record was locked for editing. Only admin users can change this state.';
602 return FALSE;
603 }
604 } else {
605 $this->errorMsg = 'ERROR: The "editLock" field named "'.$TCA[$table]['ctrl']['editlock'].'" was not found in testing record!';
606 return FALSE;
607 }
608 }
609
610 // Checking record permissions
611 // THIS is where we can include a check for "perms_" fields for other records than pages...
612
613 // Process any hooks
614 if (is_array($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['recordEditAccessInternals'])) {
615 foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['recordEditAccessInternals'] as $funcRef) {
616 $params = array(
617 'table' => $table,
618 'idOrRow' => $idOrRow,
619 'newRecord' => $newRecord
620 );
621 if (!t3lib_div::callUserFunction($funcRef, $params, $this)) {
622 return FALSE;
623 }
624 }
625 }
626
627 // Finally, return true if all is well.
628 return TRUE;
629 }
630 }
631
632 /**
633 * Will check a type of permission against the compiled permission integer, $lCP, and in relation to table, $table
634 *
635 * @param integer $lCP could typically be the "compiled permissions" integer returned by ->calcPerms
636 * @param string $table is the tablename to check: If "pages" table then edit,new,delete and editcontent permissions can be checked. Other tables will be checked for "editcontent" only (and $type will be ignored)
637 * @param string For $table='pages' this can be 'edit' (2), 'new' (8 or 16), 'delete' (4), 'editcontent' (16). For all other tables this is ignored. (16 is used)
638 * @return boolean
639 * @access private
640 */
641 function isPSet($lCP,$table,$type='') {
642 if ($this->isAdmin()) return true;
643 if ($table=='pages') {
644 if ($type=='edit') return $lCP & 2;
645 if ($type=='new') return ($lCP & 8) || ($lCP & 16); // Create new page OR pagecontent
646 if ($type=='delete') return $lCP & 4;
647 if ($type=='editcontent') return $lCP & 16;
648 } else {
649 return $lCP & 16;
650 }
651 }
652
653 /**
654 * Returns true if the BE_USER is allowed to *create* shortcuts in the backend modules
655 *
656 * @return boolean
657 */
658 function mayMakeShortcut() {
659 return $this->getTSConfigVal('options.shortcutFrame') && !$this->getTSConfigVal('options.mayNotCreateEditShortcuts');
660 }
661
662 /**
663 * Checking if editing of an existing record is allowed in current workspace if that is offline.
664 * Rules for editing in offline mode:
665 * - record supports versioning and is an offline version from workspace and has the corrent stage
666 * - or record (any) is in a branch where there is a page which is a version from the workspace and where the stage is not preventing records
667 *
668 * @param string Table of record
669 * @param array Integer (record uid) or array where fields are at least: pid, t3ver_wsid, t3ver_stage (if versioningWS is set)
670 * @return string String error code, telling the failure state. FALSE=All ok
671 */
672 function workspaceCannotEditRecord($table,$recData) {
673
674 if ($this->workspace!==0) { // Only test offline spaces:
675
676 if (!is_array($recData)) {
677 $recData = t3lib_BEfunc::getRecord($table,$recData,'pid'.($GLOBALS['TCA'][$table]['ctrl']['versioningWS']?',t3ver_wsid,t3ver_stage':''));
678 }
679
680 if (is_array($recData)) {
681 if ((int)$recData['pid']===-1) { // We are testing a "version" (identified by a pid of -1): it can be edited provided that workspace matches and versioning is enabled for the table.
682 if (!$GLOBALS['TCA'][$table]['ctrl']['versioningWS']) { // No versioning, basic error, inconsistency even! Such records should not have a pid of -1!
683 return 'Versioning disabled for table';
684 } elseif ((int)$recData['t3ver_wsid']!==$this->workspace) { // So does workspace match?
685 return 'Workspace ID of record didn\'t match current workspace';
686 } else { // So what about the stage of the version, does that allow editing for this user?
687 return $this->workspaceCheckStageForCurrent($recData['t3ver_stage']) ? FALSE : 'Record stage "'.$recData['t3ver_stage'].'" and users access level did not allow for editing';
688 }
689 } else { // We are testing a "live" record:
690 if ($res = $this->workspaceAllowLiveRecordsInPID($recData['pid'], $table)) { // For "Live" records, check that PID for table allows editing
691 // Live records are OK in this branch, but what about the stage of branch point, if any:
692 return $res>0 ? FALSE : 'Stage for versioning root point and users access level did not allow for editing'; // OK
693 } else { // If not offline and not in versionized branch, output error:
694 return 'Online record was not in versionized branch!';
695 }
696 }
697 } else return 'No record';
698 } else {
699 return FALSE; // OK because workspace is 0
700 }
701 }
702
703 /**
704 * Evaluates if a user is allowed to edit the offline version
705 *
706 * @param string Table of record
707 * @param array Integer (record uid) or array where fields are at least: pid, t3ver_wsid, t3ver_stage (if versioningWS is set)
708 * @return string String error code, telling the failure state. FALSE=All ok
709 * @see workspaceCannotEditRecord()
710 */
711 function workspaceCannotEditOfflineVersion($table,$recData) {
712 if ($GLOBALS['TCA'][$table]['ctrl']['versioningWS']) {
713
714 if (!is_array($recData)) {
715 $recData = t3lib_BEfunc::getRecord($table,$recData,'uid,pid,t3ver_wsid,t3ver_stage');
716 }
717 if (is_array($recData)) {
718 if ((int)$recData['pid']===-1) {
719 return $this->workspaceCannotEditRecord($table,$recData);
720 } else return 'Not an offline version';
721 } else return 'No record';
722 } else return 'Table does not support versioning.';
723 }
724
725 /**
726 * Check if "live" records from $table may be created or edited in this PID.
727 * If the answer is FALSE it means the only valid way to create or edit records in the PID is by versioning
728 * If the answer is 1 or 2 it means it is OK to create a record, if -1 it means that it is OK in terms of versioning because the element was within a versionized branch but NOT ok in terms of the state the root point had!
729 *
730 * @param integer PID value to check for.
731 * @param string Table name
732 * @return mixed Returns FALSE if a live record cannot be created and must be versionized in order to do so. 2 means a) Workspace is "Live" or workspace allows "live edit" of records from non-versionized tables (and the $table is not versionizable). 1 and -1 means the pid is inside a versionized branch where -1 means that the branch-point did NOT allow a new record according to its state.
733 */
734 function workspaceAllowLiveRecordsInPID($pid, $table) {
735
736 // Always for Live workspace AND if live-edit is enabled and tables are completely without versioning it is ok as well.
737 if ($this->workspace===0 || ($this->workspaceRec['live_edit'] && !$GLOBALS['TCA'][$table]['ctrl']['versioningWS']) || $GLOBALS['TCA'][$table]['ctrl']['versioningWS_alwaysAllowLiveEdit']) {
738 return 2; // OK to create for this table.
739 } elseif (t3lib_BEfunc::isPidInVersionizedBranch($pid, $table)) { // Check if records from $table can be created with this PID: Either if inside "branch" versioning type or a "versioning_followPages" table on a "page" versioning type.
740 // Now, check what the stage of that "page" or "branch" version type is:
741 $stage = t3lib_BEfunc::isPidInVersionizedBranch($pid, $table, TRUE);
742 return $this->workspaceCheckStageForCurrent($stage) ? 1 : -1;
743 } else {
744 return FALSE; // If the answer is FALSE it means the only valid way to create or edit records in the PID is by versioning
745 }
746 }
747
748 /**
749 * Evaluates if a record from $table can be created in $pid
750 *
751 * @param integer Page id. This value must be the _ORIG_uid if available: So when you have pages versionized as "page" or "element" you must supply the id of the page version in the workspace!
752 * @param string Table name
753 * @return boolean TRUE if OK.
754 */
755 function workspaceCreateNewRecord($pid, $table) {
756 if ($res = $this->workspaceAllowLiveRecordsInPID($pid,$table)) { // If LIVE records cannot be created in the current PID due to workspace restrictions, prepare creation of placeholder-record
757 if ($res<0) {
758 return FALSE; // Stage for versioning root point and users access level did not allow for editing
759 }
760 } elseif (!$GLOBALS['TCA'][$table]['ctrl']['versioningWS']) { // So, if no live records were allowed, we have to create a new version of this record:
761 return FALSE;
762 }
763 return TRUE;
764 }
765
766 /**
767 * Evaluates if auto creation of a version of a record is allowed.
768 *
769 * @param string Table of the record
770 * @param integer UID of record
771 * @param integer PID of record
772 * @return boolean TRUE if ok.
773 */
774 function workspaceAllowAutoCreation($table,$id,$recpid) {
775 // Auto-creation of version: In offline workspace, test if versioning is enabled and look for workspace version of input record. If there is no versionized record found we will create one and save to that.
776 if ($this->workspace!==0 // Only in draft workspaces
777 && !$this->workspaceRec['disable_autocreate'] // Auto-creation must not be disabled.
778 && $GLOBALS['TCA'][$table]['ctrl']['versioningWS'] // Table must be versionizable
779 && $recpid >= 0 // The PID of the record must NOT be -1 or less (would indicate that it already was a version!)
780 && !t3lib_BEfunc::getWorkspaceVersionOfRecord($this->workspace, $table, $id, 'uid') // There must be no existing version of this record in workspace.
781 && !t3lib_BEfunc::isPidInVersionizedBranch($recpid, $table)) { // PID must NOT be in a versionized branch either
782 return TRUE;
783 }
784 }
785
786 /**
787 * Checks if an element stage allows access for the user in the current workspace
788 * In workspaces 0 (Live) and -1 (Default draft) access is always granted for any stage.
789 * Admins are always allowed.
790 * An option for custom workspaces allows members to also edit when the stage is "Review"
791 *
792 * @param integer Stage id from an element: -1,0 = editing, 1 = reviewer, >1 = owner
793 * @return boolean TRUE if user is allowed access
794 */
795 function workspaceCheckStageForCurrent($stage) {
796 if ($this->isAdmin()) return TRUE;
797
798 if ($this->workspace>0) {
799 $stat = $this->checkWorkspaceCurrent();
800 $memberStageLimit = $this->workspaceRec['review_stage_edit'] ? 1 : 0;
801 if (($stage<=$memberStageLimit && $stat['_ACCESS']==='member') ||
802 ($stage<=1 && $stat['_ACCESS']==='reviewer') ||
803 ($stat['_ACCESS']==='owner')) {
804 return TRUE; // OK for these criteria
805 }
806 } else return TRUE; // Always OK for live and draft workspaces.
807 }
808
809 /**
810 * Returns TRUE if the user has access to publish content from the workspace ID given.
811 * Admin-users are always granted access to do this
812 * If the workspace ID is 0 (live) all users have access also
813 * If -1 (draft workspace) TRUE is returned if the user has access to the Live workspace
814 * For custom workspaces it depends on whether the user is owner OR like with draft workspace if the user has access to Live workspace.
815 *
816 * @param integer Workspace UID; -1,0,1+
817 * @return boolean Returns TRUE if the user has access to publish content from the workspace ID given.
818 */
819 function workspacePublishAccess($wsid) {
820 if ($this->isAdmin()) return TRUE;
821
822 // If no access to workspace, of course you cannot publish!
823 $retVal = FALSE;
824
825 $wsAccess = $this->checkWorkspace($wsid);
826 if ($wsAccess) {
827 switch($wsAccess['uid']) {
828 case 0: // Live workspace
829 $retVal = TRUE; // If access to Live workspace, no problem.
830 break;
831 case -1: // Default draft workspace
832 $retVal = $this->checkWorkspace(0) ? TRUE : FALSE; // If access to Live workspace, no problem.
833 break;
834 default: // Custom workspace
835 $retVal = $wsAccess['_ACCESS'] === 'owner' || ($this->checkWorkspace(0) && !($wsAccess['publish_access']&2)); // Either be an adminuser OR have access to online workspace which is OK as well as long as publishing access is not limited by workspace option.
836 break;
837 }
838 }
839 return $retVal;
840 }
841
842 /**
843 * Workspace swap-mode access?
844 *
845 * @return boolean Returns TRUE if records can be swapped in the current workspace, otherwise false
846 */
847 function workspaceSwapAccess() {
848 if ($this->workspace>0 && (int)$this->workspaceRec['swap_modes']===2) {
849 return FALSE;
850 } else return TRUE;
851 }
852
853 /**
854 * Workspace Versioning type access?
855 *
856 * @param integer Versioning type to evaluation: -1, 0, >1
857 * @return boolean TRUE if OK
858 */
859 function workspaceVersioningTypeAccess($type) {
860 $retVal = FALSE;
861
862 $type = t3lib_div::intInRange($type,-1);
863
864 // Check if only element versioning is allowed:
865 if ($GLOBALS['TYPO3_CONF_VARS']['BE']['elementVersioningOnly'] && $type!=-1) {
866 return FALSE;
867 }
868
869 if ($this->workspace>0 && !$this->isAdmin()) {
870 $stat = $this->checkWorkspaceCurrent();
871 if ($stat['_ACCESS']!=='owner') {
872
873 switch((int)$type) {
874 case -1:
875 $retVal = $this->workspaceRec['vtypes']&1 ? FALSE : TRUE;
876 break;
877 case 0:
878 $retVal = $this->workspaceRec['vtypes']&2 ? FALSE : TRUE;
879 break;
880 default:
881 $retVal = $this->workspaceRec['vtypes']&4 ? FALSE : TRUE;
882 break;
883 }
884 } else $retVal = TRUE;
885 } else $retVal = TRUE;
886
887 return $retVal;
888 }
889
890 /**
891 * Finding "closest" versioning type, used for creation of new records.
892 *
893 * @param integer Versioning type to evaluation: -1, 0, >1
894 * @return integer Returning versioning type
895 */
896 function workspaceVersioningTypeGetClosest($type) {
897 $type = t3lib_div::intInRange($type,-1);
898
899 if ($this->workspace>0) {
900 switch((int)$type) {
901 case -1:
902 $type = -1;
903 break;
904 case 0:
905 $type = $this->workspaceVersioningTypeAccess($type) ? $type : -1;
906 break;
907 default:
908 $type = $this->workspaceVersioningTypeAccess($type) ? $type : ($this->workspaceVersioningTypeAccess(0) ? 0 : -1);
909 break;
910 }
911 }
912 return $type;
913 }
914
915
916
917
918
919
920
921
922
923
924 /*************************************
925 *
926 * Miscellaneous functions
927 *
928 *************************************/
929
930 /**
931 * Returns the value/properties of a TS-object as given by $objectString, eg. 'options.dontMountAdminMounts'
932 * Nice (general!) function for returning a part of a TypoScript array!
933 *
934 * @param string Pointer to an "object" in the TypoScript array, fx. 'options.dontMountAdminMounts'
935 * @param array Optional TSconfig array: If array, then this is used and not $this->userTS. If not array, $this->userTS is used.
936 * @return array An array with two keys, "value" and "properties" where "value" is a string with the value of the objectsting and "properties" is an array with the properties of the objectstring.
937 * @params array An array with the TypoScript where the $objectString is located. If this argument is not an array, then internal ->userTS (User TSconfig for the current BE_USER) will be used instead.
938 */
939 function getTSConfig($objectString,$config='') {
940 if (!is_array($config)) {
941 $config=$this->userTS; // Getting Root-ts if not sent
942 }
943 $TSConf=array();
944 $parts = explode('.',$objectString,2);
945 $key = $parts[0];
946 if (trim($key)) {
947 if (count($parts)>1 && trim($parts[1])) {
948 // Go on, get the next level
949 if (is_array($config[$key.'.'])) $TSConf = $this->getTSConfig($parts[1],$config[$key.'.']);
950 } else {
951 $TSConf['value']=$config[$key];
952 $TSConf['properties']=$config[$key.'.'];
953 }
954 }
955 return $TSConf;
956 }
957
958 /**
959 * Returns the "value" of the $objectString from the BE_USERS "User TSconfig" array
960 *
961 * @param string Object string, eg. "somestring.someproperty.somesubproperty"
962 * @return string The value for that object string (object path)
963 * @see getTSConfig()
964 */
965 function getTSConfigVal($objectString) {
966 $TSConf = $this->getTSConfig($objectString);
967 return $TSConf['value'];
968 }
969
970 /**
971 * Returns the "properties" of the $objectString from the BE_USERS "User TSconfig" array
972 *
973 * @param string Object string, eg. "somestring.someproperty.somesubproperty"
974 * @return array The properties for that object string (object path) - if any
975 * @see getTSConfig()
976 */
977 function getTSConfigProp($objectString) {
978 $TSConf = $this->getTSConfig($objectString);
979 return $TSConf['properties'];
980 }
981
982 /**
983 * Returns true if $item is in $in_list
984 *
985 * @param string Comma list with items, no spaces between items!
986 * @param string The string to find in the list of items
987 * @return string Boolean
988 */
989 function inList($in_list,$item) {
990 return strstr(','.$in_list.',', ','.$item.',');
991 }
992
993 /**
994 * Returns an array with the webmounts.
995 * If no webmounts, and empty array is returned.
996 * NOTICE: Deleted pages WILL NOT be filtered out! So if a mounted page has been deleted it is STILL coming out as a webmount. This is not checked due to performance.
997 *
998 * @return array
999 */
1000 function returnWebmounts() {
1001 return (string)($this->groupData['webmounts'])!='' ? explode(',',$this->groupData['webmounts']) : Array();
1002 }
1003
1004 /**
1005 * Returns an array with the filemounts for the user. Each filemount is represented with an array of a "name", "path" and "type".
1006 * If no filemounts an empty array is returned.
1007 *
1008 * @return array
1009 */
1010 function returnFilemounts() {
1011 return $this->groupData['filemounts'];
1012 }
1013
1014 /**
1015 * Returns an integer bitmask that represents the permissions for file operations.
1016 * Permissions of the user and groups the user is a member of were combined by a logical OR.
1017 *
1018 * Meaning of each bit:
1019 * 1 - Files: Upload,Copy,Move,Delete,Rename
1020 * 2 - Files: Unzip
1021 * 4 - Directory: Move,Delete,Rename,New
1022 * 8 - Directory: Copy
1023 * 16 - Directory: Delete recursively (rm -Rf)
1024 *
1025 * @return integer File operation permission bitmask
1026 */
1027 public function getFileoperationPermissions() {
1028 if ($this->isAdmin()) {
1029 return 31;
1030 } else {
1031 return $this->groupData['fileoper_perms'];
1032 }
1033 }
1034
1035 /**
1036 * Returns true or false, depending if an alert popup (a javascript confirmation) should be shown
1037 * call like $GLOBALS['BE_USER']->jsConfirmation($BITMASK)
1038 *
1039 * 1 - typeChange
1040 * 2 - copy/move/paste
1041 * 4 - delete
1042 * 8 - frontend editing
1043 * 128 - other (not used yet)
1044 *
1045 * @param integer Bitmask
1046 * @return boolean true if the confirmation should be shown
1047 */
1048 function jsConfirmation($bitmask) {
1049 $alertPopup = $GLOBALS['BE_USER']->getTSConfig('options.alertPopups');
1050 if (empty($alertPopup['value'])) {
1051 $alertPopup = 255; // default: show all warnings
1052 } else {
1053 $alertPopup = (int)$alertPopup['value'];
1054 }
1055 if(($alertPopup&$bitmask) == $bitmask) { // show confirmation
1056 return 1;
1057 } else { // don't show confirmation
1058 return 0;
1059 }
1060 }
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070 /*************************************
1071 *
1072 * Authentication methods
1073 *
1074 *************************************/
1075
1076
1077 /**
1078 * Initializes a lot of stuff like the access-lists, database-mountpoints and filemountpoints
1079 * This method is called by ->backendCheckLogin() (from extending class t3lib_beuserauth) if the backend user login has verified OK.
1080 * Generally this is required initialization of a backend user.
1081 *
1082 * @return void
1083 * @access private
1084 * @see t3lib_TSparser
1085 */
1086 function fetchGroupData() {
1087 if ($this->user['uid']) {
1088
1089 // Get lists for the be_user record and set them as default/primary values.
1090 $this->dataLists['modList'] = $this->user['userMods']; // Enabled Backend Modules
1091 $this->dataLists['allowed_languages'] = $this->user['allowed_languages']; // Add Allowed Languages
1092 $this->dataLists['workspace_perms'] = $this->user['workspace_perms']; // Set user value for workspace permissions.
1093 $this->dataLists['webmount_list'] = $this->user['db_mountpoints']; // Database mountpoints
1094 $this->dataLists['filemount_list'] = $this->user['file_mountpoints']; // File mountpoints
1095 $this->dataLists['fileoper_perms'] = (int)$this->user['fileoper_perms']; // Fileoperation permissions
1096
1097 // Setting default User TSconfig:
1098 $this->TSdataArray[]=$this->addTScomment('From $GLOBALS["TYPO3_CONF_VARS"]["BE"]["defaultUserTSconfig"]:').
1099 $GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUserTSconfig'];
1100
1101 // Default TSconfig for admin-users
1102 if ($this->isAdmin()) {
1103 $this->TSdataArray[]=$this->addTScomment('"admin" user presets:').'
1104 admPanel.enable.all = 1
1105 options.shortcutFrame = 1
1106 ';
1107 if (t3lib_extMgm::isLoaded('sys_note')) {
1108 $this->TSdataArray[]='
1109 // Setting defaults for sys_note author / email...
1110 TCAdefaults.sys_note.author = '.$this->user['realName'].'
1111 TCAdefaults.sys_note.email = '.$this->user['email'].'
1112 ';
1113 }
1114 }
1115
1116 // FILE MOUNTS:
1117 // Admin users has the base fileadmin dir mounted
1118 if ($this->isAdmin() && $GLOBALS['TYPO3_CONF_VARS']['BE']['fileadminDir']) {
1119 $this->addFileMount($GLOBALS['TYPO3_CONF_VARS']['BE']['fileadminDir'], '', PATH_site.$GLOBALS['TYPO3_CONF_VARS']['BE']['fileadminDir'], 0, '');
1120 }
1121
1122 // If userHomePath is set, we attempt to mount it
1123 if ($GLOBALS['TYPO3_CONF_VARS']['BE']['userHomePath']) {
1124 // First try and mount with [uid]_[username]
1125 $didMount=$this->addFileMount($this->user['username'], '',$GLOBALS['TYPO3_CONF_VARS']['BE']['userHomePath'].$this->user['uid'].'_'.$this->user['username'].$GLOBALS['TYPO3_CONF_VARS']['BE']['userUploadDir'], 0, 'user');
1126 if (!$didMount) {
1127 // If that failed, try and mount with only [uid]
1128 $this->addFileMount($this->user['username'], '', $GLOBALS['TYPO3_CONF_VARS']['BE']['userHomePath'].$this->user['uid'].$GLOBALS['TYPO3_CONF_VARS']['BE']['userUploadDir'], 0, 'user');
1129 }
1130 }
1131
1132 // BE_GROUPS:
1133 // Get the groups...
1134 # $grList = t3lib_BEfunc::getSQLselectableList($this->user[$this->usergroup_column],$this->usergroup_table,$this->usergroup_table);
1135 $grList = $GLOBALS['TYPO3_DB']->cleanIntList($this->user[$this->usergroup_column]); // 240203: Since the group-field never contains any references to groups with a prepended table name we think it's safe to just intExplode and re-implode - which should be much faster than the other function call.
1136 if ($grList) {
1137 // Fetch groups will add a lot of information to the internal arrays: modules, accesslists, TSconfig etc. Refer to fetchGroups() function.
1138 $this->fetchGroups($grList);
1139 }
1140
1141 // Add the TSconfig for this specific user:
1142 $this->TSdataArray[] = $this->addTScomment('USER TSconfig field').$this->user['TSconfig'];
1143 // Check include lines.
1144 $this->TSdataArray = t3lib_TSparser::checkIncludeLines_array($this->TSdataArray);
1145
1146 // Parsing the user TSconfig (or getting from cache)
1147 $this->userTS_text = implode(chr(10).'[GLOBAL]'.chr(10),$this->TSdataArray); // Imploding with "[global]" will make sure that non-ended confinements with braces are ignored.
1148 $hash = md5('userTS:'.$this->userTS_text);
1149 $cachedContent = t3lib_BEfunc::getHash($hash);
1150 if (isset($cachedContent) && !$this->userTS_dontGetCached) {
1151 $this->userTS = unserialize($cachedContent);
1152 } else {
1153 $parseObj = t3lib_div::makeInstance('t3lib_TSparser');
1154 $parseObj->parse($this->userTS_text);
1155 $this->userTS = $parseObj->setup;
1156 t3lib_BEfunc::storeHash($hash,serialize($this->userTS),'BE_USER_TSconfig');
1157 // Update UC:
1158 $this->userTSUpdated=1;
1159 }
1160
1161 // Processing webmounts
1162 if ($this->isAdmin() && !$this->getTSConfigVal('options.dontMountAdminMounts')) { // Admin's always have the root mounted
1163 $this->dataLists['webmount_list']='0,'.$this->dataLists['webmount_list'];
1164 }
1165
1166 // Processing filemounts
1167 $this->dataLists['filemount_list'] = t3lib_div::uniqueList($this->dataLists['filemount_list']);
1168 if ($this->dataLists['filemount_list']) {
1169 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('*', 'sys_filemounts', 'deleted=0 AND hidden=0 AND pid=0 AND uid IN ('.$this->dataLists['filemount_list'].')');
1170 while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
1171 $this->addFileMount($row['title'], $row['path'], $row['path'], $row['base']?1:0, '');
1172 }
1173 }
1174
1175 // The lists are cleaned for duplicates
1176 $this->groupData['webmounts'] = t3lib_div::uniqueList($this->dataLists['webmount_list']);
1177 $this->groupData['pagetypes_select'] = t3lib_div::uniqueList($this->dataLists['pagetypes_select']);
1178 $this->groupData['tables_select'] = t3lib_div::uniqueList($this->dataLists['tables_modify'].','.$this->dataLists['tables_select']);
1179 $this->groupData['tables_modify'] = t3lib_div::uniqueList($this->dataLists['tables_modify']);
1180 $this->groupData['non_exclude_fields'] = t3lib_div::uniqueList($this->dataLists['non_exclude_fields']);
1181 $this->groupData['explicit_allowdeny'] = t3lib_div::uniqueList($this->dataLists['explicit_allowdeny']);
1182 $this->groupData['allowed_languages'] = t3lib_div::uniqueList($this->dataLists['allowed_languages']);
1183 $this->groupData['custom_options'] = t3lib_div::uniqueList($this->dataLists['custom_options']);
1184 $this->groupData['modules'] = t3lib_div::uniqueList($this->dataLists['modList']);
1185 $this->groupData['fileoper_perms'] = $this->dataLists['fileoper_perms'];
1186 $this->groupData['workspace_perms'] = $this->dataLists['workspace_perms'];
1187
1188 // populating the $this->userGroupsUID -array with the groups in the order in which they were LAST included.!!
1189 $this->userGroupsUID = array_reverse(array_unique(array_reverse($this->includeGroupArray)));
1190
1191 // Finally this is the list of group_uid's in the order they are parsed (including subgroups!) and without duplicates (duplicates are presented with their last entrance in the list, which thus reflects the order of the TypoScript in TSconfig)
1192 $this->groupList = implode(',',$this->userGroupsUID);
1193 $this->setCachedList($this->groupList);
1194
1195 // Checking read access to webmounts:
1196 if (trim($this->groupData['webmounts'])!=='') {
1197 $webmounts = explode(',',$this->groupData['webmounts']); // Explode mounts
1198 $MProws = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows('uid', 'pages', 'deleted=0 AND uid IN ('.$this->groupData['webmounts'].') AND '.$this->getPagePermsClause(1),'','','','uid'); // Selecting all webmounts with permission clause for reading
1199 foreach($webmounts as $idx => $mountPointUid) {
1200 if ($mountPointUid>0 && !isset($MProws[$mountPointUid])) { // If the mount ID is NOT found among selected pages, unset it:
1201 unset($webmounts[$idx]);
1202 }
1203 }
1204 $this->groupData['webmounts'] = implode(',',$webmounts); // Implode mounts in the end.
1205 }
1206
1207 // Setting up workspace situation (after webmounts are processed!):
1208 $this->workspaceInit();
1209 }
1210 }
1211
1212 /**
1213 * Fetches the group records, subgroups and fills internal arrays.
1214 * Function is called recursively to fetch subgroups
1215 *
1216 * @param string Commalist of be_groups uid numbers
1217 * @param string List of already processed be_groups-uids so the function will not fall into a eternal recursion.
1218 * @return void
1219 * @access private
1220 */
1221 function fetchGroups($grList,$idList='') {
1222 global $TYPO3_CONF_VARS;
1223
1224 // Fetching records of the groups in $grList (which are not blocked by lockedToDomain either):
1225 $lockToDomain_SQL = ' AND (lockToDomain=\'\' OR lockToDomain IS NULL OR lockToDomain=\''.t3lib_div::getIndpEnv('HTTP_HOST').'\')';
1226 $whereSQL = 'deleted=0 AND hidden=0 AND pid=0 AND uid IN ('.$grList.')'.$lockToDomain_SQL;
1227
1228 // Hook for manipulation of the WHERE sql sentence which controls which BE-groups are included
1229 if (is_array ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['fetchGroupQuery'])) {
1230 foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['fetchGroupQuery'] as $classRef) {
1231 $hookObj = &t3lib_div::getUserObj($classRef);
1232 if(method_exists($hookObj,'fetchGroupQuery_processQuery')){
1233 $whereSQL = $hookObj->fetchGroupQuery_processQuery($this, $grList, $idList, $whereSQL);
1234 }
1235 }
1236 }
1237
1238 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('*', $this->usergroup_table, $whereSQL);
1239
1240 // The userGroups array is filled
1241 while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
1242 $this->userGroups[$row['uid']] = $row;
1243 }
1244
1245 // Traversing records in the correct order
1246 $include_staticArr = t3lib_div::intExplode(',',$grList);
1247 reset($include_staticArr);
1248 while(list(,$uid)=each($include_staticArr)) { // traversing list
1249
1250 // Get row:
1251 $row=$this->userGroups[$uid];
1252 if (is_array($row) && !t3lib_div::inList($idList,$uid)) { // Must be an array and $uid should not be in the idList, because then it is somewhere previously in the grouplist
1253
1254 // Include sub groups
1255 if (trim($row['subgroup'])) {
1256 $theList = implode(',',t3lib_div::intExplode(',',$row['subgroup'])); // Make integer list
1257 $this->fetchGroups($theList, $idList.','.$uid); // Call recursively, pass along list of already processed groups so they are not recursed again.
1258 }
1259 // Add the group uid, current list, TSconfig to the internal arrays.
1260 $this->includeGroupArray[]=$uid;
1261 $this->includeHierarchy[]=$idList;
1262 $this->TSdataArray[] = $this->addTScomment('Group "'.$row['title'].'" ['.$row['uid'].'] TSconfig field:').$row['TSconfig'];
1263
1264 // Mount group database-mounts
1265 if (($this->user['options']&1) == 1) { $this->dataLists['webmount_list'].= ','.$row['db_mountpoints']; }
1266
1267 // Mount group file-mounts
1268 if (($this->user['options']&2) == 2) { $this->dataLists['filemount_list'].= ','.$row['file_mountpoints']; }
1269
1270 // Mount group home-dirs
1271 if (($this->user['options']&2) == 2) {
1272 // If groupHomePath is set, we attempt to mount it
1273 if ($GLOBALS['TYPO3_CONF_VARS']['BE']['groupHomePath']) {
1274 $this->addFileMount($row['title'], '', $GLOBALS['TYPO3_CONF_VARS']['BE']['groupHomePath'].$row['uid'], 0, 'group');
1275 }
1276 }
1277
1278 // The lists are made: groupMods, tables_select, tables_modify, pagetypes_select, non_exclude_fields, explicit_allowdeny, allowed_languages, custom_options
1279 if ($row['inc_access_lists']==1) {
1280 $this->dataLists['modList'].= ','.$row['groupMods'];
1281 $this->dataLists['tables_select'].= ','.$row['tables_select'];
1282 $this->dataLists['tables_modify'].= ','.$row['tables_modify'];
1283 $this->dataLists['pagetypes_select'].= ','.$row['pagetypes_select'];
1284 $this->dataLists['non_exclude_fields'].= ','.$row['non_exclude_fields'];
1285 $this->dataLists['explicit_allowdeny'].= ','.$row['explicit_allowdeny'];
1286 $this->dataLists['allowed_languages'].= ','.$row['allowed_languages'];
1287 $this->dataLists['custom_options'].= ','.$row['custom_options'];
1288 }
1289
1290 // Setting fileoperation permissions
1291 $this->dataLists['fileoper_perms'] |= (int)$row['fileoper_perms'];
1292
1293 // Setting workspace permissions:
1294 $this->dataLists['workspace_perms'] |= $row['workspace_perms'];
1295
1296 // If this function is processing the users OWN group-list (not subgroups) AND if the ->firstMainGroup is not set, then the ->firstMainGroup will be set.
1297 if (!strcmp($idList,'') && !$this->firstMainGroup) {
1298 $this->firstMainGroup=$uid;
1299 }
1300 }
1301 }
1302
1303 // ****************
1304 // HOOK: fetchGroups_postProcessing
1305 // ****************
1306 if (is_array($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['fetchGroups_postProcessing'])) {
1307 foreach($TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/class.t3lib_userauthgroup.php']['fetchGroups_postProcessing'] as $_funcRef) {
1308 $_params = array();
1309 t3lib_div::callUserFunction($_funcRef, $_params, $this);
1310 }
1311 }
1312 }
1313
1314 /**
1315 * Updates the field be_users.usergroup_cached_list if the groupList of the user has changed/is different from the current list.
1316 * The field "usergroup_cached_list" contains the list of groups which the user is a member of. After authentication (where these functions are called...) one can depend on this list being a representation of the exact groups/subgroups which the BE_USER has membership with.
1317 *
1318 * @param string The newly compiled group-list which must be compared with the current list in the user record and possibly stored if a difference is detected.
1319 * @return void
1320 * @access private
1321 */
1322 function setCachedList($cList) {
1323 if ((string)$cList != (string)$this->user['usergroup_cached_list']) {
1324 $GLOBALS['TYPO3_DB']->exec_UPDATEquery('be_users', 'uid='.intval($this->user['uid']), array('usergroup_cached_list' => $cList));
1325 }
1326 }
1327
1328 /**
1329 * Adds a filemount to the users array of filemounts, $this->groupData['filemounts'][hash_key] = Array ('name'=>$name, 'path'=>$path, 'type'=>$type);
1330 * Is a part of the authentication proces of the user.
1331 * A final requirement for a path being mounted is that a) it MUST return true on is_dir(), b) must contain either PATH_site+'fileadminDir' OR 'lockRootPath' - if lockRootPath is set - as first part of string!
1332 * Paths in the mounted information will always be absolute and have a trailing slash.
1333 *
1334 * @param string $title will be the (root)name of the filemount in the folder tree
1335 * @param string $altTitle will be the (root)name of the filemount IF $title is not true (blank or zero)
1336 * @param string $path is the path which should be mounted. Will accept backslash in paths on windows servers (will substituted with forward slash). The path should be 1) relative to TYPO3_CONF_VARS[BE][fileadminDir] if $webspace is set, otherwise absolute.
1337 * @param boolean If $webspace is set, the $path is relative to 'fileadminDir' in TYPO3_CONF_VARS, otherwise $path is absolute. 'fileadminDir' must be set to allow mounting of relative paths.
1338 * @param string Type of filemount; Can be blank (regular) or "user" / "group" (for user and group filemounts presumably). Probably sets the icon first and foremost.
1339 * @return boolean Returns "1" if the requested filemount was mounted, otherwise no return value.
1340 * @access private
1341 */
1342 function addFileMount($title, $altTitle, $path, $webspace, $type) {
1343 // Return false if fileadminDir is not set and we try to mount a relative path
1344 if ($webspace && !$GLOBALS['TYPO3_CONF_VARS']['BE']['fileadminDir']) return false;
1345
1346 // Trimming and pre-processing
1347 $path=trim($path);
1348 if ($this->OS=='WIN') { // with WINDOWS convert backslash to slash!!
1349 $path=str_replace('\\','/',$path);
1350 }
1351 // If the path is true and validates as a valid path string:
1352 if ($path && t3lib_div::validPathStr($path)) {
1353 // normalize path: remove leading '/' and './', and trailing '/' and '/.'
1354 $path=trim($path);
1355 $path=preg_replace('#^\.?/|/\.?$#','',$path);
1356
1357 if ($path) { // there must be some chars in the path
1358 $fdir=PATH_site.$GLOBALS['TYPO3_CONF_VARS']['BE']['fileadminDir']; // fileadmin dir, absolute
1359 if ($webspace) {
1360 $path=$fdir.$path; // PATH_site + fileadmin dir is prepended
1361 } else {
1362 if ($this->OS!='WIN') { // with WINDOWS no prepending!!
1363 $path='/'.$path; // root-level is the start...
1364 }
1365 }
1366 $path.='/';
1367
1368 // We now have a path with slash after and slash before (if unix)
1369 if (@is_dir($path) &&
1370 (($GLOBALS['TYPO3_CONF_VARS']['BE']['lockRootPath'] && t3lib_div::isFirstPartOfStr($path,$GLOBALS['TYPO3_CONF_VARS']['BE']['lockRootPath'])) || t3lib_div::isFirstPartOfStr($path,$fdir))) {
1371 // Alternative title?
1372 $name = $title ? $title : $altTitle;
1373 // Adds the filemount. The same filemount with same name, type and path cannot be set up twice because of the hash string used as key.
1374 $this->groupData['filemounts'][md5($name.'|'.$path.'|'.$type)] = Array('name'=>$name, 'path'=>$path, 'type'=>$type);
1375 // Return true - went well, success!
1376 return 1;
1377 }
1378 }
1379 }
1380 }
1381
1382 /**
1383 * Creates a TypoScript comment with the string text inside.
1384 *
1385 * @param string The text to wrap in comment prefixes and delimiters.
1386 * @return string TypoScript comment with the string text inside.
1387 */
1388 function addTScomment($str) {
1389 $delimiter = '# ***********************************************';
1390
1391 $out = $delimiter.chr(10);
1392 $lines = t3lib_div::trimExplode(chr(10),$str);
1393 foreach($lines as $v) {
1394 $out.= '# '.$v.chr(10);
1395 }
1396 $out.= $delimiter.chr(10);
1397 return $out;
1398 }
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411 /************************************
1412 *
1413 * Workspaces
1414 *
1415 ************************************/
1416
1417 /**
1418 * Initializing workspace.
1419 * Called from within this function, see fetchGroupData()
1420 *
1421 * @return void
1422 * @see fetchGroupData()
1423 */
1424 function workspaceInit() {
1425
1426 // Initializing workspace by evaluating and setting the workspace, possibly updating it in the user record!
1427 $this->setWorkspace($this->user['workspace_id']);
1428
1429 // Setting up the db mount points of the (custom) workspace, if any:
1430 if ($this->workspace>0 && trim($this->workspaceRec['db_mountpoints'])!=='') {
1431
1432 // Initialize:
1433 $newMounts = array();
1434 $readPerms = '1=1'; // Notice: We cannot call $this->getPagePermsClause(1); as usual because the group-list is not available at this point. But bypassing is fine because all we want here is check if the workspace mounts are inside the current webmounts rootline. The actual permission checking on page level is done elsewhere as usual anyway before the page tree is rendered.
1435
1436 // Traverse mount points of the
1437 $mountPoints = t3lib_div::intExplode(',',$this->workspaceRec['db_mountpoints']);
1438 foreach($mountPoints as $mpId) {
1439 if ($this->isInWebMount($mpId,$readPerms)) {
1440 $newMounts[] = $mpId;
1441 }
1442 }
1443
1444 // Re-insert webmounts:
1445 $this->groupData['webmounts'] = implode(',',array_unique($newMounts));
1446 }
1447
1448 // Setting up the file mount points of the (custom) workspace, if any:
1449 if ($this->workspace!==0) $this->groupData['filemounts'] = array();
1450 if ($this->workspace>0 && trim($this->workspaceRec['file_mountpoints'])!=='') {
1451
1452 // Processing filemounts
1453 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery('*', 'sys_filemounts', 'deleted=0 AND hidden=0 AND pid=0 AND uid IN ('.$GLOBALS['TYPO3_DB']->cleanIntList($this->workspaceRec['file_mountpoints']).')');
1454 while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
1455 $this->addFileMount($row['title'], $row['path'], $row['path'], $row['base']?1:0, '');
1456 }
1457 }
1458 }
1459
1460 /**
1461 * Checking if a workspace is allowed for backend user
1462 *
1463 * @param mixed If integer, workspace record is looked up, if array it is seen as a Workspace record with at least uid, title, members and adminusers columns. Can be faked for workspaces uid 0 and -1 (online and offline)
1464 * @param string List of fields to select. Default fields are: uid,title,adminusers,members,reviewers,publish_access,stagechg_notification
1465 * @return array TRUE if access. Output will also show how access was granted. Admin users will have a true output regardless of input.
1466 */
1467 function checkWorkspace($wsRec,$fields='uid,title,adminusers,members,reviewers,publish_access,stagechg_notification') {
1468 $retVal = FALSE;
1469
1470 // If not array, look up workspace record:
1471 if (!is_array($wsRec)) {
1472 switch((string)$wsRec) {
1473 case '0':
1474 case '-1':
1475 $wsRec = array('uid' => $wsRec);
1476 break;
1477 default:
1478 list($wsRec) = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows(
1479 $fields,
1480 'sys_workspace',
1481 'pid=0 AND uid='.intval($wsRec).
1482 t3lib_BEfunc::deleteClause('sys_workspace'),
1483 '',
1484 'title'
1485 );
1486 break;
1487 }
1488 }
1489
1490 // If wsRec is set to an array, evaluate it:
1491 if (is_array($wsRec)) {
1492 if ($this->isAdmin()) {
1493 return array_merge($wsRec,array('_ACCESS' => 'admin'));
1494 } else {
1495
1496 switch((string)$wsRec['uid']) {
1497 case '0':
1498 $retVal = ($this->groupData['workspace_perms']&1) ? array_merge($wsRec,array('_ACCESS' => 'online')) : FALSE;
1499 break;
1500 case '-1':
1501 $retVal = ($this->groupData['workspace_perms']&2) ? array_merge($wsRec,array('_ACCESS' => 'offline')) : FALSE;
1502 break;
1503 default:
1504 // Checking if the guy is admin:
1505 if (t3lib_div::inList($wsRec['adminusers'],$this->user['uid'])) {
1506 return array_merge($wsRec, array('_ACCESS' => 'owner'));
1507 }
1508 // Checking if he is reviewer user:
1509 if (t3lib_div::inList($wsRec['reviewers'],'be_users_'.$this->user['uid'])) {
1510 return array_merge($wsRec, array('_ACCESS' => 'reviewer'));
1511 }
1512 // Checking if he is reviewer through a user group of his:
1513 foreach($this->userGroupsUID as $groupUid) {
1514 if (t3lib_div::inList($wsRec['reviewers'],'be_groups_'.$groupUid)) {
1515 return array_merge($wsRec, array('_ACCESS' => 'reviewer'));
1516 }
1517 }
1518 // Checking if he is member as user:
1519 if (t3lib_div::inList($wsRec['members'],'be_users_'.$this->user['uid'])) {
1520 return array_merge($wsRec, array('_ACCESS' => 'member'));
1521 }
1522 // Checking if he is member through a user group of his:
1523 foreach($this->userGroupsUID as $groupUid) {
1524 if (t3lib_div::inList($wsRec['members'],'be_groups_'.$groupUid)) {
1525 return array_merge($wsRec, array('_ACCESS' => 'member'));
1526 }
1527 }
1528 break;
1529 }
1530 }
1531 }
1532
1533 return $retVal;
1534 }
1535
1536 /**
1537 * Uses checkWorkspace() to check if current workspace is available for user. This function caches the result and so can be called many times with no performance loss.
1538 *
1539 * @return array See checkWorkspace()
1540 * @see checkWorkspace()
1541 */
1542 function checkWorkspaceCurrent() {
1543 if (!isset($this->checkWorkspaceCurrent_cache)) {
1544 $this->checkWorkspaceCurrent_cache = $this->checkWorkspace($this->workspace);
1545 }
1546 return $this->checkWorkspaceCurrent_cache;
1547 }
1548
1549 /**
1550 * Setting workspace ID
1551 *
1552 * @param integer ID of workspace to set for backend user. If not valid the default workspace for BE user is found and set.
1553 * @return void
1554 */
1555 function setWorkspace($workspaceId) {
1556
1557 // Check workspace validity and if not found, revert to default workspace.
1558 if ($this->workspaceRec = $this->checkWorkspace($workspaceId,'*')) {
1559 // Set workspace ID internally
1560 $this->workspace = (int)$workspaceId;
1561 } else {
1562 $this->workspace = (int)$this->getDefaultWorkspace();
1563 $this->workspaceRec = $this->checkWorkspace($this->workspace,'*');
1564 }
1565
1566 // Unset access cache:
1567 unset($this->checkWorkspaceCurrent_cache);
1568
1569 // If ID is different from the stored one, change it:
1570 if (strcmp($this->workspace, $this->user['workspace_id'])) {
1571 $this->user['workspace_id'] = $this->workspace;
1572 $GLOBALS['TYPO3_DB']->exec_UPDATEquery('be_users','uid='.intval($this->user['uid']),array('workspace_id' => $this->user['workspace_id']));
1573 $this->simplelog('User changed workspace to "'.$this->workspace.'"');
1574 }
1575 }
1576
1577 /**
1578 * Setting workspace preview state for user:
1579 *
1580 * @param boolean State of user preview.
1581 * @return void
1582 */
1583 function setWorkspacePreview($previewState) {
1584 $this->user['workspace_preview'] = $previewState;
1585 $GLOBALS['TYPO3_DB']->exec_UPDATEquery('be_users','uid='.intval($this->user['uid']),array('workspace_preview' => $this->user['workspace_preview']));
1586 }
1587
1588 /**
1589 * Return default workspace ID for user
1590 *
1591 * @return integer Default workspace id. If no workspace is available it will be "-99"
1592 */
1593 function getDefaultWorkspace() {
1594
1595 if ($this->checkWorkspace(0)) { // Check online
1596 return 0;
1597 } elseif ($this->checkWorkspace(-1)) { // Check offline
1598 return -1;
1599 } else { // Traverse custom workspaces:
1600 $workspaces = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows('uid,title,adminusers,members,reviewers','sys_workspace','pid=0'.t3lib_BEfunc::deleteClause('sys_workspace'),'','title');
1601 foreach($workspaces as $rec) {
1602 if ($this->checkWorkspace($rec)) {
1603 return $rec['uid'];
1604 }
1605 }
1606 }
1607 return -99;
1608 }
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620 /************************************
1621 *
1622 * Logging
1623 *
1624 ************************************/
1625
1626 /**
1627 * Writes an entry in the logfile/table
1628 * Documentation in "TYPO3 Core API"
1629 *
1630 * @param integer Denotes which module that has submitted the entry. See "TYPO3 Core API". Use "4" for extensions.
1631 * @param integer Denotes which specific operation that wrote the entry. Use "0" when no sub-categorizing applies
1632 * @param integer Flag. 0 = message, 1 = error (user problem), 2 = System Error (which should not happen), 3 = security notice (admin)
1633 * @param integer The message number. Specific for each $type and $action. This will make it possible to translate errormessages to other languages
1634 * @param string Default text that follows the message (in english!). Possibly translated by identification through type/action/details_nr
1635 * @param array Data that follows the log. Might be used to carry special information. If an array the first 5 entries (0-4) will be sprintf'ed with the details-text
1636 * @param string Table name. Special field used by tce_main.php.
1637 * @param integer Record UID. Special field used by tce_main.php.
1638 * @param integer Record PID. Special field used by tce_main.php. OBSOLETE
1639 * @param integer The page_uid (pid) where the event occurred. Used to select log-content for specific pages.
1640 * @param string Special field used by tce_main.php. NEWid string of newly created records.
1641 * @param integer Alternative Backend User ID (used for logging login actions where this is not yet known).
1642 * @return integer Log entry ID.
1643 */
1644 function writelog($type,$action,$error,$details_nr,$details,$data,$tablename='',$recuid='',$recpid='',$event_pid=-1,$NEWid='',$userId=0) {
1645
1646 $fields_values = Array (
1647 'userid' => $userId ? $userId : intval($this->user['uid']),
1648 'type' => intval($type),
1649 'action' => intval($action),
1650 'error' => intval($error),
1651 'details_nr' => intval($details_nr),
1652 'details' => $details,
1653 'log_data' => serialize($data),
1654 'tablename' => $tablename,
1655 'recuid' => intval($recuid),
1656 # 'recpid' => intval($recpid),
1657 'IP' => t3lib_div::getIndpEnv('REMOTE_ADDR'),
1658 'tstamp' => $GLOBALS['EXEC_TIME'],
1659 'event_pid' => intval($event_pid),
1660 'NEWid' => $NEWid,
1661 'workspace' => $this->workspace
1662 );
1663
1664 $GLOBALS['TYPO3_DB']->exec_INSERTquery('sys_log', $fields_values);
1665 return $GLOBALS['TYPO3_DB']->sql_insert_id();
1666 }
1667
1668 /**
1669 * Simple logging function
1670 *
1671 * @param string Log message
1672 * @param string Option extension key / module name
1673 * @param integer Error level. 0 = message, 1 = error (user problem), 2 = System Error (which should not happen), 3 = security notice (admin)
1674 * @return integer Log entry UID
1675 */
1676 function simplelog($message, $extKey='', $error=0) {
1677 return $this->writelog(
1678 4,
1679 0,
1680 $error,
1681 0,
1682 ($extKey?'['.$extKey.'] ':'').$message,
1683 array()
1684 );
1685 }
1686
1687 /**
1688 * Sends a warning to $email if there has been a certain amount of failed logins during a period.
1689 * If a login fails, this function is called. It will look up the sys_log to see if there has been more than $max failed logins the last $secondsBack seconds (default 3600). If so, an email with a warning is sent to $email.
1690 *
1691 * @param string Email address
1692 * @param integer Number of sections back in time to check. This is a kind of limit for how many failures an hour for instance.
1693 * @param integer Max allowed failures before a warning mail is sent
1694 * @return void
1695 * @access private
1696 */
1697 function checkLogFailures($email, $secondsBack=3600, $max=3) {
1698
1699 if ($email) {
1700
1701 // get last flag set in the log for sending
1702 $theTimeBack = time()-$secondsBack;
1703 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
1704 'tstamp',
1705 'sys_log',
1706 'type=255 AND action=4 AND tstamp>'.intval($theTimeBack),
1707 '',
1708 'tstamp DESC',
1709 '1'
1710 );
1711 if ($testRow = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
1712 $theTimeBack = $testRow['tstamp'];
1713 }
1714
1715 // Check for more than $max number of error failures with the last period.
1716 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
1717 '*',
1718 'sys_log',
1719 'type=255 AND action=3 AND error!=0 AND tstamp>'.intval($theTimeBack),
1720 '',
1721 'tstamp'
1722 );
1723 if ($GLOBALS['TYPO3_DB']->sql_num_rows($res) > $max) {
1724 // OK, so there were more than the max allowed number of login failures - so we will send an email then.
1725 $subject = 'TYPO3 Login Failure Warning (at '.$GLOBALS['TYPO3_CONF_VARS']['SYS']['sitename'].')';
1726 $email_body = '
1727 There has been numerous attempts ('.$GLOBALS['TYPO3_DB']->sql_num_rows($res).') to login at the TYPO3
1728 site "'.$GLOBALS['TYPO3_CONF_VARS']['SYS']['sitename'].'" ('.t3lib_div::getIndpEnv('HTTP_HOST').').
1729
1730 This is a dump of the failures:
1731
1732 ';
1733 while($testRows = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
1734 $theData = unserialize($testRows['log_data']);
1735 $email_body.= date($GLOBALS['TYPO3_CONF_VARS']['SYS']['ddmmyy'].' '.$GLOBALS['TYPO3_CONF_VARS']['SYS']['hhmm'],$testRows['tstamp']).': '.@sprintf($testRows['details'],''.$theData[0],''.$theData[1],''.$theData[2]);
1736 $email_body.= chr(10);
1737 }
1738 mail( $email,
1739 $subject,
1740 $email_body,
1741 'From: TYPO3 Login WARNING<>'
1742 );
1743 $this->writelog(255,4,0,3,'Failure warning (%s failures within %s seconds) sent by email to %s',Array($GLOBALS['TYPO3_DB']->sql_num_rows($res),$secondsBack,$email)); // Logout written to log
1744 }
1745 }
1746 }
1747 }
1748
1749
1750
1751 if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_userauthgroup.php']) {
1752 include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_userauthgroup.php']);
1753 }
1754
1755 ?>