Каталоги

MaxSite CMS базируется на php-фреймворке CodeIgniter (версии 2.2.6). Это наложило свой отпечаток на структуру каталогов MaxSite CMS. Можете открыть страничку системы на гитхабе для лучшего понимания. Я скриншот не привожу.

CodeIgniter

Каталог system и файл index.php — это и есть сам CodeIgniter. Нам пришлось внести несколько правок во фреймворк, в основном для того чтобы обеспечить корректную работу с кириллицей. CodeIgniter обеспечивает основной каркас и базовую функциональность, иначе пришлось бы придумывать свой «велосипед».

В каталоге system/libraries находятся различные библиотеки, которые мы можем использовать. Например все манипуляции с изображениями в MaxSite CMS делаются с помощью Image_lib.

В каталоге system/helpers располагаются хелперы — небольшие функции-помощники. Наприме smiley_helper используется в плагине вывода смайликов.

Каталог system/database содержит функции работы с базой данных MySQL. Если бы не Active Record Class, пришлось бы писать довольно сложные sql-запросы и их обработку.

Таким образом CodeIgniter в полном объеме доступен из MaxSite CMS. Если вам нужно будет изучить возможности фреймворка, то они прекрасно описаны в документации.

Установка

Каталог install — это начальная установка MaxSite CMS. После установки, в принципе каталог можно удалить.

Загрузки

В uploads располагаются все загружаемые файлы. Это каталог где в целях безопасности запрещено выполнять php-код. В uploads есть несколько предопределенных подкаталогов.

В _mso_float хранятся «плоские опции», вроде ушек. Не удаляйте его, иначе придется создавать их заново.

В подкаталогах _mso_i хранятся служебные миниатюры размером 100x100px. Они создаются автоматически при загрузке файлов и выводятся для быстрого просмотра. Поскольку они небольшие, то не создают большого трафика и не занимают много места на диске.

А вот подкаталоги mini содержат уже «рабочие» миниатюры, которые выводятся на сайте. Как правило все миниатюры создаются автоматом по заданным критериям: размеры и тип обрезки.

Каталог favicons содержит фавиконки сайта. Сама иконка выбирается в настройках MaxSite CMS. То есть чтобы поменять иконку сайта, нужно загрузить картинку в favicons и выбрать в настройках.

Специальный каталог _pages будет создан автоматически при редактировании записей. В нем будут храниться файлы, имеющие отношение к конкретной записи. Все записи имеют свой уникальный номер ID, по которому можно ориентироваться. Например _pages/7 будет содержать файлы записи №7. Если вы загружаете файлы в режиме быстрой загрузки при редактировании записи, то MaxSite CMS сама разберется где и что размещать.

Каталог smiles содержит картинки смайликов. Если вы включили соответствующий плагин, то будут выводиться именно эти картинки.

MaxSite CMS

Каталог application содержит файлы MaxSite CMS. Основной базис — это «требование» CodeIgniter, а вот application/maxsite выделенный каталог, где собственно и расплагаются все файлы системы.

В нём подкаталоги, по которым интуитивно понятно их предназначение.

• admin — админ-панель
• common — ядро системы
• plugins — плагины
• shared — «общие» файлы
• templates — здесь размещаются шаблоны

Чтобы установить новый шаблон, нужно его загрузить в templates и после выбрать в админ-панели. Аналогично для установки плагина, нужно его загрузить в plugins и после активировать.

В admin располагается сама админ-панель: плагины и шаблоны. Для новичков он вряд ли представляет особый интерес. :-)

А вот файлы каталога common я бы посоветовал хотя бы бегло просмотреть, чтобы понять из каких функций состоит «ядро» MaxSite CM. На самом деле функций немного (по сравнению с другими CMS) и они содержат комментарии. Причем я часто комментирую в коде, чтобы было понятно что к чему.

К особеннстям MaxSite CMS я бы отнёс то, что функции я стараюсь делать многофункциональными, поэтому они как правило содержат много входящих параметров. У нас нет документации по системе, и если нужно понять какие данные требуются, то лучшим способом будет посмотреть на её исходный код. Это в общем-то касается не только MaxSite CMS, но и вообще любого программирования.

Каталог shared особенный. В нём файлы, которые когда-то были в шаблонах. То есть разные шаблоны могут использовать единый код/функции/файлы и т.п. Скорее всего на начальных порах вам придётся часто обращаться в shared/type, чтобы понять как работают разные типы данных. Также это будет актуально для тех случаев, когда нужно будет «вклиниться» или «заменить» работу по выводу данных. В файлах прописаны type_foreach-файлы — нужно знать его название. Там же могут быть и разные ушки, set-переменные, опции и т.п.

В каталоге stock находятся page-out и thumb. Первый используется для вывода записей, второй для создания миниатюр. Это мощные (и сложные) php-классы, которые со временем можно будет изучить, чтобы узнать все их возможности.