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: Cloud-Zoom

Created:2010-02-18T17:33:18
Changed by:Jürgen Furrer
Changed:2014-03-12T23:26:39
Classification:jfcloudzoom
Keywords:Image, zoom, caption, jquery, t3jquery
Author:Juergen Furrer
Email:juergen.furrer@gmail.com
Info 4:
Language:en

img-1 img-2 EXT: Cloud-Zoom - jfcloudzoom

EXT: Cloud-Zoom

Extension Key: jfcloudzoom

Language: en

Keywords: Image, zoom, caption, jquery, t3jquery

Copyright 2000-2010, Juergen Furrer, <juergen.furrer@gmail.com>

Cloud-Zoom © 2010 by R Cecco. <http://www.professorcloud.com>

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

EXT: Cloud-Zoom 1

`Introduction 3 <#__RefHeading__2140_2087176985>`_

What does it do? 3

Screenshots 3

`Users manual 4 <#__RefHeading__2146_2087176985>`_

Add page content “Cloud-Zoom” 4

Add “Cloud-Zoom” to content images 5

Add “Cloud-Zoom” to tt_news 6

Add “Cloud-Zoom” to tt_productss 7

`Administration 8 <#__RefHeading__2156_2087176985>`_

`Configuration 9 <#__RefHeading__2158_2087176985>`_

Reference 9

FAQ 10

`Known problems 11 <#__RefHeading__2164_2087176985>`_

`To-Do list 12 <#__RefHeading__2166_2087176985>`_

`ChangeLog 13 <#__RefHeading__2168_2087176985>`_

Introduction

What does it do?

With this extension you are able to publish single images with a zoom, so, users can see the image more detailed. The same effect will be possible in tt_news and tt_product on the detailed view.

Users manual

Add page content “Cloud-Zoom”

Go to Web → Page

Choose the page to add the new Cloud-Zoom

Add new content

Choose Plugin → “Cloud-Zoom”

Go to tab “Plugin”

Insert images to the field “Zoom images”

Define the titles in “Image title” (one caption per line)

Configure the Cloud-Zoom presentation in tab “Setting”

Define the color and transparency settings in tab “Color”

Use special options for your Cloud-Zoom in “Special”

img-4 img-5 img-6

Add “Cloud-Zoom” to content images

To add this, you have to modify the tt_content.image.20 in your setup. Please see the example in static/setup.txt

Go to Web → Page

Add content type “Text with image”

Go to tab “Media”

Enable the “Cloud-Zoom - Activate”

Choose a “Cloud-Zoom - Zoom factor”

Change the image width and height if you like

Add title for the images into “Title Text”

img-7

All other information's (position, options etc.) comes from the setup.

Add “Cloud-Zoom” to tt_news

To add this effect to a news entry, you have to activate the Cloud- Zoom for every item individually.

Go to Page → List

Go to the SysFolder where you store your news item

Edit the item you want to extend with the Cloud-Zoom

Go to tab “Media”

Enable the “Cloud-Zoom - Activate”

Choose a “Cloud-Zoom - Zoom factor”

Insert captions to the “Caption”

img-8

All other information's (position, options etc.) comes from the setup.

Add “Cloud-Zoom” to tt_productss

To add this effect to a product detail, you have to activate the Cloud-Zoom for every item individually.

Go to Page → List

Go to the SysFolder where you store your products

Edit the product you want to extend with Cloud-Zoom

Enable the “Cloud-Zoom - Activate”

Choose a “Cloud-Zoom - Zoom factor”

img-9

All other information's (position, options etc.) comes from the setup.

Administration

For administration, you can allow / disallow the following exclude fields for user:

  • Pagecontent: Activate
  • Pagecontent: Zoom factor
  • News: Activate
  • News: Zoom factor
  • Products: Activate
  • Products: Zoom factor

You are able to change the following options in configuration:

useSelectInsteadCheckbox

Property

useSelectInsteadCheckbox

Data type

boolean

Description

If set, most of checkboxes will turn into selectboxes, so you can choose "from TS"

Default

0

Configuration

To install the extension you have to add the static “Cloud-Zoom” to your Template.

