Renamed function so it might be more understandable
[mailer.git] / inc / libs / mediadata_functions.php
1 <?php
2 /************************************************************************
3  * Mailer v0.2.1-FINAL                                Start: 10/08/2005 *
4  * ===================                          Last change: 10/08/2005 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : mediadata_functions.php                          *
8  * -------------------------------------------------------------------- *
9  * Short description : Functions for the mediadata extension            *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Funktionen fuer die verbesserten Mediendaten     *
12  * -------------------------------------------------------------------- *
13  * $Revision::                                                        $ *
14  * $Date::                                                            $ *
15  * $Tag:: 0.2.1-FINAL                                                 $ *
16  * $Author::                                                          $ *
17  * -------------------------------------------------------------------- *
18  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
19  * Copyright (c) 2009, 2010 by Mailer Developer Team                    *
20  * For more information visit: http://www.mxchange.org                  *
21  *                                                                      *
22  * This program is free software; you can redistribute it and/or modify *
23  * it under the terms of the GNU General Public License as published by *
24  * the Free Software Foundation; either version 2 of the License, or    *
25  * (at your option) any later version.                                  *
26  *                                                                      *
27  * This program is distributed in the hope that it will be useful,      *
28  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
29  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
30  * GNU General Public License for more details.                         *
31  *                                                                      *
32  * You should have received a copy of the GNU General Public License    *
33  * along with this program; if not, write to the Free Software          *
34  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
35  * MA  02110-1301  USA                                                  *
36  ************************************************************************/
37
38 // Some security stuff...
39 if (!defined('__SECURITY')) {
40         die();
41 }
42
43 // Update an entry
44 function updateMediadataEntry ($keys_array, $mode, $value) {
45         // Default is nothing added/updated
46         $added = null;
47
48         // Do we have entries?
49         if (is_array($keys_array) && ($value > 0)) {
50                 // Is an array so we can run it through
51                 foreach ($keys_array as $key) {
52                         // First check if it does exist
53                         $result_media = SQL_QUERY_ESC("SELECT
54         `media_key`
55 FROM
56         `{?_MYSQL_PREFIX?}_mediadata`
57 WHERE
58         `media_key` = '%s'
59 LIMIT 1", array($key), __FUNCTION__, __LINE__);
60                         if (SQL_NUMROWS($result_media) == 0) {
61                                 // Not found so we create it (mode will be ignored here!)
62                                 SQL_QUERY_ESC("INSERT INTO `{?_MYSQL_PREFIX?}_mediadata` (`media_key`, `media_value`) VALUES ('%s', '%s')",
63                                         array($key, $value), __FUNCTION__, __LINE__);
64                         } else {
65                                 // Update entry
66                                 switch ($mode) {
67                                         case 'add': $mode = '+'; break;
68                                         case 'sub': $mode = '-'; break;
69                                 } // END - switch
70
71                                 if ($mode == 'init') {
72                                         // Initialize entry
73                                         SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_mediadata` SET `media_value`=%s WHERE `media_key`='%s' LIMIT 1",
74                                                 array($value, $key), __FUNCTION__, __LINE__);
75                                 } else {
76                                         // Update entry
77                                         SQL_QUERY_ESC("UPDATE `{?_MYSQL_PREFIX?}_mediadata` SET `media_value`=`media_value`".$mode."%s WHERE `media_key`='%s' LIMIT 1",
78                                                 array($value, $key), __FUNCTION__, __LINE__);
79                                 }
80                         }
81
82                         // Check affected rows
83                         if (is_null($added)) {
84                                 //* DEBUG: */ debugOutput(__FUNCTION__ . '(<font color="#0000aa">' . __LINE__ . '</font>):added='.intval($added));
85                                 $added = (!SQL_HASZEROAFFECTED());
86                                 //* DEBUG: */ debugOutput(__FUNCTION__ . '(<font color="#0000aa">' . __LINE__ . '</font>):added='.intval($added));
87                         } else {
88                                 //* DEBUG: */ debugOutput(__FUNCTION__ . '(<font color="#0000aa">' . __LINE__ . '</font>):added='.intval($added));
89                                 $added = ($added && (!SQL_HASZEROAFFECTED()));
90                                 //* DEBUG: */ debugOutput(__FUNCTION__ . '(<font color="#0000aa">' . __LINE__ . '</font>):added='.intval($added));
91                         }
92                 } // END - foreach
93         } // END - if
94
95         // Zero entries are always added
96         if ($value == 0) {
97                 // Is zero value, so we need to set $added here to avoid wrong false result
98                 $added = true;
99         } // END - if
100
101         // Return result
102         return $added;
103 }
104
105 // Getter for entry
106 function getMediadataEntry ($key) {
107         // Return nothing by default
108         $value = '';
109
110         // Check for entry
111         $result = SQL_QUERY_ESC("SELECT media_value FROM `{?_MYSQL_PREFIX?}_mediadata` WHERE media_key='%s' LIMIT 1",
112                 array($key), __FUNCTION__, __LINE__);
113         if (SQL_NUMROWS($result) == 1) {
114                 // Load data
115                 list($value) = SQL_FETCHROW($result);
116         } // END - if
117
118         // Return data
119         return $value;
120 }
121
122 // Filter for updating media data
123 function FILTER_UPDATE_MEDIADATA_ENTRY ($data) {
124         // Execute the filter function
125         $data['added'] = ($data['added'] && updateMediadataEntry(array('total_points'), $data['mode'], $data['points']));
126
127         // Return data
128         return $data;
129 }
130
131 //
132 ?>