agrosup-dijon/bulma-package

Bulma Package delivers a full configured frontend theme for TYPO3, based on the Bulma CSS Framework.

v3.2.0 2024-06-20 08:45 UTC

Requires

• ext-dom: *
• ext-simplexml: *
• scssphp/scssphp: ^1.0.8
• symfony/css-selector: ^6.3 || ^7.0
• symfony/dom-crawler: ^6.3 || ^7.0
• typo3/cms-backend: ^12.4
• typo3/cms-core: ^12.4
• typo3/cms-extbase: ^12.4
• typo3/cms-extensionmanager: ^12.4
• typo3/cms-fluid: ^12.4
• typo3/cms-frontend: ^12.4
• typo3/cms-install: ^12.4
• typo3/cms-rte-ckeditor: ^12.4
• typo3/cms-seo: ^12.4

Suggests

• b13/container: Create Custom Container Content Elements for TYPO3
• georgringer/news: Versatile news extension, based on extbase & fluid for TYPO3 CMS
• gridelementsteam/gridelements: Extends the grid-based concept known from the backend layout of pages to regular content elements
• image_autoresize: Let TYPO3 automatically resize down huge images/pictures on-the-fly during upload (or using a scheduler task for batch processing)

GPL-2.0-or-later

• Sébastien Convers

• theme
• web
• responsive
• frontend
• TYPO3 CMS
• bulma

README

Bulma Package delivers a fully configured frontend theme for TYPO3, based on Bulma CSS Framework.

This is more than greatly inspired from https://github.com/benjaminkott/bootstrap_package. Many parts are simply copy/paste, thank you Benjamin!

The main differences, CSS framework apart, is that some of the configuration is made accessible for the "non admin" editors, through a backend module. We tried to make this with the end-user in mind, as simple as we could.

You still have to be a developer if you want to extend it to make your own templates and layouts.

You are more than welcome if you want to make code reviews ;)

A real documentation will be made if this is a bit adopted!

Showcase

https://bulma-package.cnerta-web.fr/

Minimal Dependencies

• TYPO3 CMS 12.4 (for TYPO3 11.5, use version 2.x.y)
• PHP >= 8.1

Quick install guide

• With composer: composer require agrosup-dijon/bulma-package
• Without composer: install the extension via Extension manager or TER only (if you use github version, you won't have the dependencies and it won't work)
• Make sure you have a root page
• Make sure you have a "site" in Site Configuration module
• Create a new Template on the root page
  • Include static (from extensions): Bulma Package (Full package)
• Go to "Website" module
  • Create new configuration
  • In General, define SEO title. This will be your website title visible in the frontend.
  • Upload a main logo in Logo tab
• You're all set, go create contents :)

Custom colors

• Go to "Website" module
• In the top list, select "Colors management"
• Create a new color, give it a title and use color picker to define primary color.
• Save
• Custom color will be available in Page properties, Appearance tab, Frontend layout list.

Development

• Yarn usage: ddev yarn --cwd <path_bulma> <command>
• Archive for TER: ddev -d <path_bulma> composer archive --format=zip --file=bulma_package_x.y.z
• Update dependencies for non composer project: ddev composer update --dry-run -d <path_bulma>/Resources/Private/Contrib/Php
• Update js dependencies: npm install -g npm-check-updates / ncu / ncu -u