tt_news

< 1.3.14. Troubleshooting

Table Of Content

1.5.2. >

1.4. 1.5. Administration

1.5.1. Link Configuration

There are several kinds of links in a news record. The table below gives you an overview which parameters will affect which link. In the graphic you see the possible links in a news "LATEST" element. The links in the "LIST" elements work exactly like those in "LATEST" elements. The links in the "AMENU" are configured with the same parameters as the "Archive Link" (4). The Links in the "SINGLE" view are explained after this.

Link Description:	Link-Configuration:	Link-Configuration in Framesets:
	No special settings required External links will use the target, given in the link-field in the news-record. If there is no target given they will use the global target for external links. Example: This will open typo3.org in the same window:
	No special settings required	Required Settings: The global target for all links has to be defined in your main template (e.g.: PAGE_TARGET = page). Optional: If you want the news links to internal pages point to another frame, you can override the global target with this setting. plugin.tt_news { pageTypoLink.target = _top }
Links in "normal" newsitems that points to the single-view. These links are inserted to the HTML template by the ###LINK_ITEM### markers. Example: <!--###LINK_ITEM###--> ###NEWS_IMAGE### <!--###LINK_ITEM###-->	Required Settings: All (red-marked) links will point to the page id=132. This is the page which contains the news "SINGLE" content element (also known as: singlePid). plugin.tt_news { singlePid = 132 }	Required Settings: All (red-marked) links will point to the page id=465 and will open it in the frame that is configured as target for internal links from constants (e.g.: PAGE_TARGET = page). plugin.tt_news { singlePid = 465 }
Category Shortcut Category link: Type "shortcut" This link points to a page in the same pagetree. Example: plugin.tt_news { catImageMode = 2 }	No special settings required	Required Settings: For category shortcuts that point not to the same frame in which they are displayed, it is required to define the target in the "news category" db record:
Catselector Category link: Type "category-selector" This link will filter the displayed news or archivemenu-items by category. Example: plugin.tt_news { catTextMode = 3 }	No special settings required	Required Settings: If the catselector links should point to the current frame, there is no special setting required. If the catselector links should point to another frame, add this to your TS setup: plugin.tt_news { itemLinkTarget = page catSelectorTargetPid = 78 } with this setting the catselector links point to page id=78 in the frame named "page".
Archive Link - used in the "LATEST" element (example html-template) for the link that points to the page with the archive listing (marker: ###GOTOARCHIVE###) - and used for links in the "AMENU" element (archive menu). If you want the links in the archive menu point to another page, you can enter the PID of this page here.	Required Settings: plugin.tt_news { archiveTypoLink.parameter = 34 } In the example the "Archive Link" in the LATEST element points to the page with id=34. This page contains an "AMENU" content-element. The links in the "AMENU" element are configured with the same settings, but those links expect a page with a "LIST" element as target. That page is configured to list only archived newsitems. If you set this value from the Contstant-Editor for all news content-elements, this "LIST" has to be on the same page as the "AMENU". The target for this link is configured as the global PAGE_TARGET in constants. See section "The Archive" for more information about linking the "AMENU" to other news content elements or pages.
Pagebrowser links (not in the graphic)	No special settings required. The pagebrowser links in "LIST" view will point to the global "PAGE_TARGET" if one is defined in the constants.

Link Description:

Link-Configuration:

Link-Configuration in Framesets:

No special settings required

External links will use the target, given in the link-field in the news-record. If there is no target given they will use the global target for external links.
Example:

This will open typo3.org in the same window:

No special settings required

Required Settings:

The global target for all links has to be defined in your main template (e.g.: PAGE_TARGET = page).

Optional:

If you want the news links to internal pages point to another frame, you can override the global target with this setting.

  plugin.tt_news {

    pageTypoLink.target = _top

Links in "normal" newsitems that points to the single-view.

These links are inserted to the HTML template by the ###LINK_ITEM### markers.

Example:

  <!--###LINK_ITEM###-->

  ###NEWS_IMAGE###

  <!--###LINK_ITEM###-->

Required Settings:
All (red-marked) links will point to the page id=132. This is the page which contains the news "SINGLE" content element (also known as: singlePid).

  plugin.tt_news {

    singlePid = 132

Required Settings:
All (red-marked) links will point to the page id=465 and will open it in the frame that is configured as target for internal links from constants (e.g.: PAGE_TARGET = page).

  plugin.tt_news {

    singlePid = 465

Category Shortcut

Category link: Type "shortcut"

This link points to a page in the same pagetree.

Example:

  plugin.tt_news {

    catImageMode = 2

No special settings required

Required Settings:
For category shortcuts that point not to the same frame in which they are displayed, it is required to define the target in the "news category" db record:

Catselector

Category link: Type "category-selector"
This link will filter the displayed news or archivemenu-items by category.

Example:

  plugin.tt_news {

    catTextMode = 3

No special settings required

Required Settings:

If the catselector links should point to the current frame, there is no special setting required.

If the catselector links should point to another frame, add this to your TS setup:

  plugin.tt_news {

    itemLinkTarget = page

    catSelectorTargetPid = 78

with this setting the catselector links point to page id=78 in the frame named "page".

Archive Link

- used in the "LATEST" element (example html-template) for the link that points to the page with the archive listing (marker: ###GOTOARCHIVE###)

- and used for links in the "AMENU" element (archive menu). If you want the links in the archive menu point to another page, you can enter the PID of this page here.

Required Settings:

  plugin.tt_news {

    archiveTypoLink.parameter = 34

In the example the "Archive Link" in the LATEST element points to the page with id=34. This page contains an "AMENU" content-element. The links in the "AMENU" element are configured with the same settings, but those links expect a page with a "LIST" element as target. That page is configured to list only archived newsitems.
If you set this value from the Contstant-Editor for all news content-elements, this "LIST" has to be on the same page as the "AMENU". The target for this link is configured as the global PAGE_TARGET in constants.

See section "The Archive" for more information about linking the "AMENU" to other news content elements or pages.

Pagebrowser links

(not in the graphic)

No special settings required.

The pagebrowser links in "LIST" view will point to the global "PAGE_TARGET" if one is defined in the constants.

Links in the "SINGLE" view

Some of the link-types in the single view are configured with the same parameters as shown in the table above:

Links to internal pages (see -> getRelatedCObject)
Links to external URLs (see -> getRelatedCObject)
Category-links that point to category-shortcuts (2) (the catselector mode will not work - and does not make sense - in single view)

Link Description:	Link-Configuration:	Link-Configuration in Framesets:
Links to "related news"	No special settings required (see -> getRelatedCObject )
Links to Files	The links to files are configured with the "filelink" object. (see -> newsFiles)
News Links	The news "Links" are parsed through the "general_stdWrap". (see -> general_stdWrap) Hint: you can add "typolinks" to this field: <LINK http://mysite.com _blank>open mysite</LINK> This will open the linked site in a new browser window. The link will appear as "open mysite" in SINGLE view.
Back-Link	This links points to the last "LIST" or "LATEST" view. Usually the page that linked to the "SINGLE" view. (see -> backPid)
Image Link in Single view	No special settings required, in the default configuration these links point to a javascript that opens the image in a pop-up window. (see -> imageWrapIfAny )
Email link Text Links in news bodytext	No special settings required This links use the global settings for links
Search page id (not in the graphic)	If you want the search button in the "SEARCH" content element point to another page than the current you can define this page as "searchPid". (see -> searchPid )

To top