2 /************************************************************************
3 * Mailer v0.2.1-FINAL Start: 11/04/2009 *
4 * =================== Last change: 11/04/2009 *
6 * -------------------------------------------------------------------- *
7 * File : network_functions.php *
8 * -------------------------------------------------------------------- *
9 * Short description : Functions for ext-network *
10 * -------------------------------------------------------------------- *
11 * Kurzbeschreibung : Funktionen fuer ext-network *
12 * -------------------------------------------------------------------- *
15 * $Tag:: 0.2.1-FINAL $ *
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 * For more information visit: http://www.mxchange.org *
23 * This program is free software; you can redistribute it and/or modify *
24 * it under the terms of the GNU General Public License as published by *
25 * the Free Software Foundation; either version 2 of the License, or *
26 * (at your option) any later version. *
28 * This program is distributed in the hope that it will be useful, *
29 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
30 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
31 * GNU General Public License for more details. *
33 * You should have received a copy of the GNU General Public License *
34 * along with this program; if not, write to the Free Software *
35 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, *
37 ************************************************************************/
39 // Some security stuff...
40 if (!defined('__SECURITY')) {
44 // Handle a (maybe) sent form here
45 function doNetworkHandleForm () {
47 if ((isFormSent()) || (isPostRequestElementSet('edit')) || (isPostRequestElementSet('del')) || (isPostRequestElementSet('change')) || (isPostRequestElementSet('remove'))) {
49 if (isGetRequestElementSet('do')) {
50 // Process the request
51 doAdminNetworkProcessForm();
54 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_DO_404'));
59 // Processes an admin form
60 function doAdminNetworkProcessForm () {
62 if ((!isFormSent()) && (!isPostRequestElementSet('edit')) && (!isPostRequestElementSet('del')) && (!isPostRequestElementSet('change')) && (!isPostRequestElementSet('remove'))) {
64 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_FORM_NOT_SENT'));
66 } elseif (!isGetRequestElementSet('do')) {
68 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_DO_404'));
72 // Create function name
73 $functionName = sprintf("doAdminNetworkProcess%sForm", ucfirst(strtolower(getRequestElement('do'))));
75 // Is the function valid?
76 if (!function_exists($functionName)) {
77 // Invalid function name
78 debug_report_bug('Invalid do ' . getRequestElement('do') . ', function ' . $functionName .' does not exist.', false);
81 // Call-back the method handling our request
82 call_user_func($functionName);
85 // Checks wether the (short) network name is already used (valid)
86 function isNetworkNameValid ($name) {
88 $result = SQL_QUERY_ESC("SELECT `network_id` FROM `{?_MYSQL_PREFIX?}_network_data` WHERE `network_short_name`='%s' LIMIT 1",
89 array($name), __FUNCTION__, __LINE__);
92 $isValid = (SQL_NUMROWS($result) == 1);
95 SQL_FREERESULT($result);
101 // Checks wether the given network type is already used (valid)
102 function isNetworkTypeHandleValid ($type, $networkId) {
104 $result = SQL_QUERY_ESC("SELECT `network_type_id` FROM `{?_MYSQL_PREFIX?}_network_types` WHERE `network_id`=%s AND `network_type_handle`='%s' LIMIT 1",
105 array($networkId, $type), __FUNCTION__, __LINE__);
108 $isValid = (SQL_NUMROWS($result) == 1);
111 SQL_FREERESULT($result);
117 // "Getter" for a network's data by provided id number
118 function getNetworkDataById ($id) {
119 // Ids lower one are not accepted
121 // Not good, should be fixed
122 debug_report_bug('Network id ' . $id . ' is smaller than 1.');
125 // By default we have no data
126 $networkData = array();
128 // Query for the network data
129 $result = SQL_QUERY_ESC("SELECT
130 `network_id`, `network_short_name`, `network_title`, `network_reflink`, `network_data_seperator`, `network_row_seperator`, `network_request_type`, `network_charset`
132 `{?_MYSQL_PREFIX?}_network_data`
136 array(bigintval($id)), __FUNCTION__, __LINE__);
138 // Do we have an entry?
139 if (SQL_NUMROWS($result) == 1) {
141 $networkData = SQL_FETCHARRAY($result);
145 SQL_FREERESULT($result);
151 // "Getter" for a network type data by provided id number
152 function getNetworkTypeDataById ($id) {
153 // Ids lower one are not accepted
155 // Not good, should be fixed
156 debug_report_bug('Network type id ' . $id . ' is smaller than 1.');
159 // By default we have no data
160 $networkTypeData = array();
162 // Query for the network data
163 $result = SQL_QUERY_ESC("SELECT
164 `network_type_id`, `network_id`, `network_type_handle`, `network_type_api_url`, `network_type_click_url`, `network_type_banner_url`
166 `{?_MYSQL_PREFIX?}_network_types`
170 array(bigintval($id)), __FUNCTION__, __LINE__);
172 // Do we have an entry?
173 if (SQL_NUMROWS($result) == 1) {
175 $networkTypeData = SQL_FETCHARRAY($result);
179 SQL_FREERESULT($result);
182 return $networkTypeData;
185 // Updates given network (id) with data from array
186 function doNetworkUpdateDataByArray ($id, $networkData) {
187 // Ids lower one are not accepted
189 // Not good, should be fixed
190 debug_report_bug('Network id ' . $id . ' is smaller than 1.');
193 // Just call our inner method
194 return adminSaveSettings($networkData, '_network_data', sprintf("`network_id`=%s", bigintval($id)), array(), false, false);
197 // Updates given network type handler (id) with data from array
198 function doNetworkUpdateTypeByArray ($id, $networkTypeData) {
199 // Ids lower one are not accepted
201 // Not good, should be fixed
202 debug_report_bug('Network type handler id ' . $id . ' is smaller than 1.');
205 // Just call our inner method
206 return adminSaveSettings($networkTypeData, '_network_types', sprintf("`network_type_id`=%s", bigintval($id)), array(), false, false);
209 // Removes given network entry
210 function doAdminRemoveNetworkEntry ($table, $column, $id, $limit = 1) {
212 SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_network_%s` WHERE `%s`=%s LIMIT %s",
213 array($table, $column, $id, $limit), __FILE__, __LINE__);
215 // Return affected rows
216 return SQL_AFFECTEDROWS();
219 // Generates a list of networks for given script and returns it
220 function generateAdminNetworkList () {
224 // Query for all networks
225 $result = SQL_QUERY("SELECT
226 `network_id`, `network_title`
228 `{?_MYSQL_PREFIX?}_network_data`
230 `network_title` ASC", __FILE__, __LINE__);
232 // Do we have entries?
233 if (SQL_NUMROWS($result) > 0) {
236 while ($row = SQL_FETCHARRAY($result)) {
237 // Is this valid, then add it
238 if ((is_array($row)) && (isset($row['network_id']))) $rows[] = $row;
241 // Generate the selection box
242 $content = generateSelectionBoxFromArray($rows, 'network', 'network_id', 'network_title');
245 $content = loadTemplate('admin_settings_saved', false, getMessage('ADMIN_ENTRIES_404'));
249 SQL_FREERESULT($result);
255 //------------------------------------------------------------------------------
256 // Call-back functions
257 //------------------------------------------------------------------------------
259 // Callback function to add new network
260 function doAdminNetworkProcessAddnetworkForm () {
261 // We can say here, the form is sent, so check if the network is already added
262 if (isNetworkNameValid(postRequestElement('network_short_name'))) {
264 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_ALREADY_ADDED', postRequestElement('network_short_name')));
268 // Remove the 'ok' part
269 unsetPostRequestElement('ok');
271 // Add the whole request to database
272 SQL_QUERY("INSERT INTO
273 `{?_MYSQL_PREFIX?}_network_data`
275 `" . implode('`,`', array_keys(postRequestArray())) . "`
277 '" . implode("','", array_values(postRequestArray())) . "'
278 )", __FUNCTION__, __LINE__);
280 // Add the id for output only
281 setPostRequestElement('network_id', SQL_INSERTID());
284 if (SQL_AFFECTEDROWS() == 1) {
285 // Successfully added
286 loadTemplate('admin_network_added', false, postRequestArray());
289 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_DATA_NOT_ADDED', postRequestElement('network_short_name')));
293 // Displays selected networks for editing
294 function doAdminNetworkProcessHandlenetworkForm () {
295 // Do we have selections?
296 if (countPostSelection() > 0) {
297 // Something has been selected, so start displaying one by one
299 foreach (postRequestElement('sel') as $id => $sel) {
302 // Load this network's data
303 $networkData = getNetworkDataById($id);
305 // Do we have found the network?
306 if (count($networkData) > 0) {
308 $networkData['sw'] = $SW;
310 if (isPostRequestElementSet('edit')) {
311 // Make selection box for network_request_type
312 $networkData['network_request_type'] = generateOptionList(
316 getMessage('ADMIN_NETWORK_REQUEST_TYPE_GET'),
317 getMessage('ADMIN_NETWORK_REQUEST_TYPE_POST')
319 $networkData['network_request_type']
322 // Add row template for editing
323 $OUT .= loadTemplate('admin_edit_networks_row', true, $networkData);
324 } elseif (isPostRequestElementSet('del')) {
325 // Translate the request type
326 $networkData['network_request_type'] = getMessage('ADMIN_NETWORK_REQUEST_TYPE_' . $networkData['network_request_type']);
328 // Add row template for deleting
329 $OUT .= loadTemplate('admin_del_networks_row', true, $networkData);
332 debug_report_bug('Cannot detect edit/del.');
341 // If we have no rows, we don't need to display the edit form
343 // Output main template
344 if (isPostRequestElementSet('edit')) {
345 loadTemplate('admin_edit_networks', false, $OUT);
346 } elseif (isPostRequestElementSet('del')) {
347 loadTemplate('admin_del_networks', false, $OUT);
350 debug_report_bug('Cannot detect edit/del.');
353 // Don't display the list/add new form
354 $GLOBALS['network_display'] = false;
356 // Nothing selected/found
357 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_FOUND'));
362 // Handle network type form
363 function doAdminNetworkProcessHandlenetworktypeForm () {
364 // Do we have selections?
365 if (countPostSelection() > 0) {
367 $networkData = getNetworkDataById(getRequestElement('network'));
369 // Something has been selected, so start displaying one by one
371 foreach (postRequestElement('sel') as $id => $sel) {
374 // Load this network's data
375 $networkTypeData = getNetworkTypeDataById($id);
377 // Do we have found the network?
378 if (count($networkTypeData) > 0) {
380 $networkTypeData['sw'] = $SW;
382 if (isPostRequestElementSet('edit')) {
383 // Add row template for deleting
384 $OUT .= loadTemplate('admin_edit_network_types_row', true, $networkTypeData);
385 } elseif (isPostRequestElementSet('del')) {
386 // Fix empty banner URL
387 if (trim($networkTypeData['network_type_banner_url']) == '') $networkTypeData['network_type_banner_url'] = '---';
389 // Add row template for deleting
390 $OUT .= loadTemplate('admin_del_network_types_row', true, $networkTypeData);
393 debug_report_bug('Cannot detect edit/del.');
402 // If we have no rows, we don't need to display the edit form
404 // Prepare content for template
407 'network_data' => getNetworkDataById(getRequestElement('network'))
410 // Output main template
411 if (isPostRequestElementSet('edit')) {
412 loadTemplate('admin_edit_network_types', false, $content);
413 } elseif (isPostRequestElementSet('del')) {
414 loadTemplate('admin_del_network_types', false, $content);
417 debug_report_bug('Cannot detect edit/del.');
420 // Don't display the list/add new form
421 $GLOBALS['network_display'] = false;
423 // Nothing selected/found
424 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_TYPE_NOTHING_FOUND'));
429 // Changes given networks
430 function doAdminNetworkProcessChangenetworkForm () {
431 // Do we have selections?
432 if (countPostSelection() > 0) {
433 // By default nothing is updated
436 // Something has been selected, so start updating them
437 foreach (postRequestElement('sel') as $id => $sel) {
438 // Update this entry?
441 $networkData = array();
443 // Transfer whole array, except 'sel'
444 foreach (postRequestArray() as $key => $entry) {
445 // Skip 'sel' and submit button
446 if (in_array($key, array('sel', 'change'))) continue;
448 // Do we have this enty?
449 if (!isset($entry[$id])) {
450 // Not found, needs fixing
451 debug_report_bug('No entry in key=' . $key . ', id=' . $id . ' found.');
455 $networkData[$key] = $entry[$id];
458 // Update the network data
459 $updated += doNetworkUpdateDataByArray($id, $networkData);
463 // Do we have updates?
466 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_UPDATED', $updated));
469 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_CHANGED'));
474 // Removes given networks
475 function doAdminNetworkProcessRemovenetworkForm () {
476 // Do we have selections?
477 if (countPostSelection() > 0) {
478 // By default nothing is removed
481 // Something has been selected, so start updating them
482 foreach (postRequestElement('sel') as $id => $sel) {
483 // Update this entry?
486 $removed += doAdminRemoveNetworkEntry('data', 'network_id', $id);
490 // Do we have removes?
493 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REMOVED', $removed));
496 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_REMOVED'));
501 // Add a network type handler if not yet found
502 function doAdminNetworkProcessAddnetworktypeForm () {
503 // Is the network type handle already used with given network?
504 if (isNetworkTypeHandleValid(postRequestElement('network_type_handle'), getRequestElement('network'))) {
506 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_HANDLE_ALREADY_ADDED', postRequestElement('network_type_handle')));
512 // Remove the 'ok' part
513 unsetPostRequestElement('ok');
516 setPostRequestElement('network_id', getRequestElement('network'));
518 // Add the whole request to database
519 SQL_QUERY("INSERT INTO
520 `{?_MYSQL_PREFIX?}_network_types`
522 `" . implode('`,`', array_keys(postRequestArray())) . "`
524 '" . implode("','", array_values(postRequestArray())) . "'
525 )", __FUNCTION__, __LINE__);
528 if (SQL_AFFECTEDROWS() == 1) {
529 // Successfully added
530 loadTemplate('admin_network_type_added', false, postRequestArray());
533 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_NOT_ADDED', postRequestElement('network_type_handle')));
537 // Changes given network type handlers
538 function doAdminNetworkProcessChangenetworktypeForm () {
539 // Do we have selections?
540 if (countPostSelection() > 0) {
541 // By default nothing is updated
544 // Something has been selected, so start updating them
545 foreach (postRequestElement('sel') as $id => $sel) {
546 // Update this entry?
549 $networkTypeData = array();
551 // Transfer whole array, except 'sel'
552 foreach (postRequestArray() as $key => $entry) {
553 // Skip 'sel' and submit button
554 if (in_array($key, array('sel', 'change'))) continue;
556 // Do we have this enty?
557 if (!isset($entry[$id])) {
558 // Not found, needs fixing
559 debug_report_bug('No entry in key=' . $key . ', id=' . $id . ' found.');
563 $networkTypeData[$key] = $entry[$id];
566 // Update the network data
567 $updated += doNetworkUpdateTypeByArray($id, $networkTypeData);
571 // Do we have updates?
574 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_UPDATED', $updated));
577 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_TYPE_NOTHING_CHANGED'));
582 // Removes given network type handlers
583 function doAdminNetworkProcessRemovenetworktypeForm () {
584 // Do we have selections?
585 if (countPostSelection() > 0) {
586 // By default nothing is removed
589 // Something has been selected, so start updating them
590 foreach (postRequestElement('sel') as $id => $sel) {
591 // Update this entry?
594 $removed += doAdminRemoveNetworkEntry('types', 'network_type_id', $id);
598 // Do we have removes?
601 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_REMOVED', $removed));
604 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_TYPE_NOTHING_REMOVED'));