Download the PHP package softspring/symfonic without Composer

Armonic

This system acts as a content manager thanks to which you can create and manage static pages of your website from a single place, simplifying the work process, and also the lives of developers.

Armonic was developed in response to the need for a CMS that simplifies the creation of static pages and landing pages in Symfony-based projects. This allows our technical team to focus more on innovation and customization of applications, without being tied to repetitive tasks that do not add value.

Index

1. Why Armonic
2. How to Install and Use Armonic
   1. Using Armonic in a Clean Symfony Project
   2. Using Armonic with a Sylius Project
3. Adding more components to it

1. Why Armonic

• Design layouts with simple or complex block structures and reuse them on different pages or sections.
• Create pages by combining modules you create yourself or using the ones we provide.
• For common sections on different pages, simplify creation with our reusable block concept.
• Manage multiple versions of the same page and preview the changes without fear of making mistakes, publish the final version when you are happy with it!
• All this with a semantic website from the first block, responsive, multi-site, multi-language and SEO ready.

2. How to Install and Use Armonic

2.1 Using Armonic in a Clean Symfony Project

Installing Symfony

Install Symfony following current instructions in https://symfony.com/doc/current/setup.html

Previous configuration

To work with the CMS we need a MySQL database (PostgreSQL should also be compatible).

Configuring the Database in Docker

We will use the file docker-compose.yaml that comes with the project:

Note This are development values, not ready for Production.

and we can already start the container:

Configuring the environment value

In .env change the values of the MySQL database:

Configuring Symfony Flex de Softspring (for Development)

Note This step will not be needed when Softspring' Symfony Flex recipes are integrated in the contrib repository

In composer.json, we add the endpoints and we establish allow-contrib to true:

TEMPORARY

Until we release version 5.4 of the bundles we have to include (in composer.json):

Configure webpack

Note If we don't have yarn installed, we need to install it before. In Ubuntu < 18.04 there are some issues between the packages yarnpkg and cmdtest

Configure admin in webpack

In the file webpack.config.js

Install armonic

Note If we have a Driver error, we will need to install php-mysql in the php version we are using.

We install additional modules:

And we compile the assets

Symfony flex should have done all the work and we will have the project ready so we can visualize it.

Some adjustments (by now)

For the app to work properly we have to include framework.enabled_locales:

We have been unable to overwrite templates/base.html.twig with Symfony Flex recipes, so you have to change it by hand (until we fin another solution). By now:

We can start the application

We are going to use the Symfony CLI command to serve the app:

Once we have done this, we will have a Not Found in https://127.0.0.1:8000/ .

If we go to https://127.0.0.1:8000/admin/cms/pages we will be able to configure our first page.