Metadata-Version: 2.0
Name: feincms3-meta
Version: 1.3.1
Summary: UNKNOWN
Home-page: https://github.com/matthiask/feincms3-meta/
Author: Matthias Kestenholz
Author-email: mk@feinheit.ch
License: BSD License
Description-Content-Type: UNKNOWN
Platform: OS Independent
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: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Dist: Django (>=1.11)
Provides-Extra: tests
Requires-Dist: coverage (~=4.4); extra == 'tests'
Requires-Dist: pytest (~=3.3); extra == 'tests'
Requires-Dist: pytest-django (~=3.1); extra == 'tests'

=============
feincms3-meta
=============

.. image:: https://travis-ci.org/matthiask/feincms3-meta.svg?branch=master
   :target: https://travis-ci.org/matthiask/feincms3-meta

Helpers and mixins for making meta and `open graph`_ tags less annoying.

Usage
=====

1. Inherit ``feincms3_meta.models.MetaMixin``
2. Optional, but recommended: Add a setting for default tags::

    META_TAGS = {
        'site_name': 'My site',
        'title': 'Default title',
        'description': (
            'The default description,'
            ' maybe long.'
        ),
        'image': '/static/app/logo.png',
    }

3. If you define ``fieldsets`` on a ``ModelAdmin`` subclass, you may
   want to use the helper ``MetaMixin.admin_fieldset()``, or maybe not.

4. Use the dictionary returned by ``feincms3_meta.utils.meta_tags``
   either directly (its ``__str__`` method renders as a HTML fragment)
   or access individual properties using standard dictionary access::

    return render(request, ..., {
        ...
        'meta_tags': meta_tags(
            [object],
            request=request,
        ),
    })

   ``meta_tags`` also supports overriding or removing individual tags
   using keyword arguments. Falsy values are discarded, ``None`` causes
   the complete removal of the tag from the dictionary.

   The rendering of a meta tags dictionary is also usable standalone
   with ``feincms3_meta.utils.format_meta_tags``.

.. _open graph: http://ogp.me/


