{"id":26000087,"url":"https://github.com/softspring/armonic","last_synced_at":"2026-02-23T22:21:13.240Z","repository":{"id":173307681,"uuid":"639333947","full_name":"softspring/armonic","owner":"softspring","description":"A powerful Symfony CMS.","archived":false,"fork":false,"pushed_at":"2025-03-03T08:31:12.000Z","size":572,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"5.5","last_synced_at":"2025-03-03T09:31:40.201Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/softspring.png","metadata":{"files":{"readme":"README-ES.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-11T08:59:32.000Z","updated_at":"2025-02-27T12:37:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"d8bf5f69-a16c-454a-a898-3196f795afc2","html_url":"https://github.com/softspring/armonic","commit_stats":null,"previous_names":["softspring/sfs-builder","softspring/symfonic","softspring/armonic"],"tags_count":96,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softspring%2Farmonic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softspring%2Farmonic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softspring%2Farmonic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softspring%2Farmonic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/softspring","download_url":"https://codeload.github.com/softspring/armonic/tar.gz/refs/heads/5.5","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242082732,"owners_count":20069181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-05T18:41:26.826Z","updated_at":"2026-02-23T22:21:13.199Z","avatar_url":"https://github.com/softspring.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/softspring/symfonic/blob/5.1/README.md)\n[![es](https://img.shields.io/badge/lang-es-yellow.svg)](https://github.com/softspring/symfonic/blob/5.1/README-ES.md)\n\n# Symfonic\nUn CMS potente para Symfony.\n\n## Índice\n\n1. Por qué Symfonic\n2. Cómo instalar y usar Symfonic\n   1. Uso de Symfonic en un proyecto Symfony limpio\n   2. Uso de Symfonic con un proyecto Sylius\n3. Añadiéndole más componentes\n\n## 1. Por qué Symfonic\n\n- Diseña maquetaciones con estructuras de bloques simples o complejas y reutilízalas en diferentes páginas o secciones. \n- Crea páginas combinando módulos creados por ti mismo o utilizando los que le proporcionamos. \n- Para secciones comunes en diferentes páginas, simplifica la creación con nuestro concepto de bloques reutilizables.\n- Gestiona múltiples versiones de la misma página y previsualiza los cambios sin miedo a cometer errores, ¡publica la versión final cuando estés contento con ella!\n- Todo esto con una web semántica desde el primer bloque, responsive, multisite, multiidioma y preparada para SEO.\n\n## 2. Cómo instalar y utilizar Symfonic\n\n### 2.1 Usar Symfonic en un proyecto Symfony limpio\n\n#### Instalación de Symfony\n\nInstala Symfony siguiendo las instrucciones actuales en https://symfony.com/doc/current/setup.html\n\n```bash\nsymfony new mi-proyecto-symfonic --version=\"6.2.*\" --webapp\n```\n\n#### Configuración previa\n\nPara trabajar con el CMS necesitamos una base de datos MySQL (PostgreSQL también debería ser compatible).\n\n##### Configuración de la base de datos en Docker\n\nUtilizaremos el fichero *docker-compose.yaml* que viene con el proyecto:\n\n\u003e *Note* Estos son valores de desarrollo, no están listos para Producción.\n\n```yaml\nversion: '3\n\nservices:\n###\u003e doctrine/doctrine-bundle\n  base de datos:\n    image: \"mysql:8.0\"\n    entorno:\n      MYSQL_ROOT_PASSWORD: nopassword\n      MYSQL_DATABASE: cms\n      MYSQL_USER: test\n      MYSQL_PASSWORD: nopassword\n    puertos:\n      - 3306:3306\n    volúmenes:\n      - database_data:/var/lib/mysql\n###\u003c doctrine/doctrine-bundle ###\n\nvolúmenes:\n###\u003e doctrine/doctrine-bundle ###\n  database_data:\n###\u003c doctrine/doctrine-bundle ###\n```\n\ny ya podemos arrancar el contenedor\n\n```bash\ndocker-compose up -d\n```\n\n##### Configurando los valores del entorno\n\nEn .env cambiamos los valores de la base de datos MySQL:\n\n```yaml\n###\u003e doctrine/doctrine-bundle\nDATABASE_URL=\"mysql://test:nopassword@127.0.0.1:3306/cms?serverVersion=8.0\u0026charset=utf8mb4\"\n###\u003c doctrine/doctrine-bundle ###\n```\n\n### Configuring Symfony Flex de Softspring (for Development)\n\u003e *Nota* Este paso no será necesario cuando las recetas de Symfony Flex de Softspring estén integradas en el repositorio contrib.\n\nEn composer.json, añadimos los endpoints y establecemos allow-contrib a true:\n\n```yaml\n{\n    \"extra\": {\n        \"symfony\": {\n            \"allow-contrib\": true,\n            \"require\": \"6.2.*\",\n            \"endpoint\": [\"https://api.github.com/repos/softspring/recipes/contents/index.json\", \"flex://defaults\"]\n        }\n    }\n}\n```\n\n### TEMPORAL\nHasta que publiquemos la versión 5.1 de los bundles tenemos que incluir (en composer.json):\n\n```yaml\n{\n    \"minimum-stability\": \"dev\"\n}\n```\n\n#### Configurar webpack\n\u003e *Nota* Si no tenemos yarn instalado, necesitamos instalarlo antes. En Ubuntu \u003c 18.04 hay algunos problemas entre los paquetes \n\u003e yarnpkg y cmdtest\n\n```yaml\ncomposer require webpack\nyarn install\nyarn add @popperjs/core bootstrap bootstrap-icons underscore.string sass-loader@^13.0.0 sass --dev\n```\n\n##### Configurar admin en webpack\n\nEn el archivo webpack.config.js\n\n```yaml\nEncore\n    // ...\n\n    // añadir admin.js\n    .addEntry('admin', './assets/admin.js')\n\n    // ...\n    \n    // descomentar el cargador sass\n    .enableSassLoader()\n    \n    // ...\n```\n\n### Instalar symfonic\n\n```yaml\ncomposer require softspring/symfonic:^5.1@dev\nbin/consola doctrina:migraciones:migrar -n\n```\n\n\u003e *Nota* Si tenemos un error de Driver, necesitaremos instalar php-mysql en la versión de php que estemos usando.\n\nInstalamos módulos adicionales: \n\n```yaml\ncomposer require softspring/cms-module-collection:^5.1\n```\n\nY compilamos los assets\n\n``yaml\nyarn build\n```\n\nSymfony flex debería haber hecho todo el trabajo y tendremos el proyecto listo para que podamos visualizarlo.\n\n#### Algunos ajustes (por ahora)\nPara que la app funcione correctamente tenemos que incluir framework.enabled_locales:\n\n```yaml\n# config/paquetes/traduccion.yaml\nframework:\n    enabled_locales: ['en', 'es']\n``` \n\nNo hemos podido sobrescribir templates/base.html.twig con las recetas de Symfony Flex, así que tienes que cambiarlo a mano (hasta que encontremos otra solución). Por ahora:\n\n```yaml\n{# templates/base.html.twig #}\n{% extends '@SfsComponents/base.html.twig' %}\n``` \n\n### Podemos iniciar la aplicación\nVamos a utilizar el comando CLI de Symfony para servir la aplicación:\n\n```yaml\nsymfony server:start\n``` \n\nUna vez hecho esto, tendremos un Not Found en https://127.0.0.1:8000/ .\n\nSi vamos a https://127.0.0.1:8000/admin/cms/pages podremos configurar nuestra primera página.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftspring%2Farmonic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoftspring%2Farmonic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftspring%2Farmonic/lists"}