divio/django-cms — pull request #1027 by Chive (2014-02-28 12:07:50+00:00)
Title: [Docs] plugin reference should cover provided contexts.

In light of [this thread on the google group](https://groups.google.com/forum/#!topic/django-cms/OxCeQYxK04Y), I think it would make sense for the [plugins reference](http://docs.django-cms.org/en/2.2/getting_started/plugin_reference.html) to document what values get passed from the plugin to the template, and expound on how to use the placeholder variable (and potentially the```{% with %}``` tag) to change what's displayed.

I'm fairly certain this is covered in minor ways in other parts of the documentation - the ```{% with %}``` usage, for example, [is here](http://readthedocs.org/docs/django-cms/en/latest/advanced/templatetags.html#placeholder); the ```placeholder``` usage [is here](http://docs.django-cms.org/en/2.2/getting_started/plugin_reference.html#picture) - but it would be good to have it a) all in one place, b) filling out the plugin reference docs, both in a clear way.

I'll start attacking it at some point, but I wanted a ticket in case I can't do so any time soon, for whatever reason.