Question 1

Do you support a collapsable section in content?

Accepted Answer

If you'd like to have content that has to be clicked to be viewed you can create collapsable sections of content which are closed by default.

Here is an example

Here is the hidden content!

https://media.giphy.com/media/3pZipqyo1sqHDfJGtz/giphy.gif (hello!)

The Syntax is as follows

This above will render a "> Click to open" link on the page which when clicked, will reveal the rest of the content underneath.

Question 2

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 3

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 4

How can I use Square with Malcolm! to collect payment from my customers?

Accepted Answer

Malcolm! now integrates with Square. Square is a payment service provider that enables business owners to collect payment from their customers.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/d8ZLyi8A95/Square%402x.jpg (Square and Malcolm!)

With our Square integration you can create Workflows in Malcolm! that include fields for your customers to enter their card details and pay for things like products, services, memberships etc or perhaps make a donation towards something.

Here is how to set things up:

If you don't already have a Square account create one here.
In MyMalcolm go to the Settings, then Workflows, then Integrations, then click on Square.
You'll be taken to a page on the Square website where you can login and confirm that you wish to link your Square account to Malcolm!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/QBvWDgrtAV/Screenshot%202022-01-06%20at%2012.48.11.png (Connecting Square to Malcolm!)

Once you have linked your Square account you can create Workflows via the Workflow section as usual and place payment related elements onto those Workflows. Two particular elements to pay attention to are Currency and Payments.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/SlnkSg4slf/screenshot-my.malcolm.app-2021.05.28-18_08_18.png (Currency and Payment elements in MyMalcolm)

Payments is the element where your customer will provider their card details. You can configure the amount your customer is charged via the Payment element settings, or you can optionally ask the customer to enter their own amount via the Currency field - this can be useful in scenarios like donations or account payments where you may wish to offer the customer the choice of the amount to pay.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Yaj6slF0EX/Screenshot%202022-01-06%20at%2012.52.37.png (Settings for the Payment element in MyMalcolm)

If you also collect your customers email (and Name) in the Workflow you can optionally use that information to send them a payment confirmation email. You can configre and customise this via the Payment element settings.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/sZjKbFViLz/screenshot-my.malcolm.app-2021.05.28-18_11_48.png (Configuring payment confirmation emails in MyMalcolm)

You can place the Payment element on any page of your Workflow, but the actual payment transaction will not be attempted until the final submit of your Workflow. If there is a problem with the payment details your customer will be returned to the page with Payment element on it and given a chance to update their details and proceed back through the Workflow.

You can see a video walkthrough below.

And there you have it! Taking payments via Square is a really powerful and quick to implement feature of Malcolm! Workflows. Taking payments will also work when the Workflow is surfaced via our embeds, widgets and overlays too! If you have questions or need a hand setting things up just contact us and we'll be happy to help.

Question 5

Can I link to a Workflow when a user rates content?

Accepted Answer

When a user rates your FAQ or Workflow you may wish to link to a Workflow from the rating area to collect more detailed, specific information. That Workflow could in turn pass data to your other systems (eg ticketing systems or CRM) via an Integration or Webhook.

This feature can be used in combination with, or as an alternative to, the feedback comments feature.

You can enable this functionality for FAQs and/or Workflows via Settings --> FAQ --> General or Settings --> Workflow --> General respectively.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/VMGzMXACpu/Screenshot%202021-03-11%20at%2008.25.31.png (Post feedback Workflow configuration in MyMalcolm)

Here you can choose the Workflow linked to when the user gives feedback.

The default copy for the link text is "Submit additional feedback" but you can change that via the language file - details on how to do this here.

If you are going to enable this feature it may make sense to turn feedback comments off so all comments are captured in your Workflow. We also recommend you turn off the feedback on the individual Workflow you use for the post Workflow feedback (via the configure tag of the individual Workflow in question). This will avoid the user being asked for feedback on the feedback!

Question 6

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 7

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 8

What is the Media Section in MyMalcolm?

Accepted Answer

The Media Section in MyMalcolm is a central place to manage images and other resources (eg PDF's) that you may wish to reference in your FAQs or use as part of the Brand customisation of your Malcolm! Hosted Hub.

You can upload resources directly into the Media section and any resources you upload via the FAQ or Brand sections will also automatically be put into the Media Section.

Question 9

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 10

Do you support anchor links?

Accepted Answer

We support the ability to scroll the user to certain parts of your content on the same page via anchor (or "jump") links.

To insert an anchor click the anchor icon in the markdown editor. Type a name for your anchor in the dialog and hit insert (Malcolm! will make your text lower case and replace any spaces with a dash)

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/oCqoO1obU2/Insert%20anchor.png (Insert anchor dialog)

To link to the anchor use the create link dialog and find your anchor from the drop down list.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/7oI1UVxRhF/Target%20link%20to%20anchor.png (Target link to anchor)

Malcolm! will then add markdown to your content, you can see an example below

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/TkGY25Md9d/Anchor%20and%20target%20in%20markdown.png (Anchor and target in markdown)

Alternatively you can create your anchors and links directly in markdown, the syntax is as follows

To define your anchor

To link to your anchor

See the video below for a walkthrough of this feature