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

Can I password protect my Hosted Hub?

Accepted Answer

Yes, you can password protect your Hosted Hub. You can also password protect individual FAQ's or Workflows.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/KFFCF1u5Kx/password-fb%402x.png (Password protect your content on Malcolm!)

Read more about password protection of content on Malcolm! here.

Question 3

How do I set up my Hosted Hub?

Accepted Answer

Every instance of Malcolm! comes complete with a Hosted Hub that you can configure and customise.

You can find out more about the Hosted Hub here and if you want to turn if off you can find out how to do that here.

In MyMalcolm if you click "View Live" towards the top the screen you'll see what your Hosted Hub currently looks like.

The two things you are probably most likely to want to change are the URL the Hub is on and the Hub's look, feel and content. Here is how to configure each of those areas.

1. Configure the URL

In MyMalcolm, go to the Settings section, then select "Custom Domains" from the vertical left hand menu. In this area you can change the URL your Hosted Hub will use. It's possible (and no extra charge) to use your own external domain or sub-domain.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/VKQ7z1JBXW/screenshot-my.malcolm.app-2019.08.12-17_01_54.png (Customise your domains in MyMalcolm)

2. Change your Hub's look, feel and content

You can extensively customise your Hosted Hub to suit your own requirements. To do this, go to the Brand section of MyMalcolm, clone an existing theme, then choose the edit icon on your cloned theme.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/cO3r3O1RbL/screenshot-my.malcolm.app-2019.08.12-17_03_00.png (Theme management in MyMalcolm)

In the edit theme area use the left hand vertical navigation to see all the custom options you have.

Question 4

What is the Malcolm! widget and how do I implement it?

Accepted Answer

The Malcolm! widget is a great way to put your content in front of users. By using the widget you can float content over an existing website or application. Want to let your users find out answers to FAQs about a product or service you provide but don't want them to make them navigate from the screen they are on? The Malcolm! widget is what you need. Or perhaps you'd like to float a feedback or get in touch form over your website? Super easy to do with the Malcolm! widget. You can even make the content displayed contextual to the screen the widget is floating over. How cool is that?

We recommend you place the Malcolm! widget embed code on every page of your website. You can then configure whether the widget displays or not (and what it displays) from within MyMalcolm!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/IdGAskGCq2/widget-fb%402x.png (The Malcolm! Widget)

Here is how to start using the Malcolm! widget.

Step 1: Create an embed

Go the Share section of MyMalcolm and select the Embed tab and then Create an embed. Select Widget as the type of embed you want to create.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/Ji7YZa6eF7/screenshot-my.malcolm.app-2019.11.05-11_16_34.png (Create an embed in MyMalcolm)

Give your embed a name.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/zZgVvihFmE/screenshot-my.malcolm.app-2019.11.05-13_14_38.png (Names your embed in MyMalcolm)

Step 2: Choose your content

From this area you can choose a single FAQ or Workflow to display in the widget, or you can choose collections of content. These collections can be a category, a tag or an author. You can also make a collection out of a search result including a search that is contextual to the meta content of the page that the widget is on - you can query content based on the page title, meta keywords, meta description or a meta search tag.

Users can navigate content within the widget via clicking on items in the user interface eg categories, tags or authors.

If you don't choose a specific FAQ, Workflow or collection of content the default content displayed will be the most popular content.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/jbX8ylorUd/screenshot-my.malcolm.app-2019.11.05-13_16_07.png (Choose the content for your widget)

Step 3: Configure the visual style of your widget

You can configure various options about the visual appearance and behaviour of your widget. The options include what the widget looks like in it's pre-expand state (a button or a drawer), the text used on the pre-expand, the colours and logo plus the location of the widget on your screen. You can also configure whether you want the search and footer used on expanded widget and whether the transition from pre-expand to post-expand and vice versa are animated or not.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/UEdVkI4MOo/screenshot-my.malcolm.app-2019.11.05-13_16_42.png (Configure the visual style of your widget)

Step 4: Set up URL rules and visibility settings

We recommend you put the Malcolm! widget embed code on every page of your website. But you might not want the widget to appear on every page. Using URL rules you can mangage and easily change which pages the widget does appear on from within MyMalcolm!

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/rVDvNjLQrJ/screenshot-my.malcolm.app-2019.11.05-13_17_22.png (Manage URL rules for your widget)

You may not want the widget to display on mobile browsers, or you may want the widget to only appear at certain times (for example when your office is closed) - you can configure these options in visibility settings.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/GWsPKq5LZ4/screenshot-my.malcolm.app-2019.11.05-13_19_13.png (Manage your widget visibility settings)

Step 5: Publish and place code on site

