A Django content management system focused on flexibility and user experience
Find a file
Karl Hobley c24fabe1d5 Added "defer" keyword argument to PageQuerySet.specific()
Setting this to True will tell Wagtail to defer all the specific fields
for each page. Each page will still be loaded in their correct class,
but only the fields defined on Page will be loaded in the initial query.

This gives a performance improvement when dealing with pages that have large
amounts of body text which we don't need to display in the admin.

Values of specific pages will continue to work, but will add extra
queries at the point of accessing them.
2018-06-11 15:38:08 +01:00
.github Mention cross-browser testing in PR template 2018-02-14 17:11:59 +02:00
.tx Fetch new translations from Transifex 2018-05-04 20:29:48 +01:00
client Expose reusable client-side code to build Draftail extensions (#4467) 2018-04-18 00:27:07 +03:00
docs update changelog/releases for #4535 2018-06-10 12:52:10 +10:00
etc Fixed spelling error in uwsgi.conf.sample 2017-11-27 13:08:42 +01:00
gulpfile.js Update autoprefixer list on browser support 2018-01-17 21:48:17 +02:00
scripts Travis/tox configuration for Elasticsearch 6 2018-05-04 15:57:36 +01:00
wagtail Added "defer" keyword argument to PageQuerySet.specific() 2018-06-11 15:38:08 +01:00
.coveragerc Update .coveragerc 2015-12-23 00:09:44 +01:00
.editorconfig Fix whitespace errors in docs 2016-11-28 13:41:35 +00:00
.eslintignore Updated paths in .eslintignore 2017-12-04 22:51:38 +00:00
.eslintrc Update explorer for latest scope, UI, with tests 2017-05-13 23:53:10 +03:00
.gitignore Add pytest cache directories to gitignore 2018-04-08 06:58:19 +02:00
.nvmrc Replace references to Node versions 2017-08-11 15:40:43 +01:00
.stylelintrc.yaml Ignore build folder for CSS linting (#4264) 2018-02-10 01:39:44 +02:00
.travis.yml Travis/tox configuration for Elasticsearch 6 2018-05-04 15:57:36 +01:00
appveyor.yml Remove unsupported environments from appveyor config 2017-10-13 12:27:09 +01:00
CHANGELOG.txt update changelog/releases for #4535 2018-06-10 12:52:10 +10:00
circle.yml Add Codecov integration to CircleCI to track JS test coverage, with separate flags (#4219) 2018-03-06 20:19:37 +02:00
CODE_OF_CONDUCT.md Add Contributor Covenant 2016-02-03 15:47:50 +00:00
codecov.yml Disable codecov's require_ci_to_pass mode 2017-06-30 22:59:28 +01:00
conftest.py Removed __future__ imports 2017-11-27 02:18:30 +00:00
CONTRIBUTING.md Revise link to issues for contributing (#4145) 2017-12-20 14:07:09 +02:00
CONTRIBUTORS.rst Changelog/release note for #4550 2018-05-29 10:31:14 +01:00
LICENSE Make license perpetual 2017-10-27 09:55:03 +01:00
Makefile Fixes #3516 - replaces scss-lint with stylelint 2017-08-26 16:39:45 +03:00
MANIFEST.in Improvements to MANIFEST.IN 2016-03-09 14:30:25 +00:00
package-lock.json Upgrade Draftail to v0.17.1. (#4426) 2018-03-27 22:33:25 +02:00
package.json Upgrade Draftail to v0.17.1. (#4426) 2018-03-27 22:33:25 +02:00
README.rst Update test coverage link from coveralls to codecov. Fix #4143 2017-12-20 14:11:40 +02:00
runtests.py Added Elasticsearch 6 backend 2018-05-04 15:57:35 +01:00
setup.cfg Use tool:pytest in setup.cfg to fix warning message when running pytest 2018-04-08 06:57:43 +02:00
setup.py Update author details in setup.py 2018-05-14 14:38:27 +01:00
tox.ini Travis/tox configuration for Elasticsearch 6 2018-05-04 15:57:36 +01:00

.. image:: https://api.travis-ci.org/wagtail/wagtail.svg?branch=master
    :target: https://travis-ci.org/wagtail/wagtail
.. image:: https://img.shields.io/pypi/l/wagtail.svg
    :target: https://pypi.python.org/pypi/wagtail/
.. image:: https://img.shields.io/pypi/v/wagtail.svg
    :target: https://pypi.python.org/pypi/wagtail/
.. image:: http://codecov.io/github/wagtail/wagtail/coverage.svg?branch=master
    :target: http://codecov.io/github/wagtail/wagtail?branch=master


Wagtail CMS
===========

Wagtail is a content management system built on Django. It's focused on user experience,
and offers precise control for designers and developers.

.. image:: http://i.imgur.com/hSVerKq.jpg
   :width: 728 px

Features
~~~~~~~~

* A fast, attractive interface for authors and editors
* Complete control over design with standard Django templates
* Configure content types through standard Django models
* Fast out of the box. Cache-friendly if you need it
* Tightly integrated search
* Strong document and image management
* Wide support for embedded content
* Straightforward integration with existing Django apps
* Simple, configurable permissions
* Workflow support
* An extensible `form builder <http://docs.wagtail.io/en/latest/reference/contrib/forms/index.html>`_
* Multi-site and multi-language support
* Excellent `test coverage <http://codecov.io/github/wagtail/wagtail?branch=master>`_

Find out more at `wagtail.io <http://wagtail.io/>`_.

Getting started
~~~~~~~~~~~~~~~

.. code-block:: sh

    pip install wagtail
    wagtail start mysite
    cd mysite
    python manage.py migrate
    python manage.py createsuperuser
    python manage.py runserver

then sign in at http://127.0.0.1:8000/admin/

For detailed installation and setup docs, see `docs.wagtail.io <http://docs.wagtail.io/>`_.

Who's using it?
~~~~~~~~~~~~~~~
`madewithwagtail.org <http://madewithwagtail.org>`_ lists some of the public Wagtail sites we know about; please `add your own <http://madewithwagtail.org/submit/>`_.

Documentation
~~~~~~~~~~~~~
`docs.wagtail.io <http://docs.wagtail.io/>`_ is the full reference for Wagtail, and includes guides for developers, designers and editors, alongside release notes and our roadmap.

Community Support
~~~~~~~~~~~~~~~~~
There is an active community of Wagtail users and developers responding to questions on `Stack Overflow <http://stackoverflow.com/questions/tagged/wagtail>`_. When posting questions, please read Stack Overflow's advice on `how to ask questions <http://stackoverflow.com/help/how-to-ask>`_ and remember to tag your question with "wagtail".

For topics and discussions that do not fit Stack Overflow's question-and-answer format, there is also a `Wagtail Support mailing list <https://groups.google.com/forum/#!forum/wagtail>`_ and a `Slack workspace <https://github.com/wagtail/wagtail/wiki/Slack>`_.

Commercial Support
~~~~~~~~~~~~~~~~~~
Wagtail is sponsored by `Torchbox <https://torchbox.com/>`_. If you need help implementing or hosting Wagtail, please contact us: hello@torchbox.com.

Thanks
~~~~~~
We thank `BrowserStack <https://www.browserstack.com/>`_, who provide the project with free access to their live web-based browser testing tool, and automated Selenium cloud testing.

.. image:: https://cdn.rawgit.com/wagtail/wagtail/master/.github/browserstack-logo.svg
    :target: https://www.browserstack.com/
    :width: 219 px

Compatibility
~~~~~~~~~~~~~
Wagtail supports Django 1.11.x and 2.0 on Python 3.4, 3.5 and 3.6. Supported database backends are PostgreSQL, MySQL and SQLite.

Contributing
~~~~~~~~~~~~
If you're a Python or Django developer, fork the repo and get stuck in! We run a separate group for developers of Wagtail itself at https://groups.google.com/forum/#!forum/wagtail-developers (please note that this is not for support requests).

You might like to start by reviewing the `contributing guidelines <http://docs.wagtail.io/en/latest/contributing/index.html>`_ and checking issues with the `good first issue <https://github.com/wagtail/wagtail/labels/good%20first%20issue>`_ label.

We also welcome translations for Wagtail's interface. Translation work should be submitted through `Transifex <https://www.transifex.com/projects/p/wagtail/>`_.