pixelmairie/sulu-townhalldeliberationbundle

Manage deliberation for town hall on Sulu CMS

1.0.1 2024-12-08 10:34 UTC

This package is not auto-updated.

Last update: 2024-12-09 08:45:25 UTC


README

Deliberation for Town Hall Bundle

GitHub release (with filter) Minimum PHP Version Dependency Dependency Quality Gate Status

📝 Presentation

A Sulu bundle to manage deliberations.

✅ Features

  • Deliberation management
  • List of entities (via smart content)
  • Activity log
  • Trash

🚀 Installation

Install the bundle

Execute the following composer command to add the bundle to the dependencies of your project:

composer require pixelmairie/sulu-townhalldeliberationbundle

Enable the bundle

Enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

return [
    /* ... */
    Pixel\TownHallDeliberationBundle\TownHallDeliberationBundle::class => ['all' => true],
];

Bundle Config

Define the Admin Api Route in routes_admin.yaml

townhall.deiberations_api:
  type: rest
  prefix: /admin/api
  resource: pixel_townhall.deliberations_route_controller
  name_prefix: townhall.

👍 Use

Add/Edit

Go to the "Town hall" section in the administration interface. Then, click on "Deliberation". To add, simply click on "Add". Fill the fields that are needed for your use.

Here is the list of the fields:

  • Title (mandatory)
  • Date (mandatory)
  • PDF file (mandatory)
  • Description

Once you finished, click on "Save".

The deliberation you added is not visible on the website yet. In order to do that, click on "Activate?". It should be now visible for visitors.

To edit, simply click on the pencil at the left of the entity you wish to edit.

Remove/Restore

There are two ways to remove a deliberation:

  • Check every deliberation you want to remove and then click on "Delete"
  • Go to the detail of a deliberation (see the "Add/Edit" section) and click on "Delete".

In both cases, the deliberation will be put in the trash.

To access the trash, go to the "Settings" and click on "Trash". To restore a deliberation, click on the clock at the left. Confirm the restore. You will be redirected to the detail of the deliberation you restored.

To remove permanently a deliberation, check all the deliberations you want to remove and click on "Delete".

🤝 Contributing

You can contribute to this bundle. The only thing you must do is respect the coding standard we implement. You can find them in the ecs.php file.