Fixed a lot ext-network forms, {%get=foo%} introduced, a lot array elements added
[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                                 'country'
549                         ),
550                         array(
551                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_ID--}',
552                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_SID--}',
553                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_HASH--}',
554                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_PASSWORD--}',
555                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_RELOAD--}',
556                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_MAXIMUM_STAY--}',
557                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_MINIMUM_STAY--}',
558                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_CURRENCY--}',
559                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_TYPE--}',
560                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_REMAIN--}',
561                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_REWARD--}',
562                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_SIZE--}',
563                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_EROTIC--}',
564                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_EXTRA--}',
565                                 '{--ADMIN_NETWORK_REQUEST_PARAMETER_COUNTRY--}'
566                         ),
567                         $key,
568                         '', '',
569                         $GLOBALS['network_params_disabled']
570                 );
571         } // END - if
572
573         // Return content
574         return $GLOBALS['network_request_param_key'][$key];
575 }
576
577 // Generator (somewhat getter) for (return) array translation
578 function generateNetworkTranslationOptions ($default = '') {
579         // Is it cached?
580         if (!isset($GLOBALS['network_translation'][$default])) {
581                 // Generate and cache it
582                 $GLOBALS['network_translation'][$default] = generateOptionList(
583                         'network_translations',
584                         'network_translation_id',
585                         'network_translation_name',
586                         $default,
587                         '',
588                         '',
589                         $GLOBALS['network_translation_disabled'],
590                         'translateNetworkTranslationName'
591                 );
592         } // END - if
593
594         // Return content
595         return $GLOBALS['network_translation'][$default];
596 }
597
598 // Generates an option list of request types
599 function generateNetworkRequestTypeOptions ($default = '') {
600         // Do we have cache?
601         if (!isset($GLOBALS['network_request_type'][$default])) {
602                 // Generate the list
603                 $GLOBALS['network_request_type'][$default] = generateOptionList(
604                         '/ARRAY/',
605                         array(
606                                 'GET',
607                                 'POST'
608                         ),
609                         array(
610                                 '{--ADMIN_NETWORK_REQUEST_TYPE_GET--}',
611                                 '{--ADMIN_NETWORK_REQUEST_TYPE_POST--}'
612                         ),
613                         $default
614                 );
615         } // END - if
616
617         // Return cache
618         return $GLOBALS['network_request_type'][$default];
619 }
620
621 // Translates 'translate_name' for e.g. templates
622 function translateNetworkTranslationName ($name) {
623         // Get the message id
624         return getMessage('ADMIN_NETWORK_TRANSLATE_' . strtoupper($name) . '_NAME');
625 }
626
627 // Translates the network type handler (e.g. banner, paidmail) for templates
628 function translateNetworkTypeHandler ($type) {
629         // Get the message id
630         return getMessage('ADMIN_NETWORK_TYPES_' . strtoupper($type) . '');
631 }
632
633 // Translates request type
634 function translateNetworkRequestType ($name) {
635         // Get the message id
636         return getMessage('ADMIN_NETWORK_REQUEST_TYPE_' . strtoupper($name) . '');
637 }
638
639 // Translates API index
640 function translateNetworkApiIndex ($index) {
641         // Do we have cache?
642         if (!isset($GLOBALS['network_api_index'])) {
643                 // Get an array of all API array indexes
644                 $GLOBALS['network_api_index'] = array();
645
646                 // Get all entries
647                 $result = SQL_QUERY('SELECT
648         `network_api_id`, `network_api_index`, `network_translation_name`
649 FROM
650         `{?_MYSQL_PREFIX?}_network_api_translation`
651 INNER JOIN
652         `{?_MYSQL_PREFIX?}_network_translations`
653 ON
654         `network_api_index`=`network_translation_id`
655 ORDER BY
656         `sort` ASC', __FUNCTION__, __LINE__);
657
658                 // Do we have entries?
659                 if (SQL_NUMROWS($result) > 0) {
660                         // Get all entries
661                         while ($row = SQL_FETCHARRAY($result)) {
662                                 // Add it to our global array
663                                 $GLOBALS['network_api_index'][$row['network_api_index']] = $row;
664                         } // END - while
665                 } // END - if
666
667                 // Free result
668                 SQL_FREERESULT($result);
669         } // END - if
670
671         // Default name is unknown
672         $name = 'unknown';
673
674         // Is the entry there?
675         if (isset($GLOBALS['network_api_index'][$index])) {
676                 // Then get the name
677                 $name = $GLOBALS['network_api_index'][$index]['network_translation_name'];
678         } // END - if
679
680         // Return translation
681         return translateNetworkTranslationName($name);
682 }
683
684 //------------------------------------------------------------------------------
685 //                             Call-back functions
686 //------------------------------------------------------------------------------
687
688 // Callback function to add new network
689 function doAdminNetworkProcessAddNetwork () {
690         // We can say here, the form is sent, so check if the network is already added
691         if (isNetworkNameValid(postRequestParameter('network_short_name'))) {
692                 // Already there
693                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_ALREADY_ADDED', postRequestParameter('network_short_name')));
694                 return false;
695         } // END - if
696
697         // Remove the 'ok' part
698         unsetPostRequestParameter('ok');
699
700         // Add the whole request to database
701         SQL_QUERY('INSERT INTO
702         `{?_MYSQL_PREFIX?}_network_data`
703 (
704         `' . implode('`,`', array_keys(postRequestArray())) . "`
705 ) VALUES (
706         '" . implode("','", array_values(postRequestArray())) . "'
707 )", __FUNCTION__, __LINE__);
708
709         // Add the id for output only
710         setPostRequestParameter('network_id', SQL_INSERTID());
711
712         // Output message
713         if (SQL_AFFECTEDROWS() == 1) {
714                 // Successfully added
715                 loadTemplate('admin_network_added', false, postRequestArray());
716         } else {
717                 // Not added
718                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_DATA_NOT_ADDED', postRequestParameter('network_short_name')));
719         }
720 }
721
722 // Displays selected networks for editing
723 function doAdminNetworkProcessHandleNetwork () {
724         // Do we have selections?
725         if (ifPostContainsSelections()) {
726                 // Something has been selected, so start displaying one by one
727                 $OUT = '';
728                 foreach (postRequestParameter('sel') as $id => $sel) {
729                         // Is this selected?
730                         if ($sel == 1) {
731                                 // Load this network's data
732                                 $networkData = getNetworkDataById($id);
733
734                                 // Do we have found the network?
735                                 if (count($networkData) > 0) {
736                                         if (isFormSent('edit')) {
737                                                 // Add row template for editing
738                                                 $OUT .= loadTemplate('admin_edit_networks_row', true, $networkData);
739                                         } elseif (isFormSent('del')) {
740                                                 // Add row template for deleting
741                                                 $OUT .= loadTemplate('admin_del_networks_row', true, $networkData);
742                                         } else {
743                                                 // Problem!
744                                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
745                                         }
746                                 } // END - if
747                         } // END - if
748                 } // END - foreach
749
750                 // If we have no rows, we don't need to display the edit form
751                 if (!empty($OUT)) {
752                         // Output main template
753                         if (isFormSent('edit')) {
754                                 loadTemplate('admin_edit_networks', false, $OUT);
755                         } elseif (isFormSent('del')) {
756                                 loadTemplate('admin_del_networks', false, $OUT);
757                         } else {
758                                 // Problem!
759                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
760                         }
761
762                         // Don't display the list/add new form
763                         $GLOBALS['network_display'] = false;
764                 } else {
765                         // Nothing selected/found
766                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_NOTHING_FOUND--}');
767                 }
768         } // END - if
769 }
770
771 // Handle network type form
772 function doAdminNetworkProcessHandleNetworkType () {
773         // Do we have selections?
774         if (ifPostContainsSelections()) {
775                 // Load network data
776                 $networkData = getNetworkDataById(getRequestParameter('network'));
777
778                 // Something has been selected, so start displaying one by one
779                 $OUT = '';
780                 foreach (postRequestParameter('sel') as $id => $sel) {
781                         // Is this selected?
782                         if ($sel == 1) {
783                                 // Load this network's data
784                                 $networkTypeData = getNetworkTypeDataById($id);
785
786                                 // Do we have found the network?
787                                 if (count($networkTypeData) > 0) {
788                                         if (isFormSent('edit')) {
789                                                 // Add row template for deleting
790                                                 $OUT .= loadTemplate('admin_edit_network_types_row', true, $networkTypeData);
791                                         } elseif (isFormSent('del')) {
792                                                 // Add row template for deleting
793                                                 $OUT .= loadTemplate('admin_del_network_types_row', true, $networkTypeData);
794                                         } else {
795                                                 // Problem!
796                                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
797                                         }
798                                 } // END - if
799                         } // END - if
800                 } // END - foreach
801
802                 // If we have no rows, we don't need to display the edit form
803                 if (!empty($OUT)) {
804                         // Output main template
805                         if (isFormSent('edit')) {
806                                 loadTemplate('admin_edit_network_types', false, $OUT);
807                         } elseif (isFormSent('del')) {
808                                 loadTemplate('admin_del_network_types', false, $OUT);
809                         } else {
810                                 // Problem!
811                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
812                         }
813
814                         // Don't display the list/add new form
815                         $GLOBALS['network_display'] = false;
816                 } else {
817                         // Nothing selected/found
818                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_TYPES_NOTHING_FOUND--}');
819                 }
820         } // END - if
821 }
822
823 // Handle network request parameter form
824 function doAdminNetworkProcessHandleRequestParams () {
825         // Do we have selections?
826         if (ifPostContainsSelections()) {
827                 // Init cache array
828                 $GLOBALS['network_params_disabled'] = array();
829
830                 // Load network data
831                 $networkData = getNetworkDataById(getRequestParameter('network'));
832
833                 // Something has been selected, so start displaying one by one
834                 $OUT = '';
835                 foreach (postRequestParameter('sel') as $id => $sel) {
836                         // Is this selected?
837                         if ($sel == 1) {
838                                 // Load this network's data
839                                 $networkRequestData = getNetworkRequestParamsDataById($id);
840
841                                 // Do we have found the network?
842                                 if (count($networkRequestData) > 0) {
843                                         if (isFormSent('edit')) {
844                                                 // Add row template for deleting
845                                                 $OUT .= loadTemplate('admin_edit_network_params_row', true, $networkRequestData);
846                                         } elseif (isFormSent('del')) {
847                                                 // Get type data
848                                                 $networkRequestData['network_type_data'] = getNetworkTypeDataById($networkRequestData['network_type_id']);
849
850                                                 // Add row template for deleting
851                                                 $OUT .= loadTemplate('admin_del_network_params_row', true, $networkRequestData);
852                                         } else {
853                                                 // Problem!
854                                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
855                                         }
856                                 } // END - if
857                         } // END - if
858                 } // END - foreach
859
860                 // If we have no rows, we don't need to display the edit form
861                 if (!empty($OUT)) {
862                         // Output main template
863                         if (isFormSent('edit')) {
864                                 loadTemplate('admin_edit_network_params', false, $OUT);
865                         } elseif (isFormSent('del')) {
866                                 loadTemplate('admin_del_network_params', false, $OUT);
867                         } else {
868                                 // Problem!
869                                 debug_report_bug(__FUNCTION__, __LINE__, 'Cannot detect edit/del.');
870                         }
871
872                         // Don't display the list/add new form
873                         $GLOBALS['network_display'] = false;
874                 } else {
875                         // Nothing selected/found
876                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_REQUEST_PARAMETER_NOTHING_FOUND--}');
877                 }
878         } // END - if
879 }
880
881 // Changes given networks
882 function doAdminNetworkProcessChangeNetwork () {
883         // Do we have selections?
884         if (ifPostContainsSelections()) {
885                 // By default nothing is updated
886                 $updated = 0;
887
888                 // Something has been selected, so start updating them
889                 foreach (postRequestParameter('sel') as $id => $sel) {
890                         // Update this entry?
891                         if ($sel == 1) {
892                                 // Init data array
893                                 $networkData = array();
894
895                                 // Transfer whole array, except 'sel'
896                                 foreach (postRequestArray() as $key => $entry) {
897                                         // Skip 'sel' and submit button
898                                         if (in_array($key, array('sel', 'change'))) continue;
899
900                                         // Do we have this enty?
901                                         if (!isset($entry[$id])) {
902                                                 // Not found, needs fixing
903                                                 debug_report_bug(__FUNCTION__, __LINE__, 'No entry in key=' . $key . ', id=' . $id . ' found.');
904                                         } // END - if
905
906                                         // Add this entry
907                                         $networkData[$key] = $entry[$id];
908                                 } // END - foreach
909
910                                 // Update the network data
911                                 $updated += doNetworkUpdateDataByArray($id, $networkData);
912                         } // END - if
913                 } // END - foreach
914
915                 // Do we have updates?
916                 if ($updated > 0) {
917                         // Updates done
918                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_UPDATED', $updated));
919                 } else {
920                         // Nothing changed
921                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_NOTHING_CHANGED--}');
922                 }
923         } // END - if
924 }
925
926 // Removes given networks
927 function doAdminNetworkProcessRemoveNetwork () {
928         // Do we have selections?
929         if (ifPostContainsSelections()) {
930                 // By default nothing is removed
931                 $removed = 0;
932
933                 // Something has been selected, so start updating them
934                 foreach (postRequestParameter('sel') as $id => $sel) {
935                         // Update this entry?
936                         if ($sel == 1) {
937                                 // Remove this entry
938                                 $removed += doAdminRemoveNetworkEntry('data', 'network_id', $id);
939                         } // END - if
940                 } // END - foreach
941
942                 // Do we have removes?
943                 if ($removed > 0) {
944                         // Removals done
945                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REMOVED', $removed));
946                 } else {
947                         // Nothing removed
948                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_NOTHING_REMOVED--}');
949                 }
950         } // END - if
951 }
952
953 // Add a network type handler if not yet found
954 function doAdminNetworkProcessAddNetworkType () {
955         // Is the network type handle already used with given network?
956         if (isNetworkTypeHandleValid(postRequestParameter('network_type_handle'), getRequestParameter('network'))) {
957                 // Already added
958                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_HANDLE_ALREADY_ADDED', postRequestParameter('network_type_handle')));
959
960                 // ... so abort here
961                 return false;
962         } // END - if
963
964         // Remove the 'ok' part
965         unsetPostRequestParameter('ok');
966
967         // Add id
968         setPostRequestParameter('network_id', bigintval(getRequestParameter('network')));
969
970         // Is network_type_banner_url set?
971         if (postRequestParameter('network_type_banner_url') == '') {
972                 // Remove empty value to get a NULL for an optional entry
973                 unsetPostRequestParameter('network_type_banner_url');
974         } // END - if
975
976         // Add the whole request to database
977         SQL_QUERY('INSERT INTO
978         `{?_MYSQL_PREFIX?}_network_types`
979 (
980         `' . implode('`,`', array_keys(postRequestArray())) . "`
981 ) VALUES (
982         '" . implode("','", array_values(postRequestArray())) . "'
983 )", __FUNCTION__, __LINE__);
984
985         // Output message
986         if (SQL_AFFECTEDROWS() == 1) {
987                 // Successfully added
988                 loadTemplate('admin_network_type_added', false, postRequestArray());
989         } else {
990                 // Not added
991                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_NOT_ADDED', postRequestParameter('network_type_handle')));
992         }
993 }
994
995 // Changes given network type handlers
996 function doAdminNetworkProcessChangeNetworkType () {
997         // Do we have selections?
998         if (ifPostContainsSelections()) {
999                 // By default nothing is updated
1000                 $updated = 0;
1001
1002                 // Something has been selected, so start updating them
1003                 foreach (postRequestParameter('sel') as $id => $sel) {
1004                         // Update this entry?
1005                         if ($sel == 1) {
1006                                 // Init data array
1007                                 $networkTypeData = array();
1008
1009                                 // Transfer whole array, except 'sel'
1010                                 foreach (postRequestArray() as $key => $entry) {
1011                                         // Skip 'sel' and submit button
1012                                         if (in_array($key, array('sel', 'change'))) continue;
1013
1014                                         // Do we have this enty?
1015                                         if (!isset($entry[$id])) {
1016                                                 // Not found, needs fixing
1017                                                 debug_report_bug(__FUNCTION__, __LINE__, 'No entry in key=' . $key . ', id=' . $id . ' found.');
1018                                         } // END - if
1019
1020                                         // Fix empty network_type_banner_url to NULL
1021                                         if (($key == 'network_type_banner_url') && (trim($entry[$id]) == '')) {
1022                                                 // Set it to NULL
1023                                                 $entry[$id] = null;
1024                                         } // END - if
1025
1026                                         // Add this entry
1027                                         $networkTypeData[$key] = $entry[$id];
1028                                 } // END - foreach
1029
1030                                 // Update the network data
1031                                 $updated += doNetworkUpdateTypeByArray($id, $networkTypeData);
1032                         } // END - if
1033                 } // END - foreach
1034
1035                 // Do we have updates?
1036                 if ($updated > 0) {
1037                         // Updates done
1038                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_UPDATED', $updated));
1039                 } else {
1040                         // Nothing changed
1041                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_TYPES_NOTHING_CHANGED--}');
1042                 }
1043         } // END - if
1044 }
1045
1046 // Changes given network request parameters
1047 function doAdminNetworkProcessChangeNetworkParam () {
1048         // Do we have selections?
1049         if (ifPostContainsSelections()) {
1050                 // By default nothing is updated
1051                 $updated = 0;
1052
1053                 // Something has been selected, so start updating them
1054                 foreach (postRequestParameter('sel') as $id => $sel) {
1055                         // Update this entry?
1056                         if ($sel == 1) {
1057                                 // Init data array
1058                                 $networkParamsData = array();
1059
1060                                 // Transfer whole array, except 'sel'
1061                                 foreach (postRequestArray() as $key => $entry) {
1062                                         // Skip 'sel' and submit button
1063                                         if (in_array($key, array('sel', 'change'))) continue;
1064
1065                                         // Do we have this enty?
1066                                         if (!isset($entry[$id])) {
1067                                                 // Not found, needs fixing
1068                                                 debug_report_bug(__FUNCTION__, __LINE__, 'No entry in key=' . $key . ', id=' . $id . ' found.');
1069                                         } // END - if
1070
1071                                         // Fix empty request_param_default to NULL
1072                                         if (($key == 'request_param_default') && (trim($entry[$id]) == '')) {
1073                                                 // Set it to NULL
1074                                                 $entry[$id] = null;
1075                                         } // END - if
1076
1077                                         // Add this entry
1078                                         $networkParamsData[$key] = $entry[$id];
1079                                 } // END - foreach
1080
1081                                 // Update the network data
1082                                 $updated += doNetworkUpdateParamsByArray($id, $networkParamsData);
1083                         } // END - if
1084                 } // END - foreach
1085
1086                 // Do we have updates?
1087                 if ($updated > 0) {
1088                         // Updates done
1089                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_UPDATED', $updated));
1090                 } else {
1091                         // Nothing changed
1092                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_REQUEST_PARAMETER_NOTHING_CHANGED--}');
1093                 }
1094         } // END - if
1095 }
1096
1097 // Removes given network type handlers
1098 function doAdminNetworkProcessRemoveNetworkType () {
1099         // Do we have selections?
1100         if (ifPostContainsSelections()) {
1101                 // By default nothing is removed
1102                 $removed = 0;
1103
1104                 // Something has been selected, so start updating them
1105                 foreach (postRequestParameter('sel') as $id => $sel) {
1106                         // Update this entry?
1107                         if ($sel == 1) {
1108                                 // Remove this entry
1109                                 $removed += doAdminRemoveNetworkEntry('types', 'network_type_id', $id);
1110                         } // END - if
1111                 } // END - foreach
1112
1113                 // Do we have removes?
1114                 if ($removed > 0) {
1115                         // Removals done
1116                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPES_REMOVED', $removed));
1117                 } else {
1118                         // Nothing removed
1119                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_TYPES_NOTHING_REMOVED--}');
1120                 }
1121         } // END - if
1122 }
1123
1124 // Removes given network request parameters
1125 function doAdminNetworkProcessRemoveNetworkParam () {
1126         // Do we have selections?
1127         if (ifPostContainsSelections()) {
1128                 // By default nothing is removed
1129                 $removed = 0;
1130
1131                 // Something has been selected, so start updating them
1132                 foreach (postRequestParameter('sel') as $id => $sel) {
1133                         // Update this entry?
1134                         if ($sel == 1) {
1135                                 // Remove this entry
1136                                 $removed += doAdminRemoveNetworkEntry('request_params', 'network_param_id', $id);
1137                         } // END - if
1138                 } // END - foreach
1139
1140                 // Do we have removes?
1141                 if ($removed > 0) {
1142                         // Removals done
1143                         loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_REMOVED', $removed));
1144                 } else {
1145                         // Nothing removed
1146                         loadTemplate('admin_settings_unsaved', false, '{--ADMIN_NETWORK_REQUEST_PARAMETER_NOTHING_REMOVED--}');
1147                 }
1148         } // END - if
1149 }
1150
1151 // Adds a request parameter to given network and type
1152 function doAdminNetworkProcessAddNetworkParam () {
1153         // Is the request parameter already used with given network?
1154         if (isNetworkRequestParameterValid(postRequestParameter('request_param_key'), postRequestParameter('network_type_id'), getRequestParameter('network'))) {
1155                 // Already added
1156                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_ALREADY_ADDED', postRequestParameter('request_param_key')));
1157
1158                 // ... so abort here
1159                 return false;
1160         } // END - if
1161
1162         // Remove the 'ok' part
1163         unsetPostRequestParameter('ok');
1164
1165         // Add id
1166         setPostRequestParameter('network_id', bigintval(getRequestParameter('network')));
1167
1168         // Is request_param_default set?
1169         if (postRequestParameter('request_param_default') == '') {
1170                 // Remove empty value to get a NULL for an optional entry
1171                 unsetPostRequestParameter('request_param_default');
1172         } // END - if
1173
1174         // Add the whole request to database
1175         SQL_QUERY('INSERT INTO
1176         `{?_MYSQL_PREFIX?}_network_request_params`
1177 (
1178         `' . implode('`,`', array_keys(postRequestArray())) . "`
1179 ) VALUES (
1180         '" . implode("','", array_values(postRequestArray())) . "'
1181 )", __FUNCTION__, __LINE__);
1182
1183         // Output message
1184         if (SQL_AFFECTEDROWS() == 1) {
1185                 // Successfully added
1186                 loadTemplate('admin_network_request_param_added', false, postRequestArray());
1187         } else {
1188                 // Not added
1189                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_REQUEST_PARAMETER_NOT_ADDED', postRequestParameter('request_param_key')));
1190         }
1191 }
1192
1193 // Adds a API response array entry
1194 function doAdminNetworkProcessAddNetworkApiTranslation () {
1195         // Is the request parameter already used with given network?
1196         if (isNetworkApiTranslationValid(postRequestParameter('network_api_index'), postRequestParameter('network_type_id'), getRequestParameter('network'))) {
1197                 // Already added
1198                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_API_TRANSLATION_ALREADY_ADDED', postRequestParameter('network_api_index')));
1199
1200                 // ... so abort here
1201                 return false;
1202         } // END - if
1203
1204         // Remove the 'ok' part
1205         unsetPostRequestParameter('ok');
1206
1207         // Add id
1208         setPostRequestParameter('network_id', bigintval(getRequestParameter('network')));
1209
1210         // Add sorting
1211         setPostRequestParameter('sort', (countSumTotalData(
1212                 postRequestParameter('network_id'),
1213                 'network_api_translation',
1214                 'network_api_id',
1215                 'network_id',
1216                 true,
1217                 sprintf(" AND `network_type_id`=%s", bigintval(postRequestParameter('network_type_id')))
1218         ) + 1));
1219
1220         // Add the whole request to database
1221         SQL_QUERY('INSERT INTO
1222         `{?_MYSQL_PREFIX?}_network_api_translation`
1223 (
1224         `' . implode('`,`', array_keys(postRequestArray())) . "`
1225 ) VALUES (
1226         '" . implode("','", array_values(postRequestArray())) . "'
1227 )", __FUNCTION__, __LINE__);
1228
1229         // Output message
1230         if (SQL_AFFECTEDROWS() == 1) {
1231                 // Successfully added
1232                 loadTemplate('admin_network_api_translation_added', false, postRequestArray());
1233         } else {
1234                 // Not added
1235                 loadTemplate('admin_settings_unsaved', false, getMaskedMessage('ADMIN_NETWORK_API_TRANSLATION_NOT_ADDED', postRequestParameter('network_api_index')));
1236         }
1237 }
1238
1239 // Do expression code for this extension
1240 function doExpressionNetwork ($data) {
1241         // Construct replacer
1242         $replacer = sprintf(
1243                 "{DQUOTE} . %s(%s, '%s') . {DQUOTE}",
1244                 $data['callback'],
1245                 $data['matches'][4][$data['key']],
1246                 $data['extra_func']
1247         );
1248
1249         // Replace %network% with the current network id
1250         $replacer = str_replace('%network%', getCurrentNetworkId(), $replacer);
1251
1252         // Replace the code
1253         $code = replaceExpressionCode($data, $replacer);
1254
1255         // Return it
1256         return $code;
1257 }
1258 // [EOF]
1259 ?>
1260