Skip to main content

A CMS framework for Django built on a heterogenous tree editor.

Project description

Widgy: Tree Editor for Django

Build Status

Widgy is a content editor somewhat in the line of CKEditor. It is not a WYSIWYG editor though. Widgy is more suited than CKEditor for editing pages, as in a CMS because it allows you to edit specific parts of the page and those parts know how to render themselves. Whereas a WYSIWYG stores its data in HTML, Widgy stores it in a Tree where each node can render itself.

Widgy is available under the Apache Version 2.0 license. Contribute on github.

Documentation

Read Widgy’s documentation at http://docs.wid.gy.

Installation

Install with pip.

pip install django-widgy

When developing Widgy, it might be handy to clone the repository then install it.

git clone git://github.com/fusionbox/django-widgy
cd django-widgy
pip install -e .

Design Philosophy

Read about Widgy’s data model at http://docs.wid.gy/en/latest/design/data-model.html.

Contributing

There is a developers mailing list available at widgy@fusionbox.com

Running the Tests

pip install -r requirements-test.txt
make test

make test will run both the JavaScript and Python tests. To test one or the other, use make test-js or make test-py.

$ tox

$ tox will run the full test suite across all of the supported versions of Django and Python.

Coverage

Once coverage is installed (pip install coverage), the Makefile has two commands to help report on code coverage.

make coverage

will run the tests with coverage enabled and generate HTML coverage files.

make browser

will run the tests and open the coverage report in your web browser.

Changelog

