Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cdaecke/md_newsfrontend
This TYPO3 extension enables feUsers to create news records in the frontend.
https://github.com/cdaecke/md_newsfrontend
frontend news php typo3 typo3-cms-extension typo3-extension
Last synced: about 2 months ago
JSON representation
This TYPO3 extension enables feUsers to create news records in the frontend.
- Host: GitHub
- URL: https://github.com/cdaecke/md_newsfrontend
- Owner: cdaecke
- License: other
- Created: 2019-03-27T16:17:02.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-02T10:18:38.000Z (11 months ago)
- Last Synced: 2024-10-05T07:13:56.193Z (3 months ago)
- Topics: frontend, news, php, typo3, typo3-cms-extension, typo3-extension
- Language: JavaScript
- Homepage:
- Size: 884 KB
- Stars: 3
- Watchers: 4
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: Readme.md
- Changelog: Changelog.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# TYPO3 Extension ``md_newsfrontend``
This extension enables a frontend user to add ``ext:news``-records. Beside adding content for the normal text fields like ``title``, ``teaser``, ``bodytext`` it is also possible to upload an image and a file download as well as selecting a category.
Templates are ready to use with the [bootstrap framework](https://getbootstrap.com/) and icons will be shown, if you have [Font Awesome](https://fontawesome.com/) icon set included in your project. Validation of input is done in the frontend, rich text editing enabled for the textarea and a date picker in place for the archive date.
## Requirements
- TYPO3 >= 11.5
- ext:news >= 9.0
## Installation
- Install the extension by using the extension manager or use composer
- Include the static TypoScript of the extension
- Configure the extension by setting your own constants
## Usage
- Add the pluign ``News frontend`` on a page, which is restricted by the frontend user login
- Select a storage page in the plugin-tab in the field ``Record Storage Page``
- Now a frontend user is able to add, edit and delete own records
## PSR-14 Events
Following PSR-14 events are available:
- `Mediadreams\MdNewsfrontend\Event\CreateActionBeforeSave`: Called just before saving a new record
- `Mediadreams\MdNewsfrontend\Event\CreateActionAfterPersist`: Called after a new record was saved (new record Id is available)
- `Mediadreams\MdNewsfrontend\Event\UpdateActionBeforeSave`: Called just before an existig record will be updated
- `Mediadreams\MdNewsfrontend\Event\DeleteActionBeforeDelete`: Called just before a record will be deleted
### Register an event
Add following lines in `Configuration/Services.yaml` of your own extension:
```yaml
services:
Vendor\Extension\EventListener\MyListener:
tags:
- name: event.listener
identifier: 'ext-mdnewsfrontend/createActionBeforeSaveEvent'
method: 'enrichNews'
event: Mediadreams\MdNewsfrontend\Event\CreateActionBeforeSaveEvent
```
Add the class `Vendor\Extension\EventListener\MyListener` with the method `enrichNews` in your extension:
```php
namespace Vendor\Extension\EventListener;
use Mediadreams\MdNewsfrontend\Event\CreateActionBeforeSaveEvent;
final class MyListener
{
public function enrichNews(CreateActionBeforeSaveEvent $obj)
{
// Get news object
$news = $obj->getNews();
$news->setTeaser('Set some teaser...');
// Get NewsController
$newsController = $obj->getNewsController();
}
}
```
## Bugs and Known Issues
If you find a bug, it would be nice if you add an issue on [Github](https://github.com/cdaecke/md_newsfrontend/issues).
# THANKS
Thanks a lot to all who make this outstanding TYPO3 project possible!
## Credits
- Extension icon was copied from [ext:news](https://github.com/georgringer/news) and enriched with a pen from [Font Awesome](https://fontawesome.com/icons/pencil-alt?style=solid).
- Thanks to [Parsley.js](http://parsleyjs.org), which I use for validating the form in the frontend.
- Thanks to [tiny](https://www.tiny.cloud), which I use as rich text editor in the frontend.
- Thanks to [flatpickr](https://flatpickr.js.org/), which I use as date picker in the frontend.
- And last but not least thanks to the guys at [jQuery](http://jquery.com/).