# Mentionables
**URL:** https://meta.discourse.org/t/mentionables/192948
**Category:** Plugin
**Tags:** pavilion
**Created:** [June 7, 2021, 6:00am UTC](https://meta.discourse.org/t/mentionables/192948 "2021-06-07T06:00:11Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@angus](https://meta.discourse.org/u/angus)
#### Post date: [June 7, 2021, 6:00am UTC](https://meta.discourse.org/t/mentionables/192948/1 "2021-06-07T06:00:11Z")
The Mentionables plugin lets you establish a custom mention dataset. Custom mentions work the same as @users or #categories, but use data external to discourse, including linking to external urls.
#### Composer & Final Post view
This is just perfect for sets of Affiliate links. You can use Amazon or any other provider for that matter.
#### Administration View
#### Example Source
> **[Mentionables Plugin Test Data](https://docs.google.com/spreadsheets/d/1hg1zPmZjlUWPB4vdGTIMHr4a9jlZzYLnVgmCKBIatQY/edit)**
>
> This Sheet is private
Currently google sheets is the only supported data source, however the plugin is designed to support any source. If you’d like to add a new source, please [contact us](mailto:contact@thepavilion.io).
🖥 [**Get the code**](https://github.com/paviliondev/discourse-mentionables)
📄 [**Read the documentation**](https://coop.pavilion.tech/docs?ascending=false&category=120&solved=false)
🐛 [**Report a bug**](https://coop.pavilion.tech/w/bug-report/)
Not sure how to install a plugin? [Follow the steps here](https://meta.discourse.org/t/install-plugins-in-discourse/19157).
---
### Author:  [@Joshua\_Kogan](https://meta.discourse.org/u/Joshua_Kogan)
#### Post date: [October 15, 2021, 9:29pm UTC](https://meta.discourse.org/t/mentionables/192948/2 "2021-10-15T21:29:18Z")
Can topics be filtered by mentionables? I was thinking of creating a US state dataset, so each post can be related to a state.
---
### Author:  [@angus](https://meta.discourse.org/u/angus)
#### Post date: [October 18, 2021, 7:31am UTC](https://meta.discourse.org/t/mentionables/192948/3 "2021-10-18T07:31:36Z")
Not currently. How are you thinking the filter would work in an abstract sense? You can estabilsh any external dataset as a mentionables set. Perhaps you can use an additional column in the data that informs how posts with custom mentionable data would be ordered. Then you’d also need to deal with situations where mutiple mentions were made in the same post. If you scoped out the feature in some detail in an abstract sense we could get a sense of how much it would take to implement it.
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [November 3, 2021, 5:52pm UTC](https://meta.discourse.org/t/mentionables/192948/4 "2021-11-03T17:52:19Z")
Originally name was optional and could be derived from og tags - this was lost during a refactor.
I’ve pushed a fix: [make name optional again · paviliondev/discourse-mentionables@a7007b2 (github.com)](https://github.com/paviliondev/discourse-mentionables/commit/a7007b2632a4b87946faa7fe40f2b34e0def7431)
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [January 24, 2023, 7:05pm UTC](https://meta.discourse.org/t/mentionables/192948/5 "2023-01-24T19:05:45Z")
OK I’ve completed a couple of PR’s for this which get things back up and running:
[https://github.com/paviliondev/discourse-mentionables/pull/8](https://github.com/paviliondev/discourse-mentionables/pull/8)
Moves the API to Google’s official API, dropping an intermediary gem (and a few others) and adding CI so things should be a bit more reliable going forward.
Please note the breaking changes to settings:
- mentionables\_google\_spreadsheet\_url: “URL of the Google spreadsheet”
becomes:
- mentionables\_google\_spreadsheet\_id: “ID of the Google spreadsheet”
- mentionables\_google\_worksheet\_gids: “Restrict Google spreadsheet import to worksheet GIDs. If empty, all worksheets will be imported.”
becomes:
- mentionables\_google\_worksheet\_names: “Names of in-scope source worksheets (tabs)”
And there is a new setting:
- mentionables\_google\_worksheet\_max\_row: “Maximum number of rows scanned”
This fixes the front end (whilst adding tests)
[https://github.com/paviliondev/discourse-mentionables/pull/9](https://github.com/paviliondev/discourse-mentionables/pull/9)
---
### Author:  [@frold](https://meta.discourse.org/u/frold)
#### Post date: [May 2, 2023, 10:35am UTC](https://meta.discourse.org/t/mentionables/192948/6 "2023-05-02T10:35:33Z")
> [@angus](#):
>
> 📄 [**Read the documentation**](https://discourse.pluginmanager.org/c/discourse-mentionables)
Seems like a dead end…
---
### Author:  [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [May 2, 2023, 10:43am UTC](https://meta.discourse.org/t/mentionables/192948/7 "2023-05-02T10:43:38Z")
Thank you for reporting that, I have updated the link.
---
### Author:  [@frold](https://meta.discourse.org/u/frold)
#### Post date: [May 2, 2023, 11:55am UTC](https://meta.discourse.org/t/mentionables/192948/8 "2023-05-02T11:55:11Z")
Why is this so technically? Im not even able to set it up and work.
If there were a upload button for the spreadsheet it would have been available for an avg user user like me.
Or a online form editor. This is, sadly, way too advance.
---
### Author:  [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [May 2, 2023, 1:11pm UTC](https://meta.discourse.org/t/mentionables/192948/9 "2023-05-02T13:11:43Z")
I partly agree with you. This plugin was indeed built for a pretty technical audience. But only the setup is quite hard, after that, the opposite.
In fact, it tries to use a familiar editor by leveraging the power of Google Sheets.
Once it has been setup, any non-technical person can use the plugin in a much easier way than having to upload a file.
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [May 2, 2023, 1:40pm UTC](https://meta.discourse.org/t/mentionables/192948/10 "2023-05-02T13:40:09Z")
It’s not suitable for @frold’s use case I suspect which is to present a financial graph rendered by a third party site. Mentionables is not intended for such a use case.
---
### Author:  [@frold](https://meta.discourse.org/u/frold)
#### Post date: [May 2, 2023, 4:03pm UTC](https://meta.discourse.org/t/mentionables/192948/11 "2023-05-02T16:03:07Z")
if someone would guide via the chat they are welcome to contact me.
I dont think its safe to share the codes via the public forum…
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [May 2, 2023, 4:18pm UTC](https://meta.discourse.org/t/mentionables/192948/12 "2023-05-02T16:18:47Z")
@frold there’s no code here for sharing third party graphs. This plugin is not going to help you. It’s purely designed to permit sites to allow users to search and recall from a list of products as grey bubbles that are links to each products page.
---
### Author:  [@frold](https://meta.discourse.org/u/frold)
#### Post date: [May 2, 2023, 4:40pm UTC](https://meta.discourse.org/t/mentionables/192948/13 "2023-05-02T16:40:59Z")
> [@merefield](#):
>
> there’s no code here for sharing third party graphs
Okay - I thought it would insert a link into the post.
This url could be to an image, I thought
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [May 2, 2023, 4:50pm UTC](https://meta.discourse.org/t/mentionables/192948/14 "2023-05-02T16:50:46Z")
> [@frold](#):
>
> Okay - I thought it would insert a link into the post.
it does.
> [@frold](#):
>
> This url could be to an image, I thought
No, it’s just a boring description in a grey bubble 😅
A single additional screenshot would be helpful here I guess 🙂
This is just perfect for sets of Affiliate links.
Updated the OP.
---
### Author:  [@denvergeeks](https://meta.discourse.org/u/denvergeeks)
#### Post date: [October 4, 2023, 4:12pm UTC](https://meta.discourse.org/t/mentionables/192948/15 "2023-10-04T16:12:05Z")
Before I go through the setup and config – would an appropriate use-case for mentionables be in writing of Topics which are drafts of legal documents which need to be able to include references to laws and cases, where the connected “mentionables” spreadsheet contains a collection of relevant legal references and case law?
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [October 4, 2023, 4:16pm UTC](https://meta.discourse.org/t/mentionables/192948/16 "2023-10-04T16:16:49Z")
That’s sounds like a strong possibility. If you have nice pictures of dusty old books that would help 😉
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [October 4, 2023, 4:17pm UTC](https://meta.discourse.org/t/mentionables/192948/17 "2023-10-04T16:17:43Z")
One day I’ve been meaning to add alternative snippets for the same item accessed by pressing + additional times.
---
### Author:  [@denvergeeks](https://meta.discourse.org/u/denvergeeks)
#### Post date: [October 4, 2023, 4:50pm UTC](https://meta.discourse.org/t/mentionables/192948/18 "2023-10-04T16:50:45Z")
OK here are my settings (I’m using the Test Data Google Sheet provided in the setup instructions), and the error I am getting… (apparently the plugin is broken, and the developer requires a fee? Which is fine, of course, just FYI!)
Any help would be much appreciated!
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [October 5, 2023, 8:31am UTC](https://meta.discourse.org/t/mentionables/192948/19 "2023-10-05T08:31:33Z")
It’s still working, make sure your private key starts: `-----BEGIN PRIVATE KEY----` and ends `-----END PRIVATE KEY-----`
---
### Author:  [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [October 5, 2023, 8:38am UTC](https://meta.discourse.org/t/mentionables/192948/20 "2023-10-05T08:38:32Z")
> [@denvergeeks](#):
>
> apparently the plugin is broken, and the developer requires a fee
No, it’s working - and free. Why did you think that?
[Next page](https://meta.discourse.org/t/mentionables/192948.md?page=2)