0.5.0 (2015-04-17)

  • Backwards Incompatible RichTextPage is no longer unregistered by default in widgy_mezzanine. If you wish to unregister it, you can add the following to your admin.py file:

    from django.contrib import admin
    from mezzanine.pages.models import RichTextPage
    admin.site.unregister(RichTextPage)
  • Bugfix: Previously, the Widgy editor would break if CSRF_COOKIE_HTTPONLY was set to True [#311]

  • Switched to py.test for testing. [#309]

0.4.0 (2015-03-12)

  • Django 1.7 support. Requires upgrade to South 1.0 (Or use of SOUTH_MIGRATION_MODULES) if you stay on Django < 1.7. You may have to –fake some migrations to upgrade to the builtin Django migrations. Make sure your database is up to date using South, then upgrade Django and run:

    ./manage.py migrate --fake widgy
    ./manage.py migrate --fake easy_thumbnails
    ./manage.py migrate
  • Support for installing Widgy without the dependencies of its contrib apps. The ‘django-widgy’ package only has dependencies required for Widgy core. Each contrib package has a setuptools ‘extra’. To install everything, replace ‘django-widgy’ with ‘django-widgy[all]’. [#221]

  • Switched to tox for test running and allow running core tests without contrib. [#294]

  • Stopped relying on urls with consecutive ‘/’ characters [#233]. This adds a new urlpattern for widgy_mezzanine’s preview page and form submission handler. The old ones will keep working, but you should reverse with ‘page_pk’ instead of ‘slug’. For example:

    url = urlresolvers.reverse('widgy.contrib.widgy_mezzanine.views.preview', kwargs={
        'node_pk': node.pk,
        'page_pk': page.pk,
    })
  • Treat help_text for fields in a widget form as safe (HTML will not be escaped) [#298]. If you were relying on HTML special characters being escaped, you should replace help_text="1 is < 2" with help_text=django.utils.html.escape("1 is < 2").

  • Reverse URLs in form_builder admin with consideration for Form subclasses [#274].

0.3.5 (2015-01-30)

Bugfix release:

  • Set model at runtime for ClonePageView and UnpublishView [Rocky Meza, #286]

0.3.4 (2015-01-22)

Bugfix release:

  • Documentation fixes [Rocky Meza and Gavin Wahl]

  • Fixes unintentional horizontal scrolling of Widgy content [Justin Stollsteimer]

  • Increased spacing after widget title paragraphs [Justin Stollsteimer]

  • Fixed styles in ckeditor to show justifications [Zachery Metcalf, #279]

  • Eliminated the margins for InvisibleMixin [Rocky Meza]

  • CSS support for adding fields to Image. [Rocky Meza]

  • Additional mezzanine container style overflow fixes [Justin Stollsteimer]

  • Fix r.js optimization errors with daisydiff [Rocky Meza]

  • Remove delete button from widgypage add form [Gavin Wahl]

0.3.3 (2014-12-22)

Bugfix release:

  • Allow cloning with an overridden WIDGY_MEZZANINE_PAGE_MODEL [Zach Metcalf, #269]

  • SCSS syntax error [Rivo Laks, #271]

0.3.2 (2014-10-16)

Bugfix release:

  • Allow WidgyAdmin to check for ReviewedWidgySite without review_queue installed [Scott Clark, #265]

  • Fix handling of related_name on ProxyGenericRelation [#264]

0.3.1 (2014-10-01)

Bugfix release for 0.3.0. #261, #263.

0.3.0 (2014-09-24)

This release mainly focusses on the New Save Flow feature, but also includes several bug fixes and some nice CSS touch ups. There have been some updates to the dependencies, so please be sure to check the How to Upgrade section to make sure that you get everything updated correctly.

Major Changes

  • New Save Flow Requires upgrading Mezzanine to at least 3.1.10 [Gavin Wahl, Rocky Meza, #241]

    We have updated the workflow for WidgyPage. We consider this an experiment that we can hopefully expand to all WidgyAdmins in the future. We hope that this new save flow is more intuitive and less tedious.

    Screenshot of before:

    Widgy Page Admin Old Save Flow

    Screenshot of after:

    Widgy Page Admin New Save Flow

    As you can see, we have rearranged some of the buttons and have gotten rid of the Published Status button. The new save buttons on the bottom right now will control the publish state as well as the commit status. This means that now instead of committing and saving being a two-step process, it all lives in one button. This should make editing and saving a smoother process. Additionally, we have renamed some buttons to make their intent more obvious.

Bug Fixes

  • Updated overridden directory_table template for django-filer 0.9.6. Requires upgrading django-filer to at least 0.9.6. [Scott Clark, #179]

  • Fix bug in ReviewedVersionTrackerQuerySet.published [Gavin Wahl, #240]

  • Made commit buttons not look disabled [Justin Stollsteimer, #250, #205]

  • (Demo) Added ADD_PAGE_ORDER to demo settings [Zach Metcalf, #248]

  • (Demo) Updated demo project requirements [Scott Clark, #234]

  • Make Widgy’s jQuery private to prevent clashes with other admin extensions [Gavin Wahl, #246]

Documentation

  • Update recommend ADMIN_MENU_ORDER to clarify django-filer [Gavin Wahl, #249]

How to Upgrade

In this release, widgy has udpated two of its dependencies:

  • The minimum supported version of django-filer is now 0.9.6 (previously 0.9.5).

  • The minimum supported version of Mezzanine is now 3.1.10 (previously 1.3.0).

If you pip install django-widgy==0.3.0, it should upgrade the dependencies for you, but just to be sure, you may want to also run

pip install 'django-filer>=0.9.6' 'Mezzanine>=3.1.10'

to make sure that you get the updates.

0.2.0 (2014-08-04)

Changes

  • Widgy is now Apache Licensed

  • Breaking Change Use django-pyscss for SCSS compilation. [Rocky Meza, #175]

    Requires an update to the COMPRESS_PRECOMPILERS setting:

    COMPRESS_PRECOMPILERS = (
        ('text/x-scss', 'django_pyscss.compressor.DjangoScssFilter'),
    )

    You may also have to update @import statements in your SCSS, because django-pyscss uses a different (more consistent) rule for path resolution. For example, @import 'widgy_common' should be changed to @import '/widgy/css/widgy_common'

  • Added help_text to Section to help user avoid bug [Zach Metcalf, #135]

  • Allow UI to updated based on new data after reposition [Gavin Wahl, #199]

  • Changed Button’s css_classes in shelf [Rocky Meza, #203]

  • Added loading cursor while ajax is in flight [Gavin Wahl, #215, #208]

  • Get rid of “no content” [Gavin Wahl, #206]

  • Use sprites for the widget icons [Gavin Wahl and Rocky Meza, #89, #227]

  • Only show approve/unapprove buttons for interesting commits [Gavin Wahl, #228]

  • Updated demo app to have new design and new widgets [Justin Stollsteimer, Gavin Wahl, Antoine Catton and Rocky Meza, #129, #176]

  • Added cloning for WidgyPages [Gavin Wahl, #235]

  • Use a more realistic context to render pages for search [Gavin Wahl, #166]

  • Add default children to Accordion and Tabs [Rocky Meza, #238]

Bugfixes

  • Fix cursors related to dragging [Gavin Wahl, #155]

  • Update safe urls [Gavin Wahl, #212]

  • Fix widgy_mezzanine preview for Mezzanine==3.1.2 [Rocky Meza, #201]

  • Allow RichTextPage in the admin [Zach Metcalf, #197]

  • Don’t assume the response has a content-type header [Gavin Wahl, #216]

  • Fix bug with FileUpload having empty values [Rocky Meza, #217]

  • Fix urlconf_include login_required handling [Gavin Wahl, #200]

  • Patch fancybox to work with jQuery 1.9 [Gavin Wahl, #222]

  • Fix some import errors in SCSS [Rocky Meza, #230]

  • Fix restore page in newer versions of Mezzanine [Gavin Wahl, #232]

  • Use unicode format strings in review queue [Gavin Wahl, #236]

Documentation

  • Updated quickstart to cover south migrations with easy_thumbnails [Zach Metcalf, #202]

  • Added Proxy Widgy Model Tutorial [Zach Metcalf, #210]

0.1.6 (2014-09-09)

  • Fix migrations containing unsupported KeywordsField from mezzanine [Scott Clark]

  • Rename package to django-widgy

0.1.5 (2013-11-23)

  • Fix Widgy migrations without Mezzanine [Gavin Wahl]

  • Drop target collision detection [Gavin Wahl]

  • Fix Figure and StrDisplayNameMixin [Gavin Wahl]

  • Avoid loading review_queue when it’s not installed [Scott Clark]

  • Fix multi-table inheritance with LinkFields [Gavin Wahl]

0.1.4 (2013-11-04)

  • Add StrDisplayNameMixin

0.1.3 (2013-10-25)

  • Fix image widget validation with the S3 storage backend

0.1.2 (2013-10-23)

  • Fix Widgy admin for static files hosted on a different domain

0.1.1 (2013-10-21)

  • Adjust MANIFEST.in to fix PyPi install.

  • Fix layout having a unicode verbose_name

0.1.0 (2013-10-18)

First release.

Basic features:

  • Heterogeneous tree editor (widgy)

  • CMS (widgy.contrib.widgy_mezzanine)

  • CMS Plugins (widgy.contrib.urlconf_include)

  • Widgets (widgy.contrib.page_builder)

  • Form builder (widgy.contrib.form_builder)

  • Multilingual pages (widgy.contrib.widgy_i18n)

  • Review queue (widgy.contrib.review_queue)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-widgy-0.5.0.tar.gz (1.8 MB view details)

Uploaded Source

File details

Details for the file django-widgy-0.5.0.tar.gz.

File metadata

File hashes

Hashes for django-widgy-0.5.0.tar.gz
Algorithm Hash digest
SHA256 c117a0b592327d94e983fb32953218c881b55a3f575a6a769b20f94b8436d18d
MD5 e57f985c1ab39b1465480f96414e919e
BLAKE2b-256 7b9db8e8734749f3c2e0567e1d79fa644e8af0c4274d5f807bbf9139f510b624

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page