[Installation] [Usage] [Resources]

eZ Publish <--> Slideshare.net plug-in

Here is how slideshare.net defines itself :
"SlideShare is the best way to share presentations, documents and professional videos."

eZ Slideshare lets you embed any http://slideshare.net presentation (and only that, for now) in an XML Block.

Finished yet ?

No.
On the contrary.
eZSlideshare was thought of as an extensible eZPublish <--> slideshare.net toolkit, this is the reason why it was shared at an early stage on projects.ez.no (http://projects.ez.no/ezslideshare). Today, it only allows for simply embedding slideshare.net presentations, but can be extended to support the many other features supported by slideshare.net's API.

Installation

Prerequisites

eZ Publish

This extension was developed and tested on a 4.2 version, and should seamlessly work on any further version. We cannot guarantee that it works fine on prior versions, although there should not be any problem. You can download the eZ Publish Community Project here : http://share.ez.no/download

Slideshare API key/share-secret pair

Get your own API key/shared-secret pair by :

1. Creating an account on http://www.slideshare.net/ if not already done
2. Following the steps there : http://www.slideshare.net/developers/applyforapi

Get a hold on it

This extension is available from the project's SVN repository : http://projects.ez.no/ezslideshare/subversion. Follow the instructions on this page.

Once on your hard-drive, place the extension (or symlink it) inside the extension folder of your preferred eZ Publish instance.

Enable the extension

From the administration interface

Navigate to the administration interface, then click the "Setup" top-menu entry, then the "Extensions" entry in the left-column menu. The ezslideshare extension should be listed, next to an unchecked checkbox. Check it, and click the "Apply changes" button.

By editing site.ini.append.php

Spot the site.ini.append.php file where you are activating extensions (can be per siteaccess, or as a general override), and add the following :

span style="background-color: yellow;"> [ExtensionSettings]
... (other extensions being enabled)
ActiveExtensions[]=ezslideshare

You are maybe enabling extensions per siteaccess. In your siteaccess' site.ini.append.php file :

span style="background-color: yellow;"> [ExtensionSettings]
... (other extensions being enabled for this siteaccess)
ActiveAccessExtensions[]=ezslideshare

Regenerate the autoloads files. From the command line, at the root of your eZ Publish installation :

$> php bin/php/ezpgenerateautoloads.php

Install your Slideshare API key/share-secret pair

Create an override of the ezslideshare.ini.append.php file as a global or siteaccess override. Insert your key/shared-secret values in the corresponding configuration directive, as follows :

span style="background-color: yellow;"> [SlideshareAPISettings]
APIKey=<my-key>
SharedSecret=<my-shared-secret>

Clear caches

From the administration interface

Navigate to the administration interface, then click the "Setup" top-menu entry, then the "Clear all caches" button, in the top box.

Bear in mind that this should not be done on a running, production instance. If you are in this case, clear the INI cache, then the Template cache, and you should be all set.

From the command line

From the command line, at the root of your eZ Publish installation :

$> php bin/php/ezcache.php -s<siteaccess_name> --clear-all
 

Bear in mind that this should not be done on a running, production instance. If you are in this case, clear, the INI cache, then the Template cache, and you should be all set. Can be done as follows :

$> php bin/php/ezcache.php -s<siteaccess_name> --clear-tag=ini
$> php bin/php/ezcache.php -s<siteaccess_name> --clear-tag=template

Issues

Step by on the project page and post in the forums for sharing feedback, ideas and/or issues : http://projects.ez.no/ezslideshare

Usage

At this stage, embedding a slideshare.net presentation is proposed through a custom tag (see resources to learn more on this). When editing an object having an eZXMLText attribute (Rich Text datatype, XML Block), one sees the Online Editor, WYSIWYG editor based on TinyMCE, where one button reads : "<?>". Click it, it pops a dialog window. The first drop-down (select) in this pop-up lists the custom tags at disposal. Once eZSlideshare is installed, you should see en entry reading "Slideshare presentation".

Select it, and three attributes will show :

1. Presentation url
2. Width
3. Height

The first one is mandatory, the others are used to customie the dimensions of the embedded presentation. The default dimensions are instructed by the following template :design/standard/templates/content/datatype/view/ezxmltags/slideshare.tpl, feel free to create an override for it, and then alter the values.

The "Presentation url" must contain the concerned presentation's URL (meaning the one you see in your address bar).

Example : http://www.slideshare.net/pmd06c/exploring-privatecollective-business-models

The final result is an embedded slideshare.net presentation, with, on top of the content, all interesting tools : * sharing options (social streams) * link to author's presentations' library

Here is how it looks :

Resources

• eZSlideshare project page, repository and forums for feedback : http://projects.ez.no/ezslideshare
• slideshare.net API : http://www.slideshare.net/developers
• eZ Publish Community : http://share.ez.no . A crowd of nearly 40 000 people, all levels, all types of usages of eZ Publish, but the same strong feeling of belonging. Step by there, say hi.
• Custom tag concept : http://doc.ez.no/eZ-Publish/Technical-manual/4.x/Reference/Datatypes/XML-block/Custom-tags
• Custom tag in the scope of the Online Editor : http://doc.ez.no/Extensions/Online-Editor/5.x/Usage/The-toolbar/The-Custom-tag-button
• Online Editor documentation : http://doc.ez.no/Extensions/Online-Editor/5.x
• Template overrides, concepts : http://doc.ez.no/eZ-Publish/Technical-manual/4.4/Templates/The-template-override-system