Download the PHP package mediadreams/md_unreadnews without Composer

# TYPO3 Extension ``md_unreadnews`` This extension adds unread information to the records of ``ext:news`` for frontend users. In a list of news records, a frontend user can see, whether or not an article was read by himself. Additional it is possible to show how many unread articles are in a category. The extension is shipped with typoscript libraries, which can be included at desired places. ## Requirements - TYPO3 >= 11.5 - ext:news >= 9.0 ## Screenshots  ## 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 Available constants: - ``storagePid``: This is the uid of the page, where you want to store the unread records - ``categories``: Comma separated string of category uids. All news records which are connected to a configured category will be marked as unread. If you don't provide a category, all news records will be considered. - ``feGroup``: The uid of a feUserGroup. If provided, the unread info will only be set for users, who belong to this group. If not set, all users are considered. ## Usage As soon as you have installed and activated the extension, it will hook into the saving process of new news records. Everytime a backend user adds a new record, the unread info for this record and the configured feUsers will be added. ### List plugin The extension ships a plugin, which shows a list of all unread news for a user. In the ``Plugin Options`` you can set the link to the detail page. If you do not provide the detail page, the news record will be linked to the page of the first attached category. ### Show general unread counter This counter will show the number of unread items for a user. To show this information use the following code in your fluid template: ### Show unread info in list view Use the following code in the fluid template of the news extension to show, whether the current logged in feUser has read a news or not. Example: Copy ``ext:news/Ressources/Private/Partials/List/Item.html`` into your extension and modify the following:

{newsItem.title}

### Show unread info for categories With the following code snippet you can show the number of unread news according to categories: Example: Copy ``ext:news/Ressources/Private/Templates/Category/List.html`` into your extension and modify the following: {category.item.title} ### Remove unread info Remove the unread info as soon, as the user has read the news article. Therefore add the following code on the news detail page: Example: Copy ``ext:news/Ressources/Private/Templates/News/Detail.html`` into your extension and add the following code at the end of the template: ### Cleanup task This extension ships a scheduler task, which allows you to remove unread information, which is older than a certain period of days. Activate this job, by following these steps: - Switch to module `Scheduler` - Add a new task and choose in the select field `Class` the option `Execute console commands` - Fill all fields like you need them and use `mdUnreadnews:cleanup: Remove old unread information` in the field `Schedulable Command.` - After saving the task, you will be able to fill the field `Argument: days. Amount of days in the past till then all unread information shall be deleted. (integer)`. Enter the days how long you want to keep the unread information. Default is 30 days. ## 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_unreadnews/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 then modified.