Передача контента через email

На этой странице описывается возможный синтаксис, который вы можете использовать в теле ваших электронных писем для моблога. В дополнение к основному тексту сообщения электронной почты (и прикрепленному файлу/изображению) вы можете определить несколько значений, которые могут переопределять настройки по умолчанию, установленные для моблога в панели управления.

Эти значения размещаются на отдельных строках в теле сообщений электронной почты. Обычно значения настроек размещаются в начале сообщения электронной почты перед текстом вашего сообщения. Большинство значений настроек имеет несколько вариантов синтаксиса, для облегчения их использования.

Существует два различных типа моблогов "раздел" и "галерея", и в каждом существуют различные способы переопределения настроек по умолчанию.

Переопределение настроек для "Раздела"
Переопределение настроек для "Галереи"

Переопределение настроек для "Раздела"

В большинстве случаев, тело вашего сообщения электронной почты будет содержать простой текст, который вы будете отправлять вместе с вашим файлом.

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.

Ниже приведен более сложный пример, в котором используется "переопределение":

AUTH:johnsmith:mysecretword

{category}3,6{/category}



{field:body format="xhtml"}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.{/field:body}



{field:location format="none"}Train Station{/field:location}

Доступные "переопределения":

category
entry_title
field:entry_body
file_archive
status
sticky
User Authorization

entry_title

{entry_title}My Unique Title{/entry_title} <entry_title>My Unique Title</entry_title>

Вы можете переопределить стандартный заголовок записи (который определяется названием темы сообщения email), и указать свой собственный заголовок. Переопределение заголовка записи может быть указано любым из двух способов, с использованием фигурных скобок ({entry_title}{/entry_title}) или угловых скобок (<entry_title></entry_title>).

field

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

Вы можете переопределить поле по умолчанию, в котором будет размещено содержимое записи, и указать нужное. Вы должны указать, в каком поле будет размещен текст, при этом вы можете указать более одного поля. Например, если вы хотите поместить некоторый текст в поле "body", а другой текст поместить в поле "summary", то вы должны использовать:

{field:body}This is the body text.{/field:body}



{field:summary}This is a summary.{/field:summary}

Кроме того, вы можете указать форматирование для поля, добавляя к тегу параметр format. Например:

{field:body format="xhtml"}This is the body text.{/field:body}

Для параметра format доступны следующие варианты форматирования:

none: для поля не используется ни один тип форматирования
br: устанавливает для поля форматирование "Auto <br />"
xhtml: устанавливает для поля форматирование "XHTML".
Если вы используете специальный плагин для форматирования поля записи, то вы можете указать здесь плагин по имени.

Переопределение поля записи может быть указано любым из двух способов, с использованием фигурных скобок ({field}{/field}) или угловых скобок (<field></field>).

Здесь можно использовать только поле типа "textarea". Нельзя указывать поля типа "text input" или "drop-down list".

file_archive

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

Вы можете переопределить установленную по умолчанию настройку режим архива файлов для записи, и указать вручную, что данное сообщение электронной почты - архивное (то есть вы хотите просто загрузить файл, а соответствующая запись не должна создаваться). Просто используйте yes, true, или 1, чтобы указать, что из данного сообщения электронной почты должны загружаться только файлы. В качестве альтернативы, используйте no, false, или 0, чтобы указать системе, что необходимо создать запись, используя это письмо.

Переопределение режима архива может быть указано любым из двух способов, с использованием фигурных скобок ({file_archive}{/file_archive}) или угловых скобок (<file_archive></file_archive>).

status

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

Вы можете переопределить установленный по умолчанию статус для записи, и указать нужный. Для этого просто используйте слова "yes" или "no".

Переопределение статуса может быть указано любым из двух способов, с использованием фигурных скобок ({status}{/status}) или угловых скобок (<status></status>).

sticky

{sticky}yes{/sticky} <sticky>no</sticky>

Вы можете переопределить, установленную по умолчанию, настройку "прикрепить" для записи и указать свою. Для этого просто используйте слова "yes" или "no".

Переопределение прикрепления записи может быть указано любым из двух способов, с использованием фигурных скобок ({sticky}{/sticky}) или угловых скобок (<sticky></sticky>).

User Authorization

AUTH:johnsmith:mysecretword

Вы можете переопределить автора записи, установленного по умолчанию, и указать нужного. Синтаксис для этого переопределения отличается от других и соответствует следующему: AUTH:theusername:thepassword. "theusername" соответствует логину нужного пользователя, а "thepassword" соответствует его паролю.

Строка авторизации всегда должна находиться в первой строке письма

Обратите внимание, если в настройках моблога установлена опция требовать авторизацию в сообщениях email?, то вы должны использовать в сообщениях авторизацию пользователя. Если вы не укажете строку авторизации, или авторизация будет неудачной, то запись опубликована не будет. Настройка удалять неавторизованные письма моблога? определяет, будут ли удаляться письма с сервера в этом случае.

Далее, обратите внимание, что используемая учетная запись пользователя должна принадлежать группе пользователей, которая имеет разрешение публиковать записи в этом разделе.

Переопределение настроек для "Галереи"

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.

Ниже приведен более сложный пример, в котором используется "переопределение":

AUTH:johnsmith:mysecretword

{category}6{/category}



{caption}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.{/caption}

Доступные "переопределения":

caption
category
entry_title
status
User Authorization

caption

{caption}A beautiful picture of the church across the street.{/caption} <caption>Isn't my cat, Tinkerbell, just adorable?</caption>

Вы можете определить текст подписи, чтобы использовать с вашим изображением галереи. Переопределение поля может быть указано любым из двух способов, с использованием фигурных скобок ({caption}{/caption}) или угловых скобок (<caption></caption>).

entry_title

{entry_title}My Unique Title{/entry_title} <entry_title>My Unique Title</entry_title>

status

{status}open{/status} <status>closed</status>

Вы можете переопределить установленный по умолчанию статус для записи, и указать нужный. Просто используйте название статуса, "open" или "closed". Переопределение статуса может быть указано любым из двух способов, с использованием фигурных скобок ({status}{/status}) или угловых скобок (<status></status>).

User Authorization

AUTH:johnsmith:mysecretword

Строка авторизации всегда должна находиться в первой строке письма

Далее, обратите внимание, что используемая учетная запись пользователя должна принадлежать группе пользователей, которая имеет право публикации записей в этой галерее и имеет доступ к модулю галереи изображений.