Some more improvements:
[mailer.git] / inc / libs / register_functions.php
1 <?php
2 /************************************************************************
3  * Mailer v0.2.1-FINAL                                Start: 07/10/2004 *
4  * ===================                          Last change: 07/10/2004 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : register_functions.php                           *
8  * -------------------------------------------------------------------- *
9  * Short description : Special functions for register extension         *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Spezielle Funktion fuer register-Erweiterung     *
12  * -------------------------------------------------------------------- *
13  * $Revision::                                                        $ *
14  * $Date::                                                            $ *
15  * $Tag:: 0.2.1-FINAL                                                 $ *
16  * $Author::                                                          $ *
17  * -------------------------------------------------------------------- *
18  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
19  * Copyright (c) 2009 - 2013 by Mailer Developer Team                   *
20  * For more information visit: http://mxchange.org                      *
21  *                                                                      *
22  * This program is free software; you can redistribute it and/or modify *
23  * it under the terms of the GNU General Public License as published by *
24  * the Free Software Foundation; either version 2 of the License, or    *
25  * (at your option) any later version.                                  *
26  *                                                                      *
27  * This program is distributed in the hope that it will be useful,      *
28  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
29  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
30  * GNU General Public License for more details.                         *
31  *                                                                      *
32  * You should have received a copy of the GNU General Public License    *
33  * along with this program; if not, write to the Free Software          *
34  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
35  * MA  02110-1301  USA                                                  *
36  ************************************************************************/
37
38 // Some security stuff...
39 if (!defined('__SECURITY')) {
40         die();
41 } // END - if
42
43 // Checks whether all required registration fields are set
44 function ifRequiredRegisterFieldsAreSet (&$array) {
45         // By default all is fine
46         $ret = TRUE;
47         foreach ($array as $key => $value) {
48                 // Check all fields that must register
49                 $result = sqlQueryEscaped("SELECT `id` FROM `{?_MYSQL_PREFIX?}_must_register` WHERE `field_name`='%s' AND `field_required`='Y' LIMIT 1",
50                         array($key), __FUNCTION__, __LINE__);
51
52                 // Entry found?
53                 if (sqlNumRows($result) == 1) {
54                         // Check if extension country is not found (you have to enter the 2-chars long country code) or
55                         // if extensions is present check if country code was selected
56                         //         01              2         21    12             3         32    234     5      54    4               43    34                      4    4      5      5432    2      3                      3210
57                         $country = ((!isExtensionActive('country')) || ((isExtensionActive('country')) && (((empty($value)) && ($key == 'cntry')) || (($key == 'country_code') && (!empty($value)))) && (!empty($array['country_code']))));
58                         if ((empty($value)) && ($country === FALSE)) {
59                                 // Required field not set
60                                 $array[$key] = '!';
61                                 $ret = FALSE;
62                         } // END - if
63                 } // END - if
64
65                 // Free result
66                 sqlFreeResult($result);
67         } // END - foreach
68
69         // Return result
70         return $ret;
71 }
72
73 // Generates a 'category table' for the registration form
74 function registerGenerateCategoryTable ($mode, $configEntry = 'register_default') {
75         // Init output
76         $OUT = '';
77
78         /*
79          * Guests are mostly not interested in how many members has choosen an
80          * individual category.
81          */
82         $whereStatement = "WHERE `visible`='Y' ";
83
84         // Admins are allowed to see every category...
85         if (isAdmin()) {
86                 $whereStatement = '';
87         } // END - if
88
89         // Look for categories
90         $result = sqlQuery('SELECT
91         `id`,
92         `cat`,
93         `visible`
94 FROM
95         `{?_MYSQL_PREFIX?}_cats`
96 ' . $whereStatement . '
97 ORDER BY
98         `sort` ASC',
99                 __FUNCTION__, __LINE__);
100
101         if (!ifSqlHasZeroNums($result)) {
102                 // List alle visible modules (or all to the admin)
103                 $OUT .= '<table border="0" cellspacing="0" cellpadding="0" width="100%">';
104                 while ($content = sqlFetchArray($result)) {
105                         // Prepare array for the template
106                         $content['default_yes'] = '';
107                         $content['default_no']  = '';
108
109                         // Mark categories
110                         if ((postRequestElement('cat', $content['id']) == 'Y') || ((getConfig($configEntry) == 'Y') && (!isPostRequestElementSet('cat', $content['id'])))) {
111                                 $content['default_yes'] = ' checked="checked"';
112                         } else {
113                                 $content['default_no']  = ' checked="checked"';
114                         }
115
116                         // Load template and switch color
117                         $OUT .= loadTemplate('guest_cat_row', TRUE, $content);
118                 } // END - while
119                 $OUT .= '</table>';
120
121                 // Free memory
122                 sqlFreeResult($result);
123         } else {
124                 // No categories setted up so far...
125                 $OUT .= displayMessage('{--NO_CATEGORIES_VISIBLE--}', TRUE);
126         }
127
128         // Return generated HTML code
129         return $OUT;
130 }
131
132 // Outputs a 'failed message'
133 function registerOutputFailedMessage ($messageId, $extra = '') {
134         if (empty($messageId)) {
135                 outputHtml('<div class="bad">' . $extra . '</div>');
136         } else {
137                 outputHtml('<div class="bad">{--' . $messageId . '--}' . $extra . '</div>');
138         }
139 }
140
141 // Checks whether the registration data is complete
142 function isRegistrationDataComplete () {
143         // Init elements
144         $GLOBALS['registration_ip_timeout']    = FALSE;
145         $GLOBALS['registration_weak_password'] = FALSE;
146         $GLOBALS['registration_selected_cats'] = '0';
147
148         // Default is okay
149         $isOkay = TRUE;
150         $isRandom = FALSE;
151
152         // First we only check the submitted data then we continue... :)
153         //
154         // Did he agree to the terms of usage?
155         if (postRequestElement('agree') != 'Y') {
156                 setPostRequestElement('agree', '!');
157                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'agree=N - User did not agree with terms of usage.');
158                 $isOkay = FALSE;
159         } // END - if
160
161         // Did he enter a valid email address? (we really don't care about
162         // that, he has to click on a confirmation link :P )
163         if ((!isAdmin()) && ((!isPostRequestElementSet('email')) || (!isEmailValid(postRequestElement('email'))))) {
164                 setPostRequestElement('email', '!');
165                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did not enter proper email address.');
166                 $isOkay = FALSE;
167         } // END - if
168
169         // And what about surname and family's name?
170         if (!isPostRequestElementSet('surname')) {
171                 setPostRequestElement('surname', '!');
172                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did not enter surname.');
173                 $isOkay = FALSE;
174         } // END - if
175         if (!isPostRequestElementSet('family')) {
176                 setPostRequestElement('family', '!');
177                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did not enter family name.');
178                 $isOkay = FALSE;
179         } // END - if
180
181         // Get temporary array for modification
182         $postArray = postRequestArray();
183
184         // Check for required fields
185         $isOkay = ($isOkay && ifRequiredRegisterFieldsAreSet($postArray));
186
187         // Set it back in request
188         setPostRequestArray($postArray);
189
190         // Are both passwords zero length?
191         if ((strlen(postRequestElement('password1')) == 0) && (strlen(postRequestElement('password2')) == 0) && ($isOkay === TRUE)) {
192                 // Is the extension 'register' newer or equal 0.5.5?
193                 if ((isExtensionInstalledAndNewer('register', '0.5.5')) && (isRegisterGeneratePasswordEmptyEnabled())) {
194                         // Generate a random password
195                         $randomPassword = generatePassword();
196                         $isRandom = TRUE;
197
198                         // Set it in both entries
199                         setPostRequestElement('password1', $randomPassword);
200                         setPostRequestElement('password2', $randomPassword);
201                 } else {
202                         // Not allowed or no recent extension version
203                         setPostRequestElement('password1', '!');
204                         setPostRequestElement('password2', '!');
205
206                         // ... which is both not okay
207                         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'Random password generation not possible, isExtensionInstalledAndNewer(register, 0.5.5)=' . intval(isExtensionInstalledAndNewer('register', '0.5.5')) . ',isRegisterGeneratePasswordEmptyEnabled()=' . intval(isRegisterGeneratePasswordEmptyEnabled()));
208                         $isOkay = FALSE;
209                 }
210         } // END - if
211
212         // Did he enter his password twice?
213         if (((!isPostRequestElementSet('password1')) || (!isPostRequestElementSet('password2'))) || ((postRequestElement('password1') != postRequestElement('password2')) && (isPostRequestElementSet('password1')) && (isPostRequestElementSet('password2')))) {
214                 if ((postRequestElement('password1') != postRequestElement('password2')) && (isPostRequestElementSet('password1')) && (isPostRequestElementSet('password2'))) {
215                         // Both passwords did not match
216                         setPostRequestElement('password1', '!');
217                         setPostRequestElement('password2', '!');
218                         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did not enter same passwords.');
219                 } else {
220                         if (!isPostRequestElementSet('password1')) {
221                                 // Password 1 is empty
222                                 setPostRequestElement('password1', '!');
223                                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did not enter password1.');
224                         } else {
225                                 // Password 2 is empty
226                                 setPostRequestElement('password1', '');
227                         }
228                         if (!isPostRequestElementSet('password2')) {
229                                 // Password 2 is empty
230                                 setPostRequestElement('password2', '!');
231                                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did not enter password2.');
232                         } else {
233                                 // Password 1 is empty
234                                 setPostRequestElement('password2', '');
235                         }
236                 }
237                 $isOkay = FALSE;
238         } // END - if
239
240         // Is the password strong enough?
241         if (($isRandom === FALSE) && (!isStrongPassword(postRequestElement('password1')))) {
242                 $GLOBALS['registration_weak_password'] = TRUE;
243                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did enter a short password.');
244                 $isOkay = FALSE;
245         } // END - if
246
247         // Do this check only when no admin is logged in
248         if (ifPostContainsSelections('cat')) {
249                 // Only continue with array
250                 foreach (postRequestElement('cat') as $id => $answer) {
251                         // Is this category choosen?
252                         if ($answer == 'Y') {
253                                 $GLOBALS['registration_selected_cats']++;
254                         } // END - if
255                 } // END - foreach
256         } // END - if
257
258         // Enougth categories selected?
259         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'isOkay=' . intval($isOkay) . ',selected=' . $GLOBALS['registration_selected_cats'] . '/' . getLeastCats());
260         $isOkay = (($isOkay) && ($GLOBALS['registration_selected_cats'] >= getLeastCats()));
261
262         // Check if email is taken, if configured
263         if ((isExtensionInstalledAndNewer('other', '0.3.0')) && (isCheckDoubleEmailEnabled()) && (postRequestElement('email') != '!') && (isEmailTaken(postRequestElement('email'))) && (!isAdmin())) {
264                 // Is already used
265                 setPostRequestElement('email', '?');
266                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'User did enter a already used email address.');
267                 $isOkay = FALSE;
268         } // END - if
269
270         // Check for IP timeout?
271         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'isOkay=' . intval($isOkay));
272         if ((!isAdmin()) && (getIpTimeout() > 0)) {
273                 // Check his IP number
274                 $GLOBALS['registration_ip_timeout'] = (countSumTotalData(detectRemoteAddr()  , 'user_data', 'userid', 'REMOTE_ADDR', TRUE, ' AND ((UNIX_TIMESTAMP() - `joined`) < {?ip_timeout?} OR (UNIX_TIMESTAMP() - `last_update`) < {?ip_timeout?})') == 1);
275                 //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'isOkay=' . intval($isOkay).',timeout='.intval($GLOBALS['registration_ip_timeout']));
276                 $isOkay = (($isOkay) && (!$GLOBALS['registration_ip_timeout']));
277         } // END - if
278
279         // Return result
280         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'isOkay=' . intval($isOkay) . ' - EXIT!');
281         return $isOkay;
282 }
283
284 // Do the registration
285 function doUserRegistration () {
286         // Do not register an account on absent ext-user
287         if (!isExtensionInstalled('user')) {
288                 // Please report this
289                 reportBug(__FUNCTION__, __LINE__, 'Tried to register a user account without ext-user installed.');
290         } // END - if
291
292         // Init filter data array
293         $filterData = array(
294                 // Registration status is always FALSE by default
295                 'status' => FALSE,
296         );
297
298         // Run filter chain for user registration
299         $filterData = runFilterChain('user_registration', $filterData);
300
301         // Return status
302         return $filterData['status'];
303 }
304
305 // Generic user registration
306 function doGenericUserRegistration () {
307         // Init extra SQL data
308         initExtraRegistrationSql();
309
310         // Init filter data
311         $filterData = array(
312                 // Initialization not done by default
313                 'init_done'   => FALSE,
314                 'post_data'   => postRequestArray(),
315                 'blacklisted' => '',
316                 'message'     => '{--PRE_USER_REGISTRATION_FAILED--}',
317         );
318
319         // Run the pre-registration chain
320         $filterData = runFilterChain('pre_user_registration', $filterData);
321
322         // Did the initialization work?
323         if ($filterData['init_done'] === FALSE) {
324                 // Something bad happened!
325                 displayMessage($filterData['message']);
326
327                 // Stop here
328                 return FALSE;
329         } // END - if
330
331         // These elements must be set
332         assert(isset($GLOBALS['register_country_row']));
333         assert(isset($GLOBALS['register_country_data']));
334         assert(isset($GLOBALS['register_confirm_hash']));
335
336         // Only comment this in if you develop
337         //* DEVELOPER-CODE: */ return TRUE;
338
339         // Create user's account...
340         sqlQueryEscaped("INSERT INTO
341         `{?_MYSQL_PREFIX?}_user_data`
342 (
343         `gender`,
344         `surname`,
345         `family`,
346         `street_nr`,
347         %s,
348         `zip`,
349         `city`,
350         `email`,
351         `birth_day`,
352         `birth_month`,
353         `birth_year`,
354         `password`,
355         `max_mails`,
356         `receive_mails`,
357         `refid`,
358         `status`,
359         `user_hash`,
360         `REMOTE_ADDR`,
361         `joined`,
362         `last_update`,
363         `ref_payout`
364         " . $GLOBALS['register_sql_columns'] . "
365 ) VALUES (
366         '%s',
367         '%s',
368         '%s',
369         '%s',
370         '%s',
371         %s,
372         '%s',
373         '%s',
374         %s,
375         %s,
376         %s,
377         '%s',
378         %s,
379         %s,
380         %s,
381         '%s',
382         '%s',
383         '{%%pipe,detectRemoteAddr%%}',
384         UNIX_TIMESTAMP(),
385         UNIX_TIMESTAMP(),
386         {?ref_payout?}
387         " . $GLOBALS['register_sql_data'] . "
388 )",
389         array(
390                 $GLOBALS['register_country_row'],
391                 substr(postRequestElement('gender'), 0, 1),
392                 postRequestElement('surname'),
393                 postRequestElement('family'),
394                 postRequestElement('street_nr'),
395                 $GLOBALS['register_country_data'],
396                 bigintval(postRequestElement('zip')),
397                 postRequestElement('city'),
398                 postRequestElement('email'),
399                 bigintval(postRequestElement('day')),
400                 bigintval(postRequestElement('month')),
401                 bigintval(postRequestElement('year')),
402                 generateHash(postRequestElement('password1')),
403                 bigintval(postRequestElement('max_mails')),
404                 bigintval(postRequestElement('max_mails')),
405                 convertZeroToNull(postRequestElement('refid')),
406                 postRequestElement('status'),
407                 $GLOBALS['register_confirm_hash']
408         ), __FUNCTION__, __LINE__);
409
410         // Get his userid
411         $filterData['register_insert_id'] = getSqlInsertId();
412
413         // Did this work?
414         if (!isValidId($filterData['register_insert_id'])) {
415                 // Something bad happened!
416                 displayMessage('{--USER_NOT_REGISTERED--}');
417
418                 // Stop here
419                 return FALSE;
420         } // END - if
421
422         // Shall we reset random refid? Only possible with latest ext-user
423         if (isExtensionInstalledAndNewer('user', '0.3.4')) {
424                 // Reset all accounts, registration is done
425                 sqlQuery('UPDATE `{?_MYSQL_PREFIX?}_user_data` SET `rand_confirmed`=0', __FUNCTION__, __LINE__);
426         } // END - if
427
428         // Update referral table
429         updateReferralCounter($filterData['register_insert_id']);
430
431         // Write his welcome-points
432         initReferralSystem();
433         addPointsThroughReferralSystem(
434                 // Subject
435                 'register_welcome',
436                 // User's id number
437                 $filterData['register_insert_id'],
438                 // Points to add
439                 getPointsRegister(),
440                 // Referral id (or NULL if none set)
441                 convertZeroToNull(postRequestElement('refid'))
442         );
443
444         // Write catgories
445         if (ifPostContainsSelections('cat')) {
446                 // Init SQL
447                 $sql = 'INSERT INTO `{?_MYSQL_PREFIX?}_user_cats` (`userid`, `cat_id`) VALUES';
448
449                 // Write all entries
450                 foreach (postRequestElement('cat') as $categoryId => $joined) {
451                         // "Join" this group?
452                         if ($joined == 'Y') {
453                                 // Insert category entry
454                                 $sql .= ' (' . $filterData['register_insert_id'] . ', ' . bigintval($categoryId) . '),';
455                         } // END - if
456                 } // END - foreach
457
458                 // Run SQL without last commata
459                 sqlQuery(substr($sql, 0, -1), __FUNCTION__, __LINE__);
460         } // END - if
461
462         // Registration phase is done here, so for tester accounts we end here
463         if (((getExtensionVersion('user') >= '0.5.0')) && (isTesterUserName(postRequestElement('surname'))) && (ifTesterAccountsAllowed())) {
464                 // All fine here
465                 return TRUE;
466         } // END - if
467
468         // ... rewrite a zero referral id to the main title
469         if (!isValidId(postRequestElement('refid'))) {
470                 setPostRequestElement('refid', getMainTitle());
471         } // END - if
472
473         // Is ZIP code set?
474         if (isPostRequestElementSet('zip')) {
475                 // Prepare data array for the email template
476                 $content = array(
477                         'hash'     => $GLOBALS['register_confirm_hash'],
478                         'userid'   => $filterData['register_insert_id'],
479                         'gender'   => sqlEscapeString(postRequestElement('gender')),
480                         'surname'  => sqlEscapeString(postRequestElement('surname')),
481                         'family'   => sqlEscapeString(postRequestElement('family')),
482                         'email'    => sqlEscapeString(postRequestElement('email')),
483                         'street'   => sqlEscapeString(postRequestElement('street_nr')),
484                         'city'     => sqlEscapeString(postRequestElement('city')),
485                         'zip'      => bigintval(postRequestElement('zip')),
486                         'country'  => $GLOBALS['register_country_data'],
487                         'refid'    => sqlEscapeString(postRequestElement('refid')),
488                         'password' => sqlEscapeString(postRequestElement('password1')),
489                 );
490         } else {
491                 // No ZIP code entered
492                 $content = array(
493                         'hash'     => $GLOBALS['register_confirm_hash'],
494                         'userid'   => $filterData['register_insert_id'],
495                         'gender'   => sqlEscapeString(postRequestElement('gender')),
496                         'surname'  => sqlEscapeString(postRequestElement('surname')),
497                         'family'   => sqlEscapeString(postRequestElement('family')),
498                         'email'    => sqlEscapeString(postRequestElement('email')),
499                         'street'   => sqlEscapeString(postRequestElement('street_nr')),
500                         'city'     => sqlEscapeString(postRequestElement('city')),
501                         'zip'      => '',
502                         'country'  => $GLOBALS['register_country_data'],
503                         'refid'    => sqlEscapeString(postRequestElement('refid')),
504                         'password' => sqlEscapeString(postRequestElement('password1')),
505                 );
506         }
507
508         // Continue with birthday...
509         switch (getLanguage()) {
510                 case 'de':
511                         $content['birthday'] = bigintval(postRequestElement('day')) . '.' . bigintval(postRequestElement('month')) . '.' . bigintval(postRequestElement('year'));
512                         break;
513
514                 default:
515                         $content['birthday'] = bigintval(postRequestElement('month')) . '/' . bigintval(postRequestElement('day')) . '/' . bigintval(postRequestElement('year'));
516                         break;
517         } // END - switch
518
519         // Display information to the user that he got mail and send it away
520         $messageGuest = loadEmailTemplate('guest_register_done', $content, $filterData['register_insert_id'], FALSE);
521
522         // Send mail to user (confirmation link!)
523         sendEmail($filterData['register_insert_id'], '{--GUEST_CONFIRM_LINK_SUBJECT--}', $messageGuest);
524
525         // Send mail to admin
526         sendAdminNotification('{--ADMIN_NEW_ACCOUNT_SUBJECT--}', 'admin_register_done', $content, $filterData['register_insert_id']);
527
528         // All fine
529         return TRUE;
530 }
531
532 // Initialize extra registration SQL
533 function initExtraRegistrationSql () {
534         $GLOBALS['register_sql_columns'] = '';
535         $GLOBALS['register_sql_data']    = '';
536 }
537
538 // Add extra column for registration SQL
539 function addExtraRegistrationColumns ($column) {
540         // Add column
541         $GLOBALS['register_sql_columns'] .= $column;
542 }
543
544 // Add extra data for registration SQL
545 function addExtraRegistrationData ($data) {
546         // Add column
547         $GLOBALS['register_sql_data'] .= $data;
548 }
549
550 //-----------------------------------------------------------------------------
551 //                      Wrapper functions for ext-register
552 //-----------------------------------------------------------------------------
553
554 // Getter for 'display_refid'
555 function getDisplayRefid () {
556         // Is the cache entry set?
557         if (!isset($GLOBALS[__FUNCTION__])) {
558                 // No, so determine it
559                 $GLOBALS[__FUNCTION__] = getConfig('display_refid');
560         } // END - if
561
562         // Return cached entry
563         return $GLOBALS[__FUNCTION__];
564 }
565
566 // Checks whether 'display_refid' is "Y"
567 function isDisplayRefidEnabled () {
568         // Is the cache entry set?
569         if (!isset($GLOBALS[__FUNCTION__])) {
570                 // No, so determine it
571                 $GLOBALS[__FUNCTION__] = (getDisplayRefid() == 'Y');
572         } // END - if
573
574         // Return cached entry
575         return $GLOBALS[__FUNCTION__];
576 }
577
578 // Getter for 'ip_timeout'
579 function getIpTimeout () {
580         // Is the cache entry set?
581         if (!isset($GLOBALS[__FUNCTION__])) {
582                 // No, so determine it
583                 $GLOBALS[__FUNCTION__] = getConfig('ip_timeout');
584         } // END - if
585
586         // Return cached entry
587         return $GLOBALS[__FUNCTION__];
588 }
589
590 // Getter for 'register_default'
591 function getRegisterDefault () {
592         // Is the cache entry set?
593         if (!isset($GLOBALS[__FUNCTION__])) {
594                 // No, so determine it
595                 $GLOBALS[__FUNCTION__] = getConfig('register_default');
596         } // END - if
597
598         // Return cached entry
599         return $GLOBALS[__FUNCTION__];
600 }
601
602 // Checks whether 'register_default' is "YES"
603 function isRegisterDefaultEnabled () {
604         // Is the cache entry set?
605         if (!isset($GLOBALS[__FUNCTION__])) {
606                 // No, so determine it
607                 $GLOBALS[__FUNCTION__] = (getRegisterDefault() == 'Y');
608         } // END - if
609
610         // Return cached entry
611         return $GLOBALS[__FUNCTION__];
612 }
613
614 // Getter for 'register_generate_password_empty'
615 function getRegisterGeneratePasswordEmpty () {
616         // Is the cache entry set?
617         if (!isset($GLOBALS[__FUNCTION__])) {
618                 // No, so determine it
619                 $GLOBALS[__FUNCTION__] = getConfig('register_generate_password_empty');
620         } // END - if
621
622         // Return cached entry
623         return $GLOBALS[__FUNCTION__];
624 }
625
626 // Checks whether 'register_generate_password_empty' is "YES"
627 function isRegisterGeneratePasswordEmptyEnabled () {
628         // Is the cache entry set?
629         if (!isset($GLOBALS[__FUNCTION__])) {
630                 // No, so determine it
631                 $GLOBALS[__FUNCTION__] = (getRegisterGeneratePasswordEmpty() == 'Y');
632         } // END - if
633
634         // Return cached entry
635         return $GLOBALS[__FUNCTION__];
636 }
637
638 // Getter for 'default_registration_provider'
639 function getDefaultRegistrationProvider () {
640         // Is the cache entry set?
641         if (!isset($GLOBALS[__FUNCTION__])) {
642                 // No, so determine it
643                 $GLOBALS[__FUNCTION__] = getConfig('default_registration_provider');
644         } // END - if
645
646         // Return cached entry
647         return $GLOBALS[__FUNCTION__];
648 }
649
650 // "Getter" for least_cats
651 function getLeastCats () {
652         // Is there cache?
653         if (!isset($GLOBALS[__FUNCTION__])) {
654                 // Determine it
655                 $GLOBALS[__FUNCTION__] = getConfig('least_cats');
656         } // END - if
657
658         // Return cache
659         return $GLOBALS[__FUNCTION__];
660 }
661
662 // ----------------------------------------------------------------------------
663 //                            Template helper functions
664 // ----------------------------------------------------------------------------
665
666 // Template helper for generating a category selection table for admin area with given configuration entry
667 function doTemplateAdminRegisterCategoryTable ($templateName, $clear = FALSE, $configEntry) {
668         // Call the inner function
669         return registerGenerateCategoryTable('admin', $configEntry);
670 }
671
672 // Template helper for generating a list of all activated user registration provider
673 function doTemplateGuestRegistrationList ($templateName, $clear = FALSE) {
674         // Init output
675         $content = '';
676
677         // Default is only activated provider
678         $addSql = " AND `provider_is_active`='Y'";
679
680         // Is admin logged-in?
681         if (isAdmin()) {
682                 // Then show all
683                 $addSql = '';
684         } // END - if
685
686         // Search for all
687         $result = sqlQuery("SELECT
688         `provider_name`,
689         `provider_extension`
690 FROM
691         `{?_MYSQL_PREFIX?}_user_register_provider`
692 WHERE
693         `provider_extension` != 'register'
694         " . $addSql . "
695 ORDER BY
696         `provider_name` ASC", __FUNCTION__, __LINE__);
697
698         // Are there entries?
699         if (sqlNumRows($result) > 0) {
700                 // Loop through all
701                 $row = '';
702                 while ($content = sqlFetchArray($result)) {
703                         // Load row template
704                         $row .= loadTemplate('guest_registration_provider_row', TRUE, $content);
705                 } // END - while
706
707                 // Load main template
708                 $content = loadTemplate('guest_registration_provider', TRUE, $row);
709         } else {
710                 // Nothing found
711                 $content = returnMessage('{--GUEST_EXTRA_REGISTRATION_PROVIDER_404--}');
712         }
713
714         // Free result
715         sqlFreeResult($result);
716
717         // Return the generated content
718         return $content;
719 }
720
721 // ----------------------------------------------------------------------------
722 //                            "Translator" functions
723 // ----------------------------------------------------------------------------
724
725 function translateRegistrationProviderName ($providerName) {
726         // "Translate it"
727         return '{--REGISTRATION_PROVIDER_' . strtoupper($providerName) . '--}';
728 }
729
730 // [EOF]
731 ?>