Константы WordPress, полный список констант

Уважаемые подписчики и посетители блога 4remind.ru, предлагаю Вам ознакомиться с константами, которые используются или могут использоваться в конфигурации WordPress. В этой статье перечислены все константы, которые определены в WordPress 3.3 или могут быть определены непосредственно самим движком WordPress во время его работы (конечно за исключением устаревших констант).

Многим думаю известно и уже стало понятно, что панель управления WordPress не предоставляет возможности изменять все, что угодно в настройках сайта или блога. Многие настройки, которые недоступны из панели управления, все же можно изменять, но и то только с применением вызовов «action» или «filter», а для некоторых изменений даже возможно придется определять или изменять константы самого PHP. Однако, имея под рукой перечень констант WordPress, Вы скорее всего сумеете решить те свои задачи, которые раньше были для Вас недосягаемы или казались слишком сложными.

Забегая немного вперед, думаю стоит освежить свои познания касательно констант в языке PHP.
В своих проектах любой вебмастер может определять и использовать свои константы, но все же следует придерживаться определенных правил и понятий, касающихся констант в PHP. Поэтому давайте вначале кое-что уточним и вспомним, а затем уже будем обследовать список констант WordPress.

Константа — это идентификатор (имя, условное название) некоторого значения. Как следует из названия, это значение постоянно и не может изменяться по ходу выполнения скрипта. Следует иметь ввиду, что имена констант чувствительны к регистру, и по соглашению языка PHP имена констант всегда должны записываться в верхнем регистре.

Имена констант следуют тем же правилам, как и любая другая метка в языке PHP. Имя константы может начинаться только с английской буквы или с символа подчеркивания, а остальная часть имени константы может содержать любое количество букв, цифр или символов подчеркивания в любой последовательности.

Как и у суперглобальных переменных PHP, область действия констант носит глобальный характер. Поэтому Вы можете всегда получить доступ к константам из любого места вашего скрипта и независимо от масштаба проекта.

Простой пример определения констант в PHP:

Ну а теперь Вашему вниманию будет представлен наиболее полный список констант WordPress 3.3.x с описаниями и указанием значений, которые могут быть определены каждой константой.

В связи с тем, что информации на этой странице много, для удобства обзора список констант WordPress разбит по категориям, которые по сути являются якорными ссылками. Так что кликнув по ссылке категории Вы сразу переместитесь на соответствующую категорию констант.

Константы WordPress

• Базовые
• Темы
• Статус, состояние
• Пути, каталоги, ссылки
• Файловая система и соединения
• База данных
• Кэш и компрессия
• Отладка
• Защита и куки
• Мульти-сайт

Базовые

• AUTOSAVE_INTERVAL
  Определяет интервал времени в который WordPress должен делать автосохранения.
  Значение: время в секундах (по умолчанию: 60)
• CORE_UPGRADE_SKIP_NEW_BUNDLED
  Позволяет при апгрейде пропускать и не затрагивать новые группы файлов, таких как плагины или темы.
  Значение: true | false
• DISABLE_WP_CRON
  Отключает функцию WordPress для выполнения кода по расписанию (cron).
  Значение: true
• EMPTY_TRASH_DAYS
  Контролирует количество дней перед тем, чтобы WordPress удалил записи, страницы, вложения и комментарии (posts, pages, attachments, comments) из корзины (trash bin).
  Значение: количество дней (по умолчанию: 30)
• IMAGE_EDIT_OVERWRITE
  Позволяет WordPress переопределить изображение после редактирования или сохранить его как копию.
  Значение: true | false
• MEDIA_TRASH
  Включает или отключает функцию «корзины» для медиа-файлов.
  Значение: true | false (по умолчанию: false)
• WPLANG
  Определяет язык, который должен использовать WordPress.
  Значение: ru_RU (для русского)
• WP_DEFAULT_THEME
  Определяет тему по умолчанию для новых сайтов и также используется в качестве запасного варианта для сломанных тем WordPress.
  Значение: название темы (по умолчанию: twentyeleven)
• WP_CRON_LOCK_TIMEOUT
  Определяет интервал времени, в течении которого только одна задача, выполняемая по расписанию (cronjob), будет выполняться. Введено начиная с WordPress 3.3.
  Значение: время в секундах (по умолчанию: 60)
• WP_MAIL_INTERVAL
  Определяет интервал времени, в течении которого только один mail-запрос может быть выполнен.
  Значение: время в секундах (по умолчанию: 300)