Finally when you are happy publish your widget.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/g4why3UaJ5/screenshot-my.malcolm.app-2019.11.05-13_20_01.png (Publish your embed)

Finally collect your code - you can cut and paste this or have it emailed to you (or the person who is responsible for implementation).

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/KyYO8MKguT/screenshot-my.malcolm.app-2019.11.05-13_47_41.png (Collect your widget embed code)

If you use Google Tag Manager you can also deploy the embed code via this system. See here for more details.

Question 5

How do I create a Frequently Asked Question (FAQ)?

Accepted Answer

Within MyMalcolm go the FAQ Section and click "Create a FAQ" towards to the top right of the screen.

This will bring up the "compose your question and answer" dialogue. Here you can input the question, an optional brief summary answer (used in search and browse results) and your full answer. For tips on how to write a good FAQ click here.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/FrnZFuskaf/screenshot-my.malcolm.app-2019.07.29-21_44_58.png (Compose FAQ in MyMalcolm)

When composing your FAQ you can use the formating controls in the "full answer" box or directly enter Markdown. Markdown is a great way of quickly adding formatting to textual content. If you've not used it before it can take a minute or two to get used to it but it's very fast to work with once you have got the hang of it. You can click the "Need help with Markdown?" button bottom left anytime for a quick reference Markdown guide.

You can see what your FAQ will look like to your users by pressing the "Preview" button top right. When you have written your content press "Next: Configure" to move onto the configuration options for your FAQ.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/vDpsP666Gj/screenshot-my.malcolm.app-2019.07.29-22_20_03.png (Configure FAQ in MyMalcolm)

In this area you can control various things about your FAQ such as whether an author is shown, what the URL is, your choice of tags, whether the feedback form is enabled and the category or categories the FAQ lives in. You also have various options around whether the FAQ can be seen by search engines, is password protected or not and can be found or not via the Malcolm! search/browse capability. You can even set the FAQ (or versions of it) to publish and un-publish automatically at certain dates and time in the future.

Watch a video guide to creating an FAQ below.

Question 6

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 7

Could I use Malcolm! as a publishing platform?

Accepted Answer

Malcolm! has primarily been designed around service interactions with users (eg answering their questions and taking them through a process) but we do have users who use Malcolm! in a more "marketing" or "content" based way eg to host content and/or take their users through forms to download content or register for something.

If you want to use Malcolm! in this way it's worth remembering that you have full branding control (more info here) and can even rename things like FAQ's and Workflows (more info here). You can also change your base URL. See more information in this article.

By default we do mark up FAQs content using https://schema.org/FAQPage so if your content doesn't follow a question and answer format and you allow that content to be indexed by search engines you may wish to change the schema to https://schema.org/WebPage. You can see how to do this here.

The Examples section on our website may give you some further ideas on how you could use Malcolm!

If you want to go even further you might want to consider contacting us and having a chat. We do offer enterprise packages and bespoke development on top of the Malcolm! Platform.

Question 8

How do I embed a Workflow into my website?

Accepted Answer

It's quick and easy to embed a Workflow into your website or app. In the Library screen of the Workflow section of MyMalcolm click the three dots on the right hand side of the screen and select "Embed"

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/bk1dEegpoU/screenshot-my.malcolm.app-2019.08.18-17_01_27.png (Quick link to Embed from the Workflow Library in MyMalcolm)

This will take you into the Share section of MyMalcolm! Here you can choose the type of embed you want to create.

https://malcolm-en-gb.s3.eu-west-1.amazonaws.com/instances/HwJyEPPI3q/resources/N17DhjfW2Z/Screenshot%202021-12-30%20at%2013.57.57.png (Create your embed in MyMalcolm)

If you want to float your Workflow over your webpage in a widget launched from a button or drawer that hugs the side or top/bottom of the screen select Widget.
If you want to launch an overlay that contains your Workflow from your webpage choose the Overlay option.
If you want your Workflow to appear within a part of an existing webpage select the inline option.
Finally if you the page to redirect to the Malcolm! web hosted version of your Workflow when the embed tag is fired select Redirect. You may wish to use URL rules with this option otherwise the redirect will fire on all pages the Malcolm! master tag is present on.

Follow the create embed process through - the Workflow you came from will be preselected as the content you want to embed. You will be offered various styling and display options based on the type of embed you choose.

At the end of the process you will be supplied with the embed code that you can add to he site or app where you want the Workflow to appear.

Question 9

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 10

Can I change where the logo on my hosted hub and hosted pages links to?

Accepted Answer

If you add a logo to your theme it will by default link to your hosted hub home page. Sometimes you might prefer to have your logo link back to your main website, or another destination.

You can change where the logo links to and whether that link opens in a new window or not in the header section of your theme.