Представляем CockpitCMS — CMS для разработчиков

Чтобы отобразить Markdown на нашей последней HTML-странице, нам нужно установить пакет Markdown, добавив одну строку в файл composer.json :

 "michelf/php-markdown": "~1.4" 

и ссылка на него в нашем файле index.php :

 use Michelf\MarkdownExtra; 

ПРИМЕЧАНИЕ. В этой демонстрации я использую синтаксис Markdown Extra. Подробную информацию о синтаксисе Markdown (и Markdown Extra) можно найти здесь .

Визуализация строки разметки (текст) проста:

 foreach ($entries as &$entry) { $text = $entry['diary']; $html = MarkdownExtra::defaultTransform($text); $entry['diary'] = $html; } 

Результат рендеринга Markdown является удовлетворительным.

Далее мы можем захотеть отобразить галереи изображений, связанные с этой записью. Как упоминалось ранее, не существует легкого (или, на мой взгляд, интуитивного) способа сделать это. В этой демонстрации поле pic определенное выше, действует как «ссылка» на галерею, содержащую изображения. Для отображения изображений необходимо выполнить несколько строк кода.

 $app->get('/gallery/{gal}', function ($gal) use ($app) { $images = cockpit("galleries")->gallery($gal); foreach ($images as &$img) { $image = $img['path']; $imgurl = cockpit('mediamanager:thumbnail', $image, 200, 200); $img['cache']=$imgurl; $path=$img['path']; $url=str_replace('site:', 'http://'.$app['request']->getHost().'/', $path); $img['url']=$url; } return $app['twig']->render('gallery.html.twig', ['images'=>$images, 'gal'=>$gal]); } )->bind('gallery'); 

Первый шаг — получить все изображения для определенной галереи, вызвав API Cockpit: $images = cockpit("galleries")->gallery($gal); ,

Далее нам нужно получить две вещи из каждого изображения: миниатюру и реальный путь к этому изображению.

Чтобы получить миниатюру, Cockpit предоставляет API: cockpit('mediamanager:thumbnail', $image, 200, 200); где 200 указывает ширину / высоту миниатюры. Есть несколько других вариантов, доступных для создания эскиза, например, для контроля качества и режима обрезки. Пожалуйста, обратитесь к документации для подробного объяснения использования.

Однако в этом API отсутствует одна вещь, которая заключается в автоматическом повороте изображений, так что изображение, снятое в портретной ориентации, может быть правильно распознано и отображено. Теперь система отображает все изображения в альбомной ориентации независимо от ориентации исходного изображения.

Кабина не хранит реальный путь картины. Это может иметь смысл в моем случае, так как мои изображения на самом деле загружаются в бэкэнд с помощью vagrant/cockpit а внешний интерфейс — vagrant/silex .

Если мы проверим дамп VarDumper из $images , path на самом деле будет примерно таким: "path" => "site:cockpit/assets/images/IMG_3427.JPG" . Следовательно, мы используем str_replace для генерации реального веб-URI для этого изображения: "url" => "http://vagrant/cockpit/assets/images/IMG_3548.JPG" . Конечно, чтобы это работало, мы должны убедиться, что изображение обслуживается по этому URI.

Вот и все! С небольшим количеством строк кода у нас есть функциональный интерфейс на базе Cockpit CMS.

Вывод

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

Отсутствие внешнего интерфейса, на мой взгляд, неплохо. Различные структуры коллекции, безусловно, потребуют различных презентаций и макетов. Например, коллекция book может использовать табличный стиль, в то время как коллекция trip может включать в себя раздел галереи, показывающий некоторые изображения. Дамп по умолчанию для всех полей записи будет просто уродливым и неподходящим. Таким образом, я бы сказал, что кокпит довольно умен, не предоставляя его. Однако это потребует от пользователя кодирования разного макета для каждой структуры коллекции. В некоторых случаях это может быть хлопотно и занимать много времени, а также требует определенного уровня навыков программирования, поэтому CockpitCMS называет себя «CMS разработчика».

Его API имеет большое значение, когда мы занимаемся разработкой интерфейса, но он еще не завершен. Например, отсутствие предоставления реального пути к изображению и отсутствие возможности поворачивать изображение в зависимости от его ориентации — это лишь немногие, что я заметил за короткое время работы с CMS. Я бы предложил автору CMS внести некоторые дополнительные улучшения в этот аспект.

Наиболее важно то, что он не предоставляет API для CRUD-записи. Вероятно, это связано с тем, что структура коллекции отличается друг от друга, и практически невозможно предоставить универсальный CRUD API. Но это также мешает нам использовать PHP-код для быстрого и простого управления данными. Все, что у нас осталось — это бэкэнд, который иногда может быть недостаточно удобным. Мне бы очень хотелось, чтобы эта часть API появилась на свет.

Cockpit CMS лучше всего подходит для тех разработчиков PHP, которые обладают определенным уровнем знаний PHP, CSS и фреймворка, которые не хотят быть связанными с другими более тяжелыми CMS и хотят создать простую, аккуратную и «все под моим контролем» CMS хвастаться своей работой и жизнью. Тем не менее, важно подчеркнуть, что это может увеличить сложность программирования, особенно когда нам нужно добавить больше функций во внешний интерфейс.

Есть некоторые другие области, предоставленные Cockpit, которые не рассматриваются в этом посте — не стесняйтесь исследовать его потенциал и поделиться тем, что вы достигли.

Демонстрационный код для этого урока можно найти в репозитории Github здесь .