Getting Started with Zend_Service_SlideShare

In order to use the Zend_Service_SlideShare component you must first create an account on the slideshare.net servers (more information can be found » here) in order to receive an API key, username, password and shared secret value -- all of which are needed in order to use the Zend_Service_SlideShare component.

Once you have setup an account, you can begin using the Zend_Service_SlideShare component by creating a new instance of the Zend_Service_SlideShare object and providing these values as shown below:

// Create a new instance of the component
'APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD');

The SlideShow object

All slide shows in the Zend_Service_SlideShare component are represented using the Zend_Service_SlideShare_SlideShow object (both when retrieving and uploading new slide shows). For your reference a pseudo-code version of this class is provided below.

span style="color: #808080; font-style: italic;">/**
     * Retrieves the location of the slide show
     *//**
     * Gets the transcript for this slide show
     *//**
     * Adds a tag to the slide show
     *//**
     * Sets the tags for the slide show
     *//**
     * Gets all of the tags associated with the slide show
     *//**
     * Sets the filename on the local filesystem of the slide show
     * (for uploading a new slide show)
     *//**
     * Retrieves the filename on the local filesystem of the slide show
     * which will be uploaded
     *//**
     * Gets the ID for the slide show
     *//**
     * Retrieves the HTML embed code for the slide show
     *//**
     * Retrieves the Thumbnail URi for the slide show
     *//**
     * Sets the title for the Slide show
     *//**
     * Retrieves the Slide show title
     *//**
     * Sets the description for the Slide show
     *//**
     * Gets the description of the slide show
     *//**
     * Gets the numeric status of the slide show on the server
     *//**
     * Gets the textual description of the status of the slide show on
     * the server
     *//**
     * Gets the permanent link of the slide show
     *//**
     * Gets the number of views the slide show has received
     */

Note: The above pseudo-class only shows those methods which should be used by end-user developers. Other available methods are internal to the component.

When using the Zend_Service_SlideShare component, this data class will be used frequently to browse or add new slide shows to or from the web service.

Retrieving a single slide show

The simplest usage of the Zend_Service_SlideShare component is the retrieval of a single slide show by slide show ID provided by the slideshare.net application and is done by calling the getSlideShow() method of a Zend_Service_SlideShare object and using the resulting Zend_Service_SlideShare_SlideShow object as shown.

// Create a new instance of the component
'APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD'"Slide Show Title: {$slideshow->getTitle()}<br/>\n""Number of views: {$slideshow->getNumViews()}<br/>\n";

Retrieving Groups of Slide Shows

If you do not know the specific ID of a slide show you are interested in retrieving, you can retrieving groups of slide shows by using one of three methods:

Slide shows from a specific account

You can retrieve slide shows from a specific account by using the getSlideShowsByUsername() method and providing the username from which the slide shows should be retrieved
Slide shows which contain specific tags

You can retrieve slide shows which contain one or more specific tags by using the getSlideShowsByTag() method and providing one or more tags which the slide show must have assigned to it in order to be retrieved
Slide shows by group

You can retrieve slide shows which are a member of a specific group using the getSlideShowsByGroup() method and providing the name of the group which the slide show must belong to in order to be retrieved

Each of the above methods of retrieving multiple slide shows a similar approach is used. An example of using each method is shown below:

// Create a new instance of the component
'APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD'// Retrieve the first 10 of each type
'username''zend''mygroup'// Iterate over the slide shows
"Slide Show Title: {$slideshow->getTitle}<br/>\n";
}

Zend_Service_SlideShare Caching policies

By default, Zend_Service_SlideShare will cache any request against the web service automatically to the filesystem (default path /tmp) for 12 hours. If you desire to change this behavior, you must provide your own Zend_Cache object using the setCacheObject() method as shown:

span style="color: #ff0000;">'lifetime' => 7200,
                        'automatic_serialization''cache_dir' => '/webtmp/''Core',
                             'File''APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD''username'

Changing the behavior of the HTTP Client

If for whatever reason you would like to change the behavior of the HTTP client when making the web service request, you can do so by creating your own instance of the Zend_Http_Client object (see Zend_Http). This is useful for instance when it is desirable to set the timeout for the connection to something other then default as shown:

span style="color: #ff0000;">'timeout''APIKEY',
                                  'SHAREDSECRET',
                                  'USERNAME',
                                  'PASSWORD''username'