Question 1

I'd like to open the Overlay embed directly, how do I do this?

Accepted Answer

When you create an Overlay embed we give you two bits of code to add to your page. The first is the master code which you should place just before the closing tag. The second is the inline code which generates the button users click to open the overlay - this goes inside the tags where you want the button to appear. When the user clicks the button the Overlay embed will appear in a modal (pop-up) over your page.

The inline code we give you will look like this -

Sometimes you might want to call the overlay but not use our button. You might want to call it from text or use your own button/graphic or you might want to call it in the background when a user does something else on your page.

You can do this by calling mapi in JavaScript.

The mapi has four methods - open, close, trigger and toggle. Open, close and toggle all return promises (i.e., a function that resolves when the animation is complete or a rejects if something went wrong, e.g., no embed found for the param passed). Trigger is more "fire and forget" - it will call the open function if everything goes well, otherwise it silently fails.

Here is an example using an href link that uses the trigger method to open the Overlay -

Note that you must have our master embed code on your page for the above to work and you need to replace EMBED_ID with your embed ID.

The above may also be useful for customers who are using third party site building systems - sometimes putting inline code into a page on those systems can be restricted so you can't add our inline code to render your button. If you can create inline links you could try using the above example with the trigger method to open the Overlay (again remember you also need the master code on the page).

Question 2

What are tags for in the Media Section?

Accepted Answer

Tags are a way (along with folders) of helping your organise and label your media.

They can be useful when your media library becomes large. For example, if you use rights managed images in your FAQs you could use tags to help you remember the expiry dates of those rights.

Question 3

Can I remove the Malcolm! branding?

Accepted Answer

It is quick and easy to remove the Malcolm! branding and - if you want - replace it with your own. Here is how:

Hosted Hub

By default your Hosted Hub is Malcolm! branded. To change that:

In MyMalcolm go to the Brand section.
Click "Themes" on the black sub navigation.
The default Malcolm! theme will be selected. Click the "duplicate" icon (two squares overlapping). This will create a copy of the default theme called "Default copy".
Select the Default copy theme by clicking on it. Then click the "edit" icon (a pencil).
This brings up the edit theme interface. There are a huge amount of things you can change here. Use the left hand vertical navigation to browse all the possibilities.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/6ACEG5RrGl/screenshot-my.malcolm.app-2019.08.05-10_46_38.png (MyMalcolm Theme Editing Options)

Footer

Be default a "powered by Malcolm!" badge appears at the bottom of content. You can turn this off (and also add other footer content such as copyright notices etc) in the "Footer" section of the edit theme interface referenced above.

Embeds

You can turn off the "powered by Malcolm!" badge in your embeds by turning off the footer. You do this via the style section of your embed configuration.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/m6Pb8R7IbC/screenshot-my.malcolm.app-2020.05.26-11_42_48.png (Style controls in an Embed in MyMalcolm)

Emails

Malcolm! can send emails to your customers/users in the following situations:

Email this answer functionality on an FAQ
Sending the resume later Workflow link
Payment confirmation email

To change the branding of these emails see this article.

To change the sender name and email address see this article.

Domain

Finally don't forget you can easily configure Malcolm! to use your own domain or sub-domain. For further details see this article.

Question 4

What can I change or customise in the Brand Section?

Accepted Answer

The Brand section of MyMalcolm has many powerful options to help you change the look and feel, layout and content of your Malcolm! Hosted Hub in order to reflect your own brand.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/juvGMA0a3E/brand-facebook%402x.png (Use your own brand with Malcolm!)

Get started by going to the Brand section in MyMalcolm, copying your current theme, then editing things on the copied version.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/xsC67Mdwy8/screenshot-my.malcolm.app-2019.08.06-17_50_20.png (Edit your brand settings in MyMalcolm)

Watch a video guide to customising your look and feel below.

Question 5

Can I turn off the "Email this Answer" / send by email functionality?

Accepted Answer

If you would like to turn off the ability for a user to have a particular FAQ emailed to them you can do this on a per FAQ basis via the Configure / General area of the FAQ in MyMalcolm:

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/YodRL1xSiq/screenshot-my.malcolm.app-2019.10.17-20_14_58.png (Turn off Send by email on a single FAQ)

If you want to turn off this feature for all FAQ's in the instance you can do this globally via Settings / FAQs / General Settings:

Question 6

How do I sign up?

Accepted Answer

You can sign up and create a Malcolm! user account by filling in the registration form here.

