inc/extensions/ext-network.php

   1 <?php
   2 /************************************************************************
   3  * Mailer v0.2.1-FINAL                                Start: 12/18/2008 *
   4  * ===================                          Last change: 11/01/2009 *
   5  *                                                                      *
   6  * -------------------------------------------------------------------- *
   7  * File              : ext-network.php                                  *
   8  * -------------------------------------------------------------------- *
   9  * Short description : Generic (sponsor) network connection extension   *
  10  * -------------------------------------------------------------------- *
  11  * Kurzbeschreibung  : Allgemeine Werbenetzwerk-Erweiterung             *
  12  * -------------------------------------------------------------------- *
  13  * $Revision::                                                        $ *
  14  * $Date::                                                            $ *
  15  * $Tag:: 0.2.1-FINAL                                                 $ *
  16  * $Author::                                                          $ *
  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                  *
  22  *                                                                      *
  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.                                  *
  27  *                                                                      *
  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.                         *
  32  *                                                                      *
  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,               *
  36  * MA  02110-1301  USA                                                  *
  37  ************************************************************************/
  38
  39 // Some security stuff...
  40 if (!defined('__SECURITY')) {
  41         die();
  42 } // END - if
  43
  44 // Version number
  45 setThisExtensionVersion('0.0');
  46
  47 // Version history array (add more with , '0.1.0' and so on)
  48 setExtensionVersionHistory(array('0.0'));
  49
  50 // This extension is in development (non-productive)
  51 enableExtensionProductive(false);
  52
  53 switch (getExtensionMode()) {
  54         case 'register': // Do stuff when installation is running (modules.php?module=admin is called)
  55                 // Main table which hold
  56                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_data`');
  57                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_data` (
  58 `network_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  59 `network_short_name` VARCHAR(50) NOT NULL DEFAULT '',
  60 `network_title` VARCHAR(255) NOT NULL DEFAULT '',
  61 `network_reflink` VARCHAR(255) NOT NULL DEFAULT '',
  62 `network_data_seperator` CHAR(4) NOT NULL DEFAULT '|',
  63 `network_row_seperator` CHAR(4) NOT NULL DEFAULT '|',
  64 `network_request_type` ENUM('GET','POST') NOT NULL DEFAULT 'GET',
  65 `network_charset` VARCHAR(20) NOT NULL DEFAULT 'UTF-8',
  66 UNIQUE (`network_short_name`),
  67 PRIMARY KEY (`network_id`)
  68 ) TYPE={?_TABLE_TYPE?} COMMENT='Network data'");
  69
  70                 // Types the network provider is supporting (e.g. Forced-Banner and so on)
  71                 // @TODO network_type_handle is an internal name and needs documentation
  72                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`');
  73                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types` (
  74 `network_type_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  75 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
  76 `network_type_handle` VARCHAR(255) NOT NULL DEFAULT '',
  77 `network_type_api_url` VARCHAR(255) NOT NULL DEFAULT '',
  78 `network_type_click_url` VARCHAR(255) NOT NULL DEFAULT '',
  79 `network_type_banner_url` VARCHAR(255) NOT NULL DEFAULT '',
  80 UNIQUE `provider_type` (`network_id`,`network_type_handle`),
  81 PRIMARY KEY (`network_type_id`)
  82 ) TYPE={?_TABLE_TYPE?} COMMENT='Types provideable by networks'");
  83
  84                 // HTTP parameters (names) for URLs
  85                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`');
  86                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_request_params` (
  87 `network_param_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
  88 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
  89 `request_param_key` VARCHAR(10) NOT NULL DEFAULT 'invalid',
  90 `request_param_value` VARCHAR(10) NOT NULL DEFAULT 'invalid',
  91 UNIQUE `provider_key` (`network_id`, `request_param_key`),
  92 PRIMARY KEY (`network_param_id`)
  93 ) TYPE={?_TABLE_TYPE?} COMMENT='Request parameters for GET/POST request'");
  94
  95                 // Error status codes
  96                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_codes`');
  97                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_type_codes` (
  98 `network_type_code_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
  99 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 100 `network_type_code_value` VARCHAR(50) NOT NULL DEFAULT '',
 101 `network_type_code_type` VARCHAR(100) NOT NULL DEFAULT 'INVALID_TYPE',
 102 UNIQUE `code_type` (`network_type_code_value`,`network_type_id`),
 103 INDEX (`network_type_id`),
 104 PRIMARY KEY (`network_type_code_id`)
 105 ) TYPE={?_TABLE_TYPE?} COMMENT='Error codes for all types'");
 106
 107                 // Code types (internal table)
 108                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_codes`');
 109                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_codes` (
 110 `network_code_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 111 `network_code` VARCHAR(100) NOT NULL DEFAULT 'INVALID_CODE',
 112 UNIQUE (`network_code`),
 113 PRIMARY KEY (`network_code_id`)
 114 ) TYPE={?_TABLE_TYPE?} COMMENT='Error types, generic data, DO NOT ALTER!'");
 115
 116                 // Valid translation keys (we hate hard-coded arrays, you see?)
 117                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_translations`');
 118                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_translations` (
 119 `network_translate_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 120 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 121 `network_translation` VARCHAR(100) NOT NULL DEFAULT '',
 122 UNIQUE `type_trans` (`network_type_id`,`network_translation`),
 123 PRIMARY KEY (`network_translate_id`)
 124 ) TYPE={?_TABLE_TYPE?} COMMENT='Translations for array keys, generic data, DO NOT ALTER!'");
 125
 126                 // Array-Element translation tables per type/provider
 127                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_array_translation`');
 128                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_array_translation` (
 129 `network_translate_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 130 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 131 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 132 `network_array_key` SMALLINT(5) UNSIGNED NOT NULL DEFAULT 0,
 133 `network_translation` VARCHAR(100) NOT NULL DEFAULT '',
 134 UNIQUE `provider_type_key` (`network_id`,`network_type_id`,`network_array_key`),
 135 UNIQUE `provider_type_trans` (`network_id`,`network_type_id`,`network_translation`),
 136 PRIMARY KEY (`network_translate_id`)
 137 ) TYPE={?_TABLE_TYPE?} COMMENT='Cache for all queried APIs'");
 138
 139                 // Data from the webmaster (you!)
 140                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_config`');
 141                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_config` (
 142 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 143 `network_affiliate_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 144 `network_api_password` VARCHAR(255) NOT NULL DEFAULT '',
 145 `network_site_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 146 `network_query_amount` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 147 UNIQUE `network_affiliate` (`network_id`,`network_affiliate_id`),
 148 UNIQUE `affiliate_site` (`network_affiliate_id`,`network_site_id`),
 149 PRIMARY KEY (`network_id`)
 150 ) TYPE={?_TABLE_TYPE?} COMMENT='Configuration data from the webmaster (you!)'");
 151
 152                 // Configuration data for e.g. reload-time
 153                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types_config`');
 154                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_types_config` (
 155 `network_data_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 156 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 157 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 158 `max_reload_time` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 159 `min_waiting_time` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 160 `min_remain_clicks` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 161 `min_payment` FLOAT(20,5) UNSIGNED NOT NULL DEFAULT 0.00000,
 162 `allow_erotic` VARCHAR(10) NOT NULL DEFAULT '',
 163 UNIQUE `provider_type` (`network_id`,`network_type_id`),
 164 PRIMARY KEY (`network_data_id`)
 165 ) TYPE={?_TABLE_TYPE?} COMMENT='Configuration data for every type (e.g. reload-time)'");
 166
 167                 // Cache for queried APIs. Re-check depends on config
 168                 // `network_cache_refresh` in seconds or if set to zero, full day
 169                 // divided by query amount.
 170                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_cache`');
 171                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_cache` (
 172 `network_cache_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 173 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 174 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 175 `network_cache_data` MEDIUMBLOB,
 176 `network_cache_timestamp` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00',
 177 UNIQUE `provider_type` (`network_id`,`network_type_id`),
 178 PRIMARY KEY (`network_cache_id`)
 179 ) TYPE={?_TABLE_TYPE?} COMMENT='Cache for all queried APIs'");
 180
 181                 // Reload locks for several types
 182                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_reloads`');
 183                 addExtensionSql("CREATE TABLE `{?_MYSQL_PREFIX?}_network_reloads` (
 184 `network_reload_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
 185 `network_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 186 `network_type_id` BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
 187 `network_reload_lock` SMALLINT(5) UNSIGNED NOT NULL DEFAULT 0,
 188 `network_inserted` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP(),
 189 UNIQUE `provider_type` (`network_id`,`network_type_id`),
 190 PRIMARY KEY (`network_reload_id`)
 191 ) TYPE={?_TABLE_TYPE?} COMMENT='Reload locks'");
 192
 193                 // Insert error code types
 194                 // - Affiliate id or interface password wrong
 195                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('AFF_ID_PASS_WRONG')");
 196                 // - Webmaster's site id is not assigned (invalid, different affiliate id)
 197                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_NOT_ASSIGNED')");
 198                 // - Webmaster's site id is locked
 199                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_LOCKED')");
 200                 // - General error in interface data
 201                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('INTERFACE_DATA_ERROR')");
 202                 // - Request amount depleted
 203                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUESTS_DEPLETED')");
 204                 // - No campaigns found for given criteria (but maybe there are with more widen criteria)
 205                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('NO_CAMPAIGNS_FOUND')");
 206                 // - No campaigns found with allowed interface output (but there are maybe non-interface campaigns)
 207                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('NO_CAMPAIGNS_FOUND_INTERFACE')");
 208                 // - Webmaster's site id is not unlocked for choosen type
 209                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('SITE_ID_NOT_ALLOWED_TYPE')");
 210                 // - Request parameters incomplete
 211                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_codes` (`network_code`) VALUES ('REQUEST_PARAMS_INCOMPLETE')");
 212
 213                 // Sponsor networks
 214                 addExtensionSql("INSERT INTO `{?_MYSQL_PREFIX?}_network_data` (`network_short_name`, `network_title`, `network_reflink`, `network_data_seperator`, `network_row_seperator`, `network_request_type`, `network_charset`) VALUES ('yoomedia', 'Yoo!Media Solutions', 'http://www.yoomedia.de?ref=1715', '|', '|', 'GET', 'WINDOWS-1252')");
 215
 216                 // Admin menu entries
 217                 addAdminMenuSql('network',NULL,'Werbenetzwerke','Verwalten Sie hier Werbenetzwerke (API-Anbindung), versenden Sie deren Mails, oder &uuml;bernehmen Sie deren Textlinks und vieles mehr. <strong>VORSICHT:</strong> Das Einrichten von weiteren Werbenetzwerken ist nicht leicht, daf&uuml;r aber sehr flexibel! Sollte ein Netzwerk fehlen, so melden Sie dies bitte <a href="http://forum.mxchange.org/topic-462.html" target="_blank" title="Direktlink zum Forum">im Forum</a>!',4);
 218                 addAdminMenuSql('network','config_networks','API-Daten','Stellen Sie Ihre Affiliate- Webseiten-Id und API-Passwort ein. Diese erhalten Sie zu &uuml;ber 99% aus dem jeweiligen Zugangsbereich des Anbieters. Sollten Sie bei einem Netzwerk noch nicht angemeldet sein, verwenden Sie bitte meinen Referal-Link.',1);
 219                 addAdminMenuSql('network','config_network_types','Werbearten','Stellen Sie hier Reload-Zeiten, Mindestauffenthalt und so weiter pro Werbeart und Werbenetzwerk ein. Es werden sonst Standart-Werte (Mimimumwerte: 0, Maximumwerte: sehr gross, Erotik: aus) angenommen, die Sie meistens nicht wollen.',2);
 220                 addAdminMenuSql('network','query_networks','APIs abfragen','Fragt alle eingestellten APIs ab. Die Ergebnisse werden dann f&uuml;r einen einstellbaren Zeitraum gecacht und nicht erneut angefordert.',3);
 221                 addAdminMenuSql('network','config_network','Einstellungen','Stellen Sie generelle Einstellungen ein, die f&uuml;r alle Werbenetzwerke gelten, wie z.B. Cache-Erneuerungsinterval. Generell sind aber die Einstellungen in Ordnung, da z.B. sonst Ihre freien Abfragen beim Werbenetzwerk sich zu schnell abbauen.',4);
 222                 addAdminMenuSql('network','list_network_reloads','Reload-Sperren','Listen oder l&ouml;schen Sie hier Reload-Sperren. <strong>Vorsicht:</strong> Die hier gespeicherten Reload-Sperren sind vom jeweiligen Werbenetzwerk &uuml;bernommen. Eventuell verdienen Sie nichts, wenn Sie z.B. eine Mail innerhalb der Reload-Sperre erneut versenden.',5);
 223                 addAdminMenuSql('network','list_networks','Auflisten/Verwalten','<strong>Experten-Einstellungen!</strong> Hier &auml;ndern Sie die Einstellungen an den Grunddaten (Stammdaten) des jeweiligen Werbenetzwerks ab. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',6);
 224                 addAdminMenuSql('network','list_network_types','Werbearten','<strong>Experten-Einstellungen!</strong> Hier &auml;ndern Sie die Einstellungen zu den Werbearten pro Werbenetzwerken. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',7);
 225                 addAdminMenuSql('network','list_network_params','Abfrageparameter','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Abfrageparameter (wie sie genannt werden m&uuml;ssen, um das API-Script korrekt aufrufen zu k&ouml;nnen) ein, pro Werbenetzwerk. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',8);
 226                 addAdminMenuSql('network','list_network_code_types','R&uuml;ckgabewerte','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die R&uuml;ckgabewerte ein, die im Falle eines Fehlers pro API-Script kommen k&ouml;nnen. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',9);
 227                 addAdminMenuSql('network','list_network_codes','Fehlercodes','<strong>Experten-Einstellungen!</strong> Hier stellen Sie die Namen von Fehlercodes ein, die Scripte zur&uuml;ckliefern k&ouml;nnen. <strong>Dies sind INTERNE Daten und sollten nur vom Entwicklerteam angepasst werden.</strong> Stellen Sie an diesen Einstellungen bitte nichts um. Sie sollten hier generell nichts einstellen und <a href="http://forum.mxchange.org/forum-43.html" target="_blank" title="Direktlink zum Forum">im Forum</a> um Hilfe fragen, wenn Sie selber ein Werbenetzwerk einrichten m&ouml;chten.',10);
 228
 229                 // Configuration entries
 230                 addExtensionSql('ALTER TABLE `{?_MYSQL_PREFIX?}_config` ADD `network_cache_refresh` BIGINT(20) UNSIGNED NOT NULL DEFAULT ' . (60 * 15) . '');
 231                 break;
 232
 233         case 'remove': // Do stuff when removing extension
 234                 // SQL commands to run
 235                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_data`');
 236                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types`');
 237                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_request_params`');
 238                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_type_codes`');
 239                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_translations`');
 240                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_array_translation`');
 241                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_config`');
 242                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_types_config`');
 243                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_cache`');
 244                 addExtensionSql('DROP TABLE IF EXISTS `{?_MYSQL_PREFIX?}_network_reloads`');
 245
 246                 // Admin menu
 247                 addExtensionSql("DELETE LOW_PRIORITY FROM `{?_MYSQL_PREFIX?}_admin_menu` WHERE `action`='network'");
 248                 break;
 249
 250         case 'activate': // Do stuff when admin activates this extension
 251                 // SQL commands to run
 252                 break;
 253
 254         case 'deactivate': // Do stuff when admin deactivates this extension
 255                 // SQL commands to run
 256                 break;
 257
 258         case 'update': // Update an extension
 259                 switch (getCurrentExtensionVersion()) {
 260                         case '0.0.1': // SQL queries for v0.0.1
 261                                 addExtensionSql('');
 262
 263                                 // Update notes (these will be set as task text!)
 264                                 setExtensionUpdateNotes('');
 265                                 break;
 266                 } // END - switch
 267                 break;
 268
 269         case 'modify': // When the extension got modified
 270                 break;
 271
 272         case 'test': // For testing purposes. For details see file inc/modules/admin/what-extensions.php, arround line 305.
 273                 break;
 274
 275         case 'init': // Do stuff when extension is initialized
 276                 break;
 277
 278         default: // Unknown extension mode
 279                 logDebugMessage(__FILE__, __LINE__, sprintf("Unknown extension mode %s detected.", getExtensionMode()));
 280                 break;
 281 } // END - switch
 282
 283 // [EOF]
 284 ?>