e107 Руководство по обновлению

Последняя информация
Пожалуйста, читайте документацию на e107.org с последней информацией об установке и обновлении. Если вы обновляетесь с версии 0.617 или более ранней, имеется отдельное руководство по обновлению. Информация на веб-сайте всегда акутальнее любой информации в этом файле. Имеется также дополнительная информация о решении пробем, которые могут появиться, а также о том, как настраивать и использовать E107.

0.6175 -> .7 | Подготовка | Обновление | Права доступа: Основные | Права доступа: Плагины | Решение проблем | Пользователям CVS | Предупреждение

Руководство по обновлению 0.6175 -> .7

Версия .7 сильно отличается от версии.617, поэтому bkwon составил полный список изменений версии .7 на e107faq.org. Информацию об изменениях в разных релизах версии 0.7 можно найти в документации на e107.org.

Подготовка

Если вы обновляете англоязычный сайт версии .617, то вам необходимо установить дополнительный английский языковой пакет в кодировке iso-8859-1, так как основной языковой пакет версии 0.7 имеет кодировку UTF. В противном случае контент вашего сайта будет отображаться некорректно.
Если ваш сайт версии .617 не англоязычный, то вы должны убедиться в наличии нужного языкового пакета от версии .7 и в том, что он имеет одну и ту же кодировку с вашим текущим языковым пакетом. В случае если кодировки пакетов отличаются, контент вашего сайта будет отображаться некорректно.
Плагины, которые вы используете в версии .617, могут не работать в версии .7. Поэтому вы должны проверить их на работоспособность перед обновлением.
Версия .7 была практически полностью переписана по сравнению с версией .617, по этой причине были внесены большие изменения в структуру базы данных. Поэтому необходимо сделать резервную копию базы данных вашего сайта с помощью PhpMyAdmin или любого другого SQL менеджера - не используйте встроенную в e107 функцию 'Резервное копирование БД', для данного случая она не подходит. Я знаю, что все всегда говорят вам делать резервные копии - но сейчас это по настоящему необходимо, так как мы ничем не сможем помочь в случае повреждения контента вашего сайта, а при таких больших изменениях в структуре базы данных это более чем вероятно.

Внимание!

В версии 0.6xx в файлах относящихся к htmlArea системы WYSIWYG существует серьезная уязвимость. Эти файлы должны быть немедленно удалены. Пожалуйста удалите следующие директории со всем их содержимым с вашего сервера:

e107_handlers/htmlarea/
e107_admin/htmlarea/

Обновление

Загрузите zip архив с версией .7 и соответствующий языковой пакет (English iso-8859-1 для англоязычных сайтов).
Пройдите авторизацию на вашем сайте и перейдите в раздел администрирования. В подразделе 'Техническое обслуживание' активируйте флаг технического обслуживания ('Админцентр' => 'Техническое обслуживание'). Это закроет посетителям доступ к вашему сайту на время обновления.
Проверьте целостность базы данных с помощью опции 'Админцентр' => 'База данных' => 'Проверка целостности БД'. Если вы получили сообщение об ошибках, то не продолжайте процесс обновления, до тех пор пока не исправите их.
Перейдите на главную страницу раздела администрирования.
Распакуйте содержимое zip архива с e107 и загрузите файлы на ваш сервер - перезаписав существующие файлы версии .617.
Распакуйте содержимое архива с языковым пакетом и загрузите файлы на сервер, перезаписав уже существующие.
Обновите главную страницу раздела администрирования в вашем браузере, после чего на экране появится кнопка 'Обновить'. Нажав на нее, вы перейдете на страницу обновления (также вы можете попасть на эту страницу через 'Админцентр' =>'База данных' => 'Проверить обновления').
Нажмите на кнопку 'Обновить с .617 на .7'. Запустится первый этап процесса обновления. Когда он завершится? вы увидите несколько новых кнопок предназначенных для обновления форума, контента и статистики. Даже если вы не используете эти возможности e107, все равно проведите их обновление.
Когда вы сделаете все обновления, кнопки на странице обновления исчезнут, и это значит, что вы закончили процесс обновления.
Воспользуйтесь опцией 'Проверка целостности БД', чтобы проверить прошло ли обновление без ошибок.

