Download the PHP package itplusx/flexible-news without Composer
On this page you can find all versions of the php package itplusx/flexible-news. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download itplusx/flexible-news
More information about itplusx/flexible-news
Files in itplusx/flexible-news
Package flexible-news
Short Description Flexible news extension to use pages as news articles
License MIT
Homepage https://itplusx.de
Informations about the package flexible-news
TYPO3 Extension flexible_news
Create news articles based on normal pages in TYPO3 and display them as a list in the frontend.
Using pages instead of records has the following advantages:
- No extra TCA required
Since this extension uses the default pages of TYPO3 and it's TCA fields, it's not necessary to have extra TCA field declarations. (unless you need additional fields) - No extra database tables
This extension only uses thepages
table and therefore no extra tables are needed. This prevents bloating the database with additional tables and fields. - No
routeEnhancers
hassle
The url of the news article will be representing the page tree and will work out of the box. No need to addrouteEnhancers
. The slug of every article can be changed with theslug
field and is not bound to the article title. - Construct flexible articles with available content elements without being bound to a pre-defined markup
When using records as news articles the markup for every article is pre-defined in the templates.
While with pages as news, every article can be build differently with content elements without being bound to a fixed template.
This extension utilizes EXT:flexible_pages to create a custom "News" pageType and a template for the list content element.
Installation
Extension installation
Installation with composer
(recommended)
Installation with the TYPO3 Extension Manager
Use the Extension Key flexible_news
in the
TYPO3 Extension Manager.
NOTE: This extension requires EXT:flexible_pages to be installed.
Include TypoScript
Base TypoScript
After a successful install just include the TypoScript for the News List CE and you are all set.
CSS TypoScript (optional)
If you want to use the CSS for the News List CE that is shipped with this extension you have to include the Flexible News CSS (optional) TypoScript as well.
Usage
When everything is installed correctly you should see a new page icon above your page tree in the TYPO3 backend. From there you could just pull it down into the page tree like with every other page.
NOTE: If you don't see that icon at first, try to clear the cache and reload the entire page.
List View
You can add the "Pages of selected doktypes" content element to every page to render a list of articles by doktype in the frontend. The content element already comes with a "News" template to render the list accordingly.
Override List Template
You can override the List CE template. To do that you have to extend the FLUIDTEMPLATE rootPaths. You can either do this in
your own extension by extending the lib.contentElement
TypoScript
(as described HERE)
or you could use the constants provided by flexible_news:
plugin.tx_flexiblenews.templateRootPath
plugin.tx_flexiblenews.partialRootPath
plugin.tx_flexiblenews.layoutRootPath
Extend List Templates
When more News List Templates are required (e.g News List without images) the template select can be extended.
Please have a look at the documentation of EXT:flexible_pages or see how it's done in flexible_news for the "News" template.
Detail View
The detail view is just a view of the page (with the default page template). However sometimes it might be quite useful to have a special page template for just the news articles (e.g to show specific content on every news article).
Adding News Article Page Template
Assuming you want to add social media share buttons to every news article you have to do the following.
-
Add TypoScript for special dokType to override FLUIDTEMPLATE:
- Add the previously defined variable to the template file wherever the share buttons should appear:
<f:format.html parseFuncTSPath="">{socialMediaShare}</f:format.html>
Contribution
Any help on this project is very welcome! May it be as code contribution or just an idea for improvement. But we would like to ask you to follow some rules:
- Issues:
When adding issues please always describe the bug/feature/task as detailed as possible. Only providing a title is not enough. Please use issue templates. - Commits:
Our team is following the Conventional Commits. We would like ask you stick to these rules whenever you want to contribute. - Pull Requests:
Before you submit a PR please create an issue first and link it to the pull request or at least add a PR description with detailed information about what this PR does. Otherwise we are not able to decide if this PR is worth going into the main branch.