georgringer/news-filter

Filter news by date, categories and tags

2.1.0 2024-02-27 20:21 UTC

Requires

• georgringer/news: ^11.0
• typo3/cms-core: ^11.5 || ^12.4

Replaces

• typo3-ter/news-filter: 2.1.0

GPL-2.0-or-later

• Georg Ringer

• filter
• extension
• news
• typo3

README

This extension makes it possible to filter news in the frontend by the following properties:

• date from & to
• categories
• tags
• sword

This extension has been sponsored by University Basel

Requirements

• TYPO3 11.5 or 12.4
• EXT:news 11.x

Usage

1. Install the extension just as any other extension. Either use the Extension Manager or composer and composer require georgringer/news-filter.
2. Select the action "list" in the news plugin and activate the additional checkbox "Enable filter".
3. Select folders containing categories & tags.

TypoScript

The following TypoScript is required

plugin.tx_news.settings.demandClass = GeorgRinger\NewsFilter\Domain\Model\Dto\Demand

Templating

Add the following part to your News/List.html:

	<f:form action="list" object="{extendedVariables.searchDemand}" name="search" class="form-horizontal">
		<fieldset>
			<div class="form-group">
				<label for="news-subject"><f:translate key="search-subject" /></label>
				<f:form.textfield id="news-subject" property="subject" class="form-control"/>
			</div>
			<div class="form-group">
				<f:for each="{extendedVariables.categories}" as="category">
					<div class="checkbox">
						<label>
							<f:form.checkbox property="filteredCategories" value="{category.uid}"/>
							{category.title}
						</label>
					</div>
				</f:for>
			</div>
			<div class="form-group">
				<f:for each="{extendedVariables.tags}" as="tag">
					<div class="tag">
						<label>
							<f:form.checkbox property="filteredTags" value="{tag.uid}"/>
							{tag.title}
						</label>
					</div>
				</f:for>
			</div>

			<div class="form-group">
				<label for="fromDate" class="col-sm-2 control-label">Date from</label>
				<div class="col-sm-10">
					<f:form.textfield type="date" class="form-control" id="fromDate" property="fromDate"/>
				</div>
			</div>
			<div class="form-group">
				<label for="toDate" class="col-sm-2 control-label">Date to</label>
				<div class="col-sm-10">
					<f:form.textfield type="date" class="form-control" id="toDate" property="toDate"/>
				</div>
			</div>

			<f:form.submit value="submit" class="btn btn-primary"/>
		</fieldset>
	</f:form>

Order categories and tags

plugin.tx_news {
	settings {
		filterCategoriesOrderBy = title
		filterCategoriesOrderDirection = asc

		filterTagsOrderBy = title
		filterTagsOrderDirection = asc
	}
}