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.
- Install Phoca Email and switch it on. Switch on its newsletter page.
- Log in to the Joomla administrator. In the menu on the left, choose Content, then Site Modules.
- Press New. A list of module types opens.
- Choose Webal Phoca Newsletter from the list.
- Type a Title for the module.
- On the Module tab, under Newsletter, choose Show the sign-up as.
- Choose a Position in the right-hand column. A position is a named place in your template where a module can go.
- Press Save. The message "Module saved." appears. If Phoca Email is not installed, a warning appears as well.
- Open the Menu Assignment tab. To show the sign-up on every page, choose On all pages.
- Press Save & Close.
- 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
| Option | What it does | Default |
|---|---|---|
| Title | An optional heading above the sign-up. If you type one, set Show Title to Hide. | No title |
| Introduction | A few words above the box. You can use paragraphs, bold, italic, lists and links. | Empty |
| Show the sign-up as | An email box and a button, a button, or a link. | An email box and a button |
| Words on the button | The words on the button beside the email box. Only for the email box look. | Subscribe |
| Words on the button or link | The words on the button or the link. Only for those two looks. | Subscribe to our newsletter |
| Show the word Email address above the box | Off hides the label from the eye only. A screen reader still reads it. | On |
| Newsletter page | Leave 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
| Option | What it does | Default |
|---|---|---|
| Sentence under the box | A short sentence, for example how you will use the address. Plain text. | Empty |
| Privacy policy page | A link to your privacy policy under the box. Choose a page, an article or an address. | None |
| Words of the privacy policy link | The 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
| Option | What it does | Default |
|---|---|---|
| Button colour | The primary colour or grey. | Primary colour |
| Button size | Small, 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.