• WP_POST_REVISIONS
  Включает, отключает или устанавливает количество ревизий (revisions) для записей. Значение большее 0 определяет максимальное количество ревизий для одной записи (поста). Подробно об использовании константы WP_POST_REVISIONS было изложено в статье об управлении ревизиями WordPress
  Значение: true | false | количество в цифрах (по умолчанию: true)
• WP_MAX_MEMORY_LIMIT
  Позволяет определить максимальный лимит памяти для некоторых функций WordPress.
  Значение: см. документацию PHP (по умолчанию: 256M)
• WP_MEMORY_LIMIT
  Определяет лимит памяти для скриптов WordPress.
  Значение: см. документацию PHP (по умолчанию: 32M, для Multisite 64M)

• Вернуться к оглавлению

Темы

• BACKGROUND_IMAGE
  Определяет фоновое изображение по умолчанию.
• HEADER_IMAGE
  Определяет изображение заголовка (шапки) по умолчанию.
• HEADER_IMAGE_HEIGHT
  Определяет высоту изображения заголовка (шапки).
• HEADER_IMAGE_WIDTH
  Определяет ширину изображения заголовка (шапки).
• HEADER_TEXTCOLOR
  Определяет цвет текста заголовка (шапки).
• NO_HEADER_TEXT
  Включает или отключает поддержку текста заголовка (шапки).
  Значение: true | false
• STYLESHEETPATH
  Определяет абсолютный путь к таблице стилей (stylesheet) текущей темы.
• TEMPLATEPATH
  Определяет абсолютный путь к файлам шаблона текущей темы.
• WP_USE_THEMES
  Включает или отключает загрузку тем.
  Значение: true | false

• Вернуться к оглавлению

Статус, состояние

• APP_REQUEST
  Будет определена, если выполняется запрос Atom Publishing Protocol.
  Значение: true
• COMMENTS_TEMPLATE
  Будет определена, если загружен шаблон комментариев.
  Значение: true
• DOING_AJAX
  Будет определена, если выполняется запрос AJAX.
  Значение: true
• DOING_AUTOSAVE
  Будет определена, если WordPress выполняет автосохранение для записей.
  Значение: true
• DOING_CRON
  Будет определена, если WordPress выполняет задачу по расписанию (cronjob).
  Значение: true
• IFRAME_REQUEST
  Будет определена, если выполняется запрос IFRAME.
  Значение: true
• IS_PROFILE_PAGE
  Будет определена, если пользователь изменяет настройки своего профиля.
  Значение: true
• SHORTINIT
  Может быть определена для частичной загрузки WordPress.
  Значение: true
• WP_ADMIN
  Будет определена, если выполняется запрос из панели администратора WordPress.
  Значение: true
• WP_BLOG_ADMIN
  Будет определена, если выполняется запрос в /wp-admin/.
  Значение: true
• WP_IMPORTING
  Будет определена, если WordPress импортирует данные.
  Значение: true
• WP_INSTALLING
  Будет определена, во время новой инсталяции или апгрейда.
  Значение: true
• WP_INSTALLING_NETWORK
  Будет определена, если это запрос к network admin или устанавливается network. Добавлена в WordPress 3.3, раньше была WP_NETWORK_ADMIN_PAGE.
  Значение: true
• WP_LOAD_IMPORTERS
  Будет определена при открытии обзора импорта в панели управления (Tools -> Importer).
  Значение: true
• WP_NETWORK_ADMIN
  Будет определена, если идет запрос к /wp-admin/network/.
  Значение: true
• WP_REPAIRING
  Будет определена, если идет запрос к /wp-admin/maint/repair.php.
  Значение: true
• WP_SETUP_CONFIG
  Будет определена, если WordPress будет устанавливаться или конфигурироваться.
  Значение: true
• WP_UNINSTALL_PLUGIN
  Будет определена, если плагин будет деинсталироваться (для uninstall.php).
  Значение: true
• WP_USER_ADMIN
  Будет определена, если идет запрос к /wp-admin/user/.
  Значение: true
• XMLRPC_REQUEST
  Будет определена, если идет запрос через XML-RPC API.
  Значение: true

• Вернуться к оглавлению

Пути, каталоги, ссылки

• ABSPATH
  Абсолютный путь к корневому каталогу WordPress.
  По умолчанию: путь к файлу wp-load.php
• WPINC
  Относительный путь к каталогу /wp-includes/. Его нельзя изменить.
  По умолчанию: wp-includes
