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.
Linklayout with filetype and target icon¶
| Created: | 2008-12-05T21:19:18.930000000 |
|---|---|
| Changed: | 2014-07-30T16:54:04.356000000 |
| Classification: | rs_linklayout |
| Description: | The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- |
| Keywords: | linklayout, link, layout, filetype, target, forAdmins, forDevelopers, forEditors, forBeginners |
| Author: | Rene |
| Email: | typo3@rs-softweb.de |
| Info 4: | |
| Language: | en |
Linklayout with filetype and target icon -
rs_linklayout
Linklayout with filetype and target icon¶
Extension Key: rs_linklayout
Language: en
Keywords: linklayout, link, layout, filetype, target, forAdmins, forDevelopers, forEditors, forBeginners
Copyright 2008-2014, Rene, <typo3@rs-softweb.de>
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.org
Table of Contents¶
Linklayout with filetype and target icon 1
`Introduction 3 <#1.1.Introduction|outline>`_
`Users manual 4 <#1.2.Users%20manual|outline>`_
`Configuration 5 <#1.3.Configuration|outline>`_
`Known problems 6 <#1.4.Known%20problems|outline>`_
`To-Do list 7 <#1.5.To-Do%20list|outline>`_
`Changelog 8 <#1.6.Changelog|outline>`_
Introduction¶
What does it do?¶
This extension provides the functionality to format internal, external and mailto links in different styles and with different link icons.
If the linked files are of specified types (example *.pdf or *.doc), the extension shows also an file type icon.
Screenshot¶
Users manual¶
Simply install the extension and enjoy.
You may change some constants with the constant editor to change the settings.
To activate the images for links made in RTE simply mark the text and click on "Insert web link" ( arrow in image).
In the new windows select the type of link you want. It works like normal setting a link.
The images for target and file type are now created automatically in the frontend.
Special:
If you don't set a style/class (arrow in image) for this specific link, then no target or file type images are shown for this link. The frontend shows only the normal link without changes.
This is very useful for links with images like in the screenshot at beginning of documentation.
Configuration¶
There are some options for configuring. These are listed below.
TypoScript configuration
linkTargetEnabled¶
Property
linkTargetEnabled
Data type
boolean
Description
Target - Link image enabled
Default
true
linkTargetExt.file¶
Property
linkTargetExt.file
Data type
image
Description
File for the external image
Default
EXT:rs_linklayout/res/link_ext.gif
linkTargetExt.wrap¶
Property
linkTargetExt.wrap
Data type
wrap
Description
Wrap for the external image
Default
|
linkTargetExtParams¶
Property
linkTargetExtParams
Data type
string
Description
A-Tag params for the external link
If you use " or ' they are removed automatically.
Example:
class=linkExt rel=external
or
class="linkExt" rel='external'
Default
class=linkExt
linkTargetInt.file¶
Property
linkTargetInt.file
Data type
image
Description
File for the internal image
Default
linkTargetInt.wrap¶
Property
linkTargetInt.wrap
Data type
wrap
Description
Wrap for the internal image
Default
linkTargetIntParams¶
Property
linkTargetIntParams
Data type
string
Description
A-Tag params for the internal link
If you use " or ' they are removed automatically.
Example:
class=linkInt rel=internal
or
class="linkInt" rel='internal'
Default
class=linkInt
linkTargetMailto.file¶
Property
linkTargetMailto.file
Data type
image
Description
File for the mailto image
Default
EXT:rs_linklayout/res/link_mailto.gif
linkTargetMailto.wrap¶
Property
linkTargetMailto.wrap
Data type
wrap
Description
Wrap for the mailto image
Default
|
linkTargetMailtoParams¶
Property
linkTargetMailtoParams
Data type
string
Description
A-Tag params for the mailto link
If you use " or ' they are removed automatically.
Example:
class=linkMailto
or
class="linkMailto"
Default
class=linkMailto
linkFiletypeEnabled¶
Property
linkFiletypeEnabled
Data type
boolean
Description
Filetype - Link image enabled
Default
true
linkFiletypePaths¶
Property
linkFiletypePaths
Data type
string
Description
Search paths for the filetype icons
"EXT" is replaced with the extensions default icon path
Paths different from the extension path must be included in
$TYPO3_CONF_VARS['FE']['addAllowedPaths']
Default
EXT,typo3/gfx/fileicons/
linkFiletypeList¶
Property
linkFiletypeList
Data type
string
Description
Enabled extensions for filetype image
Whitespaces are removed automatically
Default
pdf,doc,zip
linkFiletypeHeight¶
Property
linkFiletypeHeight
Data type
int
Description
Max height of the filetype image in px
Default
12
linkFiletypeWrap¶
Property
linkFiletypeWrap
Data type
wrap
Description
Wrap for the filetype image
Default
|
[tsref: plugin.tx_rslinklayout]
Known problems¶
If you updated from an extension version before 1.3.0 you have to update your TS template, if you have set some values over the constant editor or directly in you template.
The configuration values have been changed in version 1.3.0 from "plugin.tx_rs_linklayout.*" to "plugin.tx_rslinklayout".The name of the class has been changed from "tx_rs_linklayout" to "tx_rslinklayout".
To-Do list¶
Your suggestions are always welcome!
If you think something is missing, feel free to contact me as well.
Changelog¶
- 1.2.0: second stable public version as extension. (full functional version)
- 1.2.1: changed behavior of link creation (params like "title" are not replaced by default)
- 1.2.2: email address of "Dirk Hoffmann" from extension description removed (his own wish)The extension manual has been updated to new manual template
- 1.3.0: changed TS-Config vars from "plugin.tx_rs_linklayout.*" to "plugin.tx_rslinklayout.*" and renamed the class from "tx_rs_linklayout" to "tx_rslinklayout".Added short user manual
- 1.3.1: added new config var "linkFiletypePaths". Search paths for the filetype icons are now customizable.
- 1.3.2: fixed Typo3 dependency in ext_emconf
8