WordPress 4.4
[autoinstalls/wordpress.git] / wp-includes / default-constants.php
index 7325845966ccb4c127f7c01c14d97755760556cc..c9092bd2cc2ba4caba4b7fc61692b76697646572 100644 (file)
@@ -11,6 +11,8 @@
  * @see wp_debug_mode()
  *
  * @since 3.0.0
+ *
+ * @global int $blog_id
  */
 function wp_initial_constants() {
        global $blog_id;
@@ -28,13 +30,6 @@ function wp_initial_constants() {
                define( 'WP_MAX_MEMORY_LIMIT', '256M' );
        }
 
-       /**
-        * The $blog_id global, which you can change in the config allows you to create a simple
-        * multiple blog installation using just one WordPress and changing $blog_id around.
-        *
-        * @global int $blog_id
-        * @since 2.0.0
-        */
        if ( ! isset($blog_id) )
                $blog_id = 1;
 
@@ -95,13 +90,37 @@ function wp_initial_constants() {
        // Constants for features added to WP that should short-circuit their plugin implementations
        define( 'WP_FEATURE_BETTER_PASSWORDS', true );
 
-       // Constants for expressing human-readable intervals
-       // in their respective number of seconds.
+       /**#@+
+        * Constants for expressing human-readable intervals
+        * in their respective number of seconds.
+        *
+        * Please note that these values are approximate and are provided for convenience.
+        * For example, MONTH_IN_SECONDS wrongly assumes every month has 30 days and
+        * YEAR_IN_SECONDS does not take leap years into account.
+        *
+        * If you need more accuracy please consider using the DateTime class (http://php.net/manual/class.datetime.php).
+        *
+        * @since 3.5.0
+        * @since 4.4.0 Introduced `MONTH_IN_SECONDS`.
+        */
        define( 'MINUTE_IN_SECONDS', 60 );
        define( 'HOUR_IN_SECONDS',   60 * MINUTE_IN_SECONDS );
        define( 'DAY_IN_SECONDS',    24 * HOUR_IN_SECONDS   );
        define( 'WEEK_IN_SECONDS',    7 * DAY_IN_SECONDS    );
+       define( 'MONTH_IN_SECONDS',  30 * DAY_IN_SECONDS    );
        define( 'YEAR_IN_SECONDS',  365 * DAY_IN_SECONDS    );
+       /**#@-*/
+
+       /**#@+
+        * Constants for expressing human-readable data sizes in their respective number of bytes.
+        *
+        * @since 4.4.0
+        */
+       define( 'KB_IN_BYTES', 1024 );
+       define( 'MB_IN_BYTES', 1024 * KB_IN_BYTES );
+       define( 'GB_IN_BYTES', 1024 * MB_IN_BYTES );
+       define( 'TB_IN_BYTES', 1024 * GB_IN_BYTES );
+       /**#@-*/
 }
 
 /**
@@ -329,10 +348,12 @@ function wp_templating_constants() {
        /**
         * Slug of the default theme for this install.
         * Used as the default theme when installing new sites.
-        * Will be used as the fallback if the current theme doesn't exist.
+        * It will be used as the fallback if the current theme doesn't exist.
+        *
         * @since 3.0.0
+        * @see WP_Theme::get_core_default_theme()
         */
        if ( !defined('WP_DEFAULT_THEME') )
-               define( 'WP_DEFAULT_THEME', 'twentyfifteen' );
+               define( 'WP_DEFAULT_THEME', 'twentysixteen' );
 
 }