• WP_LANG_DIR
  Абсолютный путь к каталогу с языковыми файлами.
  По умолчанию: WP_CONTENT_DIR /languages или WP_CONTENT_DIR WPINC /languages
• WP_PLUGIN_DIR
  Абсолютный путь к каталогу плагинов.
  По умолчанию: WP_CONTENT_DIR /plugins
• WP_PLUGIN_URL
  URL каталога плагинов.
  По умолчанию: WP_CONTENT_URL /plugins
• WP_CONTENT_DIR
  Абсолютный путь к каталогу wp-content
  По умолчанию: ABSPATH wp-content
• WP_CONTENT_URL
  URL катлога wp-content
  По умолчанию: {URL сайта}/wp-content
• WP_HOME
  URL домашнего каталога WordPress
• WP_SITEURL
  URL корневого каталога WordPress
• WP_TEMP_DIR
  Абсолютный путь к каталогу, в который могут сохраняться временные файлы
• WPMU_PLUGIN_DIR
  Абсолютный путь к каталогу плагинов типа «Must Use Plugins»
  По умолчанию: WP_CONTENT_DIR /mu-plugins
• WPMU_PLUGIN_URL
  URL каталога плагинов типа «Must Use Plugins»
  По умолчанию: WP_CONTENT_URL /mu-plugins

Справка по «Must Use Plugins»:
Согласно Codex WordPress под «Must Use Plugins» или «mu-plugins» подразумеваются плагины, которые установлены в специальный каталог контента, и они автоматически включены для всех сайтов при установке WordPress. Плагины «Must Use Plugins» не показываются на странице плагинов в панели управления администратора и не могут быть отключены, за исключением разве что путем их удаления из каталога «must-use», который по умолчанию находится в wp-content/mu-plugins. Чтобы изменить каталог по умолчанию вручную, нужно определить константы WPMU_PLUGIN_DIR и WPMU_PLUGIN_URL в файле wp-config.php.

• Вернуться к оглавлению

Файловая система и соединения

• FS_CHMOD_DIR
  Определяет права доступа для каталогов
  Значение: см. докуметацию PHP (По умолчанию: 0755)
• FS_CHMOD_FILE
  Определяет права доступа для файлов
  Значение: см. докуметацию PHP (По умолчанию: 0644)
• FS_CONNECT_TIMEOUT
  Определяет таймаут для создания соединения
  Значение: время в секундах (По умолчанию: 30)
• FS_METHOD
  Определяет метод соединения с файловой системой
  Значение: direct | ssh | ftpext | ftpsockets
• FS_TIMEOUT
  Определяет таймаут после потери соединения
  Значение: время в секундах (По умолчанию: 30)
• FTP_BASE
  Путь к корневому каталогу WordPress
  По умолчанию: ABSPATH
• FTP_CONTENT_DIR
  Путь к каталогу /wp-content/
  По умолчанию: WP_CONTENT_DIR
• FTP_HOST
  Определяет хост для FTP
  Значение: IP адрес, домен и/или порт
• FTP_LANG_DIR
  Путь к каталогу с языковыми файлами
  По умолчанию: WP_LANG_DIR
• FTP_PASS
  Определяет пароль для FTP
• FTP_PLUGIN_DIR
  Путь к каталогу плагинов
  По умолчанию: WP_PLUGIN_DIR
• FTP_PRIKEY
  Определяет private key для SSH
• FTP_PUBKEY
  Определяет public key для SSH
• FTP_SSH
  Включает или отключает SSH
  Значение: true | false
• FTP_SSL
  Включает или отключает SSL
  Значение: true | false
• FTP_USER
  Определяет имя пользователя для FTP
• WP_PROXY_BYPASS_HOSTS
  Позволяет определить адреса, которые не должны соединяться через прокси
  Значение: www.somesite.net, *.somesite.org
• WP_PROXY_HOST
  Определяет адрес прокси
  Значение: IP адрес или домен
• WP_PROXY_PASSWORD
  Определяет пароль для прокси
• WP_PROXY_PORT
  Определяет порт для прокси
• WP_PROXY_USERNAME
  Определяет имя пользователя для прокси
• WP_HTTP_BLOCK_EXTERNAL
  Позволяет блокировать внешние запросы
  Значение: true | false
• WP_ACCESSIBLE_HOSTS
  Если определена WP_HTTP_BLOCK_EXTERNAL, то можно добавить хосты, которые не будут блокироваться (белый список)
  Значение: www.somesite.net, *.somesite.org

