Question 1

How can I style my embeds?

Accepted Answer

You can now style your embeds via Embed Themes which are managed via the Brand section of MyMalcolm. Inside each Embed Theme you can customise elements like colours, icons and fonts.

Don't forget you also have further visual options on the "Style" tab of the individual embed in question.

Question 2

How do I delete feedback on an FAQ or Workflow?

Accepted Answer

Feedback collected via Malcolm! can only be seen by suitability authorised team members on your instance but there may be situations where you want to delete it, for example if it contains personally identifiable information and your organisation has a policy that you only want to store this for a certain period of time.

To delete feedback for an individual FAQ select the "Delete data" option in the Analyse section of the FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/IK3fsFzNON/Delete%20FAQ%20Data%20in%20MyMalcolm.png (Delete FAQ Data in MyMalcolm)

To delete feedback for an individual Workflow select the "Delete data" option in the Analyse section of the Workflow and then select either "Delete feedback data" or "Delete all data" (which will also delete all your completion data)

Question 3

Can I translate or change the system text and labels my users will see?

Accepted Answer

In addition to the FAQ and Workflow content that you create in MyMalcolm you can now change all the system generated text and labels your users see and interact with in the front end of Malcolm!

This means you could, for example, completely translate all the parts of Malcolm! your users will see into a different language.

The majority of the system text is stored and changed within your theme. Themes live in the Brand section of MyMalcolm.

Quite a few bits of system text can be changed contextually as you browse around the sections of your theme, however for the complete list of text you can change go to the "advanced" tab. Here you will have access to your custom language file. The language file stores any changes to the default system text. You'll see any changes you've already made in the other parts of the theme interface reflected here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/E6kdxuV8w9/screenshot-my.malcolm.app-2020.08.12-00_01_21.png (Edit your language file in MyMalcolm)

At the bottom of the screen you will see two buttons.

Show dictionary - this will show you a complete list of system text items with some further information about where the text is used
Show language file - this will show you all the default values for system text

You can copy the key and default value for a bit of text, paste it into the custom language file window and then edit it. The part you want to change is on the right hand side.

For example, if you wanted to change the text next to the send FAQ by email functionality to be "Please email me" you would add the following to your custom language file

"Heading: Email this answer": "Please email me",

Please note that a few items of system text your users will see are configured elsewhere in MyMalcolm:

The default values, placeholder text, validation message, tooltip title and descriptions used within Workflows are configured in the Workflow builder - you click on the content element when it's been placed on a page in the builder to edit these items
Window titles and button text for Embeds are managed within the visual style section of the respective embed in the Share section (although you can change the default values used via the language file)

Question 4

Can I enable reCAPTCHA on my Workflows or FAQs?

Accepted Answer

We now support using Google reCAPTCHA on your Workflows and FAQs/Articles.

When enabled, this will offer protection against spam completions of your Workflows and (if you are using them) the submit feedback and send FAQ/Article by email functionality within Malcolm!

You can find out more about Google reCAPTCHA here.

We support:

reCAPTCHA v3
reCAPTCHA v2 - Invisible
reCAPTCHA v2 - Tickbox

You can enable and configure reCAPTCHA for Workflows and/or FAQs independently. So, for example, you could enable reCAPTCHA protection for Workflows but not FAQs. You could also use a different version of reCAPTCHA for Workflows and FAQs.

You can turn reCAPTCHA on via:

Settings --> FAQs --> reCAPTCHA
Settings --> Workflows --> re CAPTCHA

Start by registering your instance with Google which you can do here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xynNm0rZqV/screenshot-my.malcolm.app-2023.04.16-22_02_50.png (Setting up reCAPTCHA in MyMalcolm)

Our dialog will show you the information you need to add to Google's interface. You can then paste the credentials you receive back from Google into MyMalcolm.

When enabled, ReCAPTCHA will work across all formats (ie content on your hosted hub, widgets, overlays and embeds).

Question 5

Why is my embed not showing?

Accepted Answer

If you've set up an embed but can't see it check these things:

Have you implemented the tags correctly? Double check the tag install instructions
Is the embed published? If it’s not published it won’t show
If you are using them check your URL rules - the rule type could be too strict (e.g. URL is exactly xxx rather than URL starts with xxx) - if you are testing on a dev or test URL you can add this within the URL rule section
Check the scheduling - if there’s a schedule to only show the embed on certain days and/or between certain times that may be having an effect
If you are testing on mobile check you've not disallowed the emded showing on mobile

If you are still having problems please open a support ticket and we'll help!

Question 6

How are Related FAQs determined and can I change this?

Accepted Answer

Related FAQs are auto-generated and by default are FAQs either in the same category or similarly tagged (we combine this pool of FAQs). We take the top 4 results from that pool, based on the sort order defined in the instance. For info on how to change the default sort order see this FAQ.

You can choose to force the Related FAQs to use tags or just the category by updating the setting in MyMalcolm / Settings / FAQs:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/mNimQ1t2R3/Screenshot%202020-03-30%2021.19.11.png (Settings in MyMalcolm)

In this scenario we will then take the top 4 results from just the category or tag pool using the defined sort order.

Question 7

What are Tags in FAQs?

Accepted Answer

Tags are a way of describing your content and allow an alternate way for your customers to browse FAQ's aside from search and categories.

You can add and manage the tags that are attached to each of your FAQs via the "configure" area.

You may also be interested in invisible tags.

Question 8

How can I listen to JavaScript events posted from embeds?

Accepted Answer

Malcolm! embeds fire events on user interactions such as when someone first reads an FAQ, completes a Workflow or performs a search. These events can be picked up on your web page for you to perform custom actions - for example creating an event for your Analytics.

How can I listen to these events?

The first event, mapiload, is fired on the window when the mapi.js library has loaded.

The embeds are then rendered followed by the mapi.onrender event.

To register a listener use the mapi.on function.

We recommend combining the window.addEventListener and mapi.on functions for maximum compatibility especially if your application uses JavaScript page transitions, however if your application reloads the page on each request you could combine these into one.

Once the embeds have rendered use the embed.on function to register listeners.

If you know the ID of the embed (can be found in MyMalcolm) use mapi.findEmbed function.

Alternatively loop through the mapi.embeds array.

Putting it all together your code snippet could look something like this.

What events are available?

Question 9

Can I change the "email this answer" description in FAQs?

Accepted Answer

You can change the text label next to the email an FAQ feature on an indiviual FAQ. This can be useful if you are using the FAQ part of Malcolm! to publish articles or other types of content rather than just answers to questions and the "email this answer" language no longer makes sense.

To update the text go to the Brand section in MyMalcolm, then Themes, then click the edit icon in the relevant theme then select "FAQs" in the left hand nav.

Question 10

My verification email has not arrived?

Accepted Answer

Your verification email (to verify your email address) should usually arrive within a few minutes. If it hasn't turned up check your spam folder.

If the email still hasn't arrived after a few minutes there are a few possible reasons:

Occasionally users may accidentally misspel their email address
There could be a temporary issue at our email sending provider (Mailgun) that is delaying emails
There could be a temporary issue at your email provider that is delaying emails
You may have very strict email filtering enabled and don't accept email from new senders (in this case you should update your rules to allow email from support@malcolm.app)
Your email provider may be rejecting email sent by our email sending provider (Mailgun)

The quickest resolution in many cases is simply to register again using a different email address.