README

Successor plugin of FroshProfiler and FroshMailCatcher

Installation

Git Version

Checkout Plugin in /custom/plugins/FroshDevelopmentHelper
Download FroshPluginUploader and run ext:prepare [folder to plugin]
Install the Plugin with the Plugin Manager

Features

Show Twig Includes / Blocks in Template as HTML Comment
Disable Annoying Storefront Error Handler
Disables Twig Cache
Twig Variables in Twig Tab
Generate definition from command line

Generate plugin

./bin/console frosh:make:plugin <plugin-name>

Optional with --namespace=xxx\\xx specifying the namespace

Generating Entities or edit Entities

Start wizard with

./bin/console frosh:make:definition My\\Plugin\\Namespace\\SomeDefinition

Generate Migration

./bin/console frosh:make:migration <plugin-name> <entity-name>

Example entity name: product, category, order

Checks the difference of that definition with the database and creates a migration

Generate Twig Extension file

./bin/console frosh:extend:template <plugin-name>

Asks for the block you want to extend and creates the twig extension file for you

SQL Logger for Console Debugging

Prints executed SQL to the console, in such a way that they can be easily copied to other SQL tools for further debugging. This is similar to the symfony debug bar, but useful in CLI commands and tests.

Usage:

 Kernel::getConnection()->getConfiguration()->setSQLLogger(
     new \Frosh\DevelopmentHelper\Doctrine\EchoSQLLogger()
 );

Known issues

Some HTML is not rendered correctly when this plugin is active 💣

This plugin can cause problems with blocks, due to the feature to show the block name as HTML comment. If you encounter such issues with your plugin or project, you can configure this in config/packages/frosh_development_helper.yaml

There is a predefined list of pattern which likely would cause such problems - feel free to provide a pull request with more such generic patterns.

frosh / development-helper

Maintainers

Details