Updated copyright year.
[mailer.git] / inc / extensions / forced / mode-setup.php
1 <?php
2 /************************************************************************
3  * Mailer v0.2.1-FINAL                                Start: 06/25/2013 *
4  * ===================                          Last change: 06/25/2013 *
5  *                                                                      *
6  * -------------------------------------------------------------------- *
7  * File              : mode-update.php                                  *
8  * -------------------------------------------------------------------- *
9  * Short description : Clickable forced banner or text links            *
10  * -------------------------------------------------------------------- *
11  * Kurzbeschreibung  : Klickbare Forced-Banner oder -Textlinks          *
12  * -------------------------------------------------------------------- *
13  * Copyright (c) 2003 - 2009 by Roland Haeder                           *
14  * Copyright (c) 2009 - 2016 by Mailer Developer Team                   *
15  * For more information visit: http://mxchange.org                      *
16  *                                                                      *
17  * This program is free software; you can redistribute it and/or modify *
18  * it under the terms of the GNU General Public License as published by *
19  * the Free Software Foundation; either version 2 of the License, or    *
20  * (at your option) any later version.                                  *
21  *                                                                      *
22  * This program is distributed in the hope that it will be useful,      *
23  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
24  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
25  * GNU General Public License for more details.                         *
26  *                                                                      *
27  * You should have received a copy of the GNU General Public License    *
28  * along with this program; if not, write to the Free Software          *
29  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
30  * MA  02110-1301  USA                                                  *
31  ************************************************************************/
32
33 // Some security stuff...
34 if (!defined('__SECURITY')) {
35         die();
36 } // END - if
37
38 // @TODO Remove double tabs from all lines
39                 // Add dependency for ext-earning
40                 addExtensionDependency('earning');
41
42                 // All required tables for this extension:
43                 // - Ads
44                 addDropTableSql('forced_ads');
45                 addCreateTableSql('forced_ads', "
46 `forced_ads_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
47 `forced_ads_provider` ENUM('ADMIN', 'MEMBER', 'API', 'UNKNOWN') NOT NULL DEFAULT 'UNKNOWN',
48 `forced_ads_api_type` VARCHAR(255) NULL DEFAULT NULL,
49 `forced_ads_ad_url` VARCHAR(255) NULL DEFAULT NULL,
50 `forced_ads_click_url` VARCHAR(255) NOT NULL,
51 `forced_ads_width` SMALLINT(3) UNSIGNED NULL DEFAULT NULL,
52 `forced_ads_height` SMALLINT(3) UNSIGNED NULL DEFAULT NULL,
53 `forced_ads_alt_text` VARCHAR(255) NULL DEFAULT NULL,
54 `forced_ads_framebreaker` ENUM('Y','N') NOT NULL DEFAULT 'Y',
55 `forced_ads_type` VARCHAR(255) NOT NULL DEFAULT 'INVALID',
56 `forced_ads_views_counter` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
57 `forced_ads_clicks_counter` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
58 `forced_ads_added` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
59 `forced_ads_userid` BIGINT(20) UNSIGNED NULL DEFAULT NULL,
60 PRIMARY KEY (`forced_ads_id`),
61 INDEX (`forced_ads_userid`)",
62                         'Forced Ads Data');
63
64                 // - Connection -> ext-network
65                 addDropTableSql('forced_network');
66                 addCreateTableSql('forced_network', "
67 `forced_network_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
68 `forced_ads_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
69 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
70 PRIMARY KEY (`forced_network_id`),
71 UNIQUE `ads_type` (`forced_ads_id`, `network_type_id`)",
72                         'Forced Campaign Data');
73
74                 // - Campaigns
75                 addDropTableSql('forced_campaigns');
76                 addCreateTableSql('forced_campaigns', "
77 `forced_campaign_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
78 `forced_campaign_created` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
79 `forced_campaign_status` ENUM('ACTIVE','PENDING','EXPIRED','LOCKED') NOT NULL DEFAULT 'PENDING',
80 `forced_campaign_last_locked` TIMESTAMP NULL DEFAULT NULL,
81 `forced_campaign_lock_reason` VARCHAR(255) NULL DEFAULT NULL,
82 `forced_campaign_expired` TIMESTAMP NULL DEFAULT NULL,
83 `forced_campaign_ordered_clicks` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
84 `forced_campaign_payment_api` FLOAT(20,5) UNSIGNED NULL DEFAULT NULL,
85 `forced_campaign_reload_lock` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
86 `forced_campaign_minimum_stay` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
87 `forced_ads_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
88 `forced_campaign_userid` BIGINT(20) UNSIGNED NULL DEFAULT NULL,
89 `forced_costs_id` BIGINT(20) UNSIGNED NULL DEFAULT NULL,
90 PRIMARY KEY (`forced_campaign_id`),
91 INDEX (`forced_costs_id`)",
92                         'Forced Campaign Data');
93
94                 // - Campaign costs
95                 addDropTableSql('forced_costs');
96                 addCreateTableSql('forced_costs', "
97 `forced_costs_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
98 `forced_costs_price_click` FLOAT(20,5) UNSIGNED NULL DEFAULT NULL,
99 `forced_costs_payment_click` FLOAT(20,5) UNSIGNED NULL DEFAULT NULL,
100 `forced_costs_visibility` ENUM('MEMBER','SPONSOR','ALL','NONE') NOT NULL DEFAULT 'NONE',
101 PRIMARY KEY (`forced_costs_id`)",
102                         'Forced Campaign Costs');
103
104                 // - Campaign Statistics
105                 addDropTableSql('forced_stats');
106                 addCreateTableSql('forced_stats', "
107 `forced_stats_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
108 `forced_stats_campaign_id` BIGINT(20) UNSIGNED NULL DEFAULT NULL,
109 `forced_stats_userid` BIGINT(20) UNSIGNED NULL DEFAULT NULL,
110 `forced_stats_token` VARCHAR(255) NULL DEFAULT NULL,
111 `forced_stats_viewed` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
112 `forced_stats_clicked` TIMESTAMP NULL DEFAULT NULL,
113 `forced_stats_real_ip` VARCHAR(15) NOT NULL DEFAULT '0.0.0.0',
114 `forced_stats_remote_addr` VARCHAR(15) NOT NULL DEFAULT '0.0.0.0',
115 `forced_stats_ua` VARCHAR(255) NULL DEFAULT NULL,
116 `forced_stats_is_proxy` ENUM('Y','N') NOT NULL DEFAULT 'N',
117 `forced_stats_session_id` VARCHAR(100) NULL DEFAULT NULL,
118 PRIMARY KEY (`forced_stats_id`),
119 INDEX (`forced_stats_campaign_id`),
120 INDEX (`forced_stats_userid`)",
121                         'Forced Campaign Statistics');
122
123                 // Menu system
124                 // - Administrator
125                 addAdminMenuSql('forced', NULL, 'Forced-Ads', 'Verwalten Sie hier bequem alle laufenden Forced-Banner, -Textlinks, -PopUps und deren Kampgnen. Sie k&ouml;nnen hier auch neue Werbmittel (Ads) hinzuf&uuml;gen oder laufende Forced-Kampagnen bei z.B. Regelverst&ouml;ssen sperren oder l&ouml;schen. Auch das natr&auml;gliche Editieren von Ads und Kampagnen ist jederzeit m&ouml;glich. Kampagnen dienen der einfacheren Verwaltung und der Trennung von dem Werbemittel selbst dienen. Sie brauchen also z.B. einen Forced-Banner nur einmal einf&uuml;gen und k&ouml;nnen dann bei Bedarf weitere Kampagnen starten.', 5);
126                 addAdminMenuSql('forced', 'list_forced_ads', 'Forced-Ads verwalten', 'Listet alle eingetragenen Forced-Ads (Werbmittel mit Klickzwang) auf und f&uuml;gt neue hinzu. Sie k&ouml;nnen hier diese nachtr&auml;glich editieren falls Sie mal eine falsche URL eingegeben haben oder den Text &auml;ndern wollen. L&ouml;schen Sie hier auch Forced-Banner, die nicht mehr g&uuml;ltig sind (z.B. abgelaufen sind). Sollten doch mit dem Werbmittel verkn&uuml;pfte Kampagnen vorhanden sein, erhalten Sie einen Warnhinweis. Neue Werbmittel k&ouml;nnen Sie hier ebenfalls hinzuf&uuml;gen. Denken Sie aber daran, dass ohne Kampagne dieses nicht angezeigt wird. Achten Sie hier auch die Reload-Sperre.', 2);
127                 addAdminMenuSql('forced', 'list_forced_campaigns', 'Kampagnen verwalten', 'Listet alle Kampagnen auf und zeigt deren Status an. Jederzeit k&ouml;nnen Sie Kampagnen stoppen, falls Sie dies w&uuml;nschen oder ein Regelverstoss vorliegt. Haben Sie ein Werbemittel hinzugef&uuml;gt, so f&uuml;gen Sie bitte unbedingt eine Kampagne hinzu, da es sonst nicht angezeigt wird.', 3);
128                 addAdminMenuSql('forced', 'list_forced_costs', 'Preise verwalten', 'Legen Sie die Preise pro Klick f&uuml;r Forced-Werbemittelbuchungen fest und wie viele {OPEN_CONFIG}POINTS{CLOSE_CONFIG} Ihre Mitglieder erhalten sollen. Generell sollten Sie bei Mitgliederbuchungen h&ouml;here Kosten pro Klick als was Ihre Mitglieder pro Klick erhalten einstellen, da so die {OPEN_CONFIG}POINTS{CLOSE_CONFIG} abgebaut werden (Sie k&ouml;nnen an Accountaufladungen z.B. verdienen).', 4);
129                 addAdminMenuSql('forced', 'stats_forced', 'Statistiken', 'Zeigt Gesamtstatistiken und zu den einzelnen Kampagnen und Werbmitteln an. Die hier angezeigte Statistik kann jedoch nicht manuell gel&ouml;scht werden (bitte auch nicht selber tun) da sie auch gleichzeitigt als Reload-Sperre dient.', 5);
130
131                 // - Members
132                 addMemberMenuSql('earn', 'forced_banner', 'Forced-Banner', 3);
133                 addMemberMenuSql('earn', 'forced_textlink', 'Forced-Textlinks', 4);
134                 addMemberMenuSql('extras', 'book_forced', 'Forced-Kampagne buchen', 3);
135
136                 // Register Forced-PopUps with earning_data table
137                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_earning_data` (`earning_group`, `earning_provider`, `earning_sorting`) VALUES ('POPUP','FORCED_POPUP',1)");
138
139                 // Register filters
140                 registerFilter(__FILE__, __LINE__, 'add_forced_ads_types', 'FORCED_AD_TYPE_DEFAULTS', FALSE, TRUE, isExtensionDryRun());
141                 registerFilter(__FILE__, __LINE__, 'member_earning_table_data', 'FORCED_POPUP_TABLE_DATA', FALSE, TRUE, isExtensionDryRun());
142                 registerFilter(__FILE__, __LINE__, 'post_change_forced_campaign_status', 'FORCED_CHANGE_CAMPAIGN_STATUS', FALSE, TRUE, isExtensionDryRun());
143                 registerFilter(__FILE__, __LINE__, 'pre_change_forced_campaign_status', 'FORCED_CHANGE_CAMPAIGN_VALIDATE_DATA', FALSE, TRUE, isExtensionDryRun());
144                 registerFilter(__FILE__, __LINE__, 'handle_click_php', 'HANDLE_FORCED_AD_CLICK', FALSE, TRUE, isExtensionDryRun());
145                 registerFilter(__FILE__, __LINE__, 'handle_view_php', 'HANDLE_FORCED_AD_VIEW', FALSE, TRUE, isExtensionDryRun());
146
147 // [EOF]
148 ?>