Question 1

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 2

How do I change the colour of my links?

Accepted Answer

You can change the colour of your links via your theme. Themes live in the Brand section of MyMalcolm.

In your main theme settings you'll see link colour options under Primary, Secondary, Tertiary and Body.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/PapJB2lyc6/Screenshot%202021-02-23%20at%2011.22.50.png (Link colour management in Themes)

In embed themes, the link colour is managed from the other colours section.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Ox2zsXtjRW/Screenshot%202021-02-23%20at%2011.23.15.png (Link colour management in Embed Themes)

In Workflow themes, the link colour defaults to the colour selected in the main theme but can be overridden.

Question 3

Can I embed HTML or add iframes to Malcolm! content?

Accepted Answer

Malcolm! FAQ supports embedding content via HTML iframes.

Most popular content channels such as YouTube and Vimeo offer an embed sharing option via HTML iframes.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/TEt5gCaFXw/Screenshot%202021-01-29%20at%2011.06.24.png (Screenshot 2021-01-29 at 11.06.24 (1).png)

Malcolm! has two buttons on its editor toolbar. One for inserting video or presentation type content and one for other type of content. To use these features simply locate the HTML iframe code on your content channel and copy/paste it into one of these two dialogs.

Question 4

Can I change the fonts Malcolm! uses?

Accepted Answer

You can change the font that Malcolm! uses in your hosted hub and your embeds via theme management in the Brand section of MyMalcolm.

We support the following fonts:

Arial
Arimo
Helvetica
Helvetica Neue
Lato
Lora
Montserrat
Merriweather
Merriweather Sans
Muli
Noto Sans
Noto Serif
Nunito
Nunito Sans
Open Sans
Oswald
Playfair Display
Poppins
PT Sans
PT Serif
Raleway
Roboto
Roboto Mono
Roboto Slab
Source Sans Pro
Source Serif Pro
Tahoma
Ubuntu
Ubuntu Mono

Question 5

Can I turn off feedback comments or enable for negative feedback only?

Accepted Answer

Sometimes you may wish to turn off the ability for users to leave feedback, or perhaps only offer the opportunity for feedback when the content has been rated negatively.

You can configure your preference via the Settings area of MyMalcolm. You can have different settings for FAQs and Workflows.

Look for the "Feedback comments" setting which appears under Settings --> FAQs and Settings --> Workflows

Question 6

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 7

Can I have a different logo on FAQ / Workflow pages?

Accepted Answer

Sometimes you might want to use a different logo on your hosted hub homepage to the rest of your hosted hub. If you are using a header image on the hosted hub homepage for example you might want to use a reversed or alternate logo that works well on top of that image.

You can specify a secondary logo inside the header section of your theme.

Question 8

Can I change the colours used in my rating elements?

Accepted Answer

You can change the colours used for the positive, negative, neutral and unrated rating elements within your theme via the Brand section of MyMalcolm.

This dialogue will change the colours used on the web page (hosted hub) versions of Malcolm! content

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/SwJ99umvNp/screenshot-my.malcolm.app-2021.01.15-17_23_10-3.png (Rating elements in MyMalcolm)

You can change the colours of rating elements used within your embeds via embed theme management, also in the Brand section of MyMalcolm

Question 9

How do I delete data submitted to a Workflow?

Accepted Answer

You can delete some or all of the submitted data (including uploaded files) associated with a Workflow by selecting "Delete Data" in the Analyse tab of the relevant Workflow.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/tRaFrYJwoo/resources/lcSsh5w64C/Screenshot%202020-11-20%20at%2023.06.05.png (Delete Data dialogue in MyMalcolm)

You can choose to delete all data or selected data between two dates. Note that as well as removing data the delete process will also remove any exports you previously generated that contain the data plus any files uploaded via the Workflow and MyMalcolm activity logs. Please therefore export and download to your local system any data you wish to keep before starting the delete process in MyMalcolm.

Ratings, analytics and feedback associated with deleted Workflow completions will be kept and can still be reviewed via MyMalcolm post delete.

Question 10

How do I export data from my Workflow?

Accepted Answer

You can export all data that has been submitted to your Workflow anytime via MyMalcolm.

To do this go to the individual Workflow via the Library in the Workflow section of MyMalcolm.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/s3FvV2ti8P/screenshot-my.malcolm.app-2019.08.18-18_06_42.png (Export Workflow data in MyMalcolm)

Your export will then be generated and will be available to download from this area soon - normally within a few minutes - you'll be emailed when it's ready.

Exports are in .csv format (with options to include any uploaded files and also an option to include part completed / abandoned completions)