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 // Updates given network (id) with data from array
152 function doNetworkUpdateDataByArray ($id, $networkData) {
153 // Ids lower one are not accepted
155 // Not good, should be fixed
156 debug_report_bug('Network id ' . $id . ' is smaller than 1.');
159 // Just call our inner method
160 return adminSaveSettings($networkData, '_network_data', sprintf("`network_id`=%s", bigintval($id)), array(), false, false);
163 // Removes given network entry
164 function doAdminRemoveNetworkEntry ($table, $column, $id, $limit = 1) {
166 SQL_QUERY_ESC("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_network_%s` WHERE `%s`=%s LIMIT %s",
167 array($table, $column, $id, $limit), __FILE__, __LINE__);
169 // Return affected rows
170 return SQL_AFFECTEDROWS();
173 // Generates a list of networks for given script and returns it
174 function generateAdminNetworkList () {
178 // Query for all networks
179 $result = SQL_QUERY("SELECT
180 `network_id`, `network_title`
182 `{?_MYSQL_PREFIX?}_network_data`
184 `network_title` ASC", __FILE__, __LINE__);
186 // Do we have entries?
187 if (SQL_NUMROWS($result) > 0) {
190 while ($row = SQL_FETCHARRAY($result)) {
191 // Is this valid, then add it
192 if ((is_array($row)) && (isset($row['network_id']))) $rows[] = $row;
195 // Generate the selection box
196 $content = generateSelectionBoxFromArray($rows, 'network', 'network_id', 'network_title');
199 $content = loadTemplate('admin_settings_saved', false, getMessage('ADMIN_ENTRIES_404'));
203 SQL_FREERESULT($result);
209 //------------------------------------------------------------------------------
210 // Call-back functions
211 //------------------------------------------------------------------------------
213 // Callback function to add new network
214 function doAdminNetworkProcessAddnetworkForm () {
215 // We can say here, the form is sent, so check if the network is already added
216 if (isNetworkNameValid(postRequestElement('network_short_name'))) {
218 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_ALREADY_ADDED', postRequestElement('network_short_name')));
222 // Remove the 'ok' part
223 unsetPostRequestElement('ok');
225 // Add the whole request to database
226 SQL_QUERY("INSERT INTO
227 `{?_MYSQL_PREFIX?}_network_data`
229 `" . implode('`,`', array_keys(postRequestArray())) . "`
231 '" . implode("','", array_values(postRequestArray())) . "'
232 )", __FUNCTION__, __LINE__);
234 // Add the id for output only
235 setPostRequestElement('network_id', SQL_INSERTID());
238 if (SQL_AFFECTEDROWS() == 1) {
239 // Successfully added
240 loadTemplate('admin_network_added', false, postRequestArray());
243 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_DATA_NOT_ADDED', postRequestElement('network_short_name')));
247 // Displays selected networks for editing
248 function doAdminNetworkProcessHandlenetworkForm () {
249 // Do we have selections?
250 if (countPostSelection() > 0) {
251 // Something has been selected, so start displaying one by one
253 foreach (postRequestElement('sel') as $id => $sel) {
256 // Load this network's data
257 $networkData = getNetworkDataById($id);
259 // Do we have found the network?
260 if (count($networkData) > 0) {
262 $networkData['sw'] = $SW;
264 if (isPostRequestElementSet('edit')) {
265 // Make selection box for network_request_type
266 $networkData['network_request_type'] = generateOptionList(
270 getMessage('ADMIN_NETWORK_REQUEST_TYPE_GET'),
271 getMessage('ADMIN_NETWORK_REQUEST_TYPE_POST')
273 $networkData['network_request_type']
276 // Add row template for editing
277 $OUT .= loadTemplate('admin_edit_networks_row', true, $networkData);
278 } elseif (isPostRequestElementSet('del')) {
279 // Translate the request type
280 $networkData['network_request_type'] = getMessage('ADMIN_NETWORK_REQUEST_TYPE_' . $networkData['network_request_type']);
282 // Add row template for deleting
283 $OUT .= loadTemplate('admin_del_networks_row', true, $networkData);
286 debug_report_bug('Cannot detect edit/del.');
295 // If we have no rows, we don't need to display the edit form
297 // Output main template
298 if (isPostRequestElementSet('edit')) {
299 loadTemplate('admin_edit_networks', false, $OUT);
300 } elseif (isPostRequestElementSet('del')) {
301 loadTemplate('admin_del_networks', false, $OUT);
304 debug_report_bug('Cannot detect edit/del.');
307 // Don't display the list/add new form
308 $GLOBALS['network_display'] = false;
310 // Nothing selected/found
311 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_FOUND'));
316 // Changes given networks
317 function doAdminNetworkProcessChangenetworkForm () {
318 // Do we have selections?
319 if (countPostSelection() > 0) {
320 // By default nothing is updated
323 // Something has been selected, so start updating them
324 foreach (postRequestElement('sel') as $id => $sel) {
325 // Update this entry?
328 $networkData = array();
330 // Transfer whole array, except 'sel'
331 foreach (postRequestArray() as $key => $entry) {
332 // Skip 'sel' and submit button
333 if (in_array($key, array('sel', 'change'))) continue;
335 // Do we have this enty?
336 if (!isset($entry[$id])) {
337 // Not found, needs fixing
338 debug_report_bug('No entry in key=' . $key . ', id=' . $id . ' found.');
342 $networkData[$key] = $entry[$id];
345 // Update the network data
346 $updated += doNetworkUpdateDataByArray($id, $networkData);
350 // Do we have updates?
353 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_UPDATED', $updated));
356 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_CHANGED'));
361 // Removes given networks
362 function doAdminNetworkProcessRemovenetworkForm () {
363 // Do we have selections?
364 if (countPostSelection() > 0) {
365 // By default nothing is removed
368 // Something has been selected, so start updating them
369 foreach (postRequestElement('sel') as $id => $sel) {
370 // Update this entry?
373 $removed += doAdminRemoveNetworkEntry('data', 'network_id', $id);
377 // Do we have removes?
380 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_REMOVED', $removed));
383 loadTemplate('admin_settings_saved', false, getMessage('ADMIN_NETWORK_NOTHING_REMOVED'));
388 // Add a network type if not yet found
389 function doAdminNetworkProcessAddnetworktypeForm () {
390 // Is the network type handle already used with given network?
391 if (isNetworkTypeHandleValid(postRequestElement('network_type_handle'), getRequestElement('network'))) {
393 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_HANDLE_ALREADY_ADDED', postRequestElement('network_type_handle')));
399 // Remove the 'ok' part
400 unsetPostRequestElement('ok');
403 setPostRequestElement('network_id', getRequestElement('network'));
405 // Add the whole request to database
406 SQL_QUERY("INSERT INTO
407 `{?_MYSQL_PREFIX?}_network_types`
409 `" . implode('`,`', array_keys(postRequestArray())) . "`
411 '" . implode("','", array_values(postRequestArray())) . "'
412 )", __FUNCTION__, __LINE__);
415 if (SQL_AFFECTEDROWS() == 1) {
416 // Successfully added
417 loadTemplate('admin_network_type_added', false, postRequestArray());
420 loadTemplate('admin_settings_saved', false, getMaskedMessage('ADMIN_NETWORK_TYPE_NOT_ADDED', postRequestElement('network_type_handle')));