EXT: sb_downloader¶

What does it do?¶

Download system with many features. Displays downloads with short description, click counter, file size and image preview. It is possible to create a detail site of each download.

Credits (look into the changelog at the end of this manual):¶

From Sebastian: Thanks to Kurt Kunig ( www.kupix.de ) for several add-ons and manual revision.

From Kurt: Thanks to Sebastian Baumann for the initial idea and the source base of version 0.1.2

Screenshots¶

Standard without image preview:

Standard with image preview:

Complete list of all downloads (no “starting point” selected and “ plugin.tx_kkdownloader_pi1.defaultDownloadPid = all ” and a separate html-template selected in the typoscript setup):

Install the Extension¶

The first step you need to do is to install the extension – kk_downloader – with the extension manager. You can get it by going to Tools section and choosing “Ext Manager” on the main action menu (usually on left-side). Then in the dropdown Menu at the top, select “Import Extensions” in the Menu at top. Then type “ kk_downloader ” in the “Extensions in TYPO3 Extension Repository” and click on the “Look up” button. You should then find this extension.

If you have never installed this, then you will see a red arrow to the left of “ kk_downloader ” and you can click on that to install. If it has been installed, you can click on the green arrow to the left of the extension or the name of the extension and then load the newest version by clicking on the Import/Update button. It is highly recommended to install the newest extension in the “local” folder (LOCAL: typo3conf/ext/kk_downloader).

Create the sites (data folder, …)¶

You have to create several pages. The usual way is to create one sysfolder where the records and categories are saved in.It´s possible to create the extension records in normal sites but we recommend to use a new Storage Folder because therecan bemany records and you can keep everything in one place.

Create a page where the LIST view appears

Create a page where the SINGLE view appears (not absolutely needed)

Create a SYSFOLDER named “download-container” e.g. beyond your site with LIST view.

On each page you have to set the “ General record store page ” to your (category-)sysfolder.

Put the plugin into your page(s) template with “ Include static (from extensions) ” = “kk_downloader” and put the desired parameters in.

Set the plugin-configuration into the template setup box. You can copy and paste it from this manual if you want (see below)

Add Categories and Partners in the data folder¶

Click on “ Create new record ” and choose one of the following:

Categorie for a new categorie and Download for a new partner record. You have to add first your categories, because you need the categories to add a new partner record(only in the sb_downloader- version!). Here in this version categories are no longer mandatory fields!The form fields are self-explanatory.

Configure the options: LIST-view¶

After you create a page and add the extension, you have to edit the Flexform to get the right settings.

Please do not forget to deactivate the cache in the page behaviour!

Flexform options

New since version 1.2.0: browse max. n items per page

Configure the options: SINGLE-view¶

The same as above, only choose SINGLE instead of LIST!

A page with the plugin SINGLE view should not be cached! Please set it in the page options.

What you have to look for!

Tell the plugin the ID of the page with the single view:

• You have the possibility to edit the following plugin properties via setup:plugin.tx_kkdownloader_pi1.singlePID = 28 (e.g.)
• Put the marker ###MORE### into your HTML-template {This link will be inactive if a) the singlePID is not given or has a wrong UID or b) the correct singlePID-page has the hidden status.

Reference¶

plugin_tx_kkdownloader_pi1.

Used Markers¶

Static css file¶

You can insert the static css file via “ Include static (from extensions) ” in the template of your page (or rootpage)

Standard HTML-Template¶

<!– List Template –>

<!– ###TEMPLATE### begin –>

<!– BEGIN: Content of extension “kk_downloader”, plugin “kk_downloader” –>

<div id=”kkdl_flexWrap”>

<!– ###CONTENT### begin–>

<!– ###LIST_ITEM### begin –>

<div class=”kkdl_flex”>

<h2 class=”title”>###TITLE###</h2>

<div class=”category_class”>###TEXT_CATEGORIES###: ###CATEGORIES###</div>

<div class=”kkdl_text”>

<div class=”links”>###LINKS###</div>

<div class=”description”>###SHORTDESCRIPTION###</div>

###MORE###

</div>

<div class=”kkdl_image”>###IMAGE###</div>

<div style=”clear: both”></div>

<div class=”clicks”>###CLICKS### ###TEXT_CLICKS###</div>

<div class=”datetime”>###TEXT_LASTDOWNLOAD###: ###LASTDOWNLOAD###</div>

<div class=”description”>###TEXT_IPLASTDOWNLOAD###: ###IPLASTDOWNLOAD###</div>

<div class=”datetime”>###TEXT_LASTEDIT###: ###LASTEDIT###</div>

</div>

<!– ###LIST_ITEM### end –>

<!– ###CONTENT### end–>

</div>

<!– END Content of extension “kk_downloader”, plugin “kk_downloader” –>

<!– ###TEMPLATE### end –>

<!– Single Template –>

<!– ###TEMPLATE_SINGLE### begin –>

<div class=”kkdl_single”>

<h2 class=”title”>###TITLE###</h2>

<div class=”category_class”>###CATEGORIES###</div>

<div class=”kkdl_text”>

<div class=”links”>###LINKS###</div>

<p class=”bodytext”>

<b>###TEXT_SHORTDESCRIPTION###:<br />###SHORTDESCRIPTION###</b>

<br />###DESCRIPTION###

</p>

</div>

<div class=”kkdl_image”>###IMAGE###</div>

<div style=”clear: both”></div>

<div class=”clicks”>###CLICKS### ###TEXT_CLICKS### <span class=”datetime”>###TEXT_DATE### ###DATE###</span></div>

<div class=”datetime”>###TEXT_LASTDOWNLOAD###: ###LASTDOWNLOAD###</div>

<div class=”description”>###TEXT_IPLASTDOWNLOAD###: ###IPLASTDOWNLOAD###</div>

<div class=”datetime”>###TEXT_LASTEDIT###: ###LASTEDIT###</div>

</div>

<!– ###TEMPLATE_SINGLE### end –>

<!– Single Template –>

<!– N E W : Template for detailled file information

! This part will replace the marker ###LINKS### in the other templates above, if existing.

! If not, the marker ###LINKS### will be rendered as it used to be.

–>

<!– ###TEMPLATE_DETAIL### begin –>

<!– ###LINK_ITEM### begin –>

<div class=”kkdl-details”>

###FILE### ###ICON###

<br />###TEXT_FILESIZE###: ###FILESIZE###

<br />###TEXT_FILEMDATE###: ###FILEMDATE###

</div>

<!– ###LINK_ITEM### end –>

<!– ###TEMPLATE_DETAIL### end –>

((generated))¶