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.
EXT: chnewsfeeds¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed: | 2008-05-18T09:37:18 |
Author: | Georg Ringer |
Email: | http://www.cyberhouse.at |
Info 3: | |
Info 4: |
EXT: chnewsfeeds¶
Extension Key: chnewsfeeds
Copyright 2000-2002, Georg Ringer, <http://www.cyberhouse.at>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.com
Table of Contents¶
EXT: chnewsfeeds 1
Introduction 1
What does it do? 1
Screenshots 1
Users manual 3
Configuration 3
Title & Description 3
Categories - General Storage PID 3
Reference 3
Feed Configuration 4
You like the extension? 4
Known problems 4
To-Do list 5
Changelog 5
Introduction¶
What does it do?¶
This extension allows you to display template-based RSS-Feeds based on tt_news categories. The editor is able to choose which feeds (=categories) are shown including title and description.
Please take a look at the screenshots to get an idea.
|img-1| This extension has been created by CYBERhouse
Screenshots¶
Image 1: Feed list in the frontend
Image 2: Backend plugin with selected titles, descriptions and categories
Users manual¶
To use this extension follow these steps:
Install the extension
Insert the Plugin on the same page and choose the categories you want to display
Include static TS “News-feed (RSS,RDF,ATOM)”
Read the next section to get further information!
Configuration¶
Title & Description¶
You can set a title and a description for every feed in the plugin. One line is for one feed!
If you leave a line empty, the title & description of the category record will be taken! This is set with the (included) TS:
# TS Code
lib.chnewsfieldsnewstitle = RECORDS
lib.chnewsfieldsnewstitle {
tables = tt_news_cat
source.field = tx_chnewsfeedsCat
conf.tt_news_cat = TEXT
conf.tt_news_cat {
field = title
#noTrimWrap = |Kategorie: | |
}
}
plugin.tx_chnewsfeeds_pi1 {
title {
trim = 1
ifEmpty.stdWrap.cObject < lib.chnewsfieldsnewstitle
}
}
Categories - General Storage PID¶
There is not much to configure. Important is that the extension uses the General Storage PID of tt_news. So if you have enabled this in tt_news, you need to set the pid with the tt_news categories as for the tt_news plugin.
More information can be found in the manual of tt_news!
Each category represents a link¶
Setting the checkbox called “Each category represents a link “ will show just 1 RSS feed including all chosen categories.
Reference¶
templateFile¶
Property
templateFile
Data type
string
Description
Path to the template
Default
EXT:chnewsfeeds/res/template.html
pathToCSS¶
Property
pathToCSS
Data type
string
Description
Path to the CSS file. Leave this empty to include no CSS file.
Default
EXT:chnewsfeeds/res/rss.css
splitChar¶
Property
splitChar
Data type
int
Description
The decimal code of the split character: 10 Means line break, 42 would be a *
Default
10
link¶
Property
link
Data type
Typolink configuration
Description
The link to the RSS feed is generated with this configuration. As shown you could override the target page.
Default:
link {
#parameter.override = 101
useCacheHash = 1
additionalParams = &type=100&tx_ttnews[cat]={field:tx_chnewsfeedsCat}
additionalParams.insertData = 1
}
Default
title¶
Property
title
Data type
stdWrap
Description
Modify the link-text. lib.chnewsfieldsnewstitle holds the title of the category.
Default:
title {
trim = 1
ifEmpty.stdWrap.cObject < lib.chnewsfieldsnewstitle
}
Default
description¶
Property
description
Data type
stdWrap
Description
Modify the link-text.lib.chnewsfieldsnewsdescription holds the description of the category.
Default:
description {
trim = 1
ifEmpty.stdWrap.cObject < lib.chnewsfieldsnewsdescription
stdWrap {
wrap = <div class="description"> |</div>
required = 1
}
}
Default
[tsref:plugin.tx_chnewsfeeds_pi1 ]
Feed Configuration¶
The feed itself is still configured with tt_news! The extension chnewsfeeds just generates the links to the feed!
If you want to change the feed itself, you need to take a look at the manual of tt_news! I for myself changed the configuration a bit and it looks like this:
# TS Code
xmlnews = PAGE
xmlnews {
typeNum = 100
10 >
10 < plugin.tt_news
10 {
pid_list >
pid_list = 83
recursive >
recursive = 10
singlePid = 42
defaultCode = XML
dontUseBackPid = 1
useSPidFromCategory = 1
useSPidFromCategoryRecusive = 1
useHRDates = 1
useSubCategories = 1
displaySubCategories = 1
categoryMode = 1
}
config {
disableAllHeaderCode = 1
additionalHeaders = Content-type:text/xml
no_cache = 1
xhtml_cleaning = 0
}
}
You like the extension?¶
I had much work with this extension so if you like this extension, you can do one or more of the following things:
- Write me a mail or create a posting at http://www.rggooglemap.com/dev/chnewsfeeds.html .
- Please rate the extension in the Repository: http://typo3.org/extensions/ search for chnewsfeeds, click on the title and then at “Ratings” (You need to be registered and logged in at typo3.org)
- Donate something, so that I can write those kind of extensions for you. More information is here: German: http://www.rggooglemap.com/menu/spende.html and English: http://www.rggooglemap.com/en/2/donate.html . Thanks!
One of those things is the least you can do for getting all those great extensions completely for free!
Known problems¶
- If you use realUrl to rewrite the tt_news category parameters, disabling the checkbox “Each checkbox represents a link” won't work.
- Nothing else known but please tell me if you found a problem!
To-Do list¶
Nothing planned! If I I missed something please tell me!