• Вернуться к оглавлению

База данных

• DB_CHARSET
  Определяет кодировку (charset) базы данных
  Значение: см. докуметацию MySQL (По умолчанию: utf8)
• DB_COLLATE
  Определяет тип сравнения (collation) для базы данных
  Значение: см. докуметацию MySQL (По умолчанию: utf8_general_ci)
• DB_HOST
  Определяет хост (host) базы данных
  Значение: IP адрес, домен и/или порт (По умолчанию: localhost)
• DB_NAME
  Определяет имя базы данных
  Значение: имя базы данных
• DB_PASSWORD
  Определяет пароль к базе данных
  Значение: пароль к базе данных
• DB_USER
  Определяет пользователя базы данных
  Значение: ник пользователя
• WP_ALLOW_REPAIR
  Позволяет автоматически восстанавливать и оптимизировать таблицы базы данных используя /wp-admin/maint/repair.php.
  Значение: true
• CUSTOM_USER_TABLE
  Позволяет определить собственную таблицу «user»
  Значение: имя таблицы
• CUSTOM_USER_META_TABLE
  Позволяет определить собственную таблицу «user meta»
  Значение: имя таблицы

• Вернуться к оглавлению

Кэш и компрессия

• WP_CACHE
  Если определена, то WordPres сможет загружать файл /wp-content/advanced-cache.php
  Значение: true | false (По умолчанию: false)
• COMPRESS_CSS
  Включает или отключает компрессию таблиц стилей (stylesheets).
  Значение: true | false
• COMPRESS_SCRIPTS
  Включает или отключает компрессию файлов JavaScript.
  Значение: true | false
• CONCATENATE_SCRIPTS
  Включает или отключает объединение файлов JavaScript или CSS перед компрессией.
  Значение: true | false
• ENFORCE_GZIP
  Включает или отключает сжатие gzip
  Значение: true | false

• Вернуться к оглавлению

Отладка

• SAVEQUERIES
  Включает или отключает запись запросов к базе данных в массив ($wpdb->queries).
  Значение: true | false
• SCRIPT_DEBUG
  Включает или отключает загрузку упакованных файлов CSS и JavaScript.
  Значение: true | false
• WP_DEBUG
  Включает или отключает режим отладки WordPress.
  Значение: true | false (По умолчанию: false)
• WP_DEBUG_DISPLAY
  Включает или отключает вывод ошибок на экран.
  Значение: true | false | null (По умолчанию: true)
• WP_DEBUG_LOG
  Включает или отключает запись ошибок в файл /wp-content/debug.log
  Значение: true | false (По умолчанию: false)

• Вернуться к оглавлению

Защита и куки

• ADMIN_COOKIE_PATH
  Путь к каталогу /wp-admin/
  По умолчанию: SITECOOKIEPATH wp-admin или для Мульти-сайта подкаталог SITECOOKIEPATH
• ALLOW_UNFILTERED_UPLOADS
  Позволяет админам делать загрузки без фильтрования
  Значение: true
• AUTH_COOKIE
  Имя Cookie для авторизации
  По умолчанию: wordpress_ COOKIEHASH
• AUTH_KEY
  Секретный ключ
  Значение: текстовый ключ
• AUTH_SALT
  Секретный ключ
  Значение: текстовый ключ
• COOKIEHASH
  Хэш для генерации имен cookie
• COOKIEPATH
  Путь к корневому каталогу WordPress.
  По умолчанию: домашний URL без http(s)://
• COOKIE_DOMAIN
  Домен инсталяции WordPress
  По умолчанию: false или для Мульти-сайт с поддоменами .domain главного сайта
• CUSTOM_TAGS
  Позволяет переопределять список секьюрити-меток HTML. Смотреть в /wp-includes/kses.php.
  Значение: true | false (По умолчанию: false)
• DISALLOW_FILE_EDIT
  Позволяет запретить редактирование тем и плагинов с использованием редактора WordPress.
  Значение: true
• DISALLOW_FILE_MODS
  Позволяет запретить редактирование, обновление, установку и удаление плагинов, тем и основных файлов WordPress из панели управления.
  Значение: true
• DISALLOW_UNFILTERED_HTML
  Позволяет запретить нефильтрованные HTML для всех пользователей, включая админа.
  Значение: true
• FORCE_SSL_ADMIN
  Активирует SSL для логинов и в панели управления.
  Значение: true | false (По умолчанию: false)