Вам может показаться, что пропали некоторые элементы e107 - форум, чат, управление контентом, ссылки, и т.д. ... Не беспокойтесь - все на месте! Большая часть основного функционала e107 была вынесена в отдельные плагины, которые находятся в разделе 'Админцентр' => 'Плагины'. Стоит заметить, что в процессе обновления контент со страницы ссылок вашего сайта будет перенесен из раздела 'Ссылки сайта' в плагин 'Ссылки'.
Обзоры, статьи и контент были вынесены в один плагин 'Управление Контентом'. Если вы использовали любую из этих возможностей в 0.6xx или хотите использовать новый плагин для нового контента, то вам нужно дополнительно поменять правда доступа к некоторым директориям. Для более подробной информации смотрите идущий далее раздел 'Права доступа'.
В версии .7 появилась новая тема, 'Jayya', разработанная для раздела администрирования и содержащая несколько новых опций предназначенных для более удобного управления e107. Если вы хотите использовать эту тему, то перейдите в 'Админцентр' => 'Менеджер тем' и поменяйте тему раздела администрирования на 'Jayya'.
По причине огромного количества изменений в версии .7, а также того, что код был практически полностью переписан, в процессе обновления могут появиться ошибки. Если вы нашли какую-то определенную ошибку, то пожалуйста сообщите о ней в разделе 'bugtracker' на e107.org, чтобы мы могли исправить ее в следующих версиях. Спасибо.

Права доступа: Основные

Следующие права доступа должны быть установлены для основных файлов и директорий e107 (большинство из них уже имеют нужные права доступа со времени предыдущей установки 0.6xx):

chmod 777: e107_themes/
chmod 777: e107_plugins/
chmod 777: e107_files/public/
chmod 777: e107_files/public/avatars/
chmod 777: e107_files/cache/

Права доступа: Плагины

Следующие права доступа должны быть установлены если в 0.6xx вы использовали функцию сбора статистики сайта или предполагаете использовать плагин 'Запись Статистики' в будущем:

chmod 777: e107_plugins/log/logs/

Следующие права доступа должны быть установлены если в 0.6xx вы использовали страницу ссылок сайта или планируете использовать новый плагин 'Страница Cсылок' в будущем:

chmod 777: e107_plugins/links_page/cat_images/
chmod 777: e107_plugins/links_page/link_images/

Следующие права доступа должны быть установлены если в 0.6xx вы использовали функции Обзоры / Статьи или Контент или предполагаете использовать новый плагин 'Управление Контентом' в будущем:

chmod 777: e107_plugins/content/images/cat/
chmod 777: e107_plugins/content/images/cat/16/
chmod 777: e107_plugins/content/images/cat/48/
chmod 777: e107_plugins/content/images/file/
chmod 777: e107_plugins/content/images/file/tmp/
chmod 777: e107_plugins/content/images/icon/
chmod 777: e107_plugins/content/images/icon/tmp/
chmod 777: e107_plugins/content/images/image/
chmod 777: e107_plugins/content/images/image/tmp/
chmod 777: e107_plugins/content/menus/

Решение проблем

Если в процессе обновления произошли какие-то ошибки, приведшие к неработоспособности вашего сайта - пожалуйста очистите кеш, удалив все php файлы в директории e107_files/cache/.

Пользователям CVS

При использовании для обновления с версии 0.6xx до версии 0.7 ночных CVS сборок или e107, загруженной напрямую из CVS репозитория, вам нужно проверить какую кодировку вы используете в настоящий момент в 0.6хх. Это можно узнать на главной странице в разделе администрирования в меню 'Информация о сайте' поле 'Кодировка'. Если в поле 'Кодировка' стоит значение 'utf-8', то вам нужно загрузить только основной zip архив и проводить обновление с помощью него. То есть текущая кодировка совпадает с кодировкой по умолчанию версии 0.7. Если же в поле 'Кодировка' стоит значение 'iso-8859-1' и у вас англоязычный сайт, то вы должны дополнительно к основному zip архиву загрузить английский языковой пакет в кодировке iso-8858-1 и перезаписать файлы языкового пакета из основного zip архива файлами этого пакета. Для не англоязычных сайтов следует убедиться, что вы загрузили соответствующий языковой пакет в той же самой кодировке, что и показанная в меню 'Информация о сайте'.

Предупреждение

Это программное обеспечение распространяется свободно и без каких либо гарантий, в полном соответствии с лицензией GNU GPL (включена в комплект поставки). Автор не несет ответственности за любые проблемы, возникшие из-за ошибок в данном программном обеспечении.