img-10

If you like to use this effect in tt_news or tt_products, you have to add the related static.

You are able to define the settings once per template in constant editor, they will be used as default values in template based use and content elements.

Reference

plugin.tx_ifcloudzoom_pi1

jQueryNoConflict

Property

jQueryNoConflict

Data type

boolean

Description

Use the noConflict methode

Default

1

jsInFooter

Property

jsInFooter

Data type

boolean

Description

If set, the Javascript will be rendered in Footer

Default

0

jsMinify

Property

jsMinify

Data type

boolean

Description

If set, the Javascript will be minified

Default

0

jsInline

Property

jsInline

Data type

boolean

Description

If set, the Javascript will be inserted into the inlineJS, after this, its possible to put it into externel files (config.removeDefaultJS = external)

Default

0

cssMinify

Property

cssMinify

Data type

boolean

Description

If set, the CSS will be minified

Default

0

jQueryLibrary

Property

jQueryLibrary

Data type

file

Description

Location of the jQuery Lib, if empty or file does not exist, the script will not be included

Default

EXT:jfcloudzoom/res/jquery/js/jquery-1.7.2.min.js

jQueryCloudZoom

Property

jQueryCloudZoom

Data type

file

Description

Location of the Cloud-Zoom, if empty or file does not exist, the script will not be included

Default

EXT:jfcloudzoom/res/jquery/js/jquery.cloudzoom-1.0.2.min.js

It's possible to define the following typoscript for different display types

plugin.tx_ifcloudzoom_pi1.normal / .header / .content / .ttnews / .ttproducts

imagewidth

Property

imagewidth

Data type

string

Description

Define the image width

Default

600m

imageheight

Property

imageheight

Data type

string

Description

Define the image height

Default

600m

thumbnailwidth

Property

thumbnailwidth

Data type

string

Description

Define the thumbnail width

Default

100c

thumbnailheight

Property

thumbnailheight

Data type

string

Description

Define the thumbnail height

Default

100c

scaleFactor

Property

scaleFactor

Data type

integer

Description

The factor to scale the image

Default

2

position

Property

position

Data type

string

Description

The position of the scaled area, possible values are:

inside,left,right,top,bottom

Default

inside

smoothMove

Property

smoothMove

Data type

boolean

Description

Define the level of the smooth view

(lower=less, higher=more)

Default

3

zoomWidth

Property

zoomWidth

Data type

string / integer

Description

Define the width of the scaled area (possible values: auto or integer values)

Default

zoomHeight

Property

zoomHeight

Data type

string / integer

Description

Define the height of the scaled area (possible values: auto or integer values)

Default

adjustX

Property

adjustX

Data type

integer

Description

Adjust the scaled area verticaly

Default

-4

adjustY

Property

adjustY

Data type

integer

Description

Adjust the scaled area horizontaly

Default

-4

showTitle

Property

showTitle

Data type

boolean

Description

If set, the title of the image will be displayed as caption

Default

1

softFocus

Property

softFocus

Data type

boolean

Description

If set, the Image will have a soft focus

Default

0

useThumbnails

Property

useThumbnails

Data type

boolean

Description

Use thumbnails in case of multiple images

Default

0

maxZindex

Property

maxZindex

Data type

integer

Description

Defines the maximum z-index to use (must be greater as four)

Default

99

options

Property

options

Data type

string

Default

tint

Property

tint

Data type

boolean

Description

Define the color for the tint