You will need to verify your account via clicking a link in an email we send to your email so please ensure you use a real email address!

It is free to sign up and have a Malcolm! user account - billing belongs to an Instance rather than a user. See here for more on instances.

Your user account can be attached to one or more instances of Malcolm! and you can easily switch between them. This can be great if your company or organisation are using Malcolm! for various different things or if you are a freelancer and work with Malcolm! across different clients or projects.

Question 7

How is the removal of Company Personal Data handled?

Accepted Answer

What is personal data?

Personal data only includes information relating to natural persons who:

can be identified or who are identifiable, directly from the information in question; or
who can be indirectly identified from that information in combination with other information.

What is Company Personal Data?

When you use Malcolm! to collect information from your customers, suppliers, staff or others that information may include personal data. In this context, Malcolm! acts as your data processor and the personal data we may process on your behalf is referred to as Company Personal Data. You can read more about this here.

Removal of Company Personal Data

There are two tiers of data removal. The first is a recoverable delete, known also as a soft delete. The second is a permanent delete or purge. Malcolm! supports both types of data deletion.

Soft deletion

Soft deletion means data is deleted enough to make it no longer visible or discoverable but not quite enough should it need to be recovered.

For example if you delete a Malcolm! Workflow in MyMalcolm then the Workflow and everything related to that Workflow is soft deleted. This means it'll all disappear from MyMalcolm and our APIs but should you realise the deletion was a mistake it could still be fully recovered (on request).

Purging

Purging is a permanent or secure delete. This could be either a physical delete (e.g. uploaded files on disk) or a nullification of stored values in a database. Once data has been purged it is no longer recoverable.

Rest assured, Malcolm! will never purge your data whilst your Instance is active!

What happens after my trial finishes?

After your 14 day trial period comes to an end your Instance will be disabled. From that point you'll have 30 days to subscribe to one of the plans. If no subscription is in place by then your Instance data will be soft deleted and after 120 days all Company Personal Data will be purged in accordance with our Data Processing Addendum.

What happens if my subscription lapses?

Subscriptions could lapse for a number of reasons but the most likely cause is an expired credit card. We'll keep you Instance active for 14 days to give you time to fix the problem.

If the problem is not fixed your Instance will be disabled but you'll still have a further 30 days to subscribe to a new plan should you wish to. If no subscription is in place by then your Instance data will be soft deleted and after 120 days all Company Personal Data will be purged in accordance with our Data Processing Addendum.

What happens after I delete my Instance?

You can request to have your Instance deleted and purged in Settings > Instance > Delete Instance. After 30 minutes of requesting the deletion your Instance data will be soft deleted and after 120 days all Company Personal Data will be purged in accordance with our Data Processing Addendum.

Can I request just a Workflow data delete and purge?

Yes you can! Within MyMalcolm you can create a Workflow data deletion request. The Workflow data will be first be soft deleted and then 30 days later it will be purged.

See How do I delete data submitted to a Workflow? for more information.

For more information...

For more information please read the Data Processing Addendum.

Question 8

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 9

How do I use your Wordpress plugin?

Accepted Answer

First download the Malcolm! Wordpress Plugin here.

In MyMalcolm! create your embeds as normal - instructions here.

At the end of the Embed creation process when your embed code is generated there is some text which says "Embedding in a Wordpress site?" - if you click that text you will be shown your instance ID and for some embed types you will be shown a shortcode. There is also an option to have this information emailed to you.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Lglywov3F9/Screenshot%202020-05-24%2022.00.27.png (Embedding in a Wordpress site?)

In Wordpress, install the Malcolm! plugin then goto Settings --> Malcolm! and add your instance ID. Currently on some versions of Wordpress when you add the instance ID and press Save there is no acknowledgement of this but you can verify the instance ID has indeed been saved by navigating away and then back to Settings --> Malcolm!

You can see your instance ID in your URL when you are in MyMalcolm eg, https://my.malcolm.app/instances/XXXXXXXXXX/dashboard. The instance ID is the 10 digit code code shown where the X's are above.

For Widget and Full page embeds this is all you have to do - you can then configure on which pages your embeds appear via MyMalcolm (via the URL rules section of the respective embed).

For inline embeds and overlays you need to position where you would like the embed or the overlay launcher in your content. You do this using the Shortcode. Go to the page or post in Wordpress, make sure you are in code editor (not visual editor) and put the Shortcode where you wish the embed to appear / or the overlay be launched from.

If you have any issues with you embeds not appearing first check these things.

Question 10

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.