EXT: Pinned Sites¶

What does it do?¶

This extension provides administrators an easy way to get the new feature of Internet Explorer 9 for Windows 7, namely Pinned Sites, on a TYPO3 website. This extension let you configure all the parameters for such a pinning. This includes the possibilities to define jump list tasks, and a custom jump list category generated either from an RSS feed or a TYPO3 folder.

More information about Pinned Sites can be found at:

• Pinned Sites: http://windows.microsoft.com/en-US/internet- explorer/products/ie-9/features/pinned-sites
• Introduction to Pinned Sites: http://msdn.microsoft.com/en- us/library/gg491738(v=vs.85).aspx

This manual is also available as a PDF document. Click here to download it .

Screenshots¶

Example: A setup with a RSS feed jump list and some quick accessible tasks (shortcuts).

Installation and setup¶

Install the extension using Ext Manager .

On a SITE include Pinned Sites (pinned_sites) . This is done by going to Template → A page → Edit the whole template record → Includes → Choose Pinned Sites (pinned_sites) under Include static (from extensions) .

How to setup the extension¶

To get the setup you want to have, then do the following to specify the precise setup:

Go to Template → A page → Choose Constant Editor → Under Category choose PLUGIN.PINNEDSITES .

Now you can define all the TypoScript configurations of the extension (see the section TypoScript configuration).

How to setup a folder with tasks / jump list items¶

The TypoScript property folderPidForTasks and folderPidForJumpList takes as parameters an int, which is expected to be and PID of a folder in TYPO3 containing shortcuts. A folder with such items can be setup as follows:

Go to Page .

Right click on a item and choose New → Create a new page .

Change the type to: SysFolder

(For “folderPidForJumpList” the name of the folder will be the name of the custom jump list category.)

To add shortcuts to this folder (in other words: to add tasks/shortcuts to your jump list), do the following:

Right click on the folder and choose New → Create a new page (inside) .

Change the type to: Shortcut or Link to external URL .

Give it a pagetitle . This will be the name of the item shown in the jump list.

The destination of the jump list item can be defined by either setting up Shortcut to page (for Shortcut)or URL (for Link to external URL).

If you want the jump list item to have another icon than the default chosen, then upload a ico file to the property Files of the shortcut.

The items of these jump list can be localized by using the standard TYPO3 localization of items/pages ( Localization → Create new page translation ). An example of this is shown on the image below.

How to localize the configuration¶

If you want to localize the configuration of this extension, e.g. say you want the Pinned Site to have an RSS feed in English as the jump list for your English site, and a RSS feed in Danish as the jump list for your Danish site, this can be done as follows:

Go to Template → A page → Choose Info/Modify → Edit the whole template record .

Under Constants you will see all the configurations you have done (starting with “plugin.tx_pinnedsites_pi.”)

To define the settings for another language, which for example have the id 2, enter: [globalVar = GP:L=2]

After this enter the settings your want for that language.

End it by entering the following: [global]

Example: Setup of a default language and a alternative language (here Danish and English)

FAQ:¶

TypoScript configuration¶

The following section will describe the different TypoScript constants that can be set. The default column is the values set by the TS template Pinned Sites (pinned_sites) .

“plugin.tx_pinnedsites_pi” have the following TypoScript properties.