ez projects / ezslideshare
|UNIX name||Owner||Status||Version||Compatible with|
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.
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.
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
Get your own API key/shared-secret pair by :
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.
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.
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
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>
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, 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
Step by on the project page and post in the forums for sharing feedback, ideas and/or issues : http://projects.ez.no/ezslideshare
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 :
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).
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 :