0
0
mirror of https://github.com/wagtail/wagtail.git synced 2024-11-25 13:10:14 +01:00
A Django content management system focused on flexibility and user experience https://wagtail.org/
Go to file
Matt Westcott a7ac18f609 Reword special-purpose FieldPanel deprecation message for clarity
Multiple people on Slack support have asked "how do I fix this error" now, which suggests that the wording here needs improvement...

* change "is obsolete" to "is no longer required", to make it sound less "your code is broken" and more "here's an improvement you can make" (but also state that it'll be removed in a future release, to make it clear that you have to do it soomer or later)
* leave out the full module paths - they're probably coming across as internal tech gobbledegook rather than informative, and obscuring the word "Panel" which is the most important thing in the message
* link to the release note to clear up any remaining confusion
2022-09-29 22:12:56 +01:00
.circleci Move tests to test 2022-03-17 17:19:59 +00:00
.github Updated screenshot for Wagtail 3 (#8331) 2022-04-14 12:09:17 +01:00
.tx Add wagtailadminjs resource to transifex config 2022-04-13 19:51:31 +01:00
client Postpone add comment widget initialisation until after comments are enabled. (#9124) 2022-09-02 14:54:28 +01:00
docs fix formatting of 2.15.6 release notes 2022-09-05 13:22:06 +01:00
etc Release note / additional fix for #6339 2020-10-05 14:25:33 +01:00
scripts Upgrade flake8-print to resolve CircleCI failures 2022-08-19 12:02:35 +01:00
wagtail Reword special-purpose FieldPanel deprecation message for clarity 2022-09-29 22:12:56 +01:00
.coveragerc Update Python and JS test coverage collection to exclude tests 2020-05-27 09:11:26 +01:00
.editorconfig Add and configure black 2022-02-15 13:06:17 +00:00
.eslintignore Move inline panel JS into inline_panel.html 2022-04-06 14:40:39 +01:00
.eslintrc.js Page editor underline tabs (#8266) 2022-04-12 16:11:08 +01:00
.git-blame-ignore-revs Add black reformatting commit SHA to .git-blame-ignore-revs 2022-02-15 13:12:22 +00:00
.gitignore Trial browser tests in CircleCI 2022-01-15 21:44:36 +10:00
.nvmrc Upgrade Node tooling to Node v16 and npm v8 2022-02-01 07:36:17 +10:00
.pre-commit-config.yaml Bump black to 22.3.0 to fix issue with dependency 2022-03-29 20:04:58 +01:00
.prettierignore Move inline panel JS into inline_panel.html 2022-04-06 14:40:39 +01:00
.readthedocs.yml Reformat codebase with Prettier (#7912) 2022-02-04 11:57:55 +00:00
.squash.yml Upgrade Node tooling to Node v16 and npm v8 2022-02-01 07:36:17 +10:00
.stylelintignore Upgrade to latest Sass and stylelint configuration, with needed refactorings 2022-02-01 07:36:17 +10:00
.stylelintrc.js Convert all UI code to CSS logical properties (#8051) 2022-03-15 13:21:06 +00:00
CHANGELOG.txt Release notes for 2.16.3 2022-09-05 13:21:58 +01:00
CODE_OF_CONDUCT.md Update email addresses for new .org domain (#7845) 2022-01-28 12:16:24 +00:00
codecov.yml Disable codecov coverage checks on PRs 2019-01-30 10:49:51 +00:00
conftest.py Move tests to test 2022-03-17 17:19:59 +00:00
CONTRIBUTORS.rst Fetch new translations from Transifex 2022-05-16 11:41:04 +01:00
LICENSE Makes LICENSE recognized by GitHub. 2019-06-05 15:18:50 +02:00
Makefile Added lint-server, lint-client, format-server and format-client tasks to the Makefile (#8177) 2022-03-30 14:14:30 +01:00
MANIFEST.in Wagtail packaging fixes (#8030) 2022-02-28 22:35:10 +00:00
package-lock.json Bump minimist from 1.2.5 to 1.2.6 2022-04-04 06:49:15 +10:00
package.json Add a script to extract strings from javascript 2022-04-01 17:01:26 -04:00
prettier.config.js Add Prettier configuration & documentation (#7908) 2022-02-04 11:45:08 +00:00
README.md 3.0 - add JSON1 SQLite compatibility requirements (#8433) 2022-04-26 13:22:27 +01:00
runtests.py Move tests to test 2022-03-17 17:19:59 +00:00
SECURITY.md Update security PGP key to use new wagtail.org domain 2022-01-28 12:16:31 +00:00
setup.cfg Add and configure black 2022-02-15 13:06:17 +00:00
setup.py Upgrade flake8-print to resolve CircleCI failures 2022-08-19 12:02:35 +01:00
SPONSORS.md Release note for #8317 2022-04-13 15:40:07 +01:00
tailwind.config.js Sidebar style updates (#8118) 2022-03-23 03:27:12 +00:00
tox.ini Formalise support for Django 4.0 2022-01-24 11:46:12 +00:00
tsconfig.json Move inline panel JS into inline_panel.html 2022-04-06 14:40:39 +01:00

Wagtail Wagtail


Build Status License Version Total alerts Language grade: Python Language grade: JavaScript Monthly downloads

Wagtail is an open source content management system built on Django, with a strong community and commercial support. It's focused on user experience, and offers precise control for designers and developers.

Wagtail screenshot

Features

  • A fast, attractive interface for authors
  • Complete control over front-end design and structure
  • Scales to millions of pages and thousands of editors
  • Fast out of the box, cache-friendly when you need it
  • Content API for 'headless' sites with de-coupled front-end
  • Runs on a Raspberry Pi or a multi-datacenter cloud platform
  • StreamField encourages flexible content without compromising structure
  • Powerful, integrated search, using Elasticsearch or PostgreSQL
  • Excellent support for images and embedded content
  • Multi-site and multi-language ready
  • Embraces and extends Django

Find out more at wagtail.org.

Getting started

Wagtail works with Python 3, on any platform.

To get started with using Wagtail, run the following in a virtual environment:

pip install wagtail
wagtail start mysite
cd mysite
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

For detailed installation and setup docs, see docs.wagtail.org.

Whos using it?

Wagtail is used by NASA, Google, Oxfam, the NHS, Mozilla, MIT, the Red Cross, Salesforce, NBC, BMW, and the US and UK governments. Add your own Wagtail site to madewithwagtail.org.

Documentation

docs.wagtail.org is the full reference for Wagtail, and includes guides for developers, designers and editors, alongside release notes and our roadmap.

Compatibility

(If you are reading this on GitHub, the details here may not be indicative of the current released version - please see Compatible Django / Python versions in the Wagtail documentation.)

Wagtail supports:

  • Django 3.2.x and 4.0.x
  • Python 3.7, 3.8, 3.9 and 3.10
  • PostgreSQL, MySQL and SQLite (with JSON1) as database backends

Previous versions of Wagtail additionally supported Python 2.7 and earlier Django versions.


Community Support

There is an active community of Wagtail users and developers responding to questions on Stack Overflow. When posting questions, please read Stack Overflow's advice on how to ask questions and remember to tag your question "wagtail".

For topics and discussions that do not fit Stack Overflow's question and answer format, we have a Slack workspace and a Wagtail Support mailing list. Please respect the time and effort of volunteers by not asking the same question in multiple places.

Our Github discussion boards are open for sharing ideas and plans for the Wagtail project.

We maintain a curated list of third party packages, articles and other resources at Awesome Wagtail.

Commercial Support

Wagtail is sponsored by Torchbox. If you need help implementing or hosting Wagtail, please contact us: hello@torchbox.com. See also madewithwagtail.org/developers/ for expert Wagtail developers around the world.

Security

We take the security of Wagtail, and related packages we maintain, seriously. If you have found a security issue with any of our projects please email us at security@wagtail.org so we can work together to find and patch the issue. We appreciate responsible disclosure with any security related issues, so please contact us first before creating a Github issue.

If you want to send an encrypted email (optional), the public key ID for security@wagtail.org is 0xbed227b4daf93ff9, and this public key is available from most commonly-used keyservers.

Release schedule

Feature releases of Wagtail are released every three months. Selected releases are designated as Long Term Support (LTS) releases, and will receive maintenance updates for an extended period to address any security and data-loss related issues. For dates of past and upcoming releases and support periods, see Release Schedule.

Nightly releases

To try out the latest features before a release, we also create builds from main every night. You can find instructions on how to install the latest nightly release at https://releases.wagtail.org/nightly/index.html

Contributing

If you're a Python or Django developer, fork the repo and get stuck in! We have several developer focused channels on the Slack workspace.

You might like to start by reviewing the contributing guidelines and checking issues with the good first issue label.

We also welcome translations for Wagtail's interface. Translation work should be submitted through Transifex.

License

BSD

Thanks

We thank the following organisations for their services used in Wagtail's development:

Browserstack
BrowserStack provides the project with free access to their live web-based browser testing tool, and automated Selenium cloud testing.

squash.io
Squash provides the project with free test environments for reviewing pull requests.

Assistiv Labs
Assistiv Labs provides the project with unlimited access to their remote testing with assistive technologies.