Русский WordPress 2.3.2 (сборка maxsite.org) Версия этого файла: 30 декабря 2007 г. Этот файл содержит важную информацию по установке WordPress. 1. Основные моменты 2. Порядок установки 3. Разная кодировка блога и базы данных 4. Новая установка или обновление? 5. Описание настроек wp-config.php 6. Установка с нуля 7. Обновление с версии 2.2.* 8. Обновление с версий 2.0.* - 2.1.* 9. Особенности этой сборки 10. Решение известных проблем 11. Прочее ОТЛИЧИЕ ЭТОЙ ВЕРСИИ ОТ ПРЕДЫДУЩИХ ВЕРСИЙ WORDPRESS СБОРКИ MAXSITE.ORG --------------------------------------------------------------------- Перевод предыдущих версии WordPress был выполнен прямо в php-файлах, поэтому не требовались никакие сторонние модули переводов (так называемые po-файлы). Начиная с версии 2.3.1 русский перевод будет находиться в отдельных po-файлах. Но поскольку полный перевод занимает большой объем - в нем в основном содержится перевод админ-панели, то я решил разделить этот файл на две части. Первая - полный перевод. Второй - lite (минимальный). Для обычных посетителей будет подгружаться небольшой lite-файл. Но как только вы обратитесь к админ-панели, то автоматически загрузится полный файл перевода. Таким образом мы исключаем бессмысленную загрузку большого файла перевода каждый раз для любого посетителя. Можно сравнить: полный перевод - 213Кб, lite - 33Кб. Если вы обновляете WordPress с предыдущих сборок, возьмите новый файл wp-config.php - в нем НЕ ДОЛЖНО быть строчки define ('WPLANG', ''); Значение WPLANG определяет подключаемый файл словаря и выполняется это автоматически в wp-language.php - этот файл также следует обновить. ------------------- 1. Основные моменты ------------------- Первое правило: ваш блог будет работать только в UTF-8. Все остальные кодировки не позволят корректно работать вашему блогу из-за того, что в WordPress включена поддержка AJAX. Второе правило: в этой сборке я использую алгоритмы, позволяющие корректно работать вашему блогу с любой кодировкой базы данных. То есть ваша база данных, в отличие от вашего блога может работать в любой кодировке, например cp1251. -------------------- 2. Порядок установки -------------------- Базовые настройки находятся в файле wp-config-sample.php. Даже если вы обновляете свой блог со старой версии, ОБЯЗАТЕЛЬНО возьмите новую версию этого файла! | Далее по тексту: когда речь идет о wp-config-sample.php, то | подразумевается один из файлов wp-config-sample-utf8.php или | wp-config-sample-win1251.php, где хранятся типичные конфигурации | (описание см. ниже). Перед началом инсталяции скопируйте файл wp-config-sample.php как wp-config.php. После этого откройте его текстовым редактором Notepad2 и добавьте необходимые настройки (см. п.4). | Как оказалось, обычный Блокнот некорректно сохраняет данные в UTF-8, | поэтому возникло множество вопросов и ошибок. Я рекомендую воспользоваться | программой Notepad2: http://www.flos-freeware.ch/ | Основным признаком того, что файл сохранен неверно, является ошибка | "Cannot modify header information - headers..." | См.: http://forum.maxsite.org/viewtopic.php?id=1075 --------------------------------------- 3. Разная кодировка блога и базы данных --------------------------------------- Внимательно отнеситесь к этому пункту, поскольку большинство ошибок в работе блогов на WordPress кроется именно в неверно выбранной кодировке. Очень часто хостер (сервер) предоставляет базу данных MySQL в кодировке cp1251 (windows-1251). Из-за того, что ваш блог всегда будет работать в UTF-8, то база данных может неверно отображать некоторые символы (часто буквы "и" и "ш"), будет неверно работать сортировка и поиск по сайту. Кроме этого вы не сможете делать корректный бэкап (резервное копирование). Уточните у вашего хостера, какая версия MySQL стоит на сервере. Так же вам стоит поинтересоваться какая кодировка базы данных используется по-умолчанию (на русскоязычных хостингах обычно установлена "cp1251"). Дальше следуйте этой схемы: - если версия MySQL меньше 4.1, то ваша база данных должна работать в кодировке cp1251 (или любая другая, но не utf8). Это означает, что вам следует ВКЛЮЧИТЬ перекодирование (см. п.5). - если версия MySQL больше либо равна 4.1, то ваша база данных может работать в кодировке utf8. Скорее всего, ваш хостинг позволит корректно установить эту кодировку, поэтому перекодирование НЕ НУЖНО. Если же после установки WordPress'а вы заметили ошибки, связанные с неверным отображением символов, то скорее всего база банных не позволяет корректно работать в utf-8, и следовательно, вам нужно включить перекодирование. ---------------------------------- 4. Новая установка или обновление? ---------------------------------- Если вы устанавливаете начисто, то главное ваше действие это заполнить wp-config.php. После этого вам достаточно будет зайти на сайт и WordPress сам предложит выполнить инсталяцию. Просто следуйте инструкции. Если же вы обновляете WordPress, то вам следует выполнить дополнительные инструкции (см. пп. 7-8). ---------------------------------- 5. Описание настроек wp-config.php ---------------------------------- Здесь приведены те настройки файла конфигурации, которые вы можете изменять и те, которые следует оставить без изменений. Для удобства я сохранил комментарии из файла wp-config.php ************************************************* define('DB_NAME', ''); # название базы данных define('DB_USER', ''); # пользователь MySQL define('DB_PASSWORD', ''); # пароль define('DB_HOST', 'localhost'); # в 99% случаев используется этот хост ::: Настройки доступа к MySQL define('DB_CHARSET', 'utf8'); # кодировка базы данных ::: Укажите здесь кодировку вашей базы данных. Обычно она utf8. Если версия ::: MySQL<4.1, то этот параметр будет проигнорирован. Если вы укажете пустое ::: значение (''), то принудительная установка кодировки будет проигнорирована. ::: Если вы будете выполнять конвертирование, то укажите пустое значение. define('DB_COLLATE', 'utf8_general_ci'); # кодировка, в которой хранятся данные ::: Укажите здесь кодировку сопоставления (сравнения). Этот параметр ::: позволяет отдельным таблицам базы данных хранить записи в другой ::: кодировке. Желательно установить его в туже кодировку, что и кодировку ::: базы данных (DB_CHARSET): utf8_general_ci или cp1251_general_ci $table_prefix = 'wp_'; # префикс таблиц ::: Укажите префикс таблиц WordPress. Вы можете устанавливать несколько ::: WordPress'ов в одну базу данных. Просто укажите для них разный префикс. define('DISABLE_CACHE', ''); ::: Перед установкой рекомендуется отключить кэширование данных. ::: После установки, когда вы убедитесь, что WordPress работает как ::: положено, вы можете закомментировать эту строчку (добавить в начало "//"). define('MAXSITE_DB_CONVERT', false); # true - разрешить, false - запретить ::: Описание см. п. 3. Обратите внимание, нужно ли использовать ::: перекодирование вам следует ДО НАЧАЛА УСТАНОВКИ! define('MAXSITE_DB_CHARSET', 'WINDOWS-1251'); # WINDOWS-1251 или UTF-8 ::: Если вы разрешили перекодирование, то здесь следует указать кодировку ::: в которую следует конвертировать тексты в базу данных. Работает только ::: если MAXSITE_DB_CONVERT=true. Именно в этой кодировке будут храниться ::: записи в базе данных. define('MAXSITE_CHARSET_BLOG', 'UTF-8'); # кодировка блога - всегда UTF-8! ::: Кодировка вашего блога. Никогда не меняйте этот параметр! ************************************************* Возможно, кому-то покажется, что эти настройки сложны. Для тех, кто не желает разбираться во всех технических нюансах, я сделал два файла-шаблона: wp-config-sample-utf8.php - для тех, у кого база данных работает в UTF-8 и wp-config-sample-win1251.php - для тех, у кого база данных работает в Windows-1251 и требуется перекодировка Выберите нужный файл. Далее по тексту, когда я пишу о файле wp-config-sample.php, то подразумевается один из этих двух файлов. ------------------- 6. Установка с нуля ------------------- * Загрузите файлы WordPress на сервер. * Установите права доступа на каталоги /wp-content/cache/ и /wp-content/uploads/ «777» или «755» (зависит от хостинга), то есть разрешающие запись. * Установите права «666» на файл «.htaccess». Если такого файла нет, его нужно создать - это обычный текстовый файл. (После установки ЧПУ, права нужно установить в «644») * Откройте файл wp-config-sample.php. Укажите в нем необходимые параметры, как указано выше. * Сохраните этот файл под именем wp-config.php и загрузите на сервер. * С помощью браузера зайдите на свой сайт. Появится сообщение с приглашением установить WordPress. Следуйте инструкции. После установки, WordPress вышлет на указанный вам адрес параметры доступа (логин и пароль). | Если вы выполняете установку на локальном компьютере (localhost), то после | установки WordPress, запишите логин и пароль, который он вам выдаст. | Поскольку у вас не работает mail-сервер, то вы не получите извещение | с этими данными на электронный ящик. ------------------------------------ 7. Обновление с версий 2.2.* - 2.3.* ------------------------------------ Если у вас предыдущая версия сборки maxsite.org, то обновление выполняется довольно просто. 1. Сделайте полный бэкап файлов и базы данных. В случае проблем, вы сможете восстановить старый блог. 2. Переключитесь на default-шаблон. 3. Отключите все плагины. 4. Отключите кеширование в wp-config.php: define('DISABLE_CACHE', ''); - строчка должна быть НЕзакомментированой. 5. Нажмите ссылку «Выход». Не пропускайте этот шаг! 6. Загрузите новые файлы WordPress на сервер. Можно просто скопировать и заменить все старые. 7. В wp-config.php удалите строчку define ('WPLANG', ''); 8. Наберите в браузере http://ваш сайт/wp-admin/upgrade.php 9. На предложение обновить базу данных, ответьте согласием. 10. Войдите в админ-панель и переключитесь на свой шаблон. Если он работает, то можно активировать нужные плагины. Обращаю ваше внимание, что версия WordPress 2.3 имеет серьезные отличия от 2.1-2.2, поэтому некоторые плагины могут работать некорректно. Прежде всего это связано с рубриками и ссылками. ------------------------------------ 8. Обновление с версий 2.0.* - 2.1.* ------------------------------------ Главная проблема обновления будет заключаться в изменяемой кодировке базы данных. Если вы обновляетесь с версии 2.1.*, то вы можете установить нужные параметры и ОТКЛЮЧИТЬ перекодирование. С большой долей вероятности, ваш блог уже работает в UTF-8, поэтому, все, что вам нужно сделать, так это просто загрузить файлы новой версии на сервер и зайти в админ-панель. WordPress автоматически предложит выполнить обновление (всего один шаг). | Вам все равно нужно взять новый wp-config-sample.php! ВАЖНО! Для версий 2.0.* нужно вначале обновиться хотя бы до 2.0.9. Если этого не сделать, то возникают проблемы с доступом в админ-панель. Если же ваша версия 2.0.* или меньше, то для вас будет очень важно определить текущую кодировку базы данных. Если при этом ваш блог работает в Windows-1251, то вам следует ВКЛЮЧИТЬ перекодирование (поскольку ваша база данных скорее всего работает в Windows-1251). Если вы этого не сделаете, то данные могут оказаться испорченными. | Важный момент. Перекодирование не меняет кодировку текстов. Перекодировщик | работает "на лету": получаемые из БД тексты просто конвертируются в UTF-8. | Поэтому для уже существующих блогов можно включать/отключать | конвертирование и проверять работу сайта. Главное, чтобы во время | настройки вы не меняли никаких параметров WordPress и не редактировали | тексты: при неверной кодировке, вы получите нечитабельный текст. Если же ваш блог работает в UTF-8 и версия 2.0.* или меньше, то, вам следует ОТКЛЮЧИТЬ перекодирование (поскольку ваша база данных скорее всего работает в UTF-8). ВАЖНО! Обновление или установка WordPress пройдет быстрее, чем вы читали этот текст. Но, поскольку на наших хостингах встречаются самые разные настройки баз данных, то В ОБЯЗАТЕЛЬНОМ ПОРЯДКЕ ПЕРЕД ОБНОВЛЕНИЕМ СДЕЛАЙТЕ БЭКАП БАЗЫ ДАННЫХ! Только в этом случае, при возниконвении проблем, вы сможете вернуть свою старую версию WordPress и сохранить все свои тексты. Бэкап нужно делать с помощью утилиты phpMyAdmin. Следуйте этой инструкции при обновлении блога. * Перед началом установки WordPress, вам нужно переключить тему на Default, а также деактивировать все плагины. * Отключите кэш (в wp-config.php: define('DISABLE_CACHE', ''); ). Для надежности вы можете переименовать или удалить каталог "wp-content/cache". Если после его удаления кэш все равно создается, значит он включен. Попробуйте поставить на него права 755 (запрещающие запись). Это важный шаг, не пропускайте его, иначе после обновления вы не сможете попасть в админ-панель. * Войдите в Настройки - Чтение и укажите кодировку "UTF-8", если она другая. * Разлогиньтесь (нажмите ссылку "Выход"). Обязательно! * С помощью phpMyAdmin сделайте полный бэкап базы данных. * Через FTP переименуйте старый каталог "wp-admin" в "wp-admin-old". * Тоже самое сделайте с каталогом "wp-includes" (в "wp-includes-old") * Переиместите каталог "wp-content/themes/default" в "wp-content/default-old". Это нужно сделать поскольку в новой версии используется новый шаблон Default. * Все файлы, которые находятся в главном каталоге WordPress необходимо переместить в отдельный каталог, Например, "wp-old". * Сохраните старые "wp-config.php" и ".htaccess". В первом файле указаны параметры доступа к базе данных. | В случае проблем, вы сможете вернуть старые файлы. * Загрузите себе на компьютер старый wp-includes/wp-db.php. Откройте его обычным блокнотом и проверьте на наличите команды "SET NAMES" в самом конце файла. Если она включена (не закомментирована "//"), то её следует включить в wp-config.php (параметры DB_CHARSET). * Откройте wp-config-sample.php и выставьте необходимую конфигурацию. Сохраните файл как wp-config.php. | Выберите wp-config-sample-utf8.php или wp-config-sample-win1251.php * После этого загрузите все файлы новой версии на сервер. * Зайдите в админ панель: http://ваш сайт/wp-admin. WordPress сам предложит обновить свою базу. * Попробуйте войти в админ-панель по адресу: http://ваш сайт/wp-admin/ Если при попытке входа WordPress выдает сообщение о неверном пароле/логине или истекшей сессии, сбросьте кэш браузера (Ctrl+F5 или Shift+F5). Если и после этого WordPress выдает сообщени об ошибке, то откройте файл wp-config.php и в самом конце файла уберите комментарий ("//") со строчки (второй этап инсталяции): require_once(ABSPATH . 'wp-upgrade-all.php'); maxsite_wp_upgrade(); После этого зайдите на свой сайт (сбросьте кэш браузера: Ctrl+F5 или Shift+F5). Должно появиться сообщение: "UPDATE COMPLETED! Please modify file wp-config.php" После этого откройте wp-config.php и опять закоментируйте последнюю строчку. Теперь вы можете опять войти в админ-панель сайта (сбросьте кэш браузера: Ctrl+F5 или Shift+F5). * Проверьте работоспособность админ-панели и шаблона Default. Если текст отображается корректно, то вы можете последовательно подключить необходимые плагины. В случае, если плагин работает с ошибкой, то вы можете просто удалить его с сервера - WordPress его автоматически деактивирует. Также проверьте, возможно существует уже обновленная версия плагина на сайте разработчика. Вы можете переключиться на свой шаблон. Если он не работает, или работает с ошибкой (это не очень часто, но случается), то вам придется его исправлять. Обратите также внимание, что теперь ваш блог будет работать в UTF-8. Если до этого у вас он работал в Windows-1251, то вам нужно будет пересохранить файлы шаблона (и плагинов) в UTF-8. Сделать это можно с помощью Notepad2. -------------------------- 9. Особенности этой сборки -------------------------- * Русский перевод выполнил Иван Калинин (Lecactus ): http://lecactus.ru/. * Дополнительный перевод, как и прежде осуществляется с помощью файла wp-language.php. При необходимости, вы можете его отредактировать. * Я исправил ошибку WordPress при отправке трэкбаков. Как и во всех моих предыдущих версиях, ваш блог будет коректно указывать свою кодировку. * В сборку я добавил некоторые плагины: - Anti Spam Image (антиспам картинка) - BBCode (использование BBCode в текстах) - Feedburner Feed Replacement (заменяет RSS-адрес блога на Feedburner) - MaxSite Новости русского WordPress'а (RRS-новости русского WordPress) - MaxSite-социальные закладки (кнопки под записями) - MaxSite Links for all (поля под записями для копирования ссылок) - MaxSite Ushki (ушки) - Psevdo-Code (псевдокод) - Russian Date (дата по-русски) - RusToLat (транслитерация русских ссылок - обязательно включите!) - Simple Tags (расширенное управление метками) - Spam Viewer (просмотр спама) - Subscribe To Comments (подписка на комментарии) - Tag Managing Thing (управление метками) - WordPress Database Backup (бэкап базы данных) - WP-PageNavi (постраничная навигация в виде: [1][2][3][4]...) - WP Comment Quicktags Plus (кнопки форматирования в комментариях) - WP Grins (кликабельные смайлы в редакторе и комментариях) ----------------------------- 10. Решение известных проблем ----------------------------- Как показал опыт предыдущей версии, то львинная доля проблем возникает в следствие неверно выполненной перекодировки файлов. Большинство проблем уже обсуждалось в комментариях: http://maxsite.org/wp220rus#comments Кратко опишу основные моменты. ---------------------------------------------------------------------------- * У вас все сделано верно, но текст в браузере отображается в виде знаков вопросов. Просмотрите исходный код страницы. В нем должна быть указана кодировка UTF-8. Однако, если вы посмотрите в браузере: Вид - Кодировка -> Кириллица (Windows-1251), то это означает, что у вас на сервере стоит принудительная отсылка http-заголовка, где указана Windows-1251. Для того, чтобы это исправить нужно в файле .htaccess вашего сайта указать строчку: AddDefaultCharset UTF-8 Если это не поможет, то нужно дописать еще и эти: CharsetDisable On CharsetDefault UTF-8 CharsetSourceEnc UTF-8 Но вообще, загляните на форум вашего хостера. Если на сервере есть проблемы с кодировками, то обычно там приведены рецепты для нормальной работы с UTF-8. ---------------------------------------------------------------------------- * В браузере выдается ошибка "Cannot modify header information - headers..." Можно сказать, что вы неверно преобразовали в кодировку UTF-8. Ответ здесь: http://forum.maxsite.org/viewtopic.php?id=1075 ---------------------------------------------------------------------------- * У вас перестал работать визуальный редатор. Прежде всего убедитесь, что у вас он включен. Это можно сделать в "Профиль" - "Использовать визуальное редактирование". Если в самом редакторе отображаются две закладки "Визуально" и "Код", но панели форматирования нет, то вам нужно сделать следующее: - сбросьте кэш браузера (Ctrl+F5 в FireFox) - если это не помогло, то отключите все плагины и повторите предыдущий пункт. - если и это не помогло, то попробуйте открыть эту же страницу другим браузером или на другом компьютере. Если там все нормально, занчит дело в вашем браузере или компьютере (например срабатывает брандмауэр или баннерорезалка). ---------------------------------------------------------------------------- * После обновления блога вместо текста появились крокозяблы (блог в UTF-8). Прежде всего не паникуйте. Ваши данные никуда не пропали и не испортились. Проблема может заключаться в неверной кодировке сопоставления. Суть в том, что когда-то на вашем сервере стояла база данных MySQL в базовой кодировке CP1251. Но, вы создали блог в UTF-8. При этом кодировка сопоставления осталась CP1251 - это очень хорошо видно при просмотре таблиц в phpMyAdmin. После этого, ваш хостер сделал обновление MySQL и выставил базовую кодировку в UTF-8. Но у вас она осталась прежней: CP1251. Поэтому сейчас, когда выставляется DB_COLLATE как положено в UTF-8, вы и получаете крокозяблы. Решение очень простое. Прежде всего отключите перекодировщик: define('MAXSITE_DB_CONVERT', false); После этого попробуйте подобрать кодировку базы данных и сопоставления: define('DB_CHARSET', 'cp1251'); или define('DB_CHARSET', 'utf8'); define('DB_COLLATE', 'cp1251_general_ci'); или define('DB_COLLATE', 'utf8_general_ci'); Не удивляйтесь, если она окажется cp1251. ;-) Дополнительная информация: http://forum.maxsite.org/viewtopic.php?id=1342 ---------- 11. Прочее ---------- Если у вас возникли проблемы, то вы всегда сможете их задать на форумах поддержки русского WordPress'а: http://forum.maxsite.org/ Дополнительную информацию вы можете найти на сайте http://maxsite.org/ Помните, что WordPress - народное достояние! Если вы нашли в нем ошибку или недочет, то сообщите об этом на email: max-3000@list.ru Если это будет возможным, я её исправлю, и вам будут благодарны сотни, тысячи и даже миллионы блогеров! :-)