Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

1.3. Installation

Extension Manager

Open the extension manager and click on the majordomo extension:

Illustration 4: Extension Majordomo

Include static extension template

Include the TS-settings with the “Include static (from extensions)” feature.

Illustration 5: Include static extension template - 1st step

  1. Select the item "Template" in the web modul.

  2. Select your root page or the page in the page tree, where you want to use the majordomo plugin.

  3. Click on the line "Click here to edit ..." below the table template tools.

  1. Select the item "Static (majordomo)"

  2. "Static (majordomo)" will be added to the selected items.

Create a page for the confirmation message

  1. Create a page where the confirmation message should displayed.

Configure the plugin

Illustration 6: Configuration with the typoscript object browser

  1. Select the typoscript object browser

  2. Open the item plugin

  3. Open the item majordomo

Id of the confirmation page

All you have to do is:

  1. Edit the value pid.confirmExample: pid.confirm = 22

Configure majordomo

Requirements:

  1. A majordomo installation on your server or on a third party server.

  2. An existing majordomo mailing list.

Configure the plugin

  1. majordomo.list =The name of the majordomo list.Example:majordomo.list = puppenspiel

  2. majordomo.address = majordomo@example.comThe mail address of the majordomo modul for handle subscribing and unsubscribing.Example:majordomo.address = majordomo@p12345678.onlinehome-server.info

  3. majordomo.owner = majordomo-owner@example.comThe mail address of the owner of the list.Example:majordomo.owner = owner-puppenspiel@s12345678.onlinehome-server.info

  4. majordomo.mail.forbidden.1 = mein.name@meine-domain.demajordomo.mail.forbidden is an array of mail addresses, which will be canceled by the majordomo plugin.The first mail address should be the address, which is the default mail address in the majordomo plugin "form" (see: form.mail.default).The second mail address should be the mail address of the majordomo list.Important: You have to forbid the mail address of the majordomo list in every case!Example:majordomo.mail.forbidden.1 = mein.name@meine-domain.demajordomo.mail.forbidden.2 = newsletter@puppenspiel-portal.de

Configure mail

This section is related to the mail, which will send in cases of subscription and unsubscription. The majordomo plugin is sending this mail (illustration below on the right hand). This isn't the mail, which will send by majordomo (illustration on the left hand).

The plugin is sending a mail, with your data and text, because the mail of majordomo is very rudimentarily.

Illustration 7: Majordomo sends this subscription mail

Illustration 8: The plugin sends this subscription mail

  1. mail.from = My Name <my-name@example.com>The sender in the mail header.Example:mail.from = Puppenspiel-Portal <newsletter@puppenspiel-portal.de> (number 1 in the illustration below)

  2. mail.name = My NameThe Name at the end of the mail text (number 2 in the illustration below).

  3. Illustration 9: The configuration possibilities for the mail with typoscript

    mail.signature.1 = My Companymail.signature is an array of lines for the signature. Clear lines, if you don't it.Example:mail.signature.1 = puppenspiel-portal.demail.signature.2 = Dirk Wildt...mail.signature.5 = Tel: 0341 / 6025631mail.signature.6 >

Install the plugin in the page content

The form

Select the page in the page tree, where you want to install the majordomo form. Insert a new record with the wizard.

Illustration 10: Pagecontent with the wizard

The page that now opening is called the “new Content Element Wizard”. At the bottom of this page you'll find an icon called “Plugins”':

Illustration 11: Select General Plugin

Select it and choose the position (column): eg NORMAL:

Illustration 12: Select the position

A form will show up looking almost like this:

Illustration 13: Type "Insert Plugin", Plugin "Majordomo"

Select the plugin "Majordomo"

Illustration 14: Plugin "Majordomo Form"

Now the plugin has to be displayed in the frontend like the illlustration:

Illustration 15: The form in the frontend

Now install the plugin "Majordomo Confirm".

The Confirm Page

You have the same steps like installing the plugin "Majordomo Form" but you have

  1. to install the element confirm on the confirm page (it may be the same page like the page with the form)

  2. and you have to select the element "Confirm".

Illustration 16: Plugin "Majordomo Confirm"

If you send the form with a mail address for subscribing or unsubscribing, your website will display the majordomo confirm page like the illustration below (case: subscription):

Illustration 17: Majordomo confirm in the frontend

Troubleshooting

If the news extension doesn't display anything (not even an error message) check the following:

  1. Did you set a “static template (from Extensions)” in your TS-template?

  2. Clear all TYPO3 caches, including the temp files in typo3conf, clear your Browser cache.