• FORCE_SSL_LOGIN
  Активирует SSL для логинов.
  Значение: true | false (По умолчанию: false)
• LOGGED_IN_COOKIE
  Имя Cookie для логинов.
  По умолчанию: wordpress_logged_in_ COOKIEHASH
• LOGGED_IN_KEY
  Секретный ключ
  Значение: текстовый ключ
• LOGGED_IN_SALT
  Секретный ключ
  Значение: текстовый ключ
• NONCE_KEY
  Секретный ключ
  Значение: текстовый ключ
• NONCE_SALT
  Секретный ключ
  Значение: текстовый ключ
• PASS_COOKIE
  Имя Cookie для пароля
  По умолчанию: wordpresspass_ COOKIEHASH
• PLUGINS_COOKIE_PATH
  Путь к каталогу плагинов
  По умолчанию: WP_PLUGIN_URL без http(s)://
• SECURE_AUTH_COOKIE
  Имя Cookie для SSL авторизации
  По умолчанию: wordpress_sec_ COOKIEHASH
• SECURE_AUTH_KEY
  Секретный ключ
  Значение: текстовый ключ
• SECURE_AUTH_SALT
  Секретный ключ
  Значение: текстовый ключ
• SITECOOKIEPATH
  Путь к сайту
  По умолчанию: URL сайта без http(s)://
• TEST_COOKIE
  Имя Cookie для тестового cookie
  По умолчанию: wordpress_test_cookie
• USER_COOKIE
  Имя Cookie для пользователей
  По умолчанию: wordpressuser_ COOKIEHASH

• Вернуться к оглавлению

Мульти-сайт

• ALLOW_SUBDIRECTORY_INSTALL
  Позволяет установить Мульти-сайт в подкаталог (поддомен).
  Значение: true
• BLOGUPLOADDIR
  Абсолютный путь к каталогу «upload» конкретного блога.
  По умолчанию: WP_CONTENT_DIR /blogs.dir/{ID блога}/files/
• BLOG_ID_CURRENT_SITE
  ID блога основного сайта.
  По умолчанию: 1
• DOMAIN_CURRENT_SITE
  Домен основного сайта.
  По умолчанию: домен
• DIEONDBERROR
  Если определена, то ошибки базы данных будут выводиться на экран.
  Значение: true
• ERRORLOGFILE
  Если определена, то ошибки базы данных будут записываться в лог-файл
  Значение: абсолютный путь к файлу с доступом на запись
• MULTISITE
  Будет определена, если используется режим Мульти-сайт.
  Значение: true
• NOBLOGREDIRECT
  Определяет URL сайта на который WordPress будет редиректить запросы, если регистрация закрыта или сайт не существует.
  Значение: %siteurl% для главного сайта или специфический URL
• PATH_CURRENT_SITE
  Путь к основному сайту
• UPLOADBLOGSDIR
  Путь к базовому каталогу upload, в зависимости от ABSPATH
  По умолчанию: wp-content/blogs.dir
• SITE_ID_CURRENT_SITE
  Network ID главного сайта
  По умолчанию: 1
• SUBDOMAIN_INSTALL
  Определяет, идет ли инсталяция в поддомен или нет.
  Значение: true | false
• SUNRISE
  Если определена, то WordPres будет загружать файл /wp-content/sunrise.php
  Значение: true
• UPLOADS
  Путь к каталогу upload специфическому для сайта, зависит от ABSPATH
  По умолчанию: UPLOADBLOGSDIR /{blogid}/files/
• WPMU_ACCEL_REDIRECT
  Включает или отключает поддержку для X-Sendfile Header
  Значение: true | false (По умолчанию: false)
• WPMU_SENDFILE
  Включает или отключает поддержку для X-Accel-Redirect Header
  Значение: true | false (По умолчанию: false)
• WP_ALLOW_MULTISITE
  Если определена, то будет доступна функция Мульти-сайт (Tools -> Network Setup).
  Значение: true

• Вернуться к оглавлению

На этом список констант WordPress исчерпан. Возможно в следующих за WordPress 3.3.1 версиях появятся новые константы или некоторые, из существующих на данный момент, будут удалены или изменены. Надеюсь предоставленная информация поможет Вам в создании плагинов и более тонкой настройке сайта или блога.

Уважаемые посетители блога 4remind.ru, если Вы обнаружили ошибку в описаниях или обозначениях констант, просьба сообщить об этом в комментариях к этой статье.
Заранее спасибо.

Удачи Вам в использовании констант WordPress!

Метки: WordPress, константы