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-классы, которые со временем можно будет изучить, чтобы узнать все их возможности.