install-ru.txt

--------------------------------------------------------------------------------
                                (с) MaxSite CMS
--------------------------------------------------------------------------------

* Официальный сайт: http://max-3000.com/
* Блог разработчика: http://maxsite.org/
* Центр помощи: http://max-3000.com/help
* ЧАВО по MaxSite CMS для новичков: http://max-3000.com/page/faq
* Книга по MaxSite CMS: http://book.max-3000.com/
* Форум: http://forum.max-3000.com/
* MaxSite CMS на GitHub: http://max-3000.com/github
* Каталог шаблонов: http://forum.max-3000.com/viewforum.php?f=13
* Каталог плагинов: http://forum.max-3000.com/viewforum.php?f=17

(О наиболее частых проблемах установки см. в конце этого файла)

==================
ТРЕБОВАНИЯ СИСТЕМЫ
==================
1. Возможность работы с .htaccess и включенный mod_rewrite.
2. MySQL > 4.1. Работа в UTF8. Тип базы MyISAM.
3. PHP > 5.2.4. (Для PHP 5.4 см. решение ниже)


=========
УСТАНОВКА
=========

Установка системы происходит очень быстро. Перед началом работы нужно будет 
указать в конфигурационных файлах параметры доступа к БД. После этого система 
сама выполнит инсталяцию. 

(Презентация на сайте: http://max-3000.com/page/kak-ustanovit-maxsite-cms)

Просто следуйте этой инструкции и всё у вас получится! :-)

    Поскольку все файлы используют кодировку UTF8, то вносить изменения лучше
    не в Блокноте, который глючит в этом режиме, а с помощью нормальных 
    программ, например Notepad2: http://www.flos-freeware.ch/

________________________________________________________________________________

0. Загрузите все файлы на сервер.
________________________________________________________________________________

1. Скопируйте файл «_mso_add/distr/.htaccess» в корень сайта (там где index.php).

    Если вы располагаете сайт НЕ в корне домена, а в его подкаталоге, например
    «http://www.your-site.com/blog/», то откройте в Notepad2 файл 
    «.htaccess-subdir» и замените в нем все «#subdir#» на имя вашего 
    подкаталога (в нашем случае - «blog» - без кавычек!). Сохраните файл с 
    именем «.htaccess» в корень сайта.
    
    Так же см. ниже «Если PHP как FastCGI».
________________________________________________________________________________

2. Скопируйте файл «_mso_add/distr/robots.txt» в корень сайта. В параметре 
   Host укажите адрес главного зеркала сайта:
    
        Host: site.com 

    Этот файл используется поисковыми системами при индексации вашего сайта. 
    Учитывайте, что адреса с www и без для поисковиков разные.
________________________________________________________________________________

3. Скопируйте файл «_mso_add/distr/sitemap.xml» в корень сайта.

   Этот файл содержит XML-карту сайта, которая используется поисковиками для
   лучшей индексации.
________________________________________________________________________________

4. Откройте в Notepad2 файл «application/config/database.php-distr». В нем 
   необходимо указать параметры вашей базы данных. После этого загрузите файл 
   на сервер с именем database.php.
________________________________________________________________________________

5. Откройте файл «application/maxsite/mso_config.php-distr». 
    
    В этом файле введите свою секретную фразу. Она используется при 
    шифровании. Учтите, что сменив эту фразу после инсталяции все пароли 
    окажутся недействительными.
    
    После изменений загрузите файл на сервер с именем «mso_config.php».
________________________________________________________________________________

6. Запустите в браузере «http://ваш сайт/» и следуйте инструкциям.
________________________________________________________________________________

7. После установки системы, откройте файл «application/maxsite/mso_config.php»
    и измените на
    
        $mso_install = true; 

    Это укажет системе, что база установлена и не нужно это проверять каждый раз.
    Формально этот пункт можно пропустить.
________________________________________________________________________________

Примечание: во время установки MaxSite CMS попробует самостоятельно выставить 
нужные права на некоторые файлы и каталоги. В случае ошибки, установщик MaxSite CMS
предложит внести соответствующие изменения вручную.


==============================
ОБНОВЛЕНИЕ С ПРЕДЫДУЩИХ ВЕРСИЙ
==============================

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

