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

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

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


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

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

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

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

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

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

<?php
	// Правильно
	define( "BANYA", "banya" );
	define( "DACHA", "moya dacha" );
	define( "BANYA_DACHA", "banya na dache" );
	define( "SUMMA", 12345 );

	// ОШИБКА - имя константы НЕ должно начинаться с цифры
	define( "2BANI", "dve bani" );
?>

Ну а теперь Вашему вниманию будет представлен наиболее полный список констант 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!

Метки: ,
Другие статьи похожей тематики:

Поделитесь материалом с другими, воспользуйтесь этими кнопками:
Получать обновления и новые материалы блога по E-mail

6 комментариев к “Константы WordPress, полный список констант”

  1. Евгений:

    Отлично. раньше о константах вообще не знал.

  2. Кстати, мне уже начали задавать вопросы по «Must Use Plugins», что это такое и для чего они…

    И хотя об этом написано в Кодексе WordPress, я все же добавил в этой статье в конце категории констант «Пути, каталоги, ссылки» справку по «Must Use Plugins».

  3. Serge:

    Спасибо Большое!!!

  4. УтБ:

    Интересно, спасибо за то, что собрано и разделено, в закладки ;)

  5. Rymljanyn:

    Автору +++. Блог в закладках

  6. Dummies:

    Отлично, давно собирался найти перечень констант, спасибо!

Оставить комментарий

Подписаться на обновления блога 4remind.ru по RSS
Новости блога в социальных сетях

="4remind.ru

Rambler's Top100
Рейтинг@Mail.ru


Яндекс.Метрика