Metadata-Version: 1.0
Name: collective.embedly
Version: 1.6
Summary: TinyMCE visual editor support for embed.ly service
Home-page: http://svn.plone.org/svn/collective/collective.embedly/
Author: Quintagroup
Author-email: support@quintagroup.com
License: GPL
Description: Introduction
        ============
        
        This package provides TinyMCE visual editor support for embed.ly service:
        videos, images and other rich media can be inserted to Plone from different
        services through one API.
        
        The approach here is to use the Transform machinery to replace the URL with
        embed code by calling the embed.ly API.
        
        There are more than 200 services that support embed.ly service. These are such
        video sharing sites as Youtube, Blip.tv, Vimeo; such audio streaming services 
        as Grooveshark, SoundCloud, last.fm; such image/photo stocks as Flickr, and 
        many other: GoogleMaps, Facebook, Twitter, etc.
        
        This product was developed by http://quintagroup.com for Plone collective, 
        sponsored by Headnet ApS http://headnet.dk.
        
        Usage
        -----
        
        To embed media from the embedly-supported external resource to Plone:
        
        * Go to the object's edit form, select some text and choose 'Embedly link' style 
          for it.
        
        * The text should now look like linked. TinyMCE makes the whole passage linked, 
          so keep in mind that the whole passage will later be substituted with 
          embedded media.
           
        * Select this text again and go to Insert link to insert the URL to the desired 
          object on the external service.
           
        * Save this page. Now when rendered, there will be "preview" from embed.ly 
          service inserted instead of the linked text.
          
        * You can pass resize the embeded object passing 'maxwidth', 'maxheight' params.
          Example: http://www.youtube.com/watch?v=L1NPLlhFTVk&maxwidth=400&maxheight=300
        
        * Also 'wmode' and 'callback' are available. Consult embed.ly documentation for usage.
        
        More about usage at http://projects.quintagroup.com/products/wiki/collective.embedly
        
        Note
        ----
        
        * collective.embedly does not fix errors in provided URLs
        
        * you can check if your URL will be transformed calling embed.ly manualy, for example:
        
           o video URL http://www.youtube.com/watch?v=L1NPLlhFTVk
           o you should call http://api.embed.ly/v1/api/oembed setting 'url' parameter with your value
           o http://api.embed.ly/v1/api/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk
           o http://api.embed.ly/v1/api/oembed?url=http://www.youtube.com/watch?v=L1NPLlhFTVk&fromat=xml format result as xml
        
        * You can set the API key by going to Site Setup -> Configuration Registry and
          setting the api_key value. The default is to not pass along a key, your
          requests to embedly will be anonymous and based solely on IP address.
        
        Supported Plone Version
        -----------------------
        
        * Plone 4.x
        
        Contributors
        ------------
        
        * Volodymyr Cherepanyak
        * Roman Kozlovskyi
        * Serhiy Valchuk
        * Clayton Parker
        
        Changelog
        =========
        
        1.6 - Sep 14, 2011
        ------------------
        
        - Only run the uninstall profile when the product is being uninstalled.
          This allows for the api key to survive through a reinstall.
          [claytron]
        
        - Add support for passing the embedly API key
          [claytron]
        
        1.5 - Sep 2, 2011
        -----------------
        
        - href distinguishing regular expression improved
        - logging added
        
        1.4.1 - Aug 8, 2011
        -------------------
        
        - typpos in CSS fixed
        
        1.4 - Apr 26, 2011
        ------------------
        
        - URL parameters parsing algorithm updated
        
        1.3 - Apr 05, 2011
        ------------------
        
        - maxwidth, maxheight, callback, wmode params support added
        
        - updated list of embedly services
        
        1.2 - Mar 29, 2011
        ------------------
        
        - the embedly link now marked with icon and background in TinyMCE
        
        1.1 - Mar 4, 2011
        -----------------
        
        - proper registration of embedly transformation done; does not clash with
          safe HTML transform from now on
        
        1.0 - Mar 3, 2011
        -----------------
        
        - Initial release
        
Keywords: web zope plone embedly TyniMCE plugin
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
