]> git.mxchange.org Git - mailer.git/blob - inc/libs/forced_functions.php
Some fixes:
[mailer.git] / inc / libs / forced_functions.php
1 <?php
2 /************************************************************************
3  * Mailer v0.2.1-FINAL                                Start: 07/25/2011 *
4  * ===================                          Last change: 07/25/2011 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : forced_functions.php                             *
8  * -------------------------------------------------------------------- *
9  * Short description : Functions for ext-forced                         *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Funktionen fuer ext-forced                       *
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 - 2013 by Mailer Developer Team                   *
20  * For more information visit: http://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 } // END - if
42
43 // Translate forced ad type
44 function translateForcedAdsType ($status) {
45         // Is the status null or empty?
46         if (is_null($status)) {
47                 // Is NULL
48                 $status = 'NULL';
49         } elseif (empty($status)) {
50                 // Is empty (string)
51                 $status = 'EMPTY';
52         } // END - if
53
54         // Default status is unknown
55         $return = '{%message,ADMIN_FORCED_ADS_TYPE_UNKNOWN=' . $status . '%}';
56
57         // Construct message id
58         $messageId = 'ADMIN_FORCED_ADS_TYPE_' . $status;
59
60         // Is it there?
61         if (isMessageIdValid($messageId)) {
62                 // Then use it as message string
63                 $return = '{--' . $messageId . '--}';
64         } // END - if
65
66         // Return the status
67         return $return;
68 }
69
70 // Translate forced campaign status
71 function translateForcedCampaignStatus ($status) {
72         // Is the status null or empty?
73         if (is_null($status)) {
74                 // Is NULL
75                 $status = 'NULL';
76         } elseif (empty($status)) {
77                 // Is empty (string)
78                 $status = 'EMPTY';
79         } // END - if
80
81         // Default status is unknown
82         $return = '{%message,ADMIN_FORCED_CAMPAIGN_TYPE_UNKNOWN=' . $status . '%}';
83
84         // Construct message id
85         $messageId = 'ADMIN_FORCED_CAMPAIGN_TYPE_' . $status;
86
87         // Is it there?
88         if (isMessageIdValid($messageId)) {
89                 // Then use it as message string
90                 $return = '{--' . $messageId . '--}';
91         } // END - if
92
93         // Return the status
94         return $return;
95 }
96
97 // Translate visibility
98 function translateForcedCostsVisibility ($visibility) {
99         // Is the status null or empty?
100         if (is_null($visibility)) {
101                 // Is NULL
102                 $visibility = 'NULL';
103         } elseif (empty($visibility)) {
104                 // Is empty (string)
105                 $visibility = 'EMPTY';
106         } // END - if
107
108         // Default status is unknown
109         $return = '{%message,ADMIN_FORCED_ADS_VISIBILITY_UNKNOWN=' . $visibility . '%}';
110
111         // Construct message id
112         $messageId = 'ADMIN_FORCED_ADS_VISIBILITY_' . $visibility;
113
114         // Is it there?
115         if (isMessageIdValid($messageId)) {
116                 // Then use it as message string
117                 $return = '{--' . $messageId . '--}';
118         } // END - if
119
120         // Return the status
121         return $return;
122 }
123
124 // "Getter" for an array of data from all forced-popups except user's own
125 function getForcedPopupDataByEarningArray ($content) {
126         die(__FUNCTION__.':content=<pre>' . print_r($content, TRUE) . '</pre>' . debug_get_printable_backtrace());
127
128         // Finally return the content
129         return $content;
130 }
131
132 // Generator (somewhat getter) for forced-ads type options
133 function generateForcedAdsTypeOptions ($type = NULL) {
134         // Is this cached?
135         if (!isset($GLOBALS[__FUNCTION__][$type])) {
136                 // Generate output and cache it
137                 $GLOBALS[__FUNCTION__][$type] = generateOptions(
138                         '/ARRAY/',
139                         array(
140                                 'BANNER',
141                                 'TEXTLINK',
142                                 'POPUP',
143                         ),
144                         array(),
145                         $type,
146                         '', '',
147                         array(),
148                         'translateForcedAdsType'
149                 );
150         } // END - if
151
152         // Return content
153         return $GLOBALS[__FUNCTION__][$type];
154 }
155
156 // Generator (somewhat getter) for forcec-costs visibility options
157 function generateForcedCostsVisibilityOptions ($visibility = NULL) {
158         // Is this cached?
159         if (!isset($GLOBALS[__FUNCTION__][$visibility])) {
160                 // Generate output and cache it
161                 $GLOBALS[__FUNCTION__][$visibility] = generateOptions(
162                         '/ARRAY/',
163                         array(
164                                 'ALL',
165                                 'MEMBER',
166                                 'SPONSOR',
167                                 'NONE'
168                         ),
169                         array(),
170                         $visibility,
171                         '', '',
172                         array(),
173                         'translateForcedCostsVisibility'
174                 );
175         } // END - if
176
177         // Return content
178         return $GLOBALS[__FUNCTION__][$visibility];
179 }
180
181 // "Getter" for an array of all given forced ads
182 function getArrayFromForcedAdsByType ($forcedType = NULL) {
183         // Init array
184         $forcedAds = array();
185
186         // Init WHERE (default)
187         $where = '';
188
189         // Is forced type not NULL?
190         if (!is_null($forcedType)) {
191                 // Then set proper WHERE
192                 $where = sprintf("WHERE `forced_ads_type`='%s'", sqlEscapeString($forcedType));
193         } // END - if
194
195         // Search all given types
196         $result = sqlQuery('SELECT
197         `forced_ads_id`,
198         `forced_ads_ad_url`,
199         `forced_ads_click_url`,
200         `forced_ads_width`,
201         `forced_ads_height`,
202         `forced_ads_alt_text`,
203         `forced_ads_framebreaker`,
204         `forced_ads_type`,
205         `forced_ads_views_counter`,
206         `forced_ads_clicks_counter`,
207         UNIX_TIMESTAMP(`forced_ads_added`) AS `forced_ads_added`,
208         `forced_ads_userid`
209 FROM
210         `{?_MYSQL_PREFIX?}_forced_ads`
211 ' . $where . '
212 ORDER BY
213         `forced_ads_id` ASC', __FUNCTION__, __LINE__);
214
215         // Is there at least one entry?
216         if (!ifSqlHasZeroNums($result)) {
217                 // Get all elements
218                 while ($content = sqlFetchArray($result)) {
219                         // Add it
220                         $forcedAds[$content['forced_ads_id']] = $content;
221                 } // END - while
222         } // END - if
223
224         // Free result
225         sqlFreeResult($result);
226
227         // Return it
228         return $forcedAds;
229 }
230
231 // "Getter" for an array of all forced costs from given visibility or all
232 function getArrayFromForcedCostsByVisibility ($visibility = NULL) {
233         // Init array
234         $forcedCosts = array();
235         $where = '';
236
237         // Is visibility not NULL?
238         if (!is_null($visibility)) {
239                 // Then add WHERE statement
240                 $where = sprintf(" WHERE `forced_costs_visibility`='%s'", sqlEscapeString($visibility));
241         } // END - if
242
243         // Search all given types
244         $result = sqlQuery("SELECT
245         `forced_costs_id`,
246         `forced_costs_price_click`,
247         `forced_costs_payment_click`,
248         `forced_costs_visibility`
249 FROM
250         `{?_MYSQL_PREFIX?}_forced_costs`
251 ".$where."
252 ORDER BY
253         `forced_costs_id` ASC", __FUNCTION__, __LINE__);
254
255         // Is there at least one entry?
256         if (!ifSqlHasZeroNums($result)) {
257                 // Get all elements
258                 while ($content = sqlFetchArray($result)) {
259                         // Add it
260                         $forcedCosts[$content['forced_costs_id']] = $content;
261                 } // END - while
262         } // END - if
263
264         // Free result
265         sqlFreeResult($result);
266
267         // Return it
268         return $forcedCosts;
269 }
270
271 // "Getter" for an array of all forced campaigns from given array and status
272 function getArrayFromForcedCampaignsByArray ($ids, $status) {
273         // Init array
274         $forcedCampaigns = array();
275
276         // Search all given types
277         $result = sqlQueryEscaped("SELECT
278         `forced_campaign_id`,
279         UNIX_TIMESTAMP(`forced_campaign_created`) AS `forced_campaign_created`,
280         `forced_campaign_status`,
281         UNIX_TIMESTAMP(`forced_campaign_last_locked`) AS `forced_campaign_last_locked`,
282         `forced_campaign_lock_reason`,
283         `forced_campaign_expired`,
284         `forced_campaign_ordered_clicks`,
285         `forced_campaign_payment_api`,
286         `forced_campaign_reload_lock`,
287         `forced_campaign_minimum_stay`,
288         `forced_ads_id`,
289         `forced_campaign_userid`,
290         `forced_costs_id`
291 FROM
292         `{?_MYSQL_PREFIX?}_forced_campaigns`
293 WHERE
294         `forced_campaign_id` IN (%s) AND
295         `forced_campaign_status`='%s'
296 ORDER BY
297         `forced_campaign_id` ASC",
298                 array(
299                         implode(', ', $ids),
300                         $status
301                 ), __FUNCTION__, __LINE__);
302
303         // Is there at least one entry?
304         if (!ifSqlHasZeroNums($result)) {
305                 // Get all elements
306                 while ($content = sqlFetchArray($result)) {
307                         // Add it
308                         $forcedCampaigns[$content['forced_campaign_id']] = $content;
309                 } // END - while
310         } // END - if
311
312         // Free result
313         sqlFreeResult($result);
314
315         // Return it
316         return $forcedCampaigns;
317 }
318
319 // "Activates" forced campaigns from POST data
320 function doForcedAdminActivateCampaigns () {
321         // Do some sanity checks
322         if (!isAdmin()) {
323                 // Not allowed to call
324                 return FALSE;
325         } elseif (countPostSelection('forced_campaign_id') == 0) {
326                 // No selections made
327                 return FALSE;
328         }
329
330         // Get an array from all pending campaigns
331         $forcedCampaigns = getArrayFromForcedCampaignsByArray(array_keys(postRequestElement('forced_campaign_id')), 'PENDING');
332
333         // By default all worked (at this point)
334         $activated = TRUE;
335
336         // Run through all entries
337         foreach ($forcedCampaigns as $campaignId => $campaignData) {
338                 // Change the status of this campaign
339                 if (!changeForcedCampaignStatus($campaignId, 'PENDING', 'ACTIVE', $campaignData)) {
340                         // One didn't work, but continue with others
341                         $activated = FALSE;
342                 } // END - if
343         } // END - foreach
344
345         // Return status
346         return $activated;
347 }
348
349 // Changes the status of a forced campaign from previous to new status
350 function changeForcedCampaignStatus ($campaignId, $prevStatus, $newStatus, $data) {
351         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'campaignId=' . $campaignId . ',prevStatus=' . $prevStatus . ',data[]=' . gettype($data) . ',newStatus=' . $newStatus . ' - ENTERED!');
352         // Make new status always lower-case
353         $newStatus = strtolower($newStatus);
354
355         // Prepare array
356         $filterData = array(
357                 'campaign_id' => $campaignId,
358                 'prev_status' => $prevStatus,
359                 'new_status'  => $newStatus,
360                 'data'        => $data,
361         );
362
363         // Run pre filter chain
364         $filterData = runFilterChain('pre_change_forced_campaign_status', $filterData);
365
366         // Abort here?
367         if (!is_null($filterData['abort'])) {
368                 // Abort here
369                 return $filterData['abort'];
370         } // END - if
371
372         // Update the status now
373         // ---------- Comment out for debugging/developing member actions! ---------
374         sqlQueryEscaped("UPDATE `{?_MYSQL_PREFIX?}_forced_campaigns` SET `forced_campaign_status`='%s' WHERE `forced_campaign_id`=%s LIMIT 1",
375                 array(
376                         $newStatus,
377                         bigintval($campaignId)
378                 ), __FUNCTION__, __LINE__);
379         // ---------- Comment out for debugging/developing member actions! ---------
380
381         // Was that fine?
382         // ---------- Comment out for debugging/developing member actions! ---------
383         if (sqlAffectedRows() != 1) {
384                 // No, something went wrong
385                 return FALSE;
386         } // END - if
387         // ---------- Comment out for debugging/developing member actions! ---------
388
389         // Run post filter chain
390         $filterData = runFilterChain('post_change_forced_campaign_status', $filterData);
391
392         // Check if generic 'data' is there
393         assert(isset($filterData['data']));
394
395         // All done!
396         //* DEBUG: */ logDebugMessage(__FUNCTION__, __LINE__, 'campaignId=' . $campaignId . ',prevStatus=' . $prevStatus . ',newStatus=' . $newStatus . ' - EXIT!');
397         return TRUE;
398 }
399
400 // Notify admin(s) with a selected message and content
401 function doForcedNotifyAdmin ($messageType, $content) {
402         // Prepare template name
403         $templateName = sprintf('admin_forced_%s', $messageType);
404
405         // Is the user id valid?
406         if (!isValidId($content['forced_campaign_userid'])) {
407                 // No, then use admin-only template
408                 $templateName = sprintf('admin_only_forced_%s', $messageType);
409         } // END - if
410
411         // Prepare subject
412         $subject = sprintf('{--ADMIN_FORCED_NOTIFY_%s_SUBJECT--}', strtoupper($messageType));
413
414         // Is the subject line there?
415         if ((substr($subject, 0, 1) == '!') && (substr($subject, -1, 1) == '!')) {
416                 // Set default subject if following eval() wents wrong
417                 $subject = '{%message,ADMIN_FORCED_NOTIFY_DEFAULT_SUBJECT=' . strtoupper($messageType) . '%}';
418         } // END - if
419
420         // Translate some data if present
421         $content = prepareForcedContentForTemplate($content);
422
423         // Send the notification out
424         return sendAdminNotification($subject, $templateName, $content, $content['forced_campaign_userid']);
425 }
426
427 // Notify the user about the performed action
428 function doForcedNotifyMember ($messageType, $content) {
429         // Skip notification if userid is NULL
430         if (!isValidId($content['forced_campaign_userid'])) {
431                 // NULL is silently ignored
432                 return TRUE;
433         } // END - if
434
435         // Prepare template name
436         $templateName = sprintf('member_forced_%s', $messageType);
437
438         // Prepare subject
439         $subject = sprintf('{--MEMBER_FORCED_NOTIFY_%s_SUBJECT--}', strtoupper($messageType));
440
441         // Is the subject line there?
442         if ((substr($subject, 0, 1) == '!') && (substr($subject, -1, 1) == '!')) {
443                 // Set default subject if following eval() wents wrong
444                 $subject = '{--MEMBER_FORCED_NOTIFY_DEFAULT_SUBJECT--}';
445         } // END - if
446
447         // Translate some data if present
448         $content = prepareForcedContentForTemplate($content);
449
450         // Load template
451         $mailText = loadEmailTemplate($templateName, $content, $content['forced_campaign_userid']);
452
453         // Send the email
454         return sendEmail($content['forced_campaign_userid'], $subject, $mailText);
455 }
456
457 // Translates some data for template usage
458 // @TODO Can't we use our new expression language instead of this ugly code?
459 function prepareForcedContentForTemplate ($content) {
460         // Prepare some code
461         if (isset($content['forced_campaign_created'])) $content['forced_campaign_created'] = generateDateTime($content['forced_campaign_created'], 2);
462
463         // Return translated content
464         return $content;
465 }
466
467 // ----------------------------------------------------------------------------
468 //                            Template helper functions
469 // ----------------------------------------------------------------------------
470
471 // Template helper function to create selection box for all forced-ad types
472 function doTemplateForcedAdTypeSelectionBox ($templateName, $clear = FALSE, $default = NULL) {
473         // Add all types through the filter
474         $forcedAdTypes = runFilterChain('add_forced_ads_types', array());
475
476         // Handle it over to generateSelectionBoxFromArray()
477         $content = generateSelectionBoxFromArray($forcedAdTypes, 'forced_ads_type', 'type', '', '', '', $default);
478
479         // Return prepared content
480         return $content;
481 }
482
483 // Template helper function to create selection box for costs visibility
484 function doTemplateForcedCostsVisiblitySelectionBox ($templateName, $clear = FALSE, $default = NULL) {
485         // Init array
486         $costsVisibility = array(
487                 0 => array('visibility' => 'ALL'),
488                 1 => array('visibility' => 'MEMBER'),
489                 2 => array('visibility' => 'SPONSOR'),
490                 3 => array('visibility' => 'NONE')
491         );
492
493         // Handle it over to generateSelectionBoxFromArray()
494         $content = generateSelectionBoxFromArray($costsVisibility, 'forced_costs_visibility', 'visibility', '', '', '', $default);
495
496         // Return prepared content
497         return $content;
498 }
499
500 // Template helper function to create selection box for foreced ads
501 function doTemplateForcedAdSelectionBox ($templateName, $clear, $default = NULL) {
502         // Get back an array of all forced popups
503         $forcedAds = getArrayFromForcedAdsByType();
504
505         // Handle it over to generateSelectionBoxFromArray()
506         $content = generateSelectionBoxFromArray($forcedAds, 'forced_ads_id', 'forced_ads_id', '', '', '', $default, 'forced_ads_type');
507
508         // Return prepared content
509         return $content;
510 }
511
512 // Template helper function to create selection box for foreced costs
513 function doTemplateForcedCostsSelectionBox ($templateName, $clear, $default = NULL) {
514         // Get back an array of all forced popups
515         $forcedCosts = getArrayFromForcedCostsByVisibility();
516
517         // Handle it over to generateSelectionBoxFromArray()
518         $content = generateSelectionBoxFromArray($forcedCosts, 'forced_costs_id', 'forced_costs_id', '', '', '', $default, '', TRUE);
519
520         // Return prepared content
521         return $content;
522 }
523
524 // Template helper function to create selection box for foreced campaign userid
525 function doTemplateForcedCampaignUseridSelectionBox ($templateName, $clear, $default = NULL) {
526         // Generate the selection box without all
527         $content = addMemberSelectionBox($default, FALSE, TRUE, TRUE, 'forced_campaign_userid');
528
529         // Return prepared content
530         return $content;
531 }
532
533 // ----------------------------------------------------------------------------
534 //                             XML call-back functions
535 // ----------------------------------------------------------------------------
536
537 // For 'doing' add forced-ads, the column-index is required
538 function addXmlSpecialAdminAddDoForcedAds () {
539         // So set it all here
540         $GLOBALS['__COLUMN_INDEX']['doXmlCallbackFunction']  = 'column';
541         $GLOBALS['__XML_ARGUMENTS']['doXmlCallbackFunction']['column_index'] = 'column';
542 }
543
544 // For 'doing' add forced-campaigns, the column-index is required
545 function addXmlSpecialAdminAddDoForcedCampaigns () {
546         // So set it all here
547         $GLOBALS['__COLUMN_INDEX']['doXmlCallbackFunction']  = 'column';
548         $GLOBALS['__XML_ARGUMENTS']['doXmlCallbackFunction']['column_index'] = 'column';
549 }
550
551 // For 'doing' add forced-costs, the column-index is required
552 function addXmlSpecialAdminAddDoForcedCosts () {
553         // So set it all here
554         $GLOBALS['__COLUMN_INDEX']['doXmlCallbackFunction']  = 'column';
555         $GLOBALS['__XML_ARGUMENTS']['doXmlCallbackFunction']['column_index'] = 'column';
556 }
557
558 // [EOF]
559 ?>