Menu:

Some documentation about the output from plugins

Here a little documentation about the output from plugins...

page_msg - give feedback

(A little outdated, see: page_msg changes)

A plugin can response feedback to the users via the PyLucid page_msg function. The output can be simple colored and the functin is good for debugging.

The using is very easy. Here some example:

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
# Output in geen:
self.page_msg.green("Something was done, ok.")



# Output in red, for error messages:
self.page_msg.red("Something failed!")



# Without a color, the output is blue:
self.page_msg("These line is blue...")


# ...and we have a black color, too:
self.page_msg.black("...and this line is black.")

The sourcecode of the page_msg object can be found here:

The output displayed via a simple django template "for loop". The output stored in the template context variable 'messages'. It's a simple list with every line of the output.
In the global template sould be exist something like this:

HTML
1
2
3
4
5
6
7
{% if messages %}
  <fieldset id="page_msg"><legend>page message</legend>
    {% for message in messages %}
      {{ message }}<br />
    {% endfor %}
  </fieldset>
{% endif %}

page title

A plugin can change the page title with:

Python
1
2
3
4
5
6
7
8
from django.utils.translation import ugettext as _


...


# Change the global page title: 
self.context["PAGE"].title = _("A new page title")

With changeset 1532 the page title would be automatic changes in every _command url. But only, if the plugin doesn't change the title themself.

Note: There should not exists a headline in the internal pages for a "page title replacement".

custom output via the CSS anchor

Every Plugin output are surrounded with a CSS anchor. At the moment we add a DIV tag around every plugin output in ./PyLucid/template_addons/lucidTag.py

The function add_css_tag() can be found here: ./PyLucid/system/context_processors.py

There exist a black list (CSS_TAG_BLACKLIST) in lucidTag.py Because Plugins how only insert a link into the page, should not have a Tag around the link. At the moment the blacklist looks like:

Python
1
CSS_TAG_BLACKLIST = ("page_style", "RSSfeedGenerator",)