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: timtab_sociable¶

Author:	Kasper Skårhøj
Created:	2002-11-01T00:32:00
Changed:	2007-12-08T23:01:27
Classification:	TIMTAB - social bookmark services
Keywords:	timtab, bookmarks
Author:	Frank Nägler
Email:	typo3@naegler.net
Info 3:
Info 4:

EXT: timtab_sociable¶

Extension Key: timtab_sociable

Please report bugs and new feature requests at http://bugs.naegler.net/

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: timtab_sociable 1

Introduction 1

What does it do? 1

Screenshots 1

Users manual 1

Adminstration 2

Configuration 2

Reference 2

Tutorial 3

references 3

Known problems 3

To-Do list 3

Changelog 3

Introduction¶

What does it do?¶

This extension shows a line of small icons of social bookmark services. with this buttons an user can add your blogpost easy to the services. Since version 1.0.4 you can use this extension on every page, not only on blogpost singleviews.

Importend hint : since version 1.1 I have change the processing of the tagline. Since this version the text for the tagline will be get from locallang.xml. This change was necessary for overwriting the value by TypoScript.

Importend hint : since version 2.0.0 I have change the processing of the icons. Since this version it is more comfortable to activate, deactivate, disable or sort the icons. All is now configured by TypoScript.

Importend hint : since version 2.0.2 I have change the processing of the global iconTarget and global iconWrap. Since this version it is configured by constants editor.

Screenshots¶

Users manual¶

This extension is easy to use. You only need to do are the next three steps:

Install the extension from TER

add the static template “timtab_sociable” to your main template

add the Plugin “social bookmark icons” (tx_timtabsociable_pi1) on your single-view page of your blog or anywhere on your website.

For configuration options see the section Configuration of this documentation.

Adminstration¶

All administration can be done by TypoScript on your main template. See all configuration options in section Configuration of this documentation.

Configuration¶

All configuration can be done by TypoScript, see the following table for all options you can set.

Reference¶

.tagline¶

Property

.tagline

Data type

stdWrap

Description

Any freetext you will place at the top of the icons-row. You can change the text by overwriting the locallang.xml values.

Default

social bookmark now:

.outerWrap¶

Property

.outerWrap

Data type

stdWrap

Description

wrap for the complete row of Icons included the tagline

Default

none

.alternativeTitle¶

Property

.alternativeTitle

Data type

cObj

Description

an alternative title, default is the page title of the current page.

Default

alternativeTitle = TEXT

alternativeTitle.field = title

.activeServices¶

Property

.activeServices

Data type

String

Description

comma separated list of active services. this option activates and sort the icons to display. change the order of the “service-keys” (see next option), or remove “service-keys” to deactivate the icon in frontend.

Default

all available services are activated

.services¶

Property

.services

Data type

Array

Description

this option is an array of available services. each service get its own “service-key”. This way you can easily add more services and activate it by adding the service-key to the “activeServices” option. see on the next rows how to configure new services and take a look at the example after this table.

Default

.services.[service-key]¶

Property

.services.[service-key]

Data type

String

Description

the service-key must be unique, so you have to check first if the key is used allways.

Default

.services.[service-key].icon¶

Property

.services.[service-key].icon

Data type

cObj: IMAGE

Description

configuration for the icon.

Default

.services.[service-key].url¶

Property

.services.[service-key].url

Data type

String

Description

the url for the service to bookmark a page. You can use two placeholder/marker in the url, which will be replaced.Marker:%TITLE% will be replaced with the title of the blogpost or the alternativeTitle.%URL% will be replaced wtth the URL to the blogpost or current page.

Default

.services.[service-key].title¶

Property

.services.[service-key].title

Data type

String

Description

title for the anchor which wrap the icon

Default

.services.[service-key].target¶

Property

.services.[service-key].target

Data type

String

Description

the link target for the icon

Default

plugin.tx_timtabsociable_pi1.iconTarget

.services.[service-key].wrap¶

Property

.services.[service-key].wrap

