Metadata-Version: 1.1
Name: feincms-oembed
Version: 1.0.0
Summary: OEmbed anything.
Home-page: https://github.com/feincms/feincms-oembed/
Author: FEINHEIT GmbH
Author-email: kontakt@feinheit.ch
License: BSD License
Description: ==============
        feincms-oembed
        ==============
        
        ``feincms-oembed`` converts standard URLs from more than 200 content
        providers into embedded videos, images and rich article previews by
        letting Embedly_ or another oEmbed provider to the hard work.
        
        
        It's stunningly simple to use:
        
        1. Add ``'feincms_oembed'`` to ``INSTALLED_APPS``.
        2. Create the content type::
        
            from feincms.module.page.models import Page
            from feincms_oembed.contents import OembedContent
        
        
            TYPE_CHOICES=[
                ('default', _('Default presentation'), {'maxwidth': 500, 'maxheight': 300, 'wmode': 'opaque'}),
                ('transparent, _('Transparent'), {'maxwidth': 500, 'maxheight': 300, 'wmode': 'transparent'}),
                ])
        
            Page.create_content_type(OembedContent, TYPE_CHOICES=TYPE_CHOICES)
        
        
        If you want to customize the Embedly_ request or use another OEmbed provider,
        set ``settings.OEMBED_PROVIDER`` to a function receiving the URL and a dict with
        additional arguments and returning a suitable URL which returns OEmbed JSON
        on access. ``OEMBED_PROVIDER`` must either be a dotted python path or a
        callable::
        
            from feincms_oembed.providers import embedly_oembed_provider
            def my_provider(url, kwargs):
                kwargs['wmode'] = 'opaque'
                return embedly_oembed_provider(url, kwargs)
        
            OEMBED_PROVIDER = 'path.to.module.my_provider'
            # OEMBED_PROVIDER = my_provider # The function can be used too, not only the
                                            # dotted python path.
        
        
        .. _Embedly: http://embed.ly/
        
        
        Using the ``FeedContent``
        =========================
        
        If you want to use the ``FeedContent``, make sure you have ``feedparser`` in your Python Path:
        https://code.google.com/p/feedparser/
        
Platform: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
