Download 
How to install raptus.article.media
- Download and install ActivePython
- Open Command Prompt
- Type
pypm install raptus.article.media
Lastest release
Introduction
raptus.article.media provides audio and video support for Articles.
The following features for raptus.article are provided by this package:
Content
- Audio - Based on File - add your audio files in a article.
- Video - Based on File - add your video files in a article.
- VideoEmbed - Based on Link - add your reference to your video in a article.
Components
- Audio (List of the audio files contained in the article)
- Video (List of the video files contained in the article)
Dependencies
- collective.flowplayer
- Products.ContentTypeValidator
- raptus.article.core
- plone.app.imaging
Installation
To install raptus.article.media into your Plone instance, locate the file buildout.cfg in the root of your Plone instance directory on the file system, and open it in a text editor.
Add the actual raptus.article.media add-on to the "eggs" section of buildout.cfg. Look for the section that looks like this:
eggs =
Plone
This section might have additional lines if you have other add-ons already installed. Just add the raptus.article.media on a separate line, like this:
eggs =
Plone
raptus.article.media
Note that you have to run buildout like this:
$ bin/buildout
Then go to the "Add-ons" control panel in Plone as an administrator, and install or reinstall the "raptus.article.default" product.
Note that if you do not use the raptus.article.default package you have to include the zcml of raptus.article.media either by adding it to the zcml list in your buildout or by including it in another package's configure.zcml.
Plone 3 compatibility
This packages requires plone.app.imaging which requires two pins in buildout when using Plone 3, which there are:
Products.Archetypes = 1.5.16 plone.scale = 1.2
Migration
Blob-storage
call this view on myplone/@@blob-article-media-migration and run the migration. all teaser have a separate view at myplone/@@blob-article-teaser-migration.
Usage
Add video/audio
You may now add videos, embedded videos and audio file in your article. Click the "Add new" menu and select "Video", "Embedded video" or "Audio" in the pull down menu. You get the standard plone form to add your video, embedded video or audio file.
Components
Navigate to the "Components" tab of your article, select the video or audio component and press "save and view". Note that at least one video or audio file has to be contained in the article in which this component is active.
Supported media types
Audio
- audio/mpeg
- audio/x-mp3
- audio/x-mpeg
- audio/mp3
Video embed
- YouTube
- GoogleVideo
- Vimeo
- MyVideo
Video
- video/x-flv
- application/x-flash-video
- flv-application/octet-stream
- video/flv
- video/mp4
- video/mp4v-es
- video/x-m4v
Supporting additional video formats
To extend the supported video formats with
- video/x-avi
- video/x-msvideo
- video/x-ms-wmv
- video/quicktime
include stxnext.transform.avi2flv in your buildout and reinstall raptus.article.media.
Go to http://pypi.python.org/pypi/stxnext.transform.avi2flv to read more about the server side requirements of stxnext.transform.avi2flv.
Copyright and credits
raptus.article is copyrighted by Raptus AG and licensed under the GPL. See LICENSE.txt for details.
Developer Manual
Note: You find a developer manual for raptus.article at raptus.article.core. Please have look there if you need more information.
Code overview
Components
plone.abovecontentbody
- raptus.article.media.video
- raptus.article.media.audio
Interfaces
file: interfaces.py
- IVideos (Provider for video files and embedded ones contained in an article)
- getVideos - method (Returns a list of video files and embedded ones (catalog brains))
- ITeaser (Handler for image thumbing of videos)
- getTeaserURL - method (Returns the url to the teaser image in the specific size. The sizes are taken from the raptus_article properties sheet and are formed by the following name schema: media_<size>_(height|width)
- getTeaser - method (Returns the html tag of the teaser image in the specific size. The sizes are taken from the raptus_article properties sheet and are formed by the following name schema: media_<size>_(height|width)
- getSize - method (Returns the width and height registered for the specific size)
IVideo (Marker interface for the video content type)
IVideoEmbed (Marker interface for the video embed content type)
- IVideoEmbedder (Provides html for different video providers)
- matches - method (Whether the embeder matches the adapted obj or not)
- getEmbedCode - method (Returns the html)
- IAudios (Provider for audio files contained in an article)
- getAudios - method (Returns a list of audio files (catalog brains))
IAudio (Marker interface for the audio content type)
Changelog
2.0b12 (2013-07-03)
- Added new configuration option to enable/disable media links
- Added new configuration option to enable/disable audio titles
2.0b11 (2013-06-24)
- Fixed bad release
2.0b10 (2013-06-24)
- Added https support
2.0b9 (2012-01-23)
- fixed missing url parameter for article viewlet
2.0b8 (2012-01-23)
- Added support for YouTube short URLs
2.0b7 (2011-08-26)
- Added MyVideo embedding support
2.0b6 (2011-02-22)
- add blob storage migration @@blob-article-media-migration
2.0b5 (2010-11-10)
- Added French translations
2.0b4 (2010-10-21)
- Updated readme and manual
2.0b3 (2010-10-20)
- First public release
successful builds