includes/Defines.php

   1 <?php
   2 /**
   3  * A few constants that might be needed during LocalSettings.php.
   4  *
   5  * Note: these constants must all be resolvable at compile time by HipHop,
   6  * since this file will not be executed during request startup for a compiled
   7  * MediaWiki.
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License along
  20  * with this program; if not, write to the Free Software Foundation, Inc.,
  21  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  22  * http://www.gnu.org/copyleft/gpl.html
  23  *
  24  * @file
  25  */
  26
  27 /**
  28  * @defgroup Constants MediaWiki constants
  29  */
  30
  31 /**
  32  * Version constants for the benefit of extensions
  33  */
  34 define( 'MW_SPECIALPAGE_VERSION', 2 );
  35
  36 /**@{
  37  * Database related constants
  38  */
  39 define( 'DBO_DEBUG', 1 );
  40 define( 'DBO_NOBUFFER', 2 );
  41 define( 'DBO_IGNORE', 4 );
  42 define( 'DBO_TRX', 8 ); // automatically start transaction on first query
  43 define( 'DBO_DEFAULT', 16 );
  44 define( 'DBO_PERSISTENT', 32 );
  45 define( 'DBO_SYSDBA', 64 ); //for oracle maintenance
  46 define( 'DBO_DDLMODE', 128 ); // when using schema files: mostly for Oracle
  47 define( 'DBO_SSL', 256 );
  48 define( 'DBO_COMPRESS', 512 );
  49 /**@}*/
  50
  51 /**@{
  52  * Valid database indexes
  53  * Operation-based indexes
  54  */
  55 define( 'DB_SLAVE', -1 );     # Read from the slave (or only server)
  56 define( 'DB_MASTER', -2 );    # Write to master (or only server)
  57 /**@}*/
  58
  59 # Obsolete aliases
  60 define( 'DB_READ', -1 );
  61 define( 'DB_WRITE', -2 );
  62 define( 'DB_LAST', -3 ); # deprecated since 2008, usage throws exception
  63
  64 /**@{
  65  * Virtual namespaces; don't appear in the page database
  66  */
  67 define( 'NS_MEDIA', -2 );
  68 define( 'NS_SPECIAL', -1 );
  69 /**@}*/
  70
  71 /**@{
  72  * Real namespaces
  73  *
  74  * Number 100 and beyond are reserved for custom namespaces;
  75  * DO NOT assign standard namespaces at 100 or beyond.
  76  * DO NOT Change integer values as they are most probably hardcoded everywhere
  77  * see bug #696 which talked about that.
  78  */
  79 define( 'NS_MAIN', 0 );
  80 define( 'NS_TALK', 1 );
  81 define( 'NS_USER', 2 );
  82 define( 'NS_USER_TALK', 3 );
  83 define( 'NS_PROJECT', 4 );
  84 define( 'NS_PROJECT_TALK', 5 );
  85 define( 'NS_FILE', 6 );
  86 define( 'NS_FILE_TALK', 7 );
  87 define( 'NS_MEDIAWIKI', 8 );
  88 define( 'NS_MEDIAWIKI_TALK', 9 );
  89 define( 'NS_TEMPLATE', 10 );
  90 define( 'NS_TEMPLATE_TALK', 11 );
  91 define( 'NS_HELP', 12 );
  92 define( 'NS_HELP_TALK', 13 );
  93 define( 'NS_CATEGORY', 14 );
  94 define( 'NS_CATEGORY_TALK', 15 );
  95
  96 /**
  97  * NS_IMAGE and NS_IMAGE_TALK are the pre-v1.14 names for NS_FILE and
  98  * NS_FILE_TALK respectively, and are kept for compatibility.
  99  *
 100  * When writing code that should be compatible with older MediaWiki
 101  * versions, either stick to the old names or define the new constants
 102  * yourself, if they're not defined already.
 103  */
 104 define( 'NS_IMAGE', NS_FILE );
 105 define( 'NS_IMAGE_TALK', NS_FILE_TALK );
 106 /**@}*/
 107
 108 /**@{
 109  * Cache type
 110  */
 111 define( 'CACHE_ANYTHING', -1 );  // Use anything, as long as it works
 112 define( 'CACHE_NONE', 0 );       // Do not cache
 113 define( 'CACHE_DB', 1 );         // Store cache objects in the DB
 114 define( 'CACHE_MEMCACHED', 2 );  // MemCached, must specify servers in $wgMemCacheServers
 115 define( 'CACHE_ACCEL', 3 );      // APC, XCache or WinCache
 116 /**@}*/
 117
 118 /**@{
 119  * Media types.
 120  * This defines constants for the value returned by File::getMediaType()
 121  */
 122 // unknown format
 123 define( 'MEDIATYPE_UNKNOWN', 'UNKNOWN' );
 124 // some bitmap image or image source (like psd, etc). Can't scale up.
 125 define( 'MEDIATYPE_BITMAP', 'BITMAP' );
 126 // some vector drawing (SVG, WMF, PS, ...) or image source (oo-draw, etc). Can scale up.
 127 define( 'MEDIATYPE_DRAWING', 'DRAWING' );
 128 // simple audio file (ogg, mp3, wav, midi, whatever)
 129 define( 'MEDIATYPE_AUDIO', 'AUDIO' );
 130 // simple video file (ogg, mpg, etc;
 131 // no not include formats here that may contain executable sections or scripts!)
 132 define( 'MEDIATYPE_VIDEO', 'VIDEO' );
 133 // Scriptable Multimedia (flash, advanced video container formats, etc)
 134 define( 'MEDIATYPE_MULTIMEDIA', 'MULTIMEDIA' );
 135 // Office Documents, Spreadsheets (office formats possibly containing apples, scripts, etc)
 136 define( 'MEDIATYPE_OFFICE', 'OFFICE' );
 137 // Plain text (possibly containing program code or scripts)
 138 define( 'MEDIATYPE_TEXT', 'TEXT' );
 139 // binary executable
 140 define( 'MEDIATYPE_EXECUTABLE', 'EXECUTABLE' );
 141 // archive file (zip, tar, etc)
 142 define( 'MEDIATYPE_ARCHIVE', 'ARCHIVE' );
 143 /**@}*/
 144
 145 /**@{
 146  * Antivirus result codes, for use in $wgAntivirusSetup.
 147  */
 148 define( 'AV_NO_VIRUS', 0 );  #scan ok, no virus found
 149 define( 'AV_VIRUS_FOUND', 1 );  #virus found!
 150 define( 'AV_SCAN_ABORTED', -1 );  #scan aborted, the file is probably immune
 151 define( 'AV_SCAN_FAILED', false );  #scan failed (scanner not found or error in scanner)
 152 /**@}*/
 153
 154 /**@{
 155  * Anti-lock flags
 156  * See DefaultSettings.php for a description
 157  */
 158 define( 'ALF_PRELOAD_LINKS', 1 ); // unused
 159 define( 'ALF_PRELOAD_EXISTENCE', 2 ); // unused
 160 define( 'ALF_NO_LINK_LOCK', 4 );
 161 define( 'ALF_NO_BLOCK_LOCK', 8 );
 162 /**@}*/
 163
 164 /**@{
 165  * Date format selectors; used in user preference storage and by
 166  * Language::date() and co.
 167  */
 168 /*define( 'MW_DATE_DEFAULT', '0' );
 169 define( 'MW_DATE_MDY', '1' );
 170 define( 'MW_DATE_DMY', '2' );
 171 define( 'MW_DATE_YMD', '3' );
 172 define( 'MW_DATE_ISO', 'ISO 8601' );*/
 173 define( 'MW_DATE_DEFAULT', 'default' );
 174 define( 'MW_DATE_MDY', 'mdy' );
 175 define( 'MW_DATE_DMY', 'dmy' );
 176 define( 'MW_DATE_YMD', 'ymd' );
 177 define( 'MW_DATE_ISO', 'ISO 8601' );
 178 /**@}*/
 179
 180 /**@{
 181  * RecentChange type identifiers
 182  */
 183 define( 'RC_EDIT', 0 );
 184 define( 'RC_NEW', 1 );
 185 define( 'RC_MOVE', 2 ); // obsolete
 186 define( 'RC_LOG', 3 );
 187 define( 'RC_MOVE_OVER_REDIRECT', 4 ); // obsolete
 188 define( 'RC_EXTERNAL', 5 );
 189 /**@}*/
 190
 191 /**@{
 192  * Article edit flags
 193  */
 194 define( 'EDIT_NEW', 1 );
 195 define( 'EDIT_UPDATE', 2 );
 196 define( 'EDIT_MINOR', 4 );
 197 define( 'EDIT_SUPPRESS_RC', 8 );
 198 define( 'EDIT_FORCE_BOT', 16 );
 199 define( 'EDIT_DEFER_UPDATES', 32 );
 200 define( 'EDIT_AUTOSUMMARY', 64 );
 201 /**@}*/
 202
 203 /**@{
 204  * Flags for Database::makeList()
 205  * These are also available as Database class constants
 206  */
 207 define( 'LIST_COMMA', 0 );
 208 define( 'LIST_AND', 1 );
 209 define( 'LIST_SET', 2 );
 210 define( 'LIST_NAMES', 3 );
 211 define( 'LIST_OR', 4 );
 212 /**@}*/
 213
 214 /**
 215  * Unicode and normalisation related
 216  */
 217 require_once __DIR__ . '/normal/UtfNormalDefines.php';
 218
 219 /**@{
 220  * Hook support constants
 221  */
 222 define( 'MW_SUPPORTS_EDITFILTERMERGED', 1 );
 223 define( 'MW_SUPPORTS_PARSERFIRSTCALLINIT', 1 );
 224 define( 'MW_SUPPORTS_LOCALISATIONCACHE', 1 );
 225 define( 'MW_SUPPORTS_CONTENTHANDLER', 1 );
 226 /**@}*/
 227
 228 /** Support for $wgResourceModules */
 229 define( 'MW_SUPPORTS_RESOURCE_MODULES', 1 );
 230
 231 /**@{
 232  * Allowed values for Parser::$mOutputType
 233  * Parameter to Parser::startExternalParse().
 234  */
 235 define( 'OT_HTML', 1 );
 236 define( 'OT_WIKI', 2 );
 237 define( 'OT_PREPROCESS', 3 );
 238 define( 'OT_MSG', 3 );  // b/c alias for OT_PREPROCESS
 239 define( 'OT_PLAIN', 4 );
 240 /**@}*/
 241
 242 /**@{
 243  * Flags for Parser::setFunctionHook
 244  */
 245 define( 'SFH_NO_HASH', 1 );
 246 define( 'SFH_OBJECT_ARGS', 2 );
 247 /**@}*/
 248
 249 /**
 250  * Flags for Parser::replaceLinkHolders
 251  */
 252 define( 'RLH_FOR_UPDATE', 1 );
 253
 254 /**@{
 255  * Autopromote conditions (must be here and not in Autopromote.php, so that
 256  * they're loaded for DefaultSettings.php before AutoLoader.php)
 257  */
 258 define( 'APCOND_EDITCOUNT', 1 );
 259 define( 'APCOND_AGE', 2 );
 260 define( 'APCOND_EMAILCONFIRMED', 3 );
 261 define( 'APCOND_INGROUPS', 4 );
 262 define( 'APCOND_ISIP', 5 );
 263 define( 'APCOND_IPINRANGE', 6 );
 264 define( 'APCOND_AGE_FROM_EDIT', 7 );
 265 define( 'APCOND_BLOCKED', 8 );
 266 define( 'APCOND_ISBOT', 9 );
 267 /**@}*/
 268
 269 /** @{
 270  * Protocol constants for wfExpandUrl()
 271  */
 272 define( 'PROTO_HTTP', 'http://' );
 273 define( 'PROTO_HTTPS', 'https://' );
 274 define( 'PROTO_RELATIVE', '//' );
 275 define( 'PROTO_CURRENT', null );
 276 define( 'PROTO_CANONICAL', 1 );
 277 define( 'PROTO_INTERNAL', 2 );
 278 /**@}*/
 279
 280 /**@{
 281  * Content model ids, used by Content and ContentHandler.
 282  * These IDs will be exposed in the API and XML dumps.
 283  *
 284  * Extensions that define their own content model IDs should take
 285  * care to avoid conflicts. Using the extension name as a prefix is recommended,
 286  * for example 'myextension-somecontent'.
 287  */
 288 define( 'CONTENT_MODEL_WIKITEXT', 'wikitext' );
 289 define( 'CONTENT_MODEL_JAVASCRIPT', 'javascript' );
 290 define( 'CONTENT_MODEL_CSS', 'css' );
 291 define( 'CONTENT_MODEL_TEXT', 'text' );
 292 /**@}*/
 293
 294 /**@{
 295  * Content formats, used by Content and ContentHandler.
 296  * These should be MIME types, and will be exposed in the API and XML dumps.
 297  *
 298  * Extensions are free to use the below formats, or define their own.
 299  * It is recommended to stick with the conventions for MIME types.
 300  */
 301 // wikitext
 302 define( 'CONTENT_FORMAT_WIKITEXT', 'text/x-wiki' );
 303 // for js pages
 304 define( 'CONTENT_FORMAT_JAVASCRIPT', 'text/javascript' );
 305 // for css pages
 306 define( 'CONTENT_FORMAT_CSS', 'text/css' );
 307 // for future use, e.g. with some plain-html messages.
 308 define( 'CONTENT_FORMAT_TEXT', 'text/plain' );
 309 // for future use, e.g. with some plain-html messages.
 310 define( 'CONTENT_FORMAT_HTML', 'text/html' );
 311 // for future use with the api and for extensions
 312 define( 'CONTENT_FORMAT_SERIALIZED', 'application/vnd.php.serialized' );
 313 // for future use with the api, and for use by extensions
 314 define( 'CONTENT_FORMAT_JSON', 'application/json' );
 315 // for future use with the api, and for use by extensions
 316 define( 'CONTENT_FORMAT_XML', 'application/xml' );
 317 /**@}*/