Have to be hex color values (e.g. #ff00ff)

Default

tintOpacity

Property

tintOpacity

Data type

double

Description

Define the opacity of the tint

Default

lensOpacity

Property

lensOpacity

Data type

double

Description

Define the opacity of the lens

Default

titleOpacity

Property

titleOpacity

Data type

double

Description

Define the opacity of the title

Default

image

Property

image

Data type

cObject

Description

Defines the image, imageLinkWrap defines the link around the image (mandatory)

Default

itemWrap

Property

itemWrap

Data type

stdWrap

Description

stdWrap around single image

Default

thumbnail

Property

thumbnail

Data type

cObject

Description

Defines the image of a thumbnail

Default

thumbnailWrap

Property

thumbnailWrap

Data type

stdWrap

Description

stdWrap around a single thumbnail

Default

thumbnailsWrap

Property

thumbnailsWrap

Data type

stdWrap

Description

stdWrap around all thumbnails

Default

stdWrap

Property

stdWrap

Data type

stdWrap

Description

stdWrap around all items

Default

[tsref:(cObject).plugin.tx_ifcloudzoom_pi1]

((generated))
Example

Here an example to define the Cloud-Zoom in TypoScript:

plugin.tx_jfcloudzoom_pi1.normal {
  position = right
  zoomWidth = 200
  zoomHeight = auto
  showTitle = 1
  titleOpacity = 0.2
}

Here an example to add the Cloud-Zoom to a marks:

page.10.marks.HEADER_IMAGE < plugin.tx_jfcloudzoom_pi1

FAQ

((generated))
I like to add some scripts / css -files globally, is this possible?

If you like to add the library globally you can set an empty string to the values. Only existing files will be included!

This will work for jQueryLibrary and jQueryCloudZoom.

ChangeLog

0.0.1

Version

0.0.1

Changes

Initial development

0.0.2

Version

0.0.2

Changes

Add documentation

0.1.0

Version

0.1.0

Changes

Add DAM support for Ctype list

0.2.0

Version

0.2.0

Changes

Add Cloud-Zoom to “Text with image”

0.3.0

Version

0.3.0

Changes

Add Cloud-Zoom for tt_news

0.3.1

Version

0.3.1

Changes

Prevent multiple JS-script output

1.0.0

Version

1.0.0

Changes

Now it's stable / Add tt_products to display Cloud-Zoom

1.1.0

Version

1.1.0

Changes

Add Cloud-Zoom gallery

1.1.1

Version

1.1.1

Changes

Change the title for Cloud-Zoom gallery / Use pageRenderer for script includ

1.1.2

Version

1.1.2

Changes

Small bugfix / Add jQuery 1.4.3

1.1.3

Version

1.1.3

Changes

Add jQuery 1.4.4 / Small bugfix (#10984)

1.2.0

Version

1.2.0

Changes

Add useSelectInsteadCheckbox to select „from TS“ / Add slider for some BE-Forms

1.2.1

Version

1.2.1

Changes

Add support for TYPO3 4.5 / Fix default value of adjustX and adjustY

1.2.2

Version

1.2.2

Changes

Add jQuery 1.5.0 / Add jQuery 1.5.1

1.3.0

Version

1.3.0

Changes

Add exclude to all flexform-fields / Add jQuery 1.5.2 / Fix tt_product view for typo3 4.5

1.3.1

Version

1.3.1

Changes

Fix the flexform data extraction / Remove unused scripts

1.3.2

Version

1.3.2

Changes

Add jQuery 1.6.2 / Fix jsInFooter / Convert linefeed to Unix

1.3.3

Version

1.3.3

Changes

Use the new color picker of jftcaforms / Fix dam_cat language overlay (#30082) / Add jQuery 1.6.4

1.3.4

Version

1.3.4

Changes

Fix caption for DAM (#31135)

1.3.5

Version

1.3.5

Changes

Add jQuery 1.7.0 / Add static for tt_content (#31635)

1.3.6

Version

1.3.6

Changes

Add jQuery 1.7.1

1.3.7

Version

1.3.7

Changes

Add maxZindex (#34430)

1.3.8

Version

1.3.8

Changes

Fix DAM-Selection

1.3.9

Version

1.3.9

Changes

Add jQuery 1.7.2 / Remove deprecated methods (#36599)

1.3.10

Version

1.3.10

Changes

Fix t3lib_utility_VersionNumber::convertVersionNumberToInteger for older typo3 versions / Remove deprecated method t3lib_div::intInRange

1.3.11

Version

1.3.11

Changes

Fix compatibility for Typo3 V6 (#41010)

1.3.12

Version

1.3.12

Changes

Fix “Add new” in backend

1.3.13

Version

1.3.13

Changes

Add Compatibility for TYPO3 V 6.2

img-2 13