Data type

stdWrap

Description

stdWrap for the icon

Default

plugin.tx_timtabsociable_pi1.iconWrap

[tsref:plugin.tx_timtabsociable_pi1]

((generated))¶

Example¶

Here you would show an example of adding new services:

plugin.tx_timtabsociable_pi1 {
        services {
                myNewService {
                        icon {
                                file = fileadmin/icons/myNewService.png
                                icon.altText = myNewService
                                icon.titleText = myNewService
                        }
                        url = http://www.example.rl/add.php?url=%URL%&amp;title=%TITLE%
                        title = myNewService
                        target < plugin.tx_timtabsociable_pi1.iconTarget
                        wrap < plugin.tx_timtabsociable_pi1.iconWrap
                }
        }
        activeServices := addToList(myNewService)
}

Tutorial¶

Install extension from TER

add static temaplte “timtab_sociable” to your main template

add the Plugin “social bookmark icons” (tx_timtabsociable_pi1) to your single view template

references¶

In this section, and on my website I would build up a references list of sites which use this extension. It would be very nice if you send me an email to typo3@naegler.net with the URL to your website inside where you use this extension.

Known problems¶

Not really a problem, but since version 1.1 I have change the processing of the tagline. Since this version the text for the tagline will be get from locallang.xml. This change was necessary for overwriting the value by TypoScript.

Nothing yet, please report bugs at http://bugs.naegler.net/

To-Do list¶

I have no idea, do have any ideas for improvements or find bugs? Or you know about an other social bookmark service which is not supported yet by this extension? Let me know at http://bugs.naegler.net/

Changelog¶

08.12.2007 Frank Nägler <typo3@naegler.net>

release 2.0.3

bugfix: wrong call for stdWrap on iconWrap

added new bookmark service (hype.yeebase.com) hype it! yeah ;-)

05.11.2007 Frank Nägler <typo3@naegler.net>

release 2.0.2

bugfix: wrong TypoScript config #0000030

03.11.2007 Frank Nägler <typo3@naegler.net>

release 2.0.1

bugfix: wrong TypoScript config (copy failure)

13.10.2007

release 2.0.0

reimplementation of the extension.

services can be configured by TypoScript

documentation updated

added new bookmark service (oneview.de) thanks to Christoph Moeller for this hint

05.10.2007

added new bookmark service (tagthat.de) thanks to Markus Gevers for this hint

bugfix #0000028: .tagline has no effect

11.07.2007

improvement of the generated URLs (& = &)

added new bookmark service (folkd.com) thanks to Bernd Wilke for this hint

added new bookmark service (linkarena.com) thanks to Bernd Wilke for this hint

added new bookmark service (webnews.de) thanks to Bernd Wilke for this hint

23.01.2007

added new bookmark service (yigg.de)

27.12.2006

added new bookmark service (addthis.com)

added new bookmark service (ask.com)

added new bookmark service (backflip.com)

added new bookmark service (stumbleupon.com)

added new bookmark service (google.com)

added new bookmark service (live.com)

added new bookmark service (technorati.com)

added new bookmark service (netscape.com)

added new bookmark service (wink.com)

added new bookmark service (bluedot.us)

19.12.2006

new feature: know you can use this extension on every page not only on Blog-Posts

06.10.2006

added new bookmark service (de.lirio.us)

added new bookmark service (fark.com)

added new bookmark service (feedmelinks.com)

added new bookmark service (linkagogo.com)

added new bookmark service (netvouz.com)

added new bookmark service (rawsugar.com)

added new bookmark service (scuttle.org)

added new bookmark service (shadows.com)

added new bookmark service (simpy.com)

added new bookmark service (smarking.com)

added new bookmark service (wists.com)

bugfix #0000011: Path to image incorrect

10.09.2006

added new bookmark service (digg.com)

added new bookmark service (newsvine.com)

09.09.2006

added documentation

added new bookmark service (mylink.de)

08.09.2006

Initial release

EXT: timtab_sociable - 4