istrategylabs

django-wordpress: Read WordPress Content in Django

django-wordpress provides read-only Django models and views for reading content from a WordPress database. It suits Django applications that need to display or export WordPress posts without making WordPress their writing interface.

InactivePythonBSD-3-ClauseDjangoLibraryDatabase
View on GitHub Compare
Stars
360
Forks
81
Stars, last 30 days
+1
Last commit
5.4 years ago
Contributors
9

Our take

Inactiveno commits in over a year

Health score

24/100

How it is scored
Activity
19
Community
36
Issues
21
Pull requests
20

+1 stars in the last 30 days

This is a focused integration for reading WordPress content from Django, but its inactive maintenance and concentrated contribution history make it a cautious choice for new dependencies.

Good fit if

  • Your application already uses Django and needs to read from a WordPress 3.5+ database.
  • Read-only access and the included post, term, tag, and export functionality cover your needs.
  • You can review and maintain the integration yourself if compatibility issues arise.

Look elsewhere if

  • You need active upstream maintenance or recent releases, since the project has had no recent commits or releases.
  • Your integration needs safe writing to WordPress. The README warns that enabling writes may break the WordPress installation.
  • Your team cannot take on extra maintenance risk from a project where most contributions come from one person.
All health signals
Last commit2021-06-07 (5.4 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors9 (top contributor: 81% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age17 years

Checked on 2026-10-26 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

361

Forks

81

Change since Nov 14, 2026: 0 stars·0 forks

Overview

django-wordpress is a Python package that connects Django applications to a WordPress database, providing models and views for reading its content. It is designed for teams that want to use WordPress as a publishing source while presenting or working with that content in a Django application.

The package supports WordPress 3.5 and later, can read from a configured database connection, and defaults to read-only behavior to help protect WordPress content. See the repository README for setup details and examples.

Key Features

  • Django models for querying published WordPress posts.
  • Query helpers for retrieving posts by publication status or term.
  • Access to post attachments and tags.
  • Configurable WordPress table prefix.
  • Support for reading from a selected Django database connection through a database router.
  • Management commands to export published posts in WXR format and authors as CSV.
  • Default templates for development, intended to be replaced with application-specific templates.

Use Cases

  • A Django site needs to display articles maintained by an existing WordPress installation.
  • A team wants to query WordPress posts and tags from Django without building a custom database integration.
  • Developers need to export published WordPress posts or author records from a Django project.
  • A project wants a read-only connection to WordPress content while keeping its presentation in Django.

What you need

Detected in the repository

  • Python (from setup.py)

License in plain words

BSD-3-Clausepermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice; the authors' names cannot endorse your product
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

pip install the-real-django-wordpress

Add wordpress to INSTALLED_APPS, configure the database router as needed, and consult the README for URL and settings details.

Considerations

The project is marked inactive, with no commits in over a year and no releases in the past year. Although nine contributors are recorded, most of the code comes from one person, and there has been no recent issue or pull-request activity. The README describes writing as disabled by default and explicitly warns that enabling it may break a WordPress installation. Default templates are for development only. The repository uses the BSD-3-Clause license; teams should review its terms before adopting or redistributing the package.

Found this useful?

Share it with someone who would like django-wordpress.