Skip to content

Officious fork of TYPO3 extension "linkhandler" with support for TYPO3 CMS 6.0.

Notifications You must be signed in to change notification settings

nelo-digitalagentur/typo3-extension-linkhandler

 
 

Repository files navigation

Linkhandler

This is a fork of the linkhandler TYPO3 extension.

About this fork

This is an experimental version of the linkhandler extension that aims to minimize the amount of duplicate code.

Additionally, all legacy code was removed, the goal is to provide a version that is compatible with TYPO3 6.2.

Additional features

This Extension offers some additional features compared to the original version.

Multiple configurations for the same table

It is now possible to create links to the same table within different configurations. E.g. you could link to different content types to different target pages.

For this to work the links now consists of four parts instead of three. The old link block looked like this:

record:<table_name>:<uid>

The new link block looks like this:

record:<config_key>:<table_name>:<uid>

This feature is backward compatible. If an old link is detected that consists only of three parts the first configuration found for the linked table will be used.

Record filtering

The records that are displayed in the list can be filtered by SQL queries. You can define a search query for each table configured in listTables. This is an example configuration for using the additionalSearchQueries option in the TSConfig:

mod.tx_linkhandler.tx_myext_imagelinks {
	label = Image link
	listTables = tt_content
	additionalSearchQueries {
		tt_content = AND tt_content.CType='image'
	}
}

Page tree mount points

You can configure mount points for the page tree that is displayed in the element browser.

For example if you only want to diplay the pages where your news records are located (in this example PID 123 and 234) you can use the following Page TSConfig:

mod.tx_linkhandler.tx_news_news.pageTreeMountPoints {
	1 = 123
	2 = 234
}
RTE.default.tx_linkhandler.tx_news_news.pageTreeMountPoints < mod.tx_linkhandler.tx_news_news.pageTreeMountPoints

Linkvalidator support

This linkhandler version comes with its own linkvalidator link type that supports the new link format with four parameters and provides some additional features that are not merged yet to the core.

To use it you have to adjust your linkvalidator TSConfig:

mod.linkvalidator {
	linktypes = db,external,tx_linkhandler
}

Please not that you need to use tx_linkhandler instead of linkhandler which is the default link type that comes with the core.

This link type comes with an additional configuration option that allows the reporting of links that point to hidden records:

mod.linkvalidator {
	tx_linkhandler.reportHiddenRecords = 1
}

For this additional option to work this pending TYPO3 patch is required: https://review.typo3.org/#/c/26499/ (Provide TSConfig to link checkers). There is a TYPO3 6.2 fork that already implements the required patches (and some more) at Github: https://github.com/Intera/TYPO3.CMS

Additional goodies

  • When editing a link the correct tab will open automatically.
  • The searchbox below the record list can be disabled by setting enableSearchBox = 0 in the tab configuration in TSConfig.
  • SoftReference handling using signal slots, TYPO3 patch pending: https://review.typo3.org/27746/
  • The current link is displayed in a nice label consisting of the localized table label and the linked record title.

Tips & Tricks

Link browser width

You can use TSConfig to increase the with of the link browser windows in the Backend to prevent problem with the styles:

RTE {
	default {
		buttons {
			link {
				dialogueWindow {
					width = 600
				}
			}
		}
	}
}

Missing Feature

The last missing feature in this version is the handling of the "Save and show" button.

About

Officious fork of TYPO3 extension "linkhandler" with support for TYPO3 CMS 6.0.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 99.9%
  • CSS 0.1%