Если вы хотите обновлять MaxSite CMS в автоматическом режиме, то воспользуйтесь
инструкцией: http://max-3000.com/page/update-maxsite-cms

	Обратите внимание, что в версии 0.84 и выше используется новый default-шаблон, который 
	может оказаться несовместимым с вашим шаблоном. Если у вас версия ниже 0.84, то предварительно
	убедитесь, что у вас шаблон либо основан на shared-каталоге, либо вы выполнили необходимые
	операции по сохранению его работоспособности. 
	Подробнее см. http://max-3000.com/page/otkaz-ot-default-shablona-shema-perehoda
	
	В версии 0.85 используется новая админ-панель, поэтому перед обновлением следует
	удалить старый админ-каталог (см. ниже). Перед обновлением MaxSite CMS нужно 
	переключиться на default шаблон админ-панели (Настройки — Основные — Админ-панель).
	После этого нажмите ссылку «Выход» в админ-панели, чтобы разлогиниться.


	Выберите вариант обновления:

	1. Если у вас версия MaxSite CMS 0.84x и ниже 0.85, то перед обновлением удалите админ-каталог:
	   /application/maxsite/admin/ 
	
		После загрузите файлы новой версии MaxSite CMS.

	2. Если у вас версия MaxSite CMS от 0.81 до 0.84x, то перед обновлением удалите Default-шаблон:
		/application/maxsite/templates/default 
		и админ-каталог
		/application/maxsite/admin/
		
		После загрузите файлы новой версии MaxSite CMS.

	3. Если у вас версия ниже 0.81, то обновление следует выполнять так:

		- Если меняется адрес сайта, то предварительно снимите опцию определения главного 
			зеркала сайта в плагине Range_url. В некоторых случаях перед обновлением желательно 
			отключить плагин глобального кэширования (Global_cache).
		
		- Переименуйте текущие каталоги 
			application в application-old
			system в system-old.
			
		- Загрузите файлы MaxSite CMS на сервер.
		
		- Установите права на запись на каталог кэша (application/cache/) и все его подкаталоги.
		
		- Скопируйте старые файлы из application-old в новый application: 
			/config/database.php
			/maxsite/mso_config.php
			
		- Скопируйте свой шаблон и сторонние плагины, если вы их устанавливали.
		
		После проверки работоспособности, каталоги system-old и application-old можно удалить.
	
	
3-м способом вы можете обновляться с любой версии MaxSite CMS.

Примечание: при обновлении MaxSite CMS каталог «_mso_add» можно не копировать.


==========
ДОПОЛНЕНИЯ
==========

Автоматический редирект с www.site.com на site.com
--------------------------------------------------
Добавьте в .htaccess после «RewriteEngine on»:

RewriteCond %{HTTP_HOST} ^www.site.com
RewriteRule ^(.*)$ http://site.com/$1 [R=permanent,L]

Примечание: вы можете активировать плагин Range_url, в котором указать главное зеркало сайта.
В этом случае редиректы будут осуществляться атоматически.


Если PHP как FastCGI
--------------------
В этом случае вам придется подобрать под свою конфигурацию параметры .htaccess. 
В моем случае заработали настройки, указанные в .htaccess-fastcgi.

На некотрых серверах вместо строчки:

    RewriteRule . /index.php [L]

можно попробовать указать:

    RewriteRule ^(.*)$ /index.php?/$1 [L,QSA]

Кроме этого нужно подобрать в config.php значение "uri_protocol". У меня 
получилось так:

    $config['uri_protocol'] = "REQUEST_URI";


Вариант для Nginx с апачем в качестве надстройки
-----------------------------------------------
RewriteRule ^(.*)$ /index.php?$1 [L,QSA]


=====================
ИСПОЛЬЗОВАНИЕ PHP 5.4
=====================

При использовании PHP 5.4 и выше следует модифицировать файл CodeIgniter.
См. http://forum.max-3000.com/viewtopic.php?f=4&t=4401

Проблема заключена в CodeIgniter, который пока не работает с этой версией PHP.


================
ВОЗМОЖНЫЕ ОШИБКИ
================

    * Хостинги, работающие с MaxSite CMS - нюансы и проблемы: 
        http://forum.max-3000.com/viewtopic.php?f=2&t=136
    
    
    * В браузере выдается ошибка "Cannot modify header information - headers..."
      
      Можно сказать, что вы неверно преобразовали файл в кодировку UTF-8.
      Ответ здесь: http://forum.maxsite.org/viewtopic.php?id=1075


    * При инсталяции при переходе ко второму шагу, происходит вывод первого.
    
      Это означает, что у вас неверно настроен ЧПУ. Проверьте верный ли у 
      вас .htaccess.


    * При инсталяции при переходе ко второму шагу, выводится ошибка, что каталог
      не существует.
    
      Это означает, что у вас неверно настроен ЧПУ. Проверьте верный ли у 
      вас .htaccess.

    
    * При инсталяции при переходе ко второму шагу, выводится ошибка 
      «No input file specified».
    
      Это означает, что у вас неверно настроен ЧПУ. Проверьте верный ли у 
      вас .htaccess. Скорее всего ваш PHP работает как CGI. Используйте 
      .htaccess-fastcgi.    

    
    * На сайте «слетает» оформление и в title страниц виден <?= . 
      
      Это означает, что на вашем сервере запрещены короткие тэги PHP. В php.ini
      укажите
            
            short_open_tag = On
            
      либо обратитесь в службу поддержки вашего хостинга.

    
===================
Директивы .htaccess
===================
Если сервер возвращает ошибку 500, значит для вас запрещено выполнять какие-то
директивы в .htaccess.


# 
Options +FollowSymLinks

# запрещает отображать список файлов в каталоге
Options -Indexes

# отключает register globals - ОБЯЗАТЕЛЬНО ВЫКЛЮЧАЙТЕ register globals
# если директива отключена, то проверьте через phpinfo() её значение
# если будет register_globals on - требуйте выключения у хостера
php_flag register_globals off

# просмотр индексных файлов
DirectoryIndex index.php index.html

# размер памяти для php-скриптов
php_value memory_limit 16M

# использует кодировку по умолчанию 
AddDefaultCharset UTF-8

# дополнительные директивы для кодировок (в зависимости от настроек сервера)
CharsetDisable On
CharsetDefault UTF-8
CharsetSourceEnc UTF-8
CharsetRecodeMultipartForms off