Retired Documentation: You are using the documentation for version 1.7.3 which was retired in 2013. Go here for the latest version documentation or check here for your available upgrades to the latest version.
Moblogging Module
The Moblogging Module Control Panel allows you to set up your Moblog account so you can begin emailing content to your site.
Main Screen
The main Moblog Module screen lists your existing Moblogs and allows you to edit, delete, or perform a check on any of them.
Create a New Moblog
This link in the upper right allows you to create a new moblog.
Moblogs
The name of the moblog.
Moblog Type
List whether the moblog is for a weblog or gallery.
Check Moblog
This link allows you to have ExpressionEngine check the moblog to get new emails.
Preferences
You may edit the preferences for your moblog by following this link. The preferences are listed under the "Create a New Moblog" section.
Delete
You may select a moblog to delete with the checkbox in this column. Simply check the box and then use the Delete button. All deletions are permanent.
There is also a separate page that covers the syntax available in the Moblog Email Template, which is a crucial part of setting up a "weblog" Moblog.
Create a New Moblog
This screen allows you to create a new Moblog account.
General Settings
Full Moblog Name
The full display name of the Moblog account.
Short Name
The short name for the Moblog account. It must be a single word with no spaces or special punctuation.
Time Between Checks
The amount of time that will elapse between checks of your Moblog account. This is used in conjunction with the {exp:moblog:check} tag on your page.
Moblog Enabled
You can determine whether or not the Moblog account is enabled. If the account is disabled then it will not be included when checks are made.
File Archive Mode
Enabling this preference basically means that your moblog is only used for uploading files. With this enabled, entries in the corresponding weblog will not be created when a moblog email is processed.
Moblog Type
Specify whether this moblog will be posting entries to a weblog or to a gallery. The settings for the next section will depend on your choice.
Allow Overrides in Email?
This allows you to specify whether or not you can override the default values specified on this page by including overrides in the actual email text. If turned on, this preference will cause the Moblog to ignore any overrides sent along with the email.
Weblog Entry Settings
Choose Weblog
Determine with which weblog the Moblog account will be associated. When you send in an entry, the entry will go into this weblog. If you do not specify a weblog, then no entries will be created when you send an email; only the attachments will be processed.
Default Categories
You may choose which category or categories the entry will be assigned to. This choice is simply a default; it can be overridden when sending the email. Field must be of the textarea type.
Default Field
You may choose which field the entry will be assigned to. This choice is simply a default; it can be overridden when sending the email.
Default Status
You may choose which status the entry will be assigned to. This choice is simply a default; it can be overridden when sending the email.
Default Author
You may choose which field the entry will be assigned to. This choice is simply a default; it can be overridden when sending the email.
Upload Directory for Files
You may determine into which of your File Upload directories the file attachments will be placed. You may define them in the File Upload Preferences section.
Moblog Template
This allows you to specify exactly how the contents of your email will be handled. The syntax for the Template is covered on the Moblog Email Template page.
Make Entry Sticky?
You may choose whether or not entries submitted via the Moblog should be marked as "sticky" by default.
Gallery Settings for Moblog
Choose Gallery
Determine with which gallery the Moblog account will be associated. When you send in an entry, the entry will go into this gallery.
Entry Categories
You may choose which category the entry will be assigned to. This choice is simply a default; it can be overridden when sending the email.
Entry Status
You may choose which status the entry will be assigned to. This choice is simply a default; it can be overridden when sending the email.
Allow Comments
Whether you wish for commenting to be enabled for entries submitted via the Moblog.
Default Author
You may choose to which field the entry will be assigned. This choice is simply a default; it can be overridden when sending the email.
Email Settings
Email Account Type
The type of email account. Currently, only POP3 accounts are supported.
Email Address
This is the email account to which you will be sending your emails. ExpressionEngine will check this account to find emails you've sent that should be processed by the Moblog Module.
Incoming Mail Server
The email server on which the email account you specified resides. This is the server to which ExpressionEngine will attempt to connect. This is typically something like mail.example.com.
Email Account Username
The username for the specified email account. Once submitted, the information will be encrypted in ExpressionEngine. Remember that some email accounts require you to use the full email address as the "username": username@example.com.
Email Account Password
The password for the specified email account. Once submitted, the information will be encrypted in ExpressionEngine.
Moblog Subject Prefix
When ExpressionEngine checks the specified email account, it will ignore any messages that do not have this text in the subject. The text does not technically have to be at the beginning of the subject, either; it can appear anywhere in the subject. If you leave this setting blank, then all emails will be processed. By default, any text in the subject that is not the subject prefix will be used for the entry title.
Authorization Required in Email?
If this preferences is set to Yes, then you will need to provide a valid username and password in the email sent. This ensures an extra level of security so that only authorized people will be able to post via the Moblog Modules. If the user authentication from the email fails then an entry will not be posted.
Delete Unauthorized Moblog Emails?
You may determine how ExpressionEngine will handle an "unauthorized" email. If you require email authorization (above) and the email fails the authorization (for instance the username or password are incorrect) then you can have ExpressionEngine automatically delete that email. If you do not set this, then the email will be left on the server.
Valid 'From' Emails for Moblog
You can specify a list of email addresses from which you can submit Moblog emails. This preference will allow you to add in another layer of security so that ExpressionEngine will only accept emails that you want it to process. This feature will check what address is specified as "From" on emails and compare it to your list.
You can specify one or more email addresses by either placing them on separate lines in the textarea or by separating them with a space. If you leave the setting blank then ExpressionEngine will not filter emails based on where it is "From".
Note: For security reasons, the email addresses put into this field must be case sensitive. So, if your email client capitalizes letters in your email address, then you will have to capitalize the letters in this field as well. For example, if your email address is 'web@example.com', your email client might specify the From address as 'Web@example.com'.
Ignore Email Text
Here you can specify any text in the email which you want to ignore. This is useful for email accounts such as those through Hotmail or Yahoo that add advertisements at the bottom. It's also useful for removing automatically-added signatures.
ExpressionEngine will first try to match the entire specified text to something in the email. If there is no match, then it will go through each of the lines (a line being one ended in a carriage return) of specified text individually and try to match content in the email in order to remove the desired content.
Image Settings
Image Width
If your images will be of a known width, then enter that here. ExpressionEngine will attempt to determine the size of the image, but due to server differences this is not always possible. If you do not know what size the images will be then set it to 0 (zero).
Image Height
If your images will be of a known height, then enter that here. ExpressionEngine will attempt to determine the size of the image, but due to server differences this is not always possible. If you do not know what size the images will be then set it to 0 (zero).
Resize Image on Import?
If this is set to "yes" then ExpressionEngine will resize your image according to the following two settings. This supersedes the settings above. In order for image resizing to work you must ensure that it is set up correctly under Image Resizing Preferences.
In general, due to the limitations of the image libraries, image resizing is only available for JPG and PNG type images. GIF and other image formats cannot normally be resized automatically. ExpressionEngine will automatically determine your image resizing protocol and only resize those image capable of being resized.
Resize Width
The width to which you wish to resize your images.
If only the width is set (and the height is 0) ExpressionEngine will automatically calculate the height in order to retain the aspect ratio.
Resize Height
The height to which you wish to resize your images.
If only the height is set (and the width is 0) ExpressionEngine will automatically calculate the width in order to retain the aspect ratio.
Create Thumbnail on Import?
If you elect to have a thumbnail created, then ExpressionEngine will create a thumbnail version of the image of the size specified below. In order for thumbnailing to work you must ensure that image resizing is set up correctly under Global Weblog Preferences.
In general, due to the limitations of the image libraries, thumbnail creation is only available for JPG and PNG type images. GIF and other image formats cannot normally be thumbnailed. ExpressionEngine will automatically determine your image resizing protocol and only resize those image capable of being resized.
Thumbnail Width
The width for your thumbnail images.
If only the width is set (and the height is 0) ExpressionEngine will automatically calculate the height in order to retain the aspect ratio.
Thumbnail Height
The height for your thumbnail images.
If only the height is set (and the width is 0) ExpressionEngine will automatically calculate the width in order to retain the aspect ratio.
Ping Servers
Sites to Ping
You may select which sites to ping when submitting a weblog entry. The list is based off of what you have defined under Default Ping Servers.