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 // Removes given network entry
198 function doAdminRemoveNetworkEntry ($table, $column, $id, $limit = 1) {
200 SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_network_%s` WHERE `%s`=%s LIMIT %s",
201 array($table, $column, $id, $limit), __FILE__, __LINE__);
203 // Return affected rows
204 return SQL_AFFECTEDROWS();
207 // Generates a list of networks for given script and returns it
208 function generateAdminNetworkList () {
212 // Query for all networks
213 $result = SQL_QUERY("SELECT
214 `network_id`, `network_title`
216 `{?_MYSQL_PREFIX?}_network_data`
218 `network_title` ASC", __FILE__, __LINE__);
220 // Do we have entries?
221 if (SQL_NUMROWS($result) > 0) {
224 while ($row = SQL_FETCHARRAY($result)) {
225 // Is this valid, then add it
226 if ((is_array($row)) && (isset($row['network_id']))) $rows[] = $row;
229 // Generate the selection box
230 $content = generateSelectionBoxFromArray($rows, 'network', 'network_id', 'network_title');
233 $content = loadTemplate('admin_settings_saved', false, getMessage('ADMIN_ENTRIES_404'));
237 SQL_FREERESULT($result);
243 //------------------------------------------------------------------------------
244 // Call-back functions
245 //------------------------------------------------------------------------------
247 // Callback function to add new network
248 function doAdminNetworkProcessAddnetworkForm () {
249 // We can say here, the form is sent, so check if the network is already added
250 if (isNetworkNameValid(postRequestElement('network_short_name'))) {
252 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_ALREADY_ADDED', postRequestElement('network_short_name')));
256 // Remove the 'ok' part
257 unsetPostRequestElement('ok');
259 // Add the whole request to database
260 SQL_QUERY("INSERT INTO
261 `{?_MYSQL_PREFIX?}_network_data`
263 `" . implode('`,`', array_keys(postRequestArray())) . "`
265 '" . implode("','", array_values(postRequestArray())) . "'
266 )", __FUNCTION__, __LINE__);
268 // Add the id for output only
269 setPostRequestElement('network_id', SQL_INSERTID());
272 if (SQL_AFFECTEDROWS() == 1) {
273 // Successfully added
274 loadTemplate('admin_network_added', false, postRequestArray());
277 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_DATA_NOT_ADDED', postRequestElement('network_short_name')));
281 // Displays selected networks for editing
282 function doAdminNetworkProcessHandlenetworkForm () {
283 // Do we have selections?
284 if (countPostSelection() > 0) {
285 // Something has been selected, so start displaying one by one
287 foreach (postRequestElement('sel') as $id => $sel) {
290 // Load this network's data
291 $networkData = getNetworkDataById($id);
293 // Do we have found the network?
294 if (count($networkData) > 0) {
296 $networkData['sw'] = $SW;
298 if (isPostRequestElementSet('edit')) {
299 // Make selection box for network_request_type
300 $networkData['network_request_type'] = generateOptionList(
304 getMessage('ADMIN_NETWORK_REQUEST_TYPE_GET'),
305 getMessage('ADMIN_NETWORK_REQUEST_TYPE_POST')
307 $networkData['network_request_type']
310 // Add row template for editing
311 $OUT .= loadTemplate('admin_edit_networks_row', true, $networkData);
312 } elseif (isPostRequestElementSet('del')) {
313 // Translate the request type
314 $networkData['network_request_type'] = getMessage('ADMIN_NETWORK_REQUEST_TYPE_' . $networkData['network_request_type']);
316 // Add row template for deleting
317 $OUT .= loadTemplate('admin_del_networks_row', true, $networkData);
320 debug_report_bug('Cannot detect edit/del.');
329 // If we have no rows, we don't need to display the edit form
331 // Output main template
332 if (isPostRequestElementSet('edit')) {
333 loadTemplate('admin_edit_networks', false, $OUT);
334 } elseif (isPostRequestElementSet('del')) {
335 loadTemplate('admin_del_networks', false, $OUT);
338 debug_report_bug('Cannot detect edit/del.');
341 // Don't display the list/add new form
342 $GLOBALS['network_display'] = false;
344 // Nothing selected/found
345 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_FOUND'));
350 // Handle network type form
351 function doAdminNetworkProcessHandlenetworktypeForm () {
352 // Do we have selections?
353 if (countPostSelection() > 0) {
355 $networkData = getNetworkDataById(getRequestElement('network'));
357 // Something has been selected, so start displaying one by one
359 foreach (postRequestElement('sel') as $id => $sel) {
362 // Load this network's data
363 $networkTypeData = getNetworkTypeDataById($id);
365 // Do we have found the network?
366 if (count($networkTypeData) > 0) {
368 $networkTypeData['sw'] = $SW;
370 if (isPostRequestElementSet('edit')) {
371 // Add row template for deleting
372 $OUT .= loadTemplate('admin_edit_network_types_row', true, $networkTypeData);
373 } elseif (isPostRequestElementSet('del')) {
374 // Fix empty banner URL
375 if (trim($networkTypeData['network_type_banner_url']) == '') $networkTypeData['network_type_banner_url'] = '---';
377 // Add row template for deleting
378 $OUT .= loadTemplate('admin_del_network_types_row', true, $networkTypeData);
381 debug_report_bug('Cannot detect edit/del.');
390 // If we have no rows, we don't need to display the edit form
392 // Prepare content for template
395 'network_data' => getNetworkDataById(getRequestElement('network'))
398 // Output main template
399 if (isPostRequestElementSet('edit')) {
400 loadTemplate('admin_edit_network_types', false, $content);
401 } elseif (isPostRequestElementSet('del')) {
402 loadTemplate('admin_del_network_types', false, $content);
405 debug_report_bug('Cannot detect edit/del.');
408 // Don't display the list/add new form
409 $GLOBALS['network_display'] = false;
411 // Nothing selected/found
412 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_TYPE_NOTHING_FOUND'));
417 // Changes given networks
418 function doAdminNetworkProcessChangenetworkForm () {
419 // Do we have selections?
420 if (countPostSelection() > 0) {
421 // By default nothing is updated
424 // Something has been selected, so start updating them
425 foreach (postRequestElement('sel') as $id => $sel) {
426 // Update this entry?
429 $networkData = array();
431 // Transfer whole array, except 'sel'
432 foreach (postRequestArray() as $key => $entry) {
433 // Skip 'sel' and submit button
434 if (in_array($key, array('sel', 'change'))) continue;
436 // Do we have this enty?
437 if (!isset($entry[$id])) {
438 // Not found, needs fixing
439 debug_report_bug('No entry in key=' . $key . ', id=' . $id . ' found.');
443 $networkData[$key] = $entry[$id];
446 // Update the network data
447 $updated += doNetworkUpdateDataByArray($id, $networkData);
451 // Do we have updates?
454 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_UPDATED', $updated));
457 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_CHANGED'));
462 // Removes given networks
463 function doAdminNetworkProcessRemovenetworkForm () {
464 // Do we have selections?
465 if (countPostSelection() > 0) {
466 // By default nothing is removed
469 // Something has been selected, so start updating them
470 foreach (postRequestElement('sel') as $id => $sel) {
471 // Update this entry?
474 $removed += doAdminRemoveNetworkEntry('data', 'network_id', $id);
478 // Do we have removes?
481 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REMOVED', $removed));
484 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_REMOVED'));
489 // Add a network type if not yet found
490 function doAdminNetworkProcessAddnetworktypeForm () {
491 // Is the network type handle already used with given network?
492 if (isNetworkTypeHandleValid(postRequestElement('network_type_handle'), getRequestElement('network'))) {
494 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_HANDLE_ALREADY_ADDED', postRequestElement('network_type_handle')));
500 // Remove the 'ok' part
501 unsetPostRequestElement('ok');
504 setPostRequestElement('network_id', getRequestElement('network'));
506 // Add the whole request to database
507 SQL_QUERY("INSERT INTO
508 `{?_MYSQL_PREFIX?}_network_types`
510 `" . implode('`,`', array_keys(postRequestArray())) . "`
512 '" . implode("','", array_values(postRequestArray())) . "'
513 )", __FUNCTION__, __LINE__);
516 if (SQL_AFFECTEDROWS() == 1) {
517 // Successfully added
518 loadTemplate('admin_network_type_added', false, postRequestArray());
521 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_NOT_ADDED', postRequestElement('network_type_handle')));