Уважаемые подписчики и посетители блога 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, константы
Отлично. раньше о константах вообще не знал.
Кстати, мне уже начали задавать вопросы по «Must Use Plugins», что это такое и для чего они…
И хотя об этом написано в Кодексе WordPress, я все же добавил в этой статье в конце категории констант «Пути, каталоги, ссылки» справку по «Must Use Plugins».
Спасибо Большое!!!
Интересно, спасибо за то, что собрано и разделено, в закладки ;)
Автору +++. Блог в закладках
Отлично, давно собирался найти перечень констант, спасибо!