Download the PHP package pixelopen/sulu-newsbundle without Composer
On this page you can find all versions of the php package pixelopen/sulu-newsbundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pixelopen/sulu-newsbundle
More information about pixelopen/sulu-newsbundle
Files in pixelopen/sulu-newsbundle
Package sulu-newsbundle
Short Description Manage news for Sulu
License MIT
Homepage https://github.com/Pixel-Open/sulu-newsbundle
Informations about the package sulu-newsbundle
Sulu news bundle
Presentation
A Sulu bundle to manage the news of your website.
Requirements
- PHP >= 8.0
- Sulu >= 2.4.*
- Symfony >= 5.4
- Composer
Features
- List view of News (smart content)
- Without elasticsearch
- Routing
- Preview
- SULU Media include
- Content Blocks (Title,Editor,Image,Quote)
- Activity Log
- Trash
- Automation
- SEO
Installation
Install the bundle
Execute the following composer command to add the bundle to the dependencies of your project:
Enable the bundle
Enable the bundle by adding it to the list of registered bundles in the config/bundles.php
file of your project:
Update schema
Bundle Config
Define the Admin Api Route in routes_admin.yaml
Use
Add/Edit a news
Go to the "News" section in the administration interface. Then, click on "Add". Fill the fields that are needed for your use.
Here is the list of the fields:
- Title (mandatory)
- URL (mandatory and filled automatically according to the title)
- Published at (manually filled)
- Cover
- Category (mandatory)
- Content
The "Content" field is a block content type. The different type of block come from the Sulu Block Bundle
Once you finished, click on "Save"
Your news is not visible on the website yet. In order to do that, click on "Publish?". It should be now visible for visitors.
To edit a news, simply click on the pencil at the left of the news you wish to edit.
Categories
As you may have seen in the previous section, a news needs a category. These categories need to be created in a very specific way:
- You must create a root category which must have its key named "news"
- Then, under this root category, you create all the news categories you need
Remove/Restore a gallery
There are two ways to remove a news:
- Check every news you want to remove and then click on "Delete"
- Go to the detail of a news (see the "Add/Edit a news" section) and click on "Delete".
In both cases, the news will be put in the trash.
To access the trash, go to the "Settings" and click on "Trash". To restore a news, click on the clock at the left. Confirm the restore. You will be redirected to the detail of the news you restored.
To remove permanently a news, check all the news you want to remove and click on "Delete".
Settings
This bundle comes with settings. There is only one setting, it's the configuration of a default image. To access the bundle settings, go to "Settings > News management".
Twig extension
There are several twig functions in order to help you use the news and settings on your website:
get_latest_news(limit, local): returns the latest news. It takes two parameters:
- limit: represents the number of the latest news to display. If no limit is provided, the default value is 3
- locale: the locale in which the news should be retrieved. If no local is provided, the default value is 'fr'
Example of use:
get_latest_news_html(limit, locale): same as get_latest_news but it renders a view instead. It takes two parameters:
- limit: represents the number of the latest news to display. If no limit is provided, the default value is 3
- locale: the locale in which the news should be retrieved. If no local is provided, the default value is 'fr'
Example of use:
news_settings(): returns the settings of the bundle. No parameters are required.
Example of use:
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.
All versions of sulu-newsbundle with dependencies
sulu/sulu Version ^2.6
symfony/config Version ^5.0 || ^6.0
pixelopen/sulu-blockbundle Version ^2.5 || ^2.6
symfony/dependency-injection Version ^5.0 || ^6.0
symfony/framework-bundle Version ^5.0 || ^6.0
symfony/http-foundation Version ^5.0 || ^6.0
symfony/http-kernel Version ^5.0 || ^6.0