Download the PHP package manuxi/sulu-tweaks-bundle without Composer

On this page you can find all versions of the php package manuxi/sulu-tweaks-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package sulu-tweaks-bundle

๏ปฟ# SuluTweaksBundle

License GitHub Tag Sulu Version Supports Sulu 2.6 or later PHP Version

English | Deutsche Version

This bundle was created to tweak some aspects of Sulu's list display.

Feature requests are always welcome.

This bundle works for Sulu 2.6 (probably earlier too) and 3.0. Use at own risk ๐Ÿคž๐Ÿป


Features

๐Ÿ”ด Publish State Indicator

Stair effects in lists are ugly, and the default display produces exactly those.

This bundle cleans that up: The included SCSS hides the current publish indicators and ghost locale and adds new ones in separate columns. The PublishIndicator also shows a green dot for published elements.

Status Color
Published ๐ŸŸข Green
Draft ๐ŸŸข๐ŸŸก Green + Yellow
Not published ๐ŸŸก Yellow

๐ŸŒ Ghost Locale Indicator

Sulu's built-in ghost locale indicator (showing the fallback language) is automatically added to cells and cannot be repositioned. This bundle provides a separate column for the ghost locale that can be placed anywhere in lists.

The styling matches Sulu's original design.

โญ Star Rating

Displays numeric ratings as visual stars. Supports both 5-point and 10-point scales (with half-stars).

Rating Display
3/5 โ˜…โ˜…โ˜…โ˜†โ˜†
7/10 โ˜…โ˜…โ˜…โฏชโ˜† (half star)

The numeric value is shown in a tooltip on hover. Optionally, the value can also be displayed next to the stars.

๐Ÿ“Š Percent Bar

Displays values as a colored progress bar. The color transitions from red (0%) through orange, yellow to green (100%).

Percent Color
0-20% ๐Ÿ”ด Red
20-40% ๐ŸŸ  Orange
40-60% ๐ŸŸก Yellow
60-80% ๐ŸŸข Light green
80-100% ๐ŸŸข Green

Features:


๐Ÿ‘ฉ๐Ÿปโ€๐Ÿญ Installation

Step 1: Install the package

Step 2: Register Admin Assets

Add to assets/admin/package.json:

Step 3: Import the Bundle

Import in assets/admin/app.js:

Step 4: Rebuild Admin Assets


๐Ÿ”ง How It Works

When importing the bundle via import 'sulu-tweaks-bundle';, the following happens automatically:

  1. Configuration Hook: The bundle registers an update config hook for sulu_tweaks
  2. Transformer Registration: All list field transformers are registered in Sulu's listFieldTransformerRegistry
  3. Styles Applied: The included SCSS hides Sulu's default indicators/ghost locales and applies custom styling

Available Transformers

Transformer Type Name Description
PublishStateFieldTransformer publish_state_indicator Colored dots for publish status
GhostLocaleFieldTransformer ghost_locale_indicator Separate column for fallback language
StarRatingFieldTransformer star_rating Star rating display
PercentBarFieldTransformer percent_bar Colored percent bar

Only the transformers that should be used need to be added to the list XML configurations.


๐Ÿ“‹ Usage

Publish State Indicator

Add to list XML (e.g., config/lists/events.xml):

Tip: Place this property at the beginning of the list for better visibility.

Ghost Locale Indicator

Add to list XML:

Note: The ghostLocale field must be available in the list data. With Sulu 3.0 DimensionContent architecture, this field is typically provided automatically.

Star Rating

Add to list XML:

With XML parameters (overrides global config):

Percent Bar

Add to list XML:

Different scales via XML parameters:


๐Ÿงถ Configuration

Create config/packages/sulu_tweaks.yaml in the project:

Configuration vs. XML Parameters

Option Global (YAML) Per List (XML)
Applies to All lists Single property
Priority Lower Higher (overrides)
Use case Project defaults Special requirements

Example: Global max_value: 100, but one list needs max_value: 10 โ†’ override via XML parameter.


๐Ÿ—ฃ๏ธ Translations

The bundle provides translations for English and German. They can be overridden in the project:


๐Ÿ“ Bundle Structure


๐Ÿค Contributing

Contributions are welcome! Pull requests can be submitted.


๐Ÿ“„ License

This bundle is under the MIT license.


All versions of sulu-tweaks-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
doctrine/doctrine-bundle Version ^2.13
sulu/sulu Version ^2.6 || ^3.0
symfony/intl Version ^6.2 | ^7.0
symfony/translation Version ^6.2 | ^7.0
sulu/sulu-rector Version ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package manuxi/sulu-tweaks-bundle contains the following files

Loading the files please wait ...