=========== django-meta

|Gitter| |PyPiVersion| |PyVersion| |GAStatus| |TestCoverage| |CodeClimate| |License|

Django-Meta is a pluggable Django app that allows developers to easily add meta tags and OpenGraph, Twitter, and Schema.org properties to their HTML responses.

By adding these tags to their pages, developers can improve the way their pages are displayed in search engine results and on social media platforms.

.. warning:: INCOMPATIBLE CHANGE: as of version 2.0 django-meta has no longer supports Google+, basic Schema.org support has been introduced.

.. contents::

Installation

See https://django-meta.readthedocs.io/en/latest/installation.html

Supported versions

Django

3.2 to 4.2 (newer versions might work but are not tested yet)

Python

Python 3.9 to 3.11

Supported Meta Tags

Django-Meta supports a wide range of meta tags, including:

• Description
• Keywords
• Robots
• Author
• Google Analytics
• Open Graph (OG) tags
• Twitter Cards
• Schema.org properties

To add meta tags to your pages using Django-Meta, you can use the provided template tags or use the view-method and model-method interface to provide and handle meta information.

Basic concept

django-meta provides a view-method and model-method interface to provide and handle meta informations

For more details check documentation_.

Configuration for Non-HTML Responses

By default, Django-Meta is designed to work with HTML responses.

However, it can also be configured to work with non-HTML responses, such as JSON or XML.

To do this, you can define your own meta classes and register them with the django-meta app.

Authors and Contributors

django-meta has been started by Branko Vukelic_.

Current maintainer: Iacopo Spalletti_

See AUTHORS file for the complete list of contributors

Apps using django-meta / extensions

See third_party_apps_

Reporting bugs

Please report all bugs to our Github issue tracker_.

.. _OpenGraph: http://opengraphprotocol.org/ .. _issue tracker: https://github.com/nephila/django-meta/issues/ .. _github: https://github.com/nephila/django-meta/ .. _Iacopo Spalletti: https://github.com/yakky .. _documentation: https://django-meta.readthedocs.io/en/latest/ .. _third_party_apps: https://django-meta.readthedocs.io/en/latest/#apps-using-django-meta-extensions .. _Branko Vukelic: https://bitbucket.org/monwara

.. |Gitter| image:: https://img.shields.io/badge/GITTER-join%20chat-brightgreen.svg?style=flat-square :target: https://gitter.im/nephila/applications :alt: Join the Gitter chat

.. |PyPiVersion| image:: https://img.shields.io/pypi/v/django-meta.svg?style=flat-square :target: https://pypi.python.org/pypi/django-meta :alt: Latest PyPI version

.. |PyVersion| image:: https://img.shields.io/pypi/pyversions/django-meta.svg?style=flat-square :target: https://pypi.python.org/pypi/django-meta :alt: Python versions

.. |GAStatus| image:: https://github.com/nephila/django-meta/workflows/Tox%20tests/badge.svg :target: https://github.com/nephila/django-meta :alt: Latest CI build status

.. |TestCoverage| image:: https://img.shields.io/coveralls/nephila/django-meta/master.svg?style=flat-square :target: https://coveralls.io/r/nephila/django-meta?branch=master :alt: Test coverage

.. |License| image:: https://img.shields.io/github/license/nephila/django-meta.svg?style=flat-square :target: https://pypi.python.org/pypi/django-meta/ :alt: License

.. |CodeClimate| image:: https://codeclimate.com/github/nephila/django-meta/badges/gpa.svg?style=flat-square :target: https://codeclimate.com/github/nephila/django-meta :alt: Code Climate