22nd October 2024 - Contact Us Route Created
Committee Configuration Enhancements
- Enhanced Committee Configuration to allow any number of roles to be created. This was needed because each group can have different committee roles or even create non-standard ones, but also because a new Enquiries role needs to be created in order to send inbound emails from the contact-us route (more on that below). Previously, roles were limited to chairman, secretary, treasurer, membership, social, walks & support.
- A Committee role now has a Role type which can be:
- Committee Member - a committee member that is formerly recorded with Ramblers Head Office.
- System Role - This can be used to create an Enquiries role which can be assigned a specific email address for inbound Enquiries.
- Group Member - not yet used, but would be a normal group member perhaps providing assistance to the committee but not formally a committee member.
- /admin/committee-settings now highlihts when a Brevo sender cannot be matched to a committee role email and provides an option to create it if this is the case:
- Create a new System Role as follows:
- Choose Create Sender when you have completed the input of the Role.
Email Configuration
- In order for the contact us email route to work, an email configuration needs to be created at /admin/mail-settings?tab=email-configurations as follows:
- Click the Add New button and enter Contact Us in the Subject Text field.
- Add an existing banner or create a new one and associate with the new configuration
- Have the Sender, Reply and Signoff Role as the new Enquiries role created above.
- Brevo template should be fully-automated-text-body.
- Leave the CC roles blank, as you may not wish internal email addresses to appear in the enquirers email copy . The option to enable them to ask for a copy of the email to be sent to them is available on the contact form.
- Save the email configuration, then switch to the Built-in Process Mappings /admin/mail-settings?tab=built-in-process-mappings tab and assign the new email configuration to the Contact Us Process Uses Email Configuration select:
- The email configuration should now look like this:
Contact Us Route
- A special email contact form has been created that can be displayed by embedding a contact-us query string parameter in any markdown link or button on the website. When the link or button is clicked, it will open up the email contact form on the currently selected route, where a public member can enter their name, email address, subject and message. The following querystring parameters can also be used to control how the contact can be made with the committee - all of which must be entered within the round brackets
() of a markdown link:
?contact-us (no value needed and no path before the ?)&role=<role_name> &redirect=<path of page containing contact us link without leading slash>&subject=<a reference to a subject that has been pre-configured in mail settings>- full example of a contact-us markdown link is shown here:
[Contact Nick](https://ngx-ramblers.org.uk/?contact-us&role=chairman&subject=joining&redirect=how-to/committee/release-notes/2024-10-22)
- A clickable button is also shown below as a working example:
Contact Nick
- When the link or button is clicked, a modal dialog will be displayed as follows:
- Once the form has been completed and the reCAPTCHa checkbox has been successfully clicked, the Send Email button can be clicked and a success alert will be displayed once the email(s) have been sent.
- An email should then be sent to the committee member specified in the
&role=<role_name> parameter. An additional copy will be sent to the enquirer as well (minus the committee sensitive information):
reCAPTCHA Configuration
- In order to carry out these steps, you will need to have an Google Cloud Console developer account.
- Visit the reCAPTCHA Admin page.
- Choose the create option and then configure a v2 site key as follows, including the domain for your website, then click Submit:
- When you click Submit, you will be presented with the Site and Secret keys.
