EXT: rgmediaimages¶

Table of Contents¶

EXT: rgmediaimages 1

Introduction 1

What does it do? 1

Demo 1

Screenshots 2

License Information! 6

Users manual 6

Prerequisite / Installation on a TYPO3 < 4. 1.6 6

Install the Extension 6

Use the Extension 7

Administration (JW FLV Player) 7

Reference 8

Administration (1pixelout mp3 player) 9

Reference 9

Administration (Video hosters, wmv, mov) 10

Administration (iframe & Content) 10

Administration (Plugin) 11

Configuration 11

Reference 11

Using the wizard 12

Extend the functionality 13

Hook 13

Show Videos in a PopUp 13

FAQ 13

You like the extension? 14

Known problems 14

To-Do list 14

Changelog 15

Introduction¶

Users manual¶

Follow these steps to use this extension:

Administration (JW FLV Player)¶

This section is only important if you want to show any flv or mp3 file using the JW FLV Player!

The FLV Player is highly configurable and there are 2 possibles where you can do this:

• Configure the FLV Player directly inside the content element using the field “Alternative text”Just add all properties comma separated in the text field (each line stands for one file of the content element).
• Use the constant editor to configure all videos on your website or all videos of a part of the page tree.

Both ways follow the same syntax which is explained in the reference

Video I
callback:1,showDownload:1,backgroundImage:www.rggooglemap.com/fileadmin/upload/rgmimg1.jpg

Video II
height:160,showDigits:false,backgroundColor:FFCC33,foregroundColor:FF3300,showVolume:false,autorepeat:true

mp3-File 1
callback:1,height:150,width:225,backgroundImage:www.rggooglemap.com/fileadmin/upload/mp3bg.jpg

Administration (1pixelout mp3 player)¶

You can decide which player you want to take to play mp3 files:

• JW FLV Player: Pro: You can show an background image. Con: Doesn't look that nice
• 1pixelout Player: Pro: Looks very cool for mp3 files. Con: IMO none.

You can switch back to the JW FLV Player by setting this in the Constants

plugin.rgmediaimages.use1PixelOut = 0

Administration (Video hosters, wmv, mov)¶

If you want to show videos from Youtube, Dailymotion, Metacafe or Video Google you are not able to configure much! So it is very easy!

Follow this steps

Whenever you want to display a video inside a content element, you need to select a dummy file with the file ending “.rgg” as a placeholder. This file can be empty (You can find a dummy file in EXT:rgmediaimages/res/dummy.rgg) .

Add a placeholder/dummy file

Add the URL to the video in the “Alternative Text” field using the following syntax: file:URL

Add a height & width inside the content element. This is mandatory .

Administration (iframe & Content)¶

If you want to show a nested content or an iframe you need to follow this steps:

Step 1 from the section “Administration (Video hosters, wmv, mov)”

• Iframe: Use this syntax: file:iframeURL
• Content elements Use this syntax: file:tt_contentIDID stands for the uid of the content element

Add a height & width inside the content element. This is mandatory .

Administration (Plugin)¶

It is also possible to use a standalone plugin to show your media files which has the big advantage that you don't need any dummy file as in the content elements.

Image: The plugin of rgmediaimages

Insert the plugin in your page and choose in the dropdown what you want to show. 3 options are available:

• External Files: Choose this option to show external files. This are all files from foreign servers like youtube & co but can also be a FLV file on the server of your friend.
• Internal Files: Choose this option if you got your files somewhere inside your fileadmin-folder. Don't forget that the file will be copied to uploads/tx_rgmediaimages!
• RTMP-Streams: Use this option for RTMP-Streams or if you want to show a playlist.

stdWrap.dataWrap = <div class="rgmediaimages-caption">|</div>

stdWrap.dataWrap = <div class="rgmediaimages-media" style="width:{field:tx_rgmediaimagesWidth}px;">|</div>

EXT:rgmediaimages/res/styles.css

plugin.tx_rgmediaimages_pi1.confmp3.bg = 000000

1

Using the wizard¶

The wizard is a very handy tool to configure the media files you want to display on your website!

The steps you need the follow are:

Create a content element with some media files or dummy rgg-files and save it.

Click on the wizard icon next to the “Alternative Text” textarea:

You can now use the wizard

Press the save button when you are finished!

Every media file can be configured through the wizard by clicking at the green underlined category title and editing the options underneath it.

Extend the functionality¶

# Hook
$video = $_procObj->extraMediaProcessor($video, $config, $width, $height, $originalUrl, $this);

# TS-Code
page >
page = PAGE
page {
        typeNum = 0
        10 < styles.content.get
}

FAQ¶

Q: Why do I need the .rgg files? A: This is a placeholder for the video, without it, you won't get anything

Q: Internet Explorer crashes with this extension. Why? A: You use an extension which uses Mootools? Please use t3mootools and be sure that window.addevent is included in the built library.

Q: I want to show videos from another website. What need I to do? A: 1 ^st check if the videos can be embedded and then as the 2 ^nd step modify the class.tx_rgmediaimages_fe.php to allow the new domain. 3 ^rd please send me you modifications.

Q: Can I play FLV files also from other websites? A: Sure, add them like a wmv file or any other file!

You like the extension?¶

I really had much work with this extension so if you like this extension, you can do one or more of the following things:

• Write me a mail or create a posting at http://www.rggooglemap.com/en/dev/rgmediaimages.html .
• Please rate the extension in the Repository: http://typo3.org/extensions/ search for rgmediaimages, click on the title and then at “Ratings” (You need to be registered and logged in at typo3.org)
• Donate something, so that I can write those kind of extensions for you. More information is here: German: http://www.rggooglemap.com/menu/spende.html and English: http://www.rggooglemap.com/en/2/donate.html . Thanks!

One of those things is the least you can do for getting all those great extensions completely for free!

Known problems¶

- None yet, did I miss something? Tell me!

To-Do list¶

• Complete the callback to create a statistic.
• Optimize the blitzeinschlag-player including the playlist.
• Anything else?

Changelog¶

Take a look at the changelog file!

EXT: rgmediaimages - 15