djangocms-page-meta-maykin 1.5.0.dev1
OpenGraph, Twitter Card and Schema.org snippet tags for django CMS 3 pages
License: BSD
Requires Python: >=3.9
Keywords: django cms, meta tags, OpenGraph, Twitter Cards, Schema.org, django-app-enabler addon

===================
djangocms-page-meta
===================

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

Meta tag information for django CMS 3 pages

Python: 3.9, 3.10, 3.11

Django: 3.2, 4.1, 4.2

django CMS: 3.9, 3.11


**********
Quickstart
**********

#. A working django CMS environment is required for djangocms-page-meta to work. Refer to `django CMS documentation`_ for how to install and configure django CMS.

#. Install djangocms-page-meta::

        $ pip install djangocms-page-meta

   or from the repository::

        pip install -e git+https://github.com/nephila/djangocms-page-meta#egg=djangocms-page-meta

#. Then add it to INSTALLED_APPS along with its dependencies::

        "filer",
        "meta",
        "easy_thumbnails",
        "djangocms_page_meta",

#. Migrate the database::

        $ python manage.py migrate

#. Configuration:

   See `usage`_ and `configuration`_ section in the documentation.

#. That's all!

.. note:: Enabling this will **hide** django CMS own **Meta description** field to keep all the meta
          information in the same part of the interface. If the django CMS field is set, it will still
          be shown (and used by djangocms-page-meta).

**************************
django-app-enabler support
**************************

`django-app-enabler`_ is supported.

You can either

* Installation & configuration: ``python -mapp_enabler install djangocms-page-meta``
* Autoconfiguration: ``python -mapp_enabler enable djangocms_page_meta``

Fully using this package will require some template changes that cannot be modified by ``django-app-enabler``:

* Load template tag in the page like outlined in `usage`_ page;
* Run migrations: ``python manage.py migrate``

Check `usage`_ documentation for details.

Dependencies
============

* `django-filer`_
* `django-meta`_

*************
Documentation
*************

For package documentation see https://djangocms-page-meta.readthedocs.io/.


.. _django-filer: https://pypi.python.org/pypi/django-filer
.. _django-meta: https://pypi.python.org/pypi/django-meta
.. _configuration: https://djangocms-page-meta.readthedocs.io/en/latest/configuration.html
.. _usage: https://djangocms-page-meta.readthedocs.io/en/latest/usage.html
.. _django CMS documentation: https://django-cms.readthedocs.io/en/latest
.. _django-app-enabler: https://github.com/nephila/django-app-enabler


.. |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/djangocms-page-meta.svg?style=flat-square
    :target: https://pypi.python.org/pypi/djangocms-page-meta
    :alt: Latest PyPI version

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

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

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

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

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

.. :changelog:

*******
History
*******

.. towncrier release notes start

1.4.4 (2024-01-16)
==================

Features
--------

