# Discourse Dictionary Plugin 🆎

**URL:** <https://meta.discourse.org/t/discourse-dictionary-plugin/214484>\
**Category:** Plugin\
**Created:** [January 11, 2022, 6:06am UTC](https://meta.discourse.org/t/discourse-dictionary-plugin/214484 "2022-01-11T06:06:07Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![fzngagan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/fzngagan/32/259349_2.png) [@fzngagan](https://meta.discourse.org/u/fzngagan)\
**Post date:** [January 11, 2022, 6:06am UTC](https://meta.discourse.org/t/discourse-dictionary-plugin/214484/1 "2022-01-11T06:06:07Z")

</div>

**Summary** : The Discourse Dictionary plugin allows a user to add the dictionary meaning of a word to the first post of a topic. Here’s a short video to demonstrate the working.

🔗 **GitHub** : [GitHub - fzngagan/discourse-dictionary: A discourse plugin to add meanings of a given word to the post · GitHub](https://github.com/fzngagan/discourse-dictionary)  
➡ **Install** : Follow the [plugin installation guide](https://meta.discourse.org/t/install-a-plugin/19157).

### Features

- Allows a user (default to TL2) to select a dictionary meaning of a word via the composer. The selected word when hovered, will display a tooltip showing the selected meaning.
- Currently supports Oxford Dictionary API.
- Currently supports singular form of words i.e. `fungi` won’t work you’ll have to use `fungus`.
- The meanings are cached to the db for quick loads in the future and to avoid exhausting the API thresholds.
- You can tweak the values once they’re loaded in the composer.

### Configuration

- Get your API credentials from [https://developer.oxforddictionaries.com/](https://developer.oxforddictionaries.com/)
- Use the `app id` for the site setting `discourse dictionary oxford app id`
- Use the `api key` for the site setting `discourse dictionary oxford api key`
- You can set the minimum trust level of user’s who can access this feature using `discourse dictionary min trust level`

### TODO

- Support plural forms of words
- Support other Dictionary APIs
- Include tests

### Credits

Thanks a lot @sam

- I’ve drawn insipiration from the tooltip code in the `discourse-footnote` plugin.
- The markdown docs on meta were indispensable for writing this plugin.

---

_[View the full topic](https://meta.discourse.org/t/discourse-dictionary-plugin/214484)._