Added sorting for later easier inserting of more array elements
[mailer.git] / inc / libs / network_functions.php
1 <?php
2 /************************************************************************
3  * Mailer v0.2.1-FINAL                                Start: 11/04/2009 *
4  * ===================                          Last change: 11/04/2009 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : network_functions.php                            *
8  * -------------------------------------------------------------------- *
9  * Short description : Functions for ext-network                        *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Funktionen fuer ext-network                      *
12  * -------------------------------------------------------------------- *
13  * $Revision::                                                        $ *
14  * $Date::                                                            $ *
15  * $Tag:: 0.2.1-FINAL                                                 $ *
16  * $Author::                                                          $ *
17  * Needs to be in all Files and every File needs "svn propset           *
18  * svn:keywords Date Revision" (autoprobset!) at least!!!!!!            *
19  * -------------------------------------------------------------------- *
20  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
21  * Copyright (c) 2009, 2010 by Mailer Developer Team                    *
22  * For more information visit: http://www.mxchange.org                  *
23  *                                                                      *
24  * This program is free software; you can redistribute it and/or modify *
25  * it under the terms of the GNU General Public License as published by *
26  * the Free Software Foundation; either version 2 of the License, or    *
27  * (at your option) any later version.                                  *
28  *                                                                      *
29  * This program is distributed in the hope that it will be useful,      *
30  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
31  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
32  * GNU General Public License for more details.                         *
33  *                                                                      *
34  * You should have received a copy of the GNU General Public License    *
35  * along with this program; if not, write to the Free Software          *
36  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
37  * MA  02110-1301  USA                                                  *
38  ************************************************************************/
39
40 // Some security stuff...
41 if (!defined('__SECURITY')) {
42         die();
43 } // END - if
44
45 // Private setter for current network id
46 function setCurrentNetworkId ($id) {
47         $GLOBALS['current_network_id'] = bigintval($id);
48 }
49
50 // Private getter for current network id
51 function getCurrentNetworkId () {
52         return $GLOBALS['current_network_id'];
53 }
54
55 // Handle a (maybe) sent form here
56 function doNetworkHandleForm () {
57         // Was the form sent?
58         if ((isFormSent()) || (isFormSent('edit')) || (isFormSent('del')) || (isFormSent('change')) || (isFormSent('remove'))) {
59                 // Do we have a 'do'?
60                 if (isGetRequestParameterSet('do')) {
61                         // Process the request
62                         doAdminNetworkProcessForm();
63                 } else {
64                         // No 'do' found
65                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_DO_404--}');
66                 }
67         } // END - if
68 }
69
70 // Processes an admin form
71 function doAdminNetworkProcessForm () {
72         // Form really sent?
73         if ((!isFormSent()) && (!isFormSent('edit')) && (!isFormSent('del')) && (!isFormSent('change')) && (!isFormSent('remove'))) {
74                 // Abort here
75                 loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_FORM_NOT_SENT--}');
76                 return;
77         } elseif (!isGetRequestParameterSet('do')) {
78                 // No 'do' found
79                 loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_DO_404--}');
80                 return;
81         }
82
83         // Create function name
84         $functionName = sprintf("doAdminNetworkProcess%s", capitalizeUnderscoreString(getRequestParameter('do')));
85
86         // Is the function valid?
87         if (!function_exists($functionName)) {
88                 // Invalid function name
89                 debug_report_bug(__FUNCTION__, __LINE__, 'Invalid do ' . getRequestParameter('do') . ', function ' . $functionName .' does not exist.', false);
90         } // END - if
91
92         // Call-back the method handling our request
93         call_user_func($functionName);
94 }
95
96 // Checks wether the (short) network name is already used (valid)
97 function isNetworkNameValid ($name) {
98         // Query for it
99         $result = SQL_QUERY_ESC("SELECT `network_id` FROM `{?_MYSQL_PREFIX?}_network_data` WHERE `network_short_name`='%s' LIMIT 1",
100                 array($name), __FUNCTION__, __LINE__);
101
102         // Does it exist?
103         $isValid = (SQL_NUMROWS($result) == 1);
104
105         // Free result
106         SQL_FREERESULT($result);
107
108         // Return result
109         return $isValid;
110 }
111
112 // Checks wether the given network type is already used (valid)
113 function isNetworkTypeHandleValid ($type, $networkId) {
114         // Query for it
115         $result = SQL_QUERY_ESC("SELECT `network_type_id` FROM `{?_MYSQL_PREFIX?}_network_types` WHERE `network_id`=%s AND `network_type_handle`='%s' LIMIT 1",
116                 array($networkId, $type), __FUNCTION__, __LINE__);
117
118         // Does it exist?
119         $isValid = (SQL_NUMROWS($result) == 1);
120
121         // Free result
122         SQL_FREERESULT($result);
123
124         // Return result
125         return $isValid;
126 }
127
128 // Checks wether the given network request parameter is already used (valid)
129 function isNetworkRequestParameterValid ($key, $type, $networkId) {
130         // Query for it
131         $result = SQL_QUERY_ESC("SELECT `network_param_id` FROM `{?_MYSQL_PREFIX?}_network_request_params` WHERE `network_id`=%s AND `network_type_id`=%s AND `request_param_key`='%s' LIMIT 1",
132                 array($networkId, $type, $key), __FUNCTION__, __LINE__);
133
134         // Does it exist?
135         $isValid = (SQL_NUMROWS($result) == 1);
136
137         // Free result
138         SQL_FREERESULT($result);
139
140         // Return result
141         return $isValid;
142 }
143
144 // Checks wether the given network API array translation
145 function isNetworkApiTranslationValid ($key, $type, $networkId) {
146         // Query for it
147         $result = SQL_QUERY_ESC("SELECT `network_api_id` FROM `{?_MYSQL_PREFIX?}_network_api_translation` WHERE `network_id`=%s AND `network_type_id`=%s AND `network_api_index`='%s' LIMIT 1",
148                 array($networkId, $type, $key), __FUNCTION__, __LINE__);
149
150         // Does it exist?
151         $isValid = (SQL_NUMROWS($result) == 1);
152
153         // Free result
154         SQL_FREERESULT($result);
155
156         // Return result
157         return $isValid;
158 }
159
160 // "Getter" for a network's data by provided id number
161 function getNetworkDataById ($id, $column = '') {
162         // Ids lower one are not accepted
163         if ($id < 1) {
164                 // Not good, should be fixed
165                 debug_report_bug(__FUNCTION__, __LINE__, 'Network id ' . $id . ' is smaller than 1.');
166         } // END - if
167
168         // Set current network id
169         setCurrentNetworkId($id);
170
171         // Is it cached?
172         if (!isset($GLOBALS['network_data'][$id])) {
173                 // By default we have no data
174                 $GLOBALS['network_data'][$id] = array();
175
176                 // Query for the network data
177                 $result = SQL_QUERY_ESC("SELECT
178         `network_id`, `network_short_name`, `network_title`, `network_reflink`, `network_data_seperator`, `network_row_seperator`, `network_request_type`, `network_charset`
179 FROM
180         `{?_MYSQL_PREFIX?}_network_data`
181 WHERE
182         `network_id`=%s
183 LIMIT 1",
184                         array(bigintval($id)), __FUNCTION__, __LINE__);
185
186                 // Do we have an entry?
187                 if (SQL_NUMROWS($result) == 1) {
188                         // Then get it
189                         $GLOBALS['network_data'][$id] = SQL_FETCHARRAY($result);
190                 } // END - if
191
192                 // Free result
193                 SQL_FREERESULT($result);
194         } // END - if
195
196         // Return result
197         if (empty($column)) {
198                 // Return array
199                 return $GLOBALS['network_data'][$id];
200         } else {
201                 // Return column
202                 return $GLOBALS['network_data'][$id][$column];
203         }
204 }
205
206 // "Getter" for a network's data by provided type id number
207 function getNetworkDataByTypeId ($id, $column = '') {
208         // Ids lower one are not accepted
209         if ($id < 1) {
210                 // Not good, should be fixed
211                 debug_report_bug(__FUNCTION__, __LINE__, 'Network type id ' . $id . ' is smaller than 1.');
212         } // END - if
213
214         // Set current network id
215         setCurrentNetworkId($id);
216
217         // Is it cached?
218         if (!isset($GLOBALS['network_data'][$id])) {
219                 // By default we have no data
220                 $GLOBALS['network_data'][$id] = array();
221
222                 // Query for the network data
223                 $result = SQL_QUERY_ESC("SELECT
224         d.`network_id`, d.`network_short_name`, d.`network_title`, d.`network_reflink`, d.`network_data_seperator`, d.`network_row_seperator`, d.`network_request_type`, d.`network_charset`,
225         t.`network_type_handle`, t.`network_type_api_url`, t.`network_type_click_url`, t.`network_type_banner_url`
226 FROM
227         `{?_MYSQL_PREFIX?}_network_data` AS d
228 LEFT JOIN
229         `{?_MYSQL_PREFIX?}_network_types` AS t
230 ON
231         d.`network_id`=t.`network_id`
232 WHERE
233         t.`network_type_id`=%s
234 LIMIT 1",
235                         array(bigintval($id)), __FUNCTION__, __LINE__);
236
237                 // Do we have an entry?
238                 if (SQL_NUMROWS($result) == 1) {
239                         // Then get it
240                         $GLOBALS['network_data'][$id] = SQL_FETCHARRAY($result);
241                 } // END - if
242
243                 // Free result
244                 SQL_FREERESULT($result);
245         } // END - if
246
247         // Return result
248         if (empty($column)) {
249                 // Return array
250                 return $GLOBALS['network_data'][$id];
251         } else {
252                 // Return column
253                 return $GLOBALS['network_data'][$id][$column];
254         }
255 }
256
257 // "Getter" for a network type data by provided id number
258 function getNetworkTypeDataById ($id) {
259         // Ids lower one are not accepted
260         if ($id < 1) {
261                 // Not good, should be fixed
262                 debug_report_bug(__FUNCTION__, __LINE__, 'Network type id ' . $id . ' is smaller than 1.');
263         } // END - if
264
265         // By default we have no data
266         $GLOBALS['network_type_data'][$id] = array();
267
268         // Query for the network data
269         $result = SQL_QUERY_ESC("SELECT
270         `network_type_id`, `network_id`, `network_type_handle`, `network_type_api_url`, `network_type_click_url`, `network_type_banner_url`
271 FROM
272         `{?_MYSQL_PREFIX?}_network_types`
273 WHERE
274         `network_type_id`=%s
275 LIMIT 1",
276                 array(bigintval($id)), __FUNCTION__, __LINE__);
277
278         // Do we have an entry?
279         if (SQL_NUMROWS($result) == 1) {
280                 // Then get it
281                 $GLOBALS['network_type_data'][$id] = SQL_FETCHARRAY($result);
282         } // END - if
283
284         // Free result
285         SQL_FREERESULT($result);
286
287         // Return result
288         return $GLOBALS['network_type_data'][$id];
289 }
290
291 // "Getter" for a network request parameter data by provided id number
292 function getNetworkRequestParamsDataById ($id) {
293         // Ids lower one are not accepted
294         if ($id < 1) {
295                 // Not good, should be fixed
296                 debug_report_bug(__FUNCTION__, __LINE__, 'Network request parameter id ' . $id . ' is smaller than 1.');
297         } // END - if
298
299         // By default we have no data
300         $networkRequestData = array();
301
302         // Query for the network data
303         $result = SQL_QUERY_ESC("SELECT
304         `network_param_id`, `network_id`, `network_type_id`, `request_param_key`, `request_param_value`, `request_param_default`
305 FROM
306         `{?_MYSQL_PREFIX?}_network_request_params`
307 WHERE
308         `network_param_id`=%s
309 LIMIT 1",
310                 array(bigintval($id)), __FUNCTION__, __LINE__);
311
312         // Do we have an entry?
313         if (SQL_NUMROWS($result) == 1) {
314                 // Then get it
315                 $networkRequestData = SQL_FETCHARRAY($result);
316         } // END - if
317
318         // Free result
319         SQL_FREERESULT($result);
320
321         // Return result
322         return $networkRequestData;
323 }
324
325 // Updates given network (id) with data from array
326 function doNetworkUpdateDataByArray ($id, $networkData) {
327         // Ids lower one are not accepted
328         if ($id < 1) {
329                 // Not good, should be fixed
330                 debug_report_bug(__FUNCTION__, __LINE__, 'Network id ' . $id . ' is smaller than 1.');
331         } // END - if
332
333         // Just call our inner method
334         return adminSaveSettings($networkData, '_network_data', sprintf("`network_id`=%s", bigintval($id)), array(), false, false);
335 }
336
337 // Updates given network type handler (id) with data from array
338 function doNetworkUpdateTypeByArray ($id, $networkTypeData) {
339         // Ids lower one are not accepted
340         if ($id < 1) {
341                 // Not good, should be fixed
342                 debug_report_bug(__FUNCTION__, __LINE__, 'Network type handler id ' . $id . ' is smaller than 1.');
343         } // END - if
344
345         // Just call our inner method
346         return adminSaveSettings($networkTypeData, '_network_types', sprintf("`network_type_id`=%s", bigintval($id)), array(), false, false);
347 }
348
349 // Updates given network request parameters (id) with data from array
350 function doNetworkUpdateParamsByArray ($id, $networkParamData) {
351         // Ids lower one are not accepted
352         if ($id < 1) {
353                 // Not good, should be fixed
354                 debug_report_bug(__FUNCTION__, __LINE__, 'Network request parameter id ' . $id . ' is smaller than 1.');
355         } // END - if
356
357         // Just call our inner method
358         return adminSaveSettings($networkParamData, '_network_request_params', sprintf("`network_param_id`=%s", bigintval($id)), array(), false, false);
359 }
360
361 // Removes given network entry
362 function doAdminRemoveNetworkEntry ($table, $column, $id, $limit = 1) {
363         // Remove the entry
364         SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_network_%s` WHERE `%s`=%s LIMIT %s",
365                 array($table, $column, $id, $limit), __FUNCTION__, __LINE__);
366
367         // Return affected rows
368         return SQL_AFFECTEDROWS();
369 }
370
371 // Generates a list of networks for given script and returns it
372 function generateAdminNetworkList () {
373         // Init output
374         $content = '';
375
376         // Query for all networks
377         $result = SQL_QUERY('SELECT
378         `network_id`, `network_short_name`, `network_title`
379 FROM
380         `{?_MYSQL_PREFIX?}_network_data`
381 ORDER BY
382         `network_short_name` ASC', __FUNCTION__, __LINE__);
383
384         // Do we have entries?
385         if (!SQL_HASZERONUMS($result)) {
386                 // List all entries
387                 $rows = array();
388                 while ($row = SQL_FETCHARRAY($result)) {
389                         // Is this valid, then add it
390                         if ((is_array($row)) && (isset($row['network_id']))) {
391                                 // Add entry
392                                 $rows[$row['network_id']] = $row;
393                         } // END - if
394                 } // END - while
395
396                 // Generate the selection box
397                 $content = generateSelectionBoxFromArray($rows, 'network', 'network_id');
398         } else {
399                 // Nothing selected
400                 $content = loadTemplate('admin_settings_unsaved', false, '{--ADMIN_ENTRIES_404--}');
401         }
402
403         // Free the result
404         SQL_FREERESULT($result);
405
406         // Return the list
407         return $content;
408 }
409
410 // Generator (somewhat getter) for a list of network types for given network id
411 function generateAdminNetworkTypeList ($networkId) {
412         // Init content
413         $content = '';
414
415         // Query all types of this network
416         $result = SQL_QUERY_ESC("SELECT
417         `network_type_id`, `network_type_handle`
418 FROM
419         `{?_MYSQL_PREFIX?}_network_types`
420 WHERE
421         `network_id`=%s
422 ORDER BY
423         `network_type_handle` ASC",
424                 array(
425                         bigintval($networkId)
426                 ), __FUNCTION__, __LINE__);
427
428         // Do we have entries?
429         if (!SQL_HASZERONUMS($result)) {
430                 // List all entries
431                 $rows = array();
432                 while ($row = SQL_FETCHARRAY($result)) {
433                         // Is this valid, then add it
434                         if ((is_array($row)) && (isset($row['network_type_id']))) {
435                                 // Add entry
436                                 $rows[$row['network_type_id']] = $row;
437                         } // END - if
438                 } // END - while
439
440                 // Generate the selection box
441                 $content = generateSelectionBoxFromArray($rows, 'network_type', 'network_type_id');
442         } else {
443                 // Nothing selected
444                 $content = loadTemplate('admin_settings_unsaved', false, '{--ADMIN_ENTRIES_404--}');
445         }
446
447         // Free the result
448         SQL_FREERESULT($result);
449
450         // Return content
451         return $content;
452 }
453
454 // Generator (somewhat getter) for a list of network types for all types
455 function generateAdminDistinctNetworkTypeList () {
456         // Init content
457         $content = '';
458
459         // Query all types of this network
460         $result = SQL_QUERY('SELECT
461         t.`network_type_id`, t.`network_type_handle`, d.`network_title`
462 FROM
463         `{?_MYSQL_PREFIX?}_network_types` AS t
464 LEFT JOIN
465         `{?_MYSQL_PREFIX?}_network_data` AS d
466 ON
467         t.`network_id`=d.`network_id`
468 ORDER BY
469         d.`network_short_name` ASC,
470         t.`network_type_handle` ASC', __FUNCTION__, __LINE__);
471
472         // Do we have entries?
473         if (!SQL_HASZERONUMS($result)) {
474                 // List all entries
475                 $rows = array();
476                 while ($row = SQL_FETCHARRAY($result)) {
477                         // Is this valid, then add it
478                         if ((is_array($row)) && (isset($row['network_type_id']))) {
479                                 // Add entry
480                                 $rows[$row['network_type_id']] = $row;
481                         } // END - if
482                 } // END - while
483
484                 // Generate the selection box
485                 $content = generateSelectionBoxFromArray($rows, 'network_type', 'network_type_id', '', '_title');
486         } else {
487                 // Nothing selected
488                 $content = loadTemplate('admin_settings_unsaved', false, '{--ADMIN_ENTRIES_404--}');
489         }
490
491         // Free the result
492         SQL_FREERESULT($result);
493         //* DEBUG: */ die('<pre>'.encodeEntities($content).'</pre>');
494
495         // Return content
496         return $content;
497 }
498
499 // Generator (somewhat getter) for network type options
500 function generateNetworkTypeOptions ($id) {
501         // Is this an array, then we just came back from edit/delete actions
502         if (is_array($id)) $id = '';
503
504         // Is this cached?
505         if (!isset($GLOBALS['network_type_options'][$id])) {
506                 // Generate output and cache it
507                 $GLOBALS['network_type_options'][$id] = generateOptionList(
508                         'network_types',
509                         'network_type_id',
510                         'network_type_handle',
511                         $id,
512                         '',
513                         sprintf(
514                                 "WHERE `network_id`=%s",
515                                 bigintval(getRequestParameter('network'))
516                         ),
517                         '',
518                         'translateNetworkTypeHandler'
519                 );
520         } // END - if
521
522         // Return content
523         return $GLOBALS['network_type_options'][$id];
524 }
525
526 // Generator (somewhat getter) for request key options
527 function generateNetworkRequestKeyOptions ($key) {
528         // Is it cached?
529         if (!isset($GLOBALS['network_request_param_key'][$key])) {
530                 // Generate and cache it
531                 $GLOBALS['network_request_param_key'][$key] = generateOptionList(
532                         '/ARRAY/',
533                         array(
534                                 'id',
535                                 'sid',
536                                 'hash',
537                                 'password',
538                                 'reload',
539                                 'maximum_stay',
540                                 'minimum_stay',
541                                 'currency',
542                                 'type',
543                                 'remain',
544                                 'reward',
545                                 'size',
546                                 'erotic',
547                                 'extra'
548                         ),
549                         array(
550                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_ID--}',
551                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_SID--}',
552                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_HASH--}',
553                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_PASSWORD--}',
554                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_RELOAD--}',
555                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_MAXIMUM_STAY--}',
556                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_MINIMUM_STAY--}',
557                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_CURRENCY--}',
558                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_TYPE--}',
559                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_REMAIN--}',
560                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_REWARD--}',
561                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_SIZE--}',
562                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_EROTIC--}',
563                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_EXTRA--}'
564                         ),
565                         $key,
566                         '', '',
567                         $GLOBALS['network_params_disabled']
568                 );
569         } // END - if
570
571         // Return content
572         return $GLOBALS['network_request_param_key'][$key];
573 }
574
575 // Generator (somewhat getter) for (return) array translation
576 function generateNetworkTranslationOptions ($default = '') {
577         // Is it cached?
578         if (!isset($GLOBALS['network_translation'][$default])) {
579                 // Generate and cache it
580                 $GLOBALS['network_translation'][$default] = generateOptionList(
581                         'network_translations',
582                         'network_translation_id',
583                         'network_translation_name',
584                         $default,
585                         '',
586                         '',
587                         $GLOBALS['network_translation_disabled'],
588                         'translateNetworkTranslationName'
589                 );
590         } // END - if
591
592         // Return content
593         return $GLOBALS['network_translation'][$default];
594 }
595
596 // Generates an option list of request types
597 function generateNetworkRequestTypeOptions ($default = '') {
598         // Do we have cache?
599         if (!isset($GLOBALS['network_request_type'][$default])) {
600                 // Generate the list
601                 $GLOBALS['network_request_type'][$default] = generateOptionList(
602                         '/ARRAY/',
603                         array(
604                                 'GET',
605                                 'POST'
606                         ),
607                         array(
608                                 '{--ADMIN_NETWORK_REQUEST_TYPE_GET--}',
609                                 '{--ADMIN_NETWORK_REQUEST_TYPE_POST--}'
610                         ),
611                         $default
612                 );
613         } // END - if
614
615         // Return cache
616         return $GLOBALS['network_request_type'][$default];
617 }
618
619 // Translates 'translate_name' for e.g. templates
620 function translateNetworkTranslationName ($name) {
621         // Get the message id
622         return getMessage('ADMIN_NETWORK_TRANSLATE_' . strtoupper($name) . '_NAME');
623 }
624
625 // Translates the network type handler (e.g. banner, paidmail) for templates
626 function translateNetworkTypeHandler ($type) {
627         // Get the message id
628         return getMessage('ADMIN_NETWORK_TYPES_' . strtoupper($type) . '');
629 }
630
631 // Translates request type
632 function translateNetworkRequestType ($name) {
633         // Get the message id
634         return getMessage('ADMIN_NETWORK_REQUEST_TYPE_' . strtoupper($name) . '');
635 }
636
637 // Translates API index
638 function translateNetworkApiIndex ($index) {
639         // Do we have cache?
640         if (!isset($GLOBALS['network_api_index'])) {
641                 // Get an array of all API array indexes
642                 $GLOBALS['network_api_index'] = array();
643
644                 // Get all entries
645                 $result = SQL_QUERY('SELECT
646         `network_api_id`, `network_api_index`, `network_translation_name`
647 FROM
648         `{?_MYSQL_PREFIX?}_network_api_translation`
649 INNER JOIN
650         `{?_MYSQL_PREFIX?}_network_translations`
651 ON
652         `network_api_index`=`network_translation_id`
653 ORDER BY
654         `sort` ASC', __FUNCTION__, __LINE__);
655
656                 // Do we have entries?
657                 if (SQL_NUMROWS($result) > 0) {
658                         // Get all entries
659                         while ($row = SQL_FETCHARRAY($result)) {
660                                 // Add it to our global array
661                                 $GLOBALS['network_api_index'][$row['network_api_index']] = $row;
662                         } // END - while
663                 } // END - if
664
665                 // Free result
666                 SQL_FREERESULT($result);
667         } // END - if
668
669         // Default name is unknown
670         $name = 'unknown';
671
672         // Is the entry there?
673         if (isset($GLOBALS['network_api_index'][$index])) {
674                 // Then get the name
675                 $name = $GLOBALS['network_api_index'][$index]['network_translation_name'];
676         } // END - if
677
678         // Return translation
679         return translateNetworkTranslationName($name);
680 }
681
682 //------------------------------------------------------------------------------
683 //                             Call-back functions
684 //------------------------------------------------------------------------------
685
686 // Callback function to add new network
687 function doAdminNetworkProcessAddNetwork () {
688         // We can say here, the form is sent, so check if the network is already added
689         if (isNetworkNameValid(postRequestParameter('network_short_name'))) {
690                 // Already there
691                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_ALREADY_ADDED', postRequestParameter('network_short_name')));
692                 return false;
693         } // END - if
694
695         // Remove the 'ok' part
696         unsetPostRequestParameter('ok');
697
698         // Add the whole request to database
699         SQL_QUERY('INSERT INTO
700         `{?_MYSQL_PREFIX?}_network_data`
701 (
702         `' . implode('`,`', array_keys(postRequestArray())) . "`
703 ) VALUES (
704         '" . implode("','", array_values(postRequestArray())) . "'
705 )", __FUNCTION__, __LINE__);
706
707         // Add the id for output only
708         setPostRequestParameter('network_id', SQL_INSERTID());
709
710         // Output message
711         if (SQL_AFFECTEDROWS() == 1) {
712                 // Successfully added
713                 loadTemplate('admin_network_added', false, postRequestArray());
714         } else {
715                 // Not added
716                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_DATA_NOT_ADDED', postRequestParameter('network_short_name')));
717         }
718 }
719
720 // Displays selected networks for editing
721 function doAdminNetworkProcessHandleNetwork () {
722         // Do we have selections?
723         if (ifPostContainsSelections()) {
724                 // Something has been selected, so start displaying one by one
725                 $OUT = '';
726                 foreach (postRequestParameter('sel') as $id => $sel) {
727                         // Is this selected?
728                         if ($sel == 1) {
729                                 // Load this network's data
730                                 $networkData = getNetworkDataById($id);
731
732                                 // Do we have found the network?
733                                 if (count($networkData) > 0) {
734                                         if (isFormSent('edit')) {
735                                                 // Add row template for editing
736                                                 $OUT .= loadTemplate('admin_edit_networks_row', true, $networkData);
737                                         } elseif (isFormSent('del')) {
738                                                 // Add row template for deleting
739                                                 $OUT .= loadTemplate('admin_del_networks_row', true, $networkData);
740                                         } else {
741                                                 // Problem!
742                                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
743                                         }
744                                 } // END - if
745                         } // END - if
746                 } // END - foreach
747
748                 // If we have no rows, we don't need to display the edit form
749                 if (!empty($OUT)) {
750                         // Output main template
751                         if (isFormSent('edit')) {
752                                 loadTemplate('admin_edit_networks', false, $OUT);
753                         } elseif (isFormSent('del')) {
754                                 loadTemplate('admin_del_networks', false, $OUT);
755                         } else {
756                                 // Problem!
757                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
758                         }
759
760                         // Don't display the list/add new form
761                         $GLOBALS['network_display'] = false;
762                 } else {
763                         // Nothing selected/found
764                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_NOTHING_FOUND--}');
765                 }
766         } // END - if
767 }
768
769 // Handle network type form
770 function doAdminNetworkProcessHandleNetworkType () {
771         // Do we have selections?
772         if (ifPostContainsSelections()) {
773                 // Load network data
774                 $networkData = getNetworkDataById(getRequestParameter('network'));
775
776                 // Something has been selected, so start displaying one by one
777                 $OUT = '';
778                 foreach (postRequestParameter('sel') as $id => $sel) {
779                         // Is this selected?
780                         if ($sel == 1) {
781                                 // Load this network's data
782                                 $networkTypeData = getNetworkTypeDataById($id);
783
784                                 // Do we have found the network?
785                                 if (count($networkTypeData) > 0) {
786                                         if (isFormSent('edit')) {
787                                                 // Add row template for deleting
788                                                 $OUT .= loadTemplate('admin_edit_network_types_row', true, $networkTypeData);
789                                         } elseif (isFormSent('del')) {
790                                                 // Add row template for deleting
791                                                 $OUT .= loadTemplate('admin_del_network_types_row', true, $networkTypeData);
792                                         } else {
793                                                 // Problem!
794                                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
795                                         }
796                                 } // END - if
797                         } // END - if
798                 } // END - foreach
799
800                 // If we have no rows, we don't need to display the edit form
801                 if (!empty($OUT)) {
802                         // Output main template
803                         if (isFormSent('edit')) {
804                                 loadTemplate('admin_edit_network_types', false, $OUT);
805                         } elseif (isFormSent('del')) {
806                                 loadTemplate('admin_del_network_types', false, $OUT);
807                         } else {
808                                 // Problem!
809                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
810                         }
811
812                         // Don't display the list/add new form
813                         $GLOBALS['network_display'] = false;
814                 } else {
815                         // Nothing selected/found
816                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_TYPES_NOTHING_FOUND--}');
817                 }
818         } // END - if
819 }
820
821 // Handle network request parameter form
822 function doAdminNetworkProcessHandleRequestParams () {
823         // Do we have selections?
824         if (ifPostContainsSelections()) {
825                 // Init cache array
826                 $GLOBALS['network_params_disabled'] = array();
827
828                 // Load network data
829                 $networkData = getNetworkDataById(getRequestParameter('network'));
830
831                 // Something has been selected, so start displaying one by one
832                 $OUT = '';
833                 foreach (postRequestParameter('sel') as $id => $sel) {
834                         // Is this selected?
835                         if ($sel == 1) {
836                                 // Load this network's data
837                                 $networkRequestData = getNetworkRequestParamsDataById($id);
838
839                                 // Do we have found the network?
840                                 if (count($networkRequestData) > 0) {
841                                         if (isFormSent('edit')) {
842                                                 // Add row template for deleting
843                                                 $OUT .= loadTemplate('admin_edit_network_params_row', true, $networkRequestData);
844                                         } elseif (isFormSent('del')) {
845                                                 // Get type data
846                                                 $networkRequestData['network_type_data'] = getNetworkTypeDataById($networkRequestData['network_type_id']);
847
848                                                 // Add row template for deleting
849                                                 $OUT .= loadTemplate('admin_del_network_params_row', true, $networkRequestData);
850                                         } else {
851                                                 // Problem!
852                                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
853                                         }
854                                 } // END - if
855                         } // END - if
856                 } // END - foreach
857
858                 // If we have no rows, we don't need to display the edit form
859                 if (!empty($OUT)) {
860                         // Output main template
861                         if (isFormSent('edit')) {
862                                 loadTemplate('admin_edit_network_params', false, $OUT);
863                         } elseif (isFormSent('del')) {
864                                 loadTemplate('admin_del_network_params', false, $OUT);
865                         } else {
866                                 // Problem!
867                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
868                         }
869
870                         // Don't display the list/add new form
871                         $GLOBALS['network_display'] = false;
872                 } else {
873                         // Nothing selected/found
874                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_REQUEST_PARAMETER_NOTHING_FOUND--}');
875                 }
876         } // END - if
877 }
878
879 // Changes given networks
880 function doAdminNetworkProcessChangeNetwork () {
881         // Do we have selections?
882         if (ifPostContainsSelections()) {
883                 // By default nothing is updated
884                 $updated = 0;
885
886                 // Something has been selected, so start updating them
887                 foreach (postRequestParameter('sel') as $id => $sel) {
888                         // Update this entry?
889                         if ($sel == 1) {
890                                 // Init data array
891                                 $networkData = array();
892
893                                 // Transfer whole array, except 'sel'
894                                 foreach (postRequestArray() as $key => $entry) {
895                                         // Skip 'sel' and submit button
896                                         if (in_array($key, array('sel', 'change'))) continue;
897
898                                         // Do we have this enty?
899                                         if (!isset($entry[$id])) {
900                                                 // Not found, needs fixing
901                                                 debug_report_bug(__FUNCTION__, __LINE__, 'No entry in key=' . $key . ', id=' . $id . ' found.');
902                                         } // END - if
903
904                                         // Add this entry
905                                         $networkData[$key] = $entry[$id];
906                                 } // END - foreach
907
908                                 // Update the network data
909                                 $updated += doNetworkUpdateDataByArray($id, $networkData);
910                         } // END - if
911                 } // END - foreach
912
913                 // Do we have updates?
914                 if ($updated > 0) {
915                         // Updates done
916                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_UPDATED', $updated));
917                 } else {
918                         // Nothing changed
919                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_NOTHING_CHANGED--}');
920                 }
921         } // END - if
922 }
923
924 // Removes given networks
925 function doAdminNetworkProcessRemoveNetwork () {
926         // Do we have selections?
927         if (ifPostContainsSelections()) {
928                 // By default nothing is removed
929                 $removed = 0;
930
931                 // Something has been selected, so start updating them
932                 foreach (postRequestParameter('sel') as $id => $sel) {
933                         // Update this entry?
934                         if ($sel == 1) {
935                                 // Remove this entry
936                                 $removed += doAdminRemoveNetworkEntry('data', 'network_id', $id);
937                         } // END - if
938                 } // END - foreach
939
940                 // Do we have removes?
941                 if ($removed > 0) {
942                         // Removals done
943                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REMOVED', $removed));
944                 } else {
945                         // Nothing removed
946                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_NOTHING_REMOVED--}');
947                 }
948         } // END - if
949 }
950
951 // Add a network type handler if not yet found
952 function doAdminNetworkProcessAddNetworkType () {
953         // Is the network type handle already used with given network?
954         if (isNetworkTypeHandleValid(postRequestParameter('network_type_handle'), getRequestParameter('network'))) {
955                 // Already added
956                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_HANDLE_ALREADY_ADDED', postRequestParameter('network_type_handle')));
957
958                 // ... so abort here
959                 return false;
960         } // END - if
961
962         // Remove the 'ok' part
963         unsetPostRequestParameter('ok');
964
965         // Add id
966         setPostRequestParameter('network_id', bigintval(getRequestParameter('network')));
967
968         // Is network_type_banner_url set?
969         if (postRequestParameter('network_type_banner_url') == '') {
970                 // Remove empty value to get a NULL for an optional entry
971                 unsetPostRequestParameter('network_type_banner_url');
972         } // END - if
973
974         // Add the whole request to database
975         SQL_QUERY('INSERT INTO
976         `{?_MYSQL_PREFIX?}_network_types`
977 (
978         `' . implode('`,`', array_keys(postRequestArray())) . "`
979 ) VALUES (
980         '" . implode("','", array_values(postRequestArray())) . "'
981 )", __FUNCTION__, __LINE__);
982
983         // Output message
984         if (SQL_AFFECTEDROWS() == 1) {
985                 // Successfully added
986                 loadTemplate('admin_network_type_added', false, postRequestArray());
987         } else {
988                 // Not added
989                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_NOT_ADDED', postRequestParameter('network_type_handle')));
990         }
991 }
992
993 // Changes given network type handlers
994 function doAdminNetworkProcessChangeNetworkType () {
995         // Do we have selections?
996         if (ifPostContainsSelections()) {
997                 // By default nothing is updated
998                 $updated = 0;
999
1000                 // Something has been selected, so start updating them
1001                 foreach (postRequestParameter('sel') as $id => $sel) {
1002                         // Update this entry?
1003                         if ($sel == 1) {
1004                                 // Init data array
1005                                 $networkTypeData = array();
1006
1007                                 // Transfer whole array, except 'sel'
1008                                 foreach (postRequestArray() as $key => $entry) {
1009                                         // Skip 'sel' and submit button
1010                                         if (in_array($key, array('sel', 'change'))) continue;
1011
1012                                         // Do we have this enty?
1013                                         if (!isset($entry[$id])) {
1014                                                 // Not found, needs fixing
1015                                                 debug_report_bug(__FUNCTION__, __LINE__, 'No entry in key=' . $key . ', id=' . $id . ' found.');
1016                                         } // END - if
1017
1018                                         // Fix empty network_type_banner_url to NULL
1019                                         if (($key == 'network_type_banner_url') && (trim($entry[$id]) == '')) {
1020                                                 // Set it to NULL
1021                                                 $entry[$id] = null;
1022                                         } // END - if
1023
1024                                         // Add this entry
1025                                         $networkTypeData[$key] = $entry[$id];
1026                                 } // END - foreach
1027
1028                                 // Update the network data
1029                                 $updated += doNetworkUpdateTypeByArray($id, $networkTypeData);
1030                         } // END - if
1031                 } // END - foreach
1032
1033                 // Do we have updates?
1034                 if ($updated > 0) {
1035                         // Updates done
1036                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_UPDATED', $updated));
1037                 } else {
1038                         // Nothing changed
1039                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_TYPES_NOTHING_CHANGED--}');
1040                 }
1041         } // END - if
1042 }
1043
1044 // Changes given network request parameters
1045 function doAdminNetworkProcessChangeNetworkParam () {
1046         // Do we have selections?
1047         if (ifPostContainsSelections()) {
1048                 // By default nothing is updated
1049                 $updated = 0;
1050
1051                 // Something has been selected, so start updating them
1052                 foreach (postRequestParameter('sel') as $id => $sel) {
1053                         // Update this entry?
1054                         if ($sel == 1) {
1055                                 // Init data array
1056                                 $networkParamsData = array();
1057
1058                                 // Transfer whole array, except 'sel'
1059                                 foreach (postRequestArray() as $key => $entry) {
1060                                         // Skip 'sel' and submit button
1061                                         if (in_array($key, array('sel', 'change'))) continue;
1062
1063                                         // Do we have this enty?
1064                                         if (!isset($entry[$id])) {
1065                                                 // Not found, needs fixing
1066                                                 debug_report_bug(__FUNCTION__, __LINE__, 'No entry in key=' . $key . ', id=' . $id . ' found.');
1067                                         } // END - if
1068
1069                                         // Fix empty request_param_default to NULL
1070                                         if (($key == 'request_param_default') && (trim($entry[$id]) == '')) {
1071                                                 // Set it to NULL
1072                                                 $entry[$id] = null;
1073                                         } // END - if
1074
1075                                         // Add this entry
1076                                         $networkParamsData[$key] = $entry[$id];
1077                                 } // END - foreach
1078
1079                                 // Update the network data
1080                                 $updated += doNetworkUpdateParamsByArray($id, $networkParamsData);
1081                         } // END - if
1082                 } // END - foreach
1083
1084                 // Do we have updates?
1085                 if ($updated > 0) {
1086                         // Updates done
1087                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_UPDATED', $updated));
1088                 } else {
1089                         // Nothing changed
1090                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_REQUEST_PARAMETER_NOTHING_CHANGED--}');
1091                 }
1092         } // END - if
1093 }
1094
1095 // Removes given network type handlers
1096 function doAdminNetworkProcessRemoveNetworkType () {
1097         // Do we have selections?
1098         if (ifPostContainsSelections()) {
1099                 // By default nothing is removed
1100                 $removed = 0;
1101
1102                 // Something has been selected, so start updating them
1103                 foreach (postRequestParameter('sel') as $id => $sel) {
1104                         // Update this entry?
1105                         if ($sel == 1) {
1106                                 // Remove this entry
1107                                 $removed += doAdminRemoveNetworkEntry('types', 'network_type_id', $id);
1108                         } // END - if
1109                 } // END - foreach
1110
1111                 // Do we have removes?
1112                 if ($removed > 0) {
1113                         // Removals done
1114                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_REMOVED', $removed));
1115                 } else {
1116                         // Nothing removed
1117                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_TYPES_NOTHING_REMOVED--}');
1118                 }
1119         } // END - if
1120 }
1121
1122 // Removes given network request parameters
1123 function doAdminNetworkProcessRemoveNetworkParam () {
1124         // Do we have selections?
1125         if (ifPostContainsSelections()) {
1126                 // By default nothing is removed
1127                 $removed = 0;
1128
1129                 // Something has been selected, so start updating them
1130                 foreach (postRequestParameter('sel') as $id => $sel) {
1131                         // Update this entry?
1132                         if ($sel == 1) {
1133                                 // Remove this entry
1134                                 $removed += doAdminRemoveNetworkEntry('request_params', 'network_param_id', $id);
1135                         } // END - if
1136                 } // END - foreach
1137
1138                 // Do we have removes?
1139                 if ($removed > 0) {
1140                         // Removals done
1141                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_REMOVED', $removed));
1142                 } else {
1143                         // Nothing removed
1144                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_REQUEST_PARAMETER_NOTHING_REMOVED--}');
1145                 }
1146         } // END - if
1147 }
1148
1149 // Adds a request parameter to given network and type
1150 function doAdminNetworkProcessAddNetworkParam () {
1151         // Is the request parameter already used with given network?
1152         if (isNetworkRequestParameterValid(postRequestParameter('request_param_key'), postRequestParameter('network_type_id'), getRequestParameter('network'))) {
1153                 // Already added
1154                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_ALREADY_ADDED', postRequestParameter('request_param_key')));
1155
1156                 // ... so abort here
1157                 return false;
1158         } // END - if
1159
1160         // Remove the 'ok' part
1161         unsetPostRequestParameter('ok');
1162
1163         // Add id
1164         setPostRequestParameter('network_id', bigintval(getRequestParameter('network')));
1165
1166         // Is request_param_default set?
1167         if (postRequestParameter('request_param_default') == '') {
1168                 // Remove empty value to get a NULL for an optional entry
1169                 unsetPostRequestParameter('request_param_default');
1170         } // END - if
1171
1172         // Add the whole request to database
1173         SQL_QUERY('INSERT INTO
1174         `{?_MYSQL_PREFIX?}_network_request_params`
1175 (
1176         `' . implode('`,`', array_keys(postRequestArray())) . "`
1177 ) VALUES (
1178         '" . implode("','", array_values(postRequestArray())) . "'
1179 )", __FUNCTION__, __LINE__);
1180
1181         // Output message
1182         if (SQL_AFFECTEDROWS() == 1) {
1183                 // Successfully added
1184                 loadTemplate('admin_network_request_param_added', false, postRequestArray());
1185         } else {
1186                 // Not added
1187                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_NOT_ADDED', postRequestParameter('request_param_key')));
1188         }
1189 }
1190
1191 // Adds a API response array entry
1192 function doAdminNetworkProcessAddNetworkApiTranslation () {
1193         // Is the request parameter already used with given network?
1194         if (isNetworkApiTranslationValid(postRequestParameter('network_api_index'), postRequestParameter('network_type_id'), getRequestParameter('network'))) {
1195                 // Already added
1196                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_API_TRANSLATION_ALREADY_ADDED', postRequestParameter('request_param_key')));
1197
1198                 // ... so abort here
1199                 return false;
1200         } // END - if
1201
1202         // Remove the 'ok' part
1203         unsetPostRequestParameter('ok');
1204
1205         // Add id
1206         setPostRequestParameter('network_id', bigintval(getRequestParameter('network')));
1207
1208         // Add sorting
1209         setPostRequestParameter('sort', countSumTotalData(
1210                 postRequestParameter('network_id'),
1211                 'network_api_translation',
1212                 'network_api_id',
1213                 'network_id',
1214                 true,
1215                 sprintf(" AND `network_type_id`=%s", bigintval(postRequestParameter('network_type_id')))
1216         ));
1217
1218         // Add the whole request to database
1219         SQL_QUERY('INSERT INTO
1220         `{?_MYSQL_PREFIX?}_network_api_translation`
1221 (
1222         `' . implode('`,`', array_keys(postRequestArray())) . "`
1223 ) VALUES (
1224         '" . implode("','", array_values(postRequestArray())) . "'
1225 )", __FUNCTION__, __LINE__);
1226
1227         // Output message
1228         if (SQL_AFFECTEDROWS() == 1) {
1229                 // Successfully added
1230                 loadTemplate('admin_network_api_translation_added', false, postRequestArray());
1231         } else {
1232                 // Not added
1233                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_API_TRANSLATION_NOT_ADDED', postRequestParameter('network_api_index')));
1234         }
1235 }
1236
1237 // Do expression code for this extension
1238 function doExpressionNetwork ($data) {
1239         // Construct replacer
1240         $replacer = sprintf(
1241                 "{DQUOTE} . %s(%s, '%s') . {DQUOTE}",
1242                 $data['callback'],
1243                 $data['matches'][4][$data['key']],
1244                 $data['extra_func']
1245         );
1246
1247         // Replace %network% with the current network id
1248         $replacer = str_replace('%network%', getCurrentNetworkId(), $replacer);
1249
1250         // Replace the code
1251         $code = replaceExpressionCode($data, $replacer);
1252
1253         // Return it
1254         return $code;
1255 }
1256 // [EOF]
1257 ?>
1258