Skip to the main content

Webal Phoca Newsletter shows a newsletter sign-up for shops that use the Phoca Email component. It can be an email box with a button, a button, or a link. The visitor types their address, or just presses the button, and is carried to the newsletter page of Phoca Email.

Use it in a footer, a sidebar or a band on your home page. It works with scripts switched off. This module is part of Webal Phoca Blocks.

Tip. This module keeps nothing and sends no email. It only shows the way in.

The sign-up takes two presses and one email. The visitor types their address here and presses the button. Phoca Email's page opens with the address already in its box, and they press Subscribe there. They are told an activation link has been sent, and the link in that email makes them a subscriber.

Check your mail works before you go live. If your site cannot send email, Phoca Email shows the visitor an error page after they press Subscribe. Sign up with a test address of your own and make sure the email arrives. Phoca Email can also show a privacy box (Display Privacy Checkbox In Form). It is off by default, so decide whether you need it.

You need Phoca Email

Phoca Email must be installed and switched on, and its newsletter page must be switched on too. In the Phoca Email options, set both Enable Newsletter Subscription and Display Subscription Form (Newsletter View) to Yes. Both are No by default.

If Phoca Email is missing or switched off, visitors see nothing at all. There is no error page. If you are signed in as an administrator, a short message at the top of the page tells you why. The edit screen of the module also says that Phoca Email is needed, and warns you when you save.

Which newsletter module do I use?

Webal Blocks has two newsletter modules.

  • Webal Newsletter sends the address straight to Mailchimp. It needs a Mailchimp key.
  • Webal Phoca Newsletter (this page) hands the visitor to Phoca Email.

Use the one that matches where your mailing list lives.

The three looks

  • An email box and a button. The visitor types their address in the box and presses the button. The page that opens is the Phoca Email newsletter page.
  • A button. One button that goes to the newsletter page.
  • A link. A plain link to the newsletter page.

Phoca Email's own module can also show the complete Phoca Email form inside the module. This module does not copy that form. The Phoca Email page has it, and the visitor lands there.

Add it to a page

These steps follow the order of the screens in Joomla. Nothing is saved until you press Save.

  1. Install Phoca Email and switch it on. Switch on its newsletter page.
  2. Log in to the Joomla administrator. In the menu on the left, choose Content, then Site Modules.
  3. Press New. A list of module types opens.
  4. Choose Webal Phoca Newsletter from the list.
  5. Type a Title for the module.
  6. On the Module tab, under Newsletter, choose Show the sign-up as.
  7. Choose a Position in the right-hand column. A position is a named place in your template where a module can go.
  8. Press Save. The message "Module saved." appears. If Phoca Email is not installed, a warning appears as well.
  9. Open the Menu Assignment tab. To show the sign-up on every page, choose On all pages.
  10. Press Save & Close.
  11. Open a page of your site and try the sign-up yourself.

Accessibility. If you type a Title, set Show Title to Hide, so the page does not get two headings.

Options

Newsletter tab

Options on the Newsletter tab
OptionWhat it doesDefault
TitleAn optional heading above the sign-up. If you type one, set Show Title to Hide.No title
IntroductionA few words above the box. You can use paragraphs, bold, italic, lists and links.Empty
Show the sign-up asAn email box and a button, a button, or a link.An email box and a button
Words on the buttonThe words on the button beside the email box. Only for the email box look.Subscribe
Words on the button or linkThe words on the button or the link. Only for those two looks.Subscribe to our newsletter
Show the word Email address above the boxOff hides the label from the eye only. A screen reader still reads it.On
Newsletter pageLeave empty to use the address Joomla works out for the Phoca Email newsletter page. Choose a menu item of your site only if the sign-up goes to the wrong place.Empty

Privacy tab

Options on the Privacy tab
OptionWhat it doesDefault
Sentence under the boxA short sentence, for example how you will use the address. Plain text.Empty
Privacy policy pageA link to your privacy policy under the box. Choose a page, an article or an address.None
Words of the privacy policy linkThe words of the link.Read our privacy policy

Tip. There is no tick box for agreement in this module, on purpose. A tick box here could look like recorded consent, but the module only carries the address to Phoca Email and records nothing. Anything you need to ask for belongs on the Phoca Email page, and you need to check that page. Say in your privacy policy where your list is kept.

Look tab

Options on the Look tab
OptionWhat it doesDefault
Button colourThe primary colour or grey.Primary colour
Button sizeSmall, normal or large. Every size is at least 44 pixels high, and the email box takes the same height.Normal

The Layout tab and the Animation tab hold the same shared groups as other Webal modules. See the General, Spacing, Width, Colour scheme and Animation groups.

Caching

The email box carries the visitor's own security token, so Joomla never stores the module and keeps the page out of the System - Page Cache plugin. A button or a link has no token and does not. A cache outside Joomla, such as a CDN or a host cache, should not keep a page that holds the email box.

For keyboards and screen readers

  • The email box has the label "Email address". It is visible, or hidden from the eye and still read by a screen reader.
  • The box asks the browser for the visitor's saved email address, and shows the email keyboard on a phone.
  • When the address is wrong, a sentence under the box says so and the box gets a thicker frame, so colour is never the only sign. The browser's own message is read out as well.
  • Tab moves to the box, then the button. Every control is at least 44 pixels high, and the focus ring is 3 pixels wide.
  • It is a real form. It works with the keyboard, with scripts switched off and with styles switched off.

Tip. If the sign-up does not appear, check that Phoca Email is installed and switched on. If you are signed in as an administrator, the message at the top of the page says which module found it missing.

Other ways to reach us

Ask the community