Sending a Moblog Email

This page describes the possible syntax you can use in the body of your Moblog emails. In addition to the regular body text of the email (and the file/image attachment) you can specify several values that can override the defaults selected for your Moblog in the Control Panel.

In most cases, your email body will simply be whatever text you want to submit along with your file:

Here's a quick picture of the train station this morning on the way to work. Notice the guy selling flowers? He's been there every morning like clockwork for the last 2 years. He's always cheerful and actually has some pretty nice flowers.

Here is a more complicated example that uses some of the "overrides":

{category}3,6{/category}
AUTH:johnsmith:mysecretword

Here's a quick picture of the train station this morning on the way to work. Notice the guy selling flowers? He's been there every morning like clockwork for the last 2 years. He's always cheerful and actually has some pretty nice flowers.

Overrides

These overrides are placed in the body of the email on their own lines. The overrides should normally be placed at the top of the email before your actual body content. Most of the overrides have multiple possible syntaxes in order to give a choice in how to enter them to make it easier.

category

{category}3,6,7{/category} <category>3,6,7</category>

You may override the default category selection and specify your own. You must specify the category ID (the number) and not the text name of the category. Multiple categories can be separated by commas (,), colons (:), or the pipe character (|).

The category override can be defined using either braces ({category}{/category}) or angle brackets (<category></category>).

field

{field}food_images{/field} <field>Food Images</field>

You may override the default field into which the contents will be placed and specify your own. You may specify the field either by the "short name" or the actual label for the field.

The field override can be defined using either braces ({field}{/field}) or angle brackets (<field></field>).

You may only specify a field that is of the "textarea" type here. You cannot specify "text input" or "drop-down list" fields.

file_archive

{file_archive}yes{/file_archive} <file_archive>yes</file_archive>

You may override the default file archive setting for the entry and specify manually that this email is a file archive (i.e. you are simply uploading a file and no corresponding entry should be made). Simply use either yes, true, or 1 to indicate that only the files of this email should be uploaded. Alternatively, use no, false, or 0 to indicate that an entry should be created using this email.

The file archive override can be defined using either braces ({file_archive}{/file_archive}) or angle brackets (<file_archive></file_archive>).

status

{status}pending{/status} <status>Closed</status>

You may override the default status for the entry and specify your own. Simply use the name of the status.

The status override can be defined using either braces ({status}{/status}) or angle brackets (<status></status>).

User Authorization

AUTH:johnsmith:mysecretword

You may override the default author for the entry and specify your own author. The syntax for this override is different from the others and follows the guide: AUTH:theusername:thepassword. "theusername" should be replaced by the username of the desired member and "thepassword" should be replaced by their password.

Note that if you have the Authorization Required in Email? option turned on for this Moblog in the Control Panel then you must include this user authorization. If you do not include it or if the authorization fails, the entry will not be posted. The Delete Unauthorized Moblog Emails? setting will determine whether or not the email is deleted from the server in these cases.