Assistance with Utterances commenting plugin

support
1

Can someone please help me add the Utterances commenting plugin to the Hugo-goa, a Hugo theme? I’ve added the HTML file into the folder structure of my site theme but I don’t know/understand how to reference it in my config.toml file, can someone help me a complete noob?

I’ve commented out discuss Discuss commenting but add its replacement.

2

And link to your repo?

3

Here is a link to the Hugo-goa theme. My commenting repo is here. There is nothing in it, it was made for the commenting setup only.

In a separate question, is there a way to make the Utterances controlled by the theme’s front matter so the author can designate whether a page gets comments or not?

So, for example…

---
Author: me
title: My title
published: true
comments: false
---

On another page the comment visibility may be true.

4

Set comments: false` to the pages you want to exclude comments on, then wrap your utterances code with a command like below

{{- if (not (isset .Params "comments")) }}
<!-- your Utterances code here -->
{{- end }}
5

What @anon34553931 mentions shall be enough. You just need to paste it into your relevant layout (in that case content.html).

I know that utterances is quite popular and it’s a good solution but personally would recommend thinking about activating discussions in GitHub and using Giscus for comments.

6

I still need help. How do I associate this code with something on my config.toml file?

CleanShot 2022-11-26 at 20.39.54@2x
CleanShot 2022-11-26 at 20.39.54@2x3358×2228 395 KB

7

Like what?

8

You don’t. You paste it into your layout where it supposed to be displayed. There is nothing to associate.

9

I’ve done that then. Nothing has changed.

10

I edited the code. Try it again.

11

I made the edits, nothing changed

{{- if (not (isset .Params "comments")) }}
<script src="https://utteranc.es/client.js"
        repo="bocciaman/site-comments.git"
        issue-term="pathname"
        label="Blog"
        theme="github-light"
        crossorigin="anonymous"
        async>
</script>
{{- end }}

Nothing changed!

12

I should also ask, will the comment section appear if the site is still using the localhost to preview?

13

Are you sure you have configured Utterances correctly?

14

I think so, what can I share to confirm?

15

I don’t use utterances. Does the comment box show up when you jut paste the script without wrapping it with the Hugo code?

16

No, that why I thought I’m missing something that should be in the config.toml page.

17

Try below:

  {{ if .Params.comments }}
  <script src="https://utteranc.es/client.js"
        repo="bocciaman/site-comments.git"
        issue-term="pathname"
        label="Blog"
        theme="github-light"
        crossorigin="anonymous"
        async>
</script>
{{ end }}

set in post frontmatter in which this need to be displayed

comments: true

and pass the link where is implemented live to have a look.

18

I might be wrong, but perhaps you have not implemented utterances properly. I tested the code I shared and in pages where the comments: false is set, the script does not show up in the source code. So, I advise you troubleshoot the installation again (you can also test in production and see).

19

Exactly.
I see code loading in console but not displaying.
Try to implement it to see if it’s working before adding conditions to when need to be displayed.

20

You also have to decide i you want the comments on or off by default. But troubleshoot your installation and get back. This seems to be an Utterances issue, not a Hugo issue.