ea480f402bc8dea476999a3a3457bac10b355423
[mailer.git] / inc / extensions / ext-coupon.php
1 <?php
2 /************************************************************************
3  * Mailer-Project 0.2.1-FINAL                         Start: 01/07/2005 *
4  * ==========================                   Last change: 01/07/2005 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : ext-coupon.php                                   *
8  * -------------------------------------------------------------------- *
9  * Short description : Coupon system                                    *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Coupon-System                                    *
12  * -------------------------------------------------------------------- *
13  *                                                                      *
14  * -------------------------------------------------------------------- *
15  * $Revision::                                                        $ *
16  * $Date::                                                            $ *
17  * $Tag:: 0.2.1-FINAL                                                 $ *
18  * $Author::                                                          $ *
19  * -------------------------------------------------------------------- *
20  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
21  * Copyright (c) 2009 - 2011 by Mailer Developer Team                   *
22  * For more information visit: http://www.mxchange.org                  *
23  *                                                                      *
24  * This program is free software; you can redistribute it and/or modify *
25  * it under the terms of the GNU General Public License as published by *
26  * the Free Software Foundation; either version 2 of the License, or    *
27  * (at your option) any later version.                                  *
28  *                                                                      *
29  * This program is distributed in the hope that it will be useful,      *
30  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
31  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
32  * GNU General Public License for more details.                         *
33  *                                                                      *
34  * You should have received a copy of the GNU General Public License    *
35  * along with this program; if not, write to the Free Software          *
36  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
37  * MA  02110-1301  USA                                                  *
38  ************************************************************************/
39
40 // Some security stuff...
41 if (!defined('__SECURITY')) {
42         die();
43 } // END - if
44
45 // Version number
46 setThisExtensionVersion('0.0');
47
48 // Version history array (add more with , '0.1' and so on)
49 setExtensionVersionHistory(array('0.0'));
50
51 // This extension is in development (non-productive)
52 enableExtensionProductive(false);
53
54 switch (getExtensionMode()) {
55         case 'register': // Do stuff when installtion is running (modules.php?module=admin&action=login is called)
56                 // Coupon data
57                 addDropTableSql('coupon_data');
58                 addCreateTableSql('coupon_data', "(
59 `id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
60 `timestamp_created` TIMESTAMP NULL DEFAULT NULL,
61 `timestamp_expired` TIMESTAMP NULL DEFAULT NULL,
62 `coupon_type` ENUM('CODE','API') NOT NULL DEFAULT 'CODE',
63 `total_created` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
64 `total_used` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
65 `points` FLOAT(20,5) NOT NULL DEFAULT 0.00000,
66 `coupon_description` TEXT,
67 PRIMARY KEY (`id`)
68 ) TYPE = {?_TABLE_TYPE?} CHARACTER SET utf8 COLLATE utf8_general_ci COMMENT = 'Created coupons'");
69
70                 // Coupon->user connection table
71                 addDropTableSql('user_coupons');
72                 addCreateTableSql('user_coupons', "(
73 `id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
74 `coupon_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
75 `userid` BIGINT(2) UNSIGNED NOT NULL DEFAULT 0,
76 `coupon_code` VARCHAR(30) NULL DEFAULT NULL,
77 `cashed_on` TIMESTAMP NULL DEFAULT NULL,
78 PRIMARY KEY (`id`),
79 UNIQUE KEY `coupon_user` (`coupon_id`,`userid`),
80 UNIQUE KEY (`coupon_code`)
81 ) TYPE = {?_TABLE_TYPE?} CHARACTER SET utf8 COLLATE utf8_general_ci COMMENT = 'Coupon->user connection'");
82
83                 // Configuration entries
84                 addConfigAddSql('coupon_default_time', 'BIGINT(20) NOT NULL DEFAULT ' . (getOneDay() * 7));
85                 addConfigAddSql('coupon_default_points', 'FLOAT(20,5) NOT NULL DEFAULT 100.00000');
86
87                 // User data table
88                 addExtensionSql("ALTER TABLE `{?_MYSQL_PREFIX?}_user_data` ADD `receiving_coupons` ENUM('Y','N') NOT NULL DEFAULT 'Y'");
89
90                 // Menu systems:
91                 //  - Admin entries
92                 addAdminMenuSql('coupon', NULL, 'Gutscheine', 'Einrichten und Versenden von Code-Gutscheinen, sowie per API (noch in Planung). Bei Code-Gutscheinen wird ein Code pro Mitglied erzeugt, der dann an das Mitglied ausgesandt wird. L&ouml;st das Mitglied den Gutschein ein, erh&auml;lt es die Gutschrift auf sein Konto gutgeschrieben. Ausgangseinstellung ist die Gutschrift auf das Werbeguthaben, was f&uuml;r Paidmailer von Wichtigkeit ist, dass Guthaben aus Gutscheinen nicht auszahlungsf&auml;hig ist.', 6);
93                 addAdminMenuSql('coupon', 'list_coupon', 'Auflisten', 'Listet alle Gutscheine und Einl&ouml;sungen durch die Mitglieder auf.', 1);
94                 addAdminMenuSql('coupon', 'send_coupon', 'Versenden/Neuen erstellen', 'Versendet neue Gutscheine an die Mitglieder. Wenn Sie auf &quot;Absenden&quot; klicken, warten Sie bitte die Folgeseite ab, da der Versand der Gutscheine derzeit nicht gepoolt ist.', 2);
95                 addAdminMenuSql('coupon', 'config_coupon', 'Einstellungen', 'Allgemeine Einstellungen zu Code-Gutscheinen und Gutscheinen von Sponsoren (z.B. per API) k&ouml;nnen hier vorgenommen werden.', 3);
96                 //  - Member entries
97                 addMemberMenuSql('coupon', NULL, 'Gutscheine', 'N', 'Y', 3);
98                 addMemberMenuSql('coupon', 'cash_coupon', 'Gutschein einl&ouml;sen', 'N', 'Y', 1);
99                 addMemberMenuSql('coupon', 'list_coupon', 'Eingel&ouml;ste auflisten', 'N', 'Y', 2);
100                 break;
101
102         case 'remove': // Do stuff when removing extension
103                 // SQL commands to run
104                 addDropTableSql('coupon_data');
105                 addDropTableSql('user_coupons');
106                 addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admin_menu` WHERE `action`='coupon' LIMIT 4");
107                 addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_member_menu` WHERE `action`='coupon' LIMIT 3");
108                 break;
109
110         case 'activate': // Do stuff when admin activates this extension
111                 // SQL commands to run
112                 addExtensionSql('');
113                 break;
114
115         case 'deactivate': // Do stuff when admin deactivates this extension
116                 // SQL commands to run
117                 addExtensionSql('');
118                 break;
119
120         case 'update': // Update an extension
121                 switch (getCurrentExtensionVersion()) {
122                         case '0.0.1': // SQL queries for v0.0.1
123                                 addExtensionSql('');
124
125                                 // Update notes (these will be set as task text!)
126                                 setExtensionUpdateNotes('');
127                                 break;
128                 } // END - switch
129                 break;
130
131         case 'modify': // When the extension got modified
132                 break;
133
134         case 'test': // For testing purposes
135                 break;
136
137         case 'init': // Do stuff when extension is initialized
138                 break;
139
140         default: // Unknown extension mode
141                 logDebugMessage(__FILE__, __LINE__, sprintf("Unknown extension mode %s in extension %s detected.", getExtensionMode(), getCurrentExtensionName()));
142                 break;
143 } // END - switch
144
145 // [EOF]
146 ?>