EXT: Viral Mail (Linktip)¶

What does it do?¶

• Displays a form for the submit of a link tip. For the reason that this is a very important feature to get to know your website, it is like viral marketing → viral mail.
• Furthermore it has the possibility to only show a link (text or/and picture) to minimize the needed place. Via Jquery the form pops up.
• Additionally the submit of a linktip for a page can be counted. Therefore the table “pages” gets an additional field. With the second Frontend-Plugin included you can output the statistic of the counters for all pages. Additionally you see the counter in the Page-Setup in the Tab “Extended”:

Screenshots¶

Viral Mail Form¶

After installation of the extension in the Extension Manager, you can insert the Viral Mail plugin (pi1) on each page as a Content Element.

Select the Plugin

...and Save

Now you can configure the Plugin Output in the Template (mbviralmail/res/template.tpl → not necessary) and via TypoScript (not necessary if you include the static TypoScript-File to your Main Template) or change the Language-Output (mbviralmail/pi1/locallang.xml and mbviralmail/pi2/locallang.xml)

Viral Mail Statistic¶

After installation of the extension in the Extension Manager, you can insert the Viral Mail plugin (pi2) on each page as a Plugin. But you usually will include this Plugin only on an Admin-Page which isn't visible for normal Frontend-Users.

Select a plugin e.g. Viral Mail Form (see above)

In the setup under the tab Plugin, select the Plugin “Viral Mail Statistic Output”

...and Save

FAQ¶

Is it possible to send HTML-Mails with Images?

Yes.

FAQ¶

• Why doesn't the plugin work correctly?

  Did you include the Static TypoScript Template?

• How to send HTML-Mails?

  TypoScript: plugin.tx_mbviralmail_pi1.htmlmail = 1

• How to hide the name-input-field?

  TypoScript: plugin.tx_mbviralmail_pi1.hidefromfield = 1

• How to hide the textarea-field?

  TypoScript: plugin.tx_mbviralmail_pi1.hidetextfield = 1

• How to deactivate the JavaScript version?

  TypoScript: plugin.tx_mbviralmail_pi1.usejavascript = 0

• How to influence the time how long the form shows before disappearing after a successful submit?

  TypoScript: plugin.tx_mbviralmail_pi1.closingtime = 5000 [in Milliseconds!]

• How to get a copy of each link tip via mail (CC)?

  TypoScript: plugin.tx_mbviralmail_pi1.postmastermail = yourmailname@domain.com

• How to change the Mailtext or Subject?

  Mailtext or Subject are like other language-specific text-outputs, located in the plugin-specific Language-File (mbviralmail/pi1/locallang.xml for the form and mbviralmail/pi2/locallang.xml for the statistic)

• How to use Images in HTML Mails?

  • Use the Upload-Folder, that can be specified via TypoScript: plugin.tx_mbviralmail_pi1.uploadfolder = fileadmin/user_uploads/ [this is default]
  • You can use the Upload-Folder-Setting in the template mbviralmail/res/template.tpl in the SubPart ###PARTVIRALMAILHTML### with <img src=”###UPLOADFOLDER###mypic.gif” />

Reference¶

page = PAGE
page.typeNum = 0
plugin.tx_mbviralmail_pi1 {

 ### Mail-Properties ###
     # Template-File
     template =

    # choose if html (1) or text (0) mail
       html_mail = 0

    # for pictures in html mail
 upload_folder = fileadmin/user_uploads/

    # Mail-Address for CC
       postmaster_mail =

    # From-Property
     hide_from_field = 0
 show_locallang_from_and_post_var_from = 0

    # Text Property
     hide_text_field = 0

    # Reply-Property
    reply_email = noreply@domain.com


    ### JavaScript ###
  # Enable JavaScript Functions
       use_javascript = 1

    # enable the mootools-Framework instead of JQuery
   use_mootools = 0

    # If JS-Library is already embedded turn this option on
     js_framework_already_included = 0

    # If js_framework_already_included = 1, this option has no effect, otherwise the framework uses $j (JQuery) OR $m (Mootools) instead of $
   use_js_dollar_conflict_mode = 1

    # Closing Time after successful Submit (Milliseconds)
       closing_time = 5000

    # Statistic-Storage-Folder
  statistic_storage_folder_pid = 1
}
page.10 < plugin.tx_mbviralmail_pi1