DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
Documentation for TYPO3 extension just_news¶
Installation¶
Install via composer¶
composer require spooner-web/just_news
Install via Extension Manager¶
- Open Extension Manager in TYPO3 backend
- Search for
just_news
- Download and install it
- You need to install and use extension
fluid_styled_content
Integrators Guide¶
Integrate extension¶
- Include static template
- Create a sys folder
- Edit the page properties and add PageTS
News pages (sys folder)
to make sure only news pages (or sys folders) will be created below - Create a content element and switch to
News listing
- Add the sys folder to
Pages with news sub elements
Enhancing extension¶
By adding template, partial and layout paths to lib.fluidContent
with their
subsections templateRootPaths
, partialRootPaths
and layoutRootPaths
you can
create own templates and override the original ones.
To change the markup of the news listing you can add this code into TypoScript:
lib.fluidContent {
templateRootPaths {
40 = EXT:my_ext/Resources/Private/Templates
}
partialRootPaths {
40 = EXT:my_ext/Resources/Private/Partials
}
layoutRootPaths {
40 = EXT:my_ext/Resources/Private/Layouts
}
}
Configuration¶
Property
maxItems
Data type
integer+
Description
The maximum news items appearing on the listing
Default
0 (means no limit)
Editors Guide¶
Add a news article¶
- Go to the news sys folder
- Create a news page below the sys folder (the sorting is irrelevant as the news articles will be sorted by datetime in the listing)
- Title and datetime are mandatory fields
- You can add an image in resources tab and an abstract in main tab which will be shown in the listing
- You can add a sys_category to categorize the article
- To create content, just add content elements to this page
- You can set visibility settings as well as start- and endtime to either the news page or even the content elements
Frequently asked questions¶
Is there a possibility to add content elements to an article?¶
As you are using a page as article you only have the possibility to use content elements. But think about the possibilities you have with the freedom of using any content element (and even plugins).
How can I use different layouts for an article?¶
As you are using a page as article you are free to use every layout (e.g. backend layouts) for your news article.
Is there a configuration for RealURL?¶
You don't need a configuration as you are free to create a speaking url by your sys folder and page structure.
If you set the sys folder named news
below root page and add your articles into the sys folder you will have the url
example.com/news/the-title-of-your-article
. And all without extra configuration. Cool, hm?
I want to make a TYPO3 upgrade. Do I need to be careful?¶
As long as you are using fluid_styled_content
, you don't have to care of anything when upgrading.
The extension is using TYPO3 core features and don't need any extra tables, Extbase models or repositories.
It is very confusing in the page tree if there are many articles.¶
You can manage your articles in subfolders, e.g. the year of the article. So you have all 2016 articles in one folder and
the 2017 articles in another folder. RealUrl will handle that by adding the year into the url like
example.com/news/2017/the-title-of-your-article
.
If you have too many articles per year, you can add more subfolders as months. Or you use a type of category instead of the date.
The good thing is, you are free to do what you want. It just works.
Wish list¶
1. Include a page browser 1. Importer for tt_news and news
Contribute¶
Feel free to contribute or test the extension! Here you can get in contact: