[[PageOutline(2-5,Contents,pullout)]] = Insert word-wrapped text blocks == Description [t:WikiProcessors Wiki Processor] to wrap a {{{
}}} text block to a specified number of columns, 72 by default.

This is especially useful for pasting emails and getting blocks of text that don't scroll horizontally.

[[Image(email_formatter_example.png)]]

The EmailProcessorMacro is installed on Trac-Hacks, so you can test it out. Please do so only by previewing, not submitting tickets.

== Bugs/Feature Requests

Existing bugs and feature requests for EmailProcessorMacro are [query:status!=closed&component=EmailProcessorMacro&order=priority here]. If you have any issues, create a 
[/newticket?component=EmailProcessorMacro&owner=pacopablo new ticket].

[[TicketQuery(component=EmailProcessorMacro&group=type,format=progress)]]

== Download and Source

Download the [download:emailprocessormacro zipped source], check out [/svn/emailprocessormacro using Subversion], or [source:emailprocessormacro browse the source] with Trac.

== Installation

While this is a wiki macro, it is in the new macro format, which is actually a single-file plugin. As of 0.11, old style macros (those installed in the wiki-macros folder and only consisting of an `execute` function) are no longer supported. This means that this `macro` needs to be installed in the global plugin directory, or in the trac environment's `plugins` directory.

 * Copy `emailprocessor.py` into the environment's `plugins` directory.
 * Add the following to the environment's `trac.ini` file:
{{{
[components]
emailprocessor.emailmacro = enabled
}}}
 * Restart your web server.

== Example

Invocation:
{{{
 {{{
 #!email
 
 }}}
}}}

To wrap to a specified length, the line immediately following the invocation should contain `cols: ` followed by the number of columns at wich we wrap. For example:
{{{
 {{{
 #!email
 cols: 40
 
 }}}
}}}

It is important that the `cols:` starts at the beginning of the line and that only a number follows it.

== Recent Changes

[[ChangeLog(emailprocessormacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:pacopablo] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''