oveleon/contao-theme-compiler-bundle

Theme-Compiler for Theme-Manager Bundles

1.9.1 2024-09-13 07:16 UTC

Requires

• php: ^8.1
• contao/core-bundle: ^4.13 || ^5.3
• scssphp/scssphp: ^1.12
• symfony/config: ^5.4 || ^6.4 || ^7.0
• symfony/console: ^5.4 || ^6.4 || ^7.0
• symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
• symfony/event-dispatcher: ^5.4 || ^6.4 || ^7.0
• symfony/http-kernel: ^5.4 || ^6.4 || ^7.0

Requires (Dev)

• contao/contao-rector: @dev
• contao/easy-coding-standard: ^6.12
• contao/manager-plugin: ^2.3.1
• phpstan/phpstan: ^1.0
• phpstan/phpstan-doctrine: ^1.3
• phpstan/phpstan-phpunit: ^1.0
• phpstan/phpstan-symfony: ^1.0
• shipmonk/composer-dependency-analyser: ^1.5
• slam/phpstan-extensions: ^6.0
• thecodingmachine/phpstan-strict-rules: ^1.0

Conflicts

• contao/core: *
• contao/manager-plugin: <2.0 || >=3.0

MIT

• Oveleon
• Daniele Sciannimanica
• Sebastian Zoglowek

• compiler
• contao

README

The contao theme compiler bundle adds the functionality to compile selected scss files within your theme settings.

• Features
• How to install
• Initial setup
• Console commands
• Miscellaneous

Features

• Compiles your scss files in your contao installation
• A compile button next to your themes
• Able to add multiple source files
• Able to compile multiple files into one
• Enable backups for your compiled scss

How to install the package

Via composer

composer require oveleon/contao-theme-compiler-bundle

Via contao-manager

Search for contao theme compiler bundle and add it to your extensions.

Initial setup

1. Create a theme and add source file/s in your theme settings

2. Add a destination folder for your source files

3. (Optional settings for combining your files and more)

4. Save

   

5. Compile in your theme-settings, within your theme overview, under maintenance or via console command

   

   php vendor/bin/contao-console contao:themecompiler:compile [id]
   

Console commands

List themes

• Outputs a list of your themes within tl_theme

php vendor/bin/contao-console contao:themecompiler:list

Compile theme

• Compiles a theme ([id] is mandatory):

php vendor/bin/contao-console contao:themecompiler:compile [id]

Miscellaneous

Enable file sync on every compilation

Version 1.8 has been rewritten to skip the DBAFS sync if the files already exist. This saves a database call and logic for each output file and improves compilation time.

To enable the old behaviour, use following in your config.yaml

# config/config.yml
contao_theme_compiler:
  file_sync: true