- Switch to Coveralls Github action (#189)


Bugfixes
--------

- Pin Django CMS version < 4 (#197)


1.4.3 (2023-09-27)
==================

Bugfixes
--------

- Set default_auto_field in AppConfig to avoid migrations problem if DEFAULT_AUTO_FIELD is different (#181)


1.4.2 (2023-09-26)
==================

Bugfixes
--------

- Bump django-meta version, fix settings accordingly (#178)


1.4.1 (2023-09-20)
==================

Features
--------

- Migrate to bump-my-version, fix python/django/djangocms versions in README (#176)


Bugfixes
--------

- Update filer dependency to avoid migration error from 155.feature (#173)


1.4.0 (2023-08-31)
==================

Features
--------

- Add DefaultMetaImage model to handle default meta image (#155)


1.3.0 (2023-08-07)
==================

Features
--------

- Add meta robots (#116)


1.2.0 (2023-05-08)
==================

Features
--------

- Update GH actions / linting configuration (#157)
- Add support for Django 4.2 / django CMS 3.11


1.1.0 (2022-08-27)
==================

Bugfixes
--------

- Skip creating toolbar item in page types (#150)
- Add support for Django 3.2 / django CMS 3.10 (#151)


1.0.1 (2020-12-21)
==================

Features
--------

- Add configuration for django-app-enabler (#141)


1.0.0 (2020-11-18)
==================

Features
--------

- Update tooling and drop Python 2 / Django < 2.2 compatibility (#135)
- Add support for django CMS 3.8 / Django 3.1
- Add support for django-meta 2.0


Bugfixes
--------

- Fix setup.cfg and pyproject.toml package name (#138)

0.10.0 (2019-12-27)
===================

* Move from djangocms-helper to django-app-helper
* Improve toolbar performance

0.9.0 (2019-08-22)
==================

* Add support for django CMS 3.7 / Django 2.2
* Remove support for Django < 1.11 / Python 3.4

0.8.5 (2019-03-22)
==================

* Fix error in migration missing on_delete argument

0.8.4 (2019-03-11)
==================

* Add Django 2.0 and Django 2.1 compatibility
* Add django CMS 3.6 compatibility
* Fixes a crash on creating new pagetype with djangocms 3.5.2

0.8.3 (2018-04-07)
==================

* Remove description when creating a CMS page
* Provide page dates meta if PageMeta does not exists
* Improve compatibility with Django 3.5

0.8.2 (2018-02-22)
==================

* Change method of patching PageAdmin for better compatibility with other addons

0.8.1 (2018-02-17)
==================

* Fix duplicate GenericMetaAttribute on publish
* Fix error on Divio cloud when description fields length is not set

0.8.0 (2018-01-14)
==================

* Add Django 1.11 support
* Add django CMS 3.5 support
* Drop django CMS 3.2, 3.3
* Add support for filer canonical URL
* Do not fail if request is not in context
* Make HTML and twitter description fields length configurable

0.7.0 (2016-12-04)
==================

* Drop Django 1.7 and below
* Drop django CMS 3.1 and below
* Add Django 1.10 support

0.6.3 (2016-10-22)
==================

* Added support for django CMS 3.4

0.6.2 (2016-08-01)
==================

* Conditionally show page description field if not empty

0.6.1 (2016-06-20)
==================

* Drop unique index on generic meta attributes

0.6 (2016-06-05)
================

* Let settings be used as defaults
* Added support for fb_pages attribute
* Added support for generic meta attributes

0.5.11 (2016-03-17)
===================

* Make object type not required

0.5.10 (2016-03-03)
===================

* Fix handling Google+ author URL

0.5.9 (2016-02-25)
==================

* Fix issue with Django 1.9

0.5.8 (2016-02-23)
==================

* Improve Aldryn support
* Catch AttributeError in get_page_meta

0.5.7 (2016-01-09)
==================

* Fix handling of pages in non existing languages
* Add support for Aldryn environment

0.5.6 (2015-10-03)
==================

* Fix error when retrieing tags from djangocms-page-tags
* Add support for django CMS 3.2
* Add support for Django 1.8

0.5.5 (2015-08-21)
==================

* Different approach at fix error when page is None
* Better fallback mechanism
* Update i18n

0.5.4 (2015-08-08)
==================

* Fix error when page is None
* Code cleanup
* Add pep8/isort to tests
* Add missing migration

0.5.3 (2015-06-29)
==================

* Fix Django 1.7 migration
* Update testing configuration

0.5.2 (2015-06-28)
==================

* Compatibility with django CMS 3.1.1

0.5.1 (2015-06-06)
==================

* Make south migrations indipendent from djangocms-helper

0.5 (2015-06-06)
================

* Add support for custom user model
* Fix the length of SEO fields
* Use djangocms-helper for tests
* Add support for Django 1.7
* Add support for django CMS 3.1

0.4.1 (2014-08-10)
==================

* Minor fixes

0.4.0 (2014-04-19)
==================

* django CMS 3 final release support
* Moved some code to external django-meta-mixin application

0.3.3 (2014-03-23)
==================

* Better support for sn-dependent descriptions

0.3.2 (2014-03-07)
==================

* Add different descriptions for each supported social network

0.3.1 (2014-02-13)
==================

* Fix permission name

0.3.0 (2014-02-02)
==================

* Fix for django CMS 3 develop update

0.2.1 (2014-01-26)
==================

* Vendorizing django-meta compatibility templatetags

0.2.0 (2014-01-22)
==================

* Put toolbar menu items in a submenu

0.1.0 (2014-01-21)
